交易所 / 众筹站多币种接入集成接口
海蓝天1688
发表于 2022-12-2 10:10:36
69
0
0
标准json字符串: x; P6 _ C- L8 ^# x7 _8 _! ]; c Z
统一响应参数
标准josn字符串2 [7 `. u, k1 Z# c+ t c& z( S& @
example:{code:1,msg:”测试”,result:”json数组”}+ [; h6 S" V1 W5 _# G* q; N: r
统一code说明; |) W! q( w, P" ^- z2 z
code:-2 msg:操作失败
code:-1 msg:系统异常
code: 0 msg:操作成功# a& h1 w! S% _6 Q2 l1 Z
1.1. 创建钱包地址( `" Q9 G3 ]3 g* D8 ]! @; P" N; T
请求地址 http://IP:PORT/api/wallet8 [* I# q) U. g/ O' J/ b
请求参数
{
"cmd":"wallet_create",
"params": {: {5 y, t5 f7 V) j" U
"password":"123456"
}
}9 s2 T- x* b: {5 U: p
参数说明
参数名称 说明 必填
password 钱包密码 Y2 z8 k5 r7 ^) {# C, w
响应参数
{0 l2 \3 R5 u0 R" U5 P2 s
"code":"0",
"msg": "",
"result":{3 t4 A9 z" x- H
"address": "0x113d79bea1f6ff0681a778dace3c64d5ff915c89"3 T1 c3 O/ \. t' m8 M# q1 V
"keystore": "{\"address\":\"fdd332dd0035eeec1a81ed56fd72633b25f63361\",\"id\":\"e67e1962-d9d7-4cf9-aa07-5387ae5dc320\",\"version\":3,\"crypto\":{\"cipher\":\"aes-128-ctr\",\"ciphertext\":\"466ab1504fc6b1082945779429aba45dc081385a4dc3846ff940d0703741e071\",\"cipherparams\":{\"iv\":\"f5f5a4547bc7f22f44f22ba64ff50603\"},\"kdf\":\"scrypt\",\"kdfparams\":{\"dklen\":32,\"n\":4096,\"p\":6,\"r\":8,\"salt\":\"3e66f07671383d420ded08098f50a5246f64ddf1c1ab56d0acdc9a04fe96cef0\"},\"mac\":\"4496da44fa9d1d44a5e09f6abd7500fe03500054a5c5aea3d4af6e3a28593fff\"}}"
}
}3 c- x+ U8 B. k( p5 [
参数说明 address 钱包地址
1.2. 导入钱包
请求地址 http://IP:PORT/api/wallet5 }9 g# o4 L8 r v p( U7 E
请求参数6 G4 S( l0 A+ C5 b% f( u
{
"cmd":"wallet_import",2 d5 V* A2 \8 `/ P6 \
"params": {
"keystore":"{\"address\":\"113d79bea1f6ff0681a778dace3c64d5ff915c89\",\"id\":\"778a5f41-b680-4edb-86fd-e117d426dfbb\",\"version\":3,\"crypto\":{\"cipher\":\"aes-128-ctr\",\"ciphertext\":\"e59369214acc42d6f4b72ae3c1623273c7a6f9238e97c1e3a74401551315fc42\",\"cipherparams\":{\"iv\":\"27227ccc77183e8fc97c57afe644774a\"},\"kdf\":\"scrypt\",\"kdfparams\":{\"dklen\":32,\"n\":4096,\"p\":6,\"r\":8,\"salt\":\"8f2860de861d5f4273d447dd66b6b8df3ae19bc88c5a5782be7428de64be71b5\"},\"mac\":\"b5f92a51d0dc6c60484204c8559d1debcd3efe89f82f870bd40f8ce6a392ade5\"}}",% f- s7 l$ V2 j/ D
"password":"123456"3 T( J9 d# W# V; }
}
}" A* O/ U. Z% F
参数说明$ v; A9 t" @4 w* L7 }- {, c
参数名称 说明 必填
keystore 钱包keystore Y& ~9 A( w+ L' w! A9 |1 L0 A
password 钱包密码 Y
响应参数 K! L# S5 M6 c" u; ?% M* y3 V
{
"code":"0",
"msg": "",4 u% S6 X$ k l5 b a/ [3 R) N
"result":{" Z6 V5 S$ F2 u( d8 i, b
"address": "0x113d79bea1f6ff0681a778dace3c64d5ff915c89" e$ @# v: S6 d' T) i/ u; T0 W
}+ h: e1 a2 b% r3 H9 s; p9 { w3 Y* I
}
参数说明 address 钱包地址
1.3. 查询余额6 q N! f$ |6 \9 Z9 _
请求地址 http://IP:PORT/api/wallet
请求参数7 o* {$ s& o. c+ |( b( P9 m' u) A
{
"cmd":"wallet_balance",9 R* C) \) s/ ^* b8 S& F9 a
"params": {
"address":"0x78c001ad4409ceb94dc0e07e1f2cd9ac62f24d10"
}
}
参数说明0 Q$ R8 C) M) V4 a. X g+ P
参数名称 说明 必填+ _- O- z3 K" ]0 ^3 T3 U" @
keystore 钱包keystore Y
password 钱包密码 Y
响应参数7 ~8 c1 g' y5 N2 I& h
{
"code":"0",
"msg": "",
"result":{- r& {# T2 N: u2 U0 S9 q
"balance": "88.2",: s0 P* |4 Z$ ^7 s
"eth_balance": "0.03",( ~) B8 V1 T# A8 y# `
}
}
参数说明6 D4 w. X$ }& Q% J* G% @: w
eth_balance 以太币数量# g) ~& v$ B+ W: |
balance 代币数量
1.4. 代币转账0 ]6 i8 l- H8 ]. S' ]7 m
请求地址 http://IP:PORT/api/wallet
请求参数
{3 Z+ g+ @0 i7 q/ Z3 j1 U: j
"cmd":"wallet_transaction",
"params": {
"from_address":"0x78c001ad4409ceb94dc0e07e1f2cd9ac62f24d10",
"password":"123"," h& f% @$ T8 |5 _4 ~' S
"to_address":"0x113d79bea1f6ff0681a778dace3c64d5ff915c89", Z* {' P8 i) V: {% ]# e
"cost": "0.00018", : h$ S) v/ l0 i( [% ^
"num":"0.22"
}
}: R+ ?1 {2 y& ^# G4 W7 E
参数说明% Z* f/ \5 w' k' |3 s7 J6 ]8 J% Y
参数名称 说明 必填
from_address 转出钱包地址 Y; @; ~0 a) Z4 |3 G2 f) B
password 转出钱包的密码 Y
to_address 转入钱包地址 Y. v8 Z7 q; U3 E- i' O0 x; M- T0 [
cost 手续费,单位:以太币。(手续费越高,到账时间越短,过低的手续费可能导致交易失败)目前限制了最低手续费为 0.00018 Y5 q" j2 `+ G. f$ K0 F1 f
num 转出代币数量 Y2 E: Q4 q6 x; }% f
响应参数 o* P9 a+ P+ f7 x1 m
{' l% g: N$ M0 }- q7 ?. s$ M
"code": "0",1 _4 H* M0 C: }7 g1 b+ f
"msg": "",1 I4 \: G1 i6 O/ j% t9 }7 a
"result":{8 c# d/ x8 {* c9 [9 B$ [6 W
"trans_hash": "0x601e124ffc98d7682ef9ea4c731efdab576f34f47e80bec84c5f17b5af7098d6"2 o5 E5 S6 k% u/ a: N1 o4 N
}
}+ J) I/ ^! _3 f& F3 E
参数说明 trans_hash 交易Hash值
1.5. 查询交易状态; g! O: s# U$ A
请求地址 http://IP:PORT/api/wallet! M/ Y7 h0 A) }" Q8 E- f( ?2 O
请求参数( I! B% S9 U" Y! x- d
{
"cmd":"trans_status",
"params": {5 W/ v. _ h# i" A- T+ F2 M. l- T" n
"trans_hash": "0x601e124ffc98d7682ef9ea4c731efdab576f34f47e80bec84c5f17b5af7098d6"" }. f" y: I# t0 Q6 ~3 D* g
}7 C: B: p; i5 l) Z
}
参数说明7 u' i0 A8 x3 q( S: D3 ~
参数名称 说明 必填 q! p4 Y+ b1 F: g, J( A3 p
trans_hash 交易hash值 Y, T' J) v J( S8 E# d
响应参数
{
"code": "0",! o6 \% K8 V+ M7 G
"msg": "",
"result":{
"status": "1"7 g- n- L& C( q6 c$ B& ?1 n
}
}4 W0 F% C$ J: [* d4 f" l+ S3 x
参数说明 status 1 交易完成、 0 未完成7 _$ N' y& D* E# r& d+ O7 R
1.6. 查询交易详情
请求地址 http://IP:PORT/api/wallet% A1 A5 U1 }" J0 X9 k( {& l X
请求参数& C& u+ k e* P* L& c
{. L+ U D4 T0 M2 ?- B8 `9 X3 P' r
"cmd":"trans_detail",
"params": {$ q* u% W1 F3 M M
"trans_hash": "0x601e124ffc98d7682ef9ea4c731efdab576f34f47e80bec84c5f17b5af7098d6"
}9 X4 b$ w* ]; D# x$ U- A
}
参数说明
参数名称 说明 必填
trans_hash 交易hash值 Y: n) p2 E e+ p! m4 {; t
响应参数
{4 S( z/ I+ Q; G4 k) j8 z
"code": "0",. \2 a( p! b* r+ S; s# Q5 K
"result":{0 Z/ b2 H, o* W/ W7 M: c
"num": "2",
"from": "0x78c001ad4409ceb94dc0e07e1f2cd9ac62f24d10",
"to": "0x33852530794c67fac23a010e2e4a88fb84477ff2", k5 p& U0 ?9 K* ^) H4 l; J
"timestamp": 15257742965 j6 W! F1 i# G) S- J
}
}. U/ N! A: g* x0 l+ H0 E
参数说明
1.7. 查询交易记录
请求地址 http://IP:PORT/api/wallet
请求参数5 N v: W0 S6 y8 a1 l* v& j! D4 O) _
{
"cmd":"trans_record",
"params": {
"address":"0x78c001ad4409ceb94dc0e07e1f2cd9ac62f24d10"+ N+ z/ ?4 t1 l
}1 `9 S5 ~4 r6 `% s; a2 P9 E
}
参数说明0 p( ?& k% {& s4 T( f
参数名称 说明 必填! ?1 d0 I% |* _% S# P; ?
trans_hash 交易hash值 Y4 m& J) M5 X" e. v9 c
响应参数. u: q; \( g5 d
{
"code": "0",! {- `& b1 K" v3 D
"result":{0 V- Z$ z9 p) `6 k; B! Y# l
"records":[{4 F; a( l" Q0 U$ X+ t& e8 ?
"num": "0.02",
"from": "0x06bf56bd88349c5b9f77d6bb79377d43f0f0abd8",) e) K6 i* a1 M: B/ W# N* _# m' ]
"to": "0x70550b9acd503d5154d21985426a0829612dc060",0 j3 K, P1 Z" q, @* c) Q& z
"hash": "0x7c2ed817daca92c6ee29f18e31807c663b1b91d35f82365697ef14f6a272b208",4 U9 {0 e& y* Q& w: [$ \
"timestamp": 15257742963 y0 V* ]$ G: y7 Q4 w
},{7 G: x( ~6 w$ v) B$ Q& S
"num": "0.01",
"from": "0x70550b9acd503d5154d21985426a0829612dc060",1 o( R( u) M+ X) Y4 O: P! u
"to": "0x06bf56bd88349c5b9f77d6bb79377d43f0f0abd8",8 K* d% o# \1 D7 F
"hash": "0x7c2ed817daca92c6ee29f18e31807c663b1b91d35f82365697ef14f6a272b208",
"timestamp": 1525774296
}]6 w4 A& U0 k" o( F
}3 H& H" M, Q: p9 A
}
成为第一个吐槽的人