交易所 / 众筹站多币种接入集成接口
海蓝天1688
发表于 2022-12-2 10:10:36
74
0
0
标准json字符串
统一响应参数$ Q o% M+ M, s8 A
标准josn字符串9 [/ @) ]" q- {6 o
example:{code:1,msg:”测试”,result:”json数组”}0 R1 _/ [( p5 x3 }
统一code说明
code:-2 msg:操作失败
code:-1 msg:系统异常+ S. P" T. Y4 D# W+ N+ z- |
code: 0 msg:操作成功
1.1. 创建钱包地址
请求地址 http://IP:PORT/api/wallet: I% g/ G7 b# k1 K: \) D( V( ]
请求参数1 p6 d* t' L% c9 Y% ?
{% ?9 U: ]: ^3 k: B: V' q$ V% q
"cmd":"wallet_create",
"params": {+ K+ X! W' g o3 l6 G: ~1 k
"password":"123456"* w& B% d! G0 a1 G( \6 j/ u
}
}- Z+ v1 k7 c# ]; L, A1 F
参数说明
参数名称 说明 必填
password 钱包密码 Y4 V. h! y4 W0 q2 S) ` Y
响应参数
{+ s* q2 U& @4 X4 G B% o: g+ g, m0 Y
"code":"0",
"msg": "",
"result":{ t/ v% a9 `) O( D4 c
"address": "0x113d79bea1f6ff0681a778dace3c64d5ff915c89"
"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\"}}"
}7 x' j. K( p+ t# L$ ^3 m
}8 i( V. A* E- o: Z9 A4 M. i5 N
参数说明 address 钱包地址
1.2. 导入钱包$ l) `2 n S4 w5 s6 R
请求地址 http://IP:PORT/api/wallet6 B' v/ B1 d) q* `
请求参数
{: n2 i9 \) R5 m. G. M6 b
"cmd":"wallet_import",
"params": {8 J% U; e. C& y: n
"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\"}}",
"password":"123456"; x' V$ x: g7 p' ?- B
}: c X' j& ~% d! `! A
}
参数说明
参数名称 说明 必填- p' i- N7 K; J, x0 n1 }
keystore 钱包keystore Y
password 钱包密码 Y
响应参数7 [4 k$ x! ^+ g7 n6 `0 C. U2 ]* ?
{8 r6 ^! a3 s3 q9 ?( e/ K$ E
"code":"0",5 @5 f$ U# U1 p# v
"msg": "",7 w' p9 f2 G6 t3 G# u+ j- [# g
"result":{* a5 t: t; K% C0 [" P: l6 ], Q
"address": "0x113d79bea1f6ff0681a778dace3c64d5ff915c89"
}+ [$ F2 p: ?4 ^- e/ @
}2 e9 N+ T9 d f( o5 s
参数说明 address 钱包地址$ u$ R! j6 L) `% l! h1 Z
1.3. 查询余额% y3 ]" A+ C# r) C: t) a
请求地址 http://IP:PORT/api/wallet
请求参数6 D9 M/ c, W5 ^$ g1 \. s; I
{- E/ v' L0 H& H
"cmd":"wallet_balance",
"params": {, F; ]3 s) Z4 g# v
"address":"0x78c001ad4409ceb94dc0e07e1f2cd9ac62f24d10"
}9 t, O N% P+ ^
}
参数说明0 Z# g3 O8 _5 v/ B4 E" b
参数名称 说明 必填& i. _9 X7 [ R
keystore 钱包keystore Y
password 钱包密码 Y3 t U& V# Z8 S, Z8 T
响应参数
{
"code":"0",
"msg": "",
"result":{
"balance": "88.2",
"eth_balance": "0.03",
}
}
参数说明" |6 l U7 H) d8 E4 F
eth_balance 以太币数量
balance 代币数量9 b: M* k6 R. W+ ~ I
1.4. 代币转账
请求地址 http://IP:PORT/api/wallet* H- g9 o" \9 D. k" a: C/ k. G
请求参数
{
"cmd":"wallet_transaction",' Z( c. X8 Q! {( L
"params": {! K) j4 r7 A6 {8 p) l4 \
"from_address":"0x78c001ad4409ceb94dc0e07e1f2cd9ac62f24d10",
"password":"123",
"to_address":"0x113d79bea1f6ff0681a778dace3c64d5ff915c89",! O% n% R1 F/ H q$ j0 }7 J
"cost": "0.00018", T" h+ m( s( s% l, y6 L
"num":"0.22"% K5 R( t. u: o; \: s
}
}
参数说明6 O @- q& l+ b; ^8 s7 R' P/ K7 n
参数名称 说明 必填2 L4 e) M& t& }7 `6 k0 G
from_address 转出钱包地址 Y
password 转出钱包的密码 Y6 o- n! b2 N0 h c
to_address 转入钱包地址 Y# f- s& N6 }- u4 M; D% E- L. k
cost 手续费,单位:以太币。(手续费越高,到账时间越短,过低的手续费可能导致交易失败)目前限制了最低手续费为 0.00018 Y5 G7 _+ ?7 y( h! b& y
num 转出代币数量 Y
响应参数% G& o) U! f9 s% F0 a* D
{$ _' g9 k' i T& F w! j; W
"code": "0",/ b; ]3 [" ^* `9 A" \) o; C
"msg": "",
"result":{" I( }" e: L! f5 z9 w. l
"trans_hash": "0x601e124ffc98d7682ef9ea4c731efdab576f34f47e80bec84c5f17b5af7098d6"
}3 s7 l2 T% w9 L; ] e
}5 \+ z$ {& J8 W( O* M \
参数说明 trans_hash 交易Hash值; |0 \: N0 C. [" _9 P) T8 k
1.5. 查询交易状态
请求地址 http://IP:PORT/api/wallet9 U0 g- U) [5 I. Z5 U$ }8 ]4 h2 F& M
请求参数6 z- T) a# [: y0 @: \9 v) x
{" P' ?' x0 N3 a/ S
"cmd":"trans_status",+ N( w3 n# ?/ d
"params": {/ W [0 w( F; d! x& g- V& m# H
"trans_hash": "0x601e124ffc98d7682ef9ea4c731efdab576f34f47e80bec84c5f17b5af7098d6"
}
}
参数说明$ G& t1 a9 O; ^
参数名称 说明 必填, r# |4 m# y" q1 A* H7 E
trans_hash 交易hash值 Y' [- @ ^, m, E' {9 P& C
响应参数! n* k; C9 i& W2 _$ s' q
{( c) r% J8 u2 f2 y- x1 ?8 v- w L
"code": "0",
"msg": "",
"result":{
"status": "1"
}' F f% O2 H9 i. a" o5 x( T- E% L& d
}, n. h/ {0 A0 g
参数说明 status 1 交易完成、 0 未完成
1.6. 查询交易详情0 U3 G0 [* K: {) ]
请求地址 http://IP:PORT/api/wallet
请求参数
{- T8 [* z0 w4 V( Y' E
"cmd":"trans_detail",
"params": {7 F7 o, `+ B8 S& ? [5 y
"trans_hash": "0x601e124ffc98d7682ef9ea4c731efdab576f34f47e80bec84c5f17b5af7098d6"
}
}4 j6 g' l) q$ w( Q) O7 B- J
参数说明
参数名称 说明 必填 V# ?4 H& x b' B' P
trans_hash 交易hash值 Y/ g0 ?" i) Q' v
响应参数4 ^$ @& Z# C: v
{4 O! _8 H- b* D
"code": "0",9 @6 G* `0 \+ V
"result":{0 k- _0 ~" r# a' m& {; {0 I
"num": "2",5 T% j2 A3 t5 d0 \
"from": "0x78c001ad4409ceb94dc0e07e1f2cd9ac62f24d10",
"to": "0x33852530794c67fac23a010e2e4a88fb84477ff2",
"timestamp": 1525774296
}+ A3 K; \$ A3 o, {* k' {1 r
}
参数说明. i P4 Q0 }" R. r
1.7. 查询交易记录; k0 u3 A$ f1 T2 }; R- O
请求地址 http://IP:PORT/api/wallet' @8 x7 e1 n7 }: a9 i: U3 ?% ^) [
请求参数$ A7 g- F+ d- M" K; _# L
{
"cmd":"trans_record",
"params": { u0 j4 X7 w1 _
"address":"0x78c001ad4409ceb94dc0e07e1f2cd9ac62f24d10"
}, E c6 k3 ~/ \5 ^. E6 D. G
}% a; @9 U5 h" X: {
参数说明
参数名称 说明 必填! o1 j4 E# A4 o/ m) `% T
trans_hash 交易hash值 Y
响应参数; c: r$ G$ M& K( V( T
{/ u2 H3 x7 `( Q/ o. }
"code": "0",$ T. u1 R# ]3 a" V) L
"result":{" y2 w; _& e8 T/ v, y
"records":[{: _+ Z0 S2 J y9 k f
"num": "0.02",
"from": "0x06bf56bd88349c5b9f77d6bb79377d43f0f0abd8",
"to": "0x70550b9acd503d5154d21985426a0829612dc060",
"hash": "0x7c2ed817daca92c6ee29f18e31807c663b1b91d35f82365697ef14f6a272b208",1 \/ Q* C8 v' ?0 m& }! S
"timestamp": 1525774296
},{$ ]# U; l3 K; k
"num": "0.01",
"from": "0x70550b9acd503d5154d21985426a0829612dc060",
"to": "0x06bf56bd88349c5b9f77d6bb79377d43f0f0abd8",
"hash": "0x7c2ed817daca92c6ee29f18e31807c663b1b91d35f82365697ef14f6a272b208",, u0 a2 j# L a( W1 W
"timestamp": 1525774296" w$ e1 u1 z; |: z T' c
}]3 [: Z' f) Q2 Y! W
}
}
成为第一个吐槽的人