交易所 / 众筹站多币种接入集成接口
海蓝天1688
发表于 2022-12-2 10:10:36
75
0
0
标准json字符串) o$ _9 R1 `6 Z( S0 c
统一响应参数
标准josn字符串
example:{code:1,msg:”测试”,result:”json数组”}
统一code说明0 T2 |# Y) Z$ `; k
code:-2 msg:操作失败1 i; H" S% d, O" t+ A$ X
code:-1 msg:系统异常1 n; p5 n9 h# @7 e+ c/ w: C
code: 0 msg:操作成功
1.1. 创建钱包地址
请求地址 http://IP:PORT/api/wallet
请求参数8 e) [* _. }* r, ~4 h
{
"cmd":"wallet_create",- ^# |2 l, D4 W; x3 E5 m
"params": {& X& N) M7 w1 t7 A0 C6 C
"password":"123456"
}
}
参数说明/ I9 u& \8 c q$ }$ q* j( x" u
参数名称 说明 必填8 X% J" k- ]$ R( v
password 钱包密码 Y7 Y" j# N! }1 m( G' ~* U
响应参数
{
"code":"0",
"msg": "",
"result":{
"address": "0x113d79bea1f6ff0681a778dace3c64d5ff915c89"7 C( D# t( l. J9 \% y [
"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\"}}"
}+ C( t& k2 w6 e
}
参数说明 address 钱包地址
1.2. 导入钱包
请求地址 http://IP:PORT/api/wallet7 V1 P# _4 b7 _- m
请求参数
{( P' |) [ m6 |# ~
"cmd":"wallet_import",# l2 @3 w( Y% Z
"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"6 E5 U7 G6 p, |( i/ N5 `
}
}3 X0 C! p4 v1 G7 E. L* L- G
参数说明# Q5 T7 r# P/ k
参数名称 说明 必填/ P; m9 Z" T" q
keystore 钱包keystore Y+ U0 O- r' }5 P1 X* D
password 钱包密码 Y$ S+ E8 ~% }0 y9 P% b) j( p
响应参数) G3 X/ l; S. M2 |) p5 `& ?1 z
{7 z6 c# v6 w! h0 F5 L& O/ E! t, ]
"code":"0",
"msg": "",1 [9 J' Y- \! d& }
"result":{
"address": "0x113d79bea1f6ff0681a778dace3c64d5ff915c89"
}; f5 V9 Q6 Q6 P- D
}
参数说明 address 钱包地址: i( ~0 _- g/ ]6 E3 \
1.3. 查询余额/ G- N5 {3 d3 x
请求地址 http://IP:PORT/api/wallet. b* }2 F- S& Z6 u, O7 v! b
请求参数
{
"cmd":"wallet_balance",
"params": {5 M* I* O6 [; d: P( w$ i9 Z
"address":"0x78c001ad4409ceb94dc0e07e1f2cd9ac62f24d10"
}
}# f1 C7 w( |# K) e
参数说明3 {+ m3 e% x h
参数名称 说明 必填
keystore 钱包keystore Y# N! j) c/ ^! F! U# Q) ]
password 钱包密码 Y
响应参数
{* k! m( O9 e; K- n7 S
"code":"0",) L- e9 p- ]- F, s
"msg": ""," X* H* f/ l0 N, }! q, f1 ]/ S
"result":{8 H( P! Y8 O4 z6 y: y
"balance": "88.2",( G- J' f; n3 G2 j- E# P& `& _" D1 B
"eth_balance": "0.03",
}& Q! W+ I; v5 {* @8 m. s8 _
}
参数说明
eth_balance 以太币数量
balance 代币数量7 h+ X' H8 j& `; Q8 ^
1.4. 代币转账
请求地址 http://IP:PORT/api/wallet
请求参数
{
"cmd":"wallet_transaction",) s4 t9 {* @0 {
"params": {1 ]$ \- b t' E8 K
"from_address":"0x78c001ad4409ceb94dc0e07e1f2cd9ac62f24d10",
"password":"123",
"to_address":"0x113d79bea1f6ff0681a778dace3c64d5ff915c89",
"cost": "0.00018",
"num":"0.22") B7 M8 C- H! b5 ^
}
}
参数说明
参数名称 说明 必填
from_address 转出钱包地址 Y" ^. h8 `0 w; b6 m% t6 D, P
password 转出钱包的密码 Y/ i" ]6 R/ P% g
to_address 转入钱包地址 Y! M4 i" \$ A, t
cost 手续费,单位:以太币。(手续费越高,到账时间越短,过低的手续费可能导致交易失败)目前限制了最低手续费为 0.00018 Y# w: R, o1 t& W
num 转出代币数量 Y: B6 T# n+ |! n6 S
响应参数; w8 x! m, M# [' u; p! P
{$ i* y1 T2 s2 \8 i
"code": "0",* O0 M; H8 J) Z' n2 Y, h
"msg": "",
"result":{
"trans_hash": "0x601e124ffc98d7682ef9ea4c731efdab576f34f47e80bec84c5f17b5af7098d6"
}& U! h5 A4 w5 [3 ]! b4 p
}6 B% v) y6 M( p
参数说明 trans_hash 交易Hash值
1.5. 查询交易状态
请求地址 http://IP:PORT/api/wallet
请求参数
{
"cmd":"trans_status",
"params": {
"trans_hash": "0x601e124ffc98d7682ef9ea4c731efdab576f34f47e80bec84c5f17b5af7098d6"6 ?( A5 O- o5 B' Z$ q" o
}
}/ {5 J: A+ D& c0 K+ y- A' {
参数说明
参数名称 说明 必填
trans_hash 交易hash值 Y
响应参数# q9 d+ H+ m! h
{
"code": "0",
"msg": "",
"result":{
"status": "1"; c: }" i- B9 o7 Y( s" s c
}% u1 J" w3 i: A4 s0 S5 [. Z' F
}' L( |$ [0 w1 q
参数说明 status 1 交易完成、 0 未完成
1.6. 查询交易详情
请求地址 http://IP:PORT/api/wallet
请求参数
{
"cmd":"trans_detail",( ]- H7 p+ S( G3 e9 E" n
"params": {7 q4 r( d8 y: S) M8 C$ N
"trans_hash": "0x601e124ffc98d7682ef9ea4c731efdab576f34f47e80bec84c5f17b5af7098d6"
}
}
参数说明7 k: E0 t+ t+ @$ t5 T L& {
参数名称 说明 必填1 X4 t5 r1 Y4 k: R0 L$ e
trans_hash 交易hash值 Y
响应参数
{# A/ T+ U3 X7 V3 G8 X6 S: Z6 ]& m
"code": "0",! O" S2 f+ |( H2 k
"result":{
"num": "2",
"from": "0x78c001ad4409ceb94dc0e07e1f2cd9ac62f24d10",! t* D1 y, K6 ~: Y
"to": "0x33852530794c67fac23a010e2e4a88fb84477ff2",
"timestamp": 1525774296
}
}! z0 `+ Z, n* t8 N' [8 K
参数说明
1.7. 查询交易记录1 L' p$ n8 J5 G
请求地址 http://IP:PORT/api/wallet/ J7 j' C/ j3 v ]9 a- h3 S
请求参数
{8 I: v2 I* r* j- r7 C, m& a( u% L
"cmd":"trans_record",: {$ M$ a- N+ O) F9 E2 x
"params": {
"address":"0x78c001ad4409ceb94dc0e07e1f2cd9ac62f24d10". X2 E! _6 A E( K! Z" I8 T
}
}) r4 l( O: i& s( P$ ^; Y4 V9 {
参数说明7 _& ]4 F5 r: O3 h8 i2 f9 Q( K5 z: r
参数名称 说明 必填
trans_hash 交易hash值 Y1 b- i( e6 V2 X; W& X2 o
响应参数
{. @" k5 F+ }- h- g$ {+ X, y
"code": "0",( e! ^; n) N4 I0 x) q
"result":{
"records":[{- w$ _$ q8 C, n& G* w
"num": "0.02",+ K7 d, e9 R1 o% x5 }9 V
"from": "0x06bf56bd88349c5b9f77d6bb79377d43f0f0abd8",
"to": "0x70550b9acd503d5154d21985426a0829612dc060",1 j' g0 c" k: t4 H$ f
"hash": "0x7c2ed817daca92c6ee29f18e31807c663b1b91d35f82365697ef14f6a272b208",
"timestamp": 15257742961 _. n4 g' J& C1 h, L2 y p$ s
},{
"num": "0.01",$ m6 i) n X' t6 h2 c4 G
"from": "0x70550b9acd503d5154d21985426a0829612dc060",
"to": "0x06bf56bd88349c5b9f77d6bb79377d43f0f0abd8",
"hash": "0x7c2ed817daca92c6ee29f18e31807c663b1b91d35f82365697ef14f6a272b208",
"timestamp": 1525774296; x% y* N3 I2 ^" S# u
}]% X( _ P7 v" ]% X; v" J2 _7 W7 t
}
}
成为第一个吐槽的人