交易所 / 众筹站多币种接入集成接口
海蓝天1688
发表于 2022-12-2 10:10:36
124
0
0
标准json字符串
统一响应参数6 ^# O7 k0 N; v( E
标准josn字符串
example:{code:1,msg:”测试”,result:”json数组”}4 p- c% x) a$ k$ H0 H. Z1 J* p/ @% w' g
统一code说明) D, R! e5 `9 b! p& C- A5 {
code:-2 msg:操作失败+ `, D z% g; {
code:-1 msg:系统异常
code: 0 msg:操作成功
1.1. 创建钱包地址
请求地址 http://IP:PORT/api/wallet" G$ Q$ w( P. B4 h
请求参数
{
"cmd":"wallet_create",% {9 Z [+ C8 r" s
"params": {
"password":"123456"
}
}
参数说明
参数名称 说明 必填
password 钱包密码 Y; O, v' \/ N' Q% }; _+ D
响应参数
{
"code":"0",
"msg": "",, X) s5 X; L- I3 [
"result":{
"address": "0x113d79bea1f6ff0681a778dace3c64d5ff915c89"5 [' m9 V7 z$ d# x$ N( q- C1 V# J
"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 \3 M+ K8 y! m5 R+ z
参数说明 address 钱包地址& r" P4 i9 _" ^1 F) W
1.2. 导入钱包
请求地址 http://IP:PORT/api/wallet
请求参数0 i' N" e% }. f4 u
{
"cmd":"wallet_import",: d9 Z8 ~5 B8 M; U! @5 D' F
"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\"}}",$ g9 v3 s% T# d" i& j* N6 j
"password":"123456"8 c* e# M- J# n& g
}
}
参数说明2 m- m! `' B6 w0 I* r' F
参数名称 说明 必填- Q& N' o* L; @1 g4 S/ Q4 u+ ]( F
keystore 钱包keystore Y
password 钱包密码 Y
响应参数
{( P7 `% a0 O5 {! p. b
"code":"0",
"msg": "",0 G' l( V8 Y: E6 U9 J/ \3 ]' H# u
"result":{, G0 N6 D0 r! S, ]; n1 k( F2 k
"address": "0x113d79bea1f6ff0681a778dace3c64d5ff915c89"3 e& S" e3 Q) ^# _' F2 U
}
}+ k! l8 O4 |! s4 D) ^! M
参数说明 address 钱包地址
1.3. 查询余额4 ^! }, A' y. U9 f! X
请求地址 http://IP:PORT/api/wallet
请求参数0 i" a! y1 G N% |4 V! S8 W
{
"cmd":"wallet_balance",: G9 z& v* s$ E6 k9 N9 s% c5 Q" a7 Z$ G9 p
"params": {
"address":"0x78c001ad4409ceb94dc0e07e1f2cd9ac62f24d10"
}
}- D* Y" X+ Z- c1 G2 ^" E
参数说明, q |0 P, n! ]: B0 ]/ x, v8 Z7 }, j
参数名称 说明 必填
keystore 钱包keystore Y
password 钱包密码 Y9 b' V( v3 G" U H/ t/ B
响应参数
{
"code":"0",
"msg": "",
"result":{5 ]* k& g" s: S g( [! O9 f
"balance": "88.2",
"eth_balance": "0.03",( `4 ^% s0 m; y
}: P1 V: n( A n) \. ?
}3 {- ^7 x6 N. l6 p z& U
参数说明0 d& M9 o1 o6 O6 y. h( K/ f6 R8 u
eth_balance 以太币数量4 [* p- U% \1 B' v" M
balance 代币数量
1.4. 代币转账
请求地址 http://IP:PORT/api/wallet
请求参数# ~: K# I0 _1 ~# _- O' F* a8 l
{
"cmd":"wallet_transaction",5 Y( K+ H/ D: B) o; X" `( X/ l; M
"params": {
"from_address":"0x78c001ad4409ceb94dc0e07e1f2cd9ac62f24d10",
"password":"123",
"to_address":"0x113d79bea1f6ff0681a778dace3c64d5ff915c89",# j7 S' r/ r/ J' `% a+ V& J) }
"cost": "0.00018", 2 b6 z2 B; {: F5 T- B z
"num":"0.22"( \' h; f$ _6 c' o1 n1 v: g9 f
}8 }3 y# V, L, d+ \ ~
}- C8 t) c4 G* b' i0 y
参数说明7 R0 A, B- i* p" e" Q7 G9 w1 J
参数名称 说明 必填
from_address 转出钱包地址 Y: G" F+ q$ i6 H
password 转出钱包的密码 Y
to_address 转入钱包地址 Y
cost 手续费,单位:以太币。(手续费越高,到账时间越短,过低的手续费可能导致交易失败)目前限制了最低手续费为 0.00018 Y
num 转出代币数量 Y* ~8 }% W* ?7 ~$ f) }
响应参数
{! R0 ~ @9 U1 C
"code": "0",
"msg": "",
"result":{
"trans_hash": "0x601e124ffc98d7682ef9ea4c731efdab576f34f47e80bec84c5f17b5af7098d6"( N# M& |( u5 z3 s. ^
}' e+ S$ B7 {8 k& A( ]
}; B3 ~8 u, ^0 v: C$ |
参数说明 trans_hash 交易Hash值
1.5. 查询交易状态
请求地址 http://IP:PORT/api/wallet* F/ \4 `9 R- G4 j; p! R( H% [
请求参数: ^' E0 \3 A9 z& C8 N
{
"cmd":"trans_status",
"params": {
"trans_hash": "0x601e124ffc98d7682ef9ea4c731efdab576f34f47e80bec84c5f17b5af7098d6". b7 y) r- w% y+ S# c
}7 `5 m& r" E5 h
}
参数说明
参数名称 说明 必填5 f) l x4 o3 W( Q
trans_hash 交易hash值 Y+ M8 ?, K( S" a: X7 r' a
响应参数7 N9 P# v- X! V2 ~) @" |0 [
{( H+ R/ X& S( p) b# i7 N3 X
"code": "0",
"msg": "",
"result":{
"status": "1"9 @# X U5 t- f# z7 W, l2 Q
}
}$ k- V4 o$ W5 p, ~9 e" V% u
参数说明 status 1 交易完成、 0 未完成
1.6. 查询交易详情
请求地址 http://IP:PORT/api/wallet
请求参数
{
"cmd":"trans_detail",0 _/ T1 X5 a3 J
"params": {5 [$ z. t# U7 g, @. ]. i1 f( b$ Y- D
"trans_hash": "0x601e124ffc98d7682ef9ea4c731efdab576f34f47e80bec84c5f17b5af7098d6"4 D' V$ v, Q$ X" A& M( M
}, j& u( ]5 r/ ]' @
}
参数说明- k0 t/ X0 H! W0 i, L$ @
参数名称 说明 必填
trans_hash 交易hash值 Y1 Z/ N2 S1 a$ Y* m8 q* x$ x
响应参数 c4 ?# Y. h: Q2 L5 c
{# X) S4 e( s( u& X* T
"code": "0",
"result":{
"num": "2",
"from": "0x78c001ad4409ceb94dc0e07e1f2cd9ac62f24d10",: M+ A- w# g! {3 ?! d5 R
"to": "0x33852530794c67fac23a010e2e4a88fb84477ff2",
"timestamp": 1525774296
}2 r0 G; V, J1 x4 D a9 D8 ?# l
}
参数说明
1.7. 查询交易记录
请求地址 http://IP:PORT/api/wallet& r& A- Z9 A/ E$ R* c
请求参数 Z2 ~* l( e; t+ c0 L+ l, J9 }
{
"cmd":"trans_record",! z' Z7 I! N' e8 o% l1 j; v5 l
"params": {
"address":"0x78c001ad4409ceb94dc0e07e1f2cd9ac62f24d10"" s6 H E @+ k/ z2 a1 t
}* k* W% s& V9 z' P% u
}
参数说明/ |7 r3 p+ s6 ~7 C$ m, t
参数名称 说明 必填
trans_hash 交易hash值 Y7 ~/ q u X, H
响应参数
{- K1 ?( }4 W$ m# _
"code": "0",
"result":{
"records":[{
"num": "0.02",
"from": "0x06bf56bd88349c5b9f77d6bb79377d43f0f0abd8",$ [- y( |1 F1 I7 n1 ^0 L
"to": "0x70550b9acd503d5154d21985426a0829612dc060",! a, G) \- C7 |# j, J
"hash": "0x7c2ed817daca92c6ee29f18e31807c663b1b91d35f82365697ef14f6a272b208",
"timestamp": 1525774296
},{7 w& m& }: D# p5 ~
"num": "0.01",
"from": "0x70550b9acd503d5154d21985426a0829612dc060"," `( W* S; e" V1 Y; j' l
"to": "0x06bf56bd88349c5b9f77d6bb79377d43f0f0abd8",
"hash": "0x7c2ed817daca92c6ee29f18e31807c663b1b91d35f82365697ef14f6a272b208",* G6 ^: u+ p0 y" U( T: s/ \
"timestamp": 1525774296, @- D& E: k6 _) _* ^% v I
}]; j( |9 s2 @+ A! K& |
}3 G6 `! h9 F j) a- Y% `
}
成为第一个吐槽的人