交易所 / 众筹站多币种接入集成接口
海蓝天1688
发表于 2022-12-2 10:10:36
113
0
0
标准json字符串
统一响应参数
标准josn字符串% W. f ~/ K- G" J" Q/ C
example:{code:1,msg:”测试”,result:”json数组”}
统一code说明
code:-2 msg:操作失败3 X; N" G! ?) K3 p. {1 i: K0 i( R
code:-1 msg:系统异常( x$ C( I/ c/ v# P
code: 0 msg:操作成功, c; w: a; D% r+ f* s$ P
1.1. 创建钱包地址
请求地址 http://IP:PORT/api/wallet9 h& {. y7 r: k5 ?0 V- i
请求参数
{
"cmd":"wallet_create",
"params": {
"password":"123456"# S7 g7 ^% W r# T
}9 j" |( ~* p3 B4 f
}9 V1 l$ O* n* L( x, g9 {0 Z
参数说明& H2 G) g+ r& \* U# y' ~$ X, J7 r
参数名称 说明 必填
password 钱包密码 Y. C9 G' v5 C6 D- j
响应参数
{
"code":"0",
"msg": "",
"result":{
"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\"}}") m; d/ s) j# h
}
}1 e6 R/ |5 S+ T8 N: o
参数说明 address 钱包地址
1.2. 导入钱包* s+ H" q* z e, B# f' N
请求地址 http://IP:PORT/api/wallet# j* C2 u# N; L
请求参数
{
"cmd":"wallet_import",
"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\"}}",
"password":"123456"+ m9 C! R, l* N4 W2 G! |# A% y
}
}
参数说明
参数名称 说明 必填
keystore 钱包keystore Y
password 钱包密码 Y. G- \$ l6 F) F5 a% x2 b% S
响应参数
{& @7 q: N( ~+ N+ f0 N3 q. e
"code":"0",% ^: P+ Q4 W$ ?- ]# o% R c5 e2 E
"msg": "",. F7 F" X- _* `3 m0 t4 E9 P7 N
"result":{
"address": "0x113d79bea1f6ff0681a778dace3c64d5ff915c89"
}
}
参数说明 address 钱包地址
1.3. 查询余额# \, L9 ?) k& h1 i* R9 s
请求地址 http://IP:PORT/api/wallet& B5 g0 h0 b& N
请求参数
{3 \- ~$ ^' w6 z' D8 ^
"cmd":"wallet_balance",
"params": {
"address":"0x78c001ad4409ceb94dc0e07e1f2cd9ac62f24d10", c Q% F2 W! {5 } K
}
}
参数说明; h0 a; z5 y" y/ y3 ]+ n( G
参数名称 说明 必填
keystore 钱包keystore Y
password 钱包密码 Y
响应参数
{$ e$ n, L$ e/ V) e4 J& h: ~% X
"code":"0",5 d2 |5 W$ ]+ r3 t7 k! y2 l) r
"msg": "",) o* E1 H, K3 Q3 F
"result":{
"balance": "88.2",: t8 z7 t5 T2 S
"eth_balance": "0.03",
}
}% O9 w% {2 y* g0 o
参数说明. F* {/ J( v) B y# ^' S
eth_balance 以太币数量5 w8 m4 ^3 U5 C' E; J. o r) l" _
balance 代币数量
1.4. 代币转账; J7 X. M0 P, ~$ m
请求地址 http://IP:PORT/api/wallet
请求参数: |& @: l4 X* _9 F! ~2 f+ _
{5 c) u3 z. @" {* L% o
"cmd":"wallet_transaction",
"params": {
"from_address":"0x78c001ad4409ceb94dc0e07e1f2cd9ac62f24d10",; U3 X2 G6 V3 D' r
"password":"123",8 f' U" g9 W$ l' U
"to_address":"0x113d79bea1f6ff0681a778dace3c64d5ff915c89",
"cost": "0.00018", 0 ~3 K, T! M' b$ `/ U$ `1 e, q
"num":"0.22"% j/ `, s% Z' e0 r: {
}- v+ V9 R8 e( ~* E' d: B& U
}
参数说明6 N. H: p4 \* A" x
参数名称 说明 必填
from_address 转出钱包地址 Y2 r2 j2 H+ K1 Y1 l2 u2 o
password 转出钱包的密码 Y
to_address 转入钱包地址 Y: b& M- @; l) _1 t! n
cost 手续费,单位:以太币。(手续费越高,到账时间越短,过低的手续费可能导致交易失败)目前限制了最低手续费为 0.00018 Y U ^9 L m' C4 V) Y3 p4 l
num 转出代币数量 Y
响应参数+ u* J% |4 w# U! ]$ [8 b( a6 r
{
"code": "0",
"msg": "",, I l( C; L! T! u! _
"result":{4 s& K$ s; f6 V6 I7 y/ _& X8 L
"trans_hash": "0x601e124ffc98d7682ef9ea4c731efdab576f34f47e80bec84c5f17b5af7098d6"
}
}
参数说明 trans_hash 交易Hash值2 W0 ^. G+ z& n8 n6 Z+ Z
1.5. 查询交易状态; Q: q" T: F; B4 j$ D
请求地址 http://IP:PORT/api/wallet" n. v& M2 O: [( P( U/ g6 ?3 d
请求参数
{3 d% ?, c1 m% @1 H- V
"cmd":"trans_status",6 R3 {, w- ?' U k, L$ M0 \2 K0 G" C
"params": {- w' E( J! v0 X
"trans_hash": "0x601e124ffc98d7682ef9ea4c731efdab576f34f47e80bec84c5f17b5af7098d6"
}
}- C# w/ D" H9 e, q* e2 k* p' `, `2 j$ ?
参数说明9 |, Z0 \8 k& s% i6 l# p1 q
参数名称 说明 必填
trans_hash 交易hash值 Y
响应参数' Z% T' m- U( M4 Y
{7 |$ p0 U4 d" s0 I5 L" J! P
"code": "0",
"msg": "",
"result":{3 Q# \3 c# U9 M% i' @7 a. W3 y1 v0 S6 l
"status": "1"
}1 U+ Y3 ?* @+ K8 I
}
参数说明 status 1 交易完成、 0 未完成
1.6. 查询交易详情 C2 {& v& g. s6 V, M% Y; l
请求地址 http://IP:PORT/api/wallet$ I* ]7 G# a& u9 z1 h$ b" m+ S- a3 M
请求参数
{7 N0 t" z S8 u* f
"cmd":"trans_detail",
"params": {" D! u, u5 a- p' P
"trans_hash": "0x601e124ffc98d7682ef9ea4c731efdab576f34f47e80bec84c5f17b5af7098d6"
}. r5 Y! e- {: c/ {- x
}5 S/ G3 [: X. V7 ?
参数说明$ x4 s. R1 d' k! v8 j8 y' U8 H
参数名称 说明 必填9 \, G: b( Z9 g/ q n
trans_hash 交易hash值 Y
响应参数
{4 ?& i# Q# I$ u5 A
"code": "0",
"result":{
"num": "2",7 A# v9 t: L; @
"from": "0x78c001ad4409ceb94dc0e07e1f2cd9ac62f24d10",9 o: x7 L* R, Y1 |- t$ F4 m" K& G
"to": "0x33852530794c67fac23a010e2e4a88fb84477ff2",; F _" E9 z4 o& x8 o& t
"timestamp": 1525774296
} v1 U% B% M7 P! \6 Y
} b; @- j1 {+ b2 M" C' N
参数说明
1.7. 查询交易记录7 _. p# b. {8 G) V& I% I
请求地址 http://IP:PORT/api/wallet
请求参数# a! Y, E; r& b1 Y8 x, m
{
"cmd":"trans_record",2 X- B% t' `; a, y
"params": {
"address":"0x78c001ad4409ceb94dc0e07e1f2cd9ac62f24d10"& T4 z3 t' H! S+ g5 I( u
}* o z0 X& j5 a2 R% t3 |& w
}( x8 a, d+ Z# J0 x
参数说明
参数名称 说明 必填0 N' s+ H" o. \- j1 [
trans_hash 交易hash值 Y" O$ \) Q- V' z, ^. t2 R
响应参数9 M Y# e% Y' U( [3 ^5 |& F! p
{+ {) }! v5 y! w: b! q
"code": "0",6 L9 F( }0 X4 n( h- P0 o
"result":{
"records":[{6 t% A+ d% F$ t7 k
"num": "0.02",
"from": "0x06bf56bd88349c5b9f77d6bb79377d43f0f0abd8",
"to": "0x70550b9acd503d5154d21985426a0829612dc060",
"hash": "0x7c2ed817daca92c6ee29f18e31807c663b1b91d35f82365697ef14f6a272b208",* y& ^! @* N3 C
"timestamp": 1525774296
},{
"num": "0.01",
"from": "0x70550b9acd503d5154d21985426a0829612dc060",
"to": "0x06bf56bd88349c5b9f77d6bb79377d43f0f0abd8",* l+ H, [0 j: E; h
"hash": "0x7c2ed817daca92c6ee29f18e31807c663b1b91d35f82365697ef14f6a272b208",
"timestamp": 15257742961 f: c6 I: g8 u$ ?
}]
}6 G- Z% ^; d9 J$ ~
}
成为第一个吐槽的人