交易所 / 众筹站多币种接入集成接口
海蓝天1688
发表于 2022-12-2 10:10:36
68
0
0
标准json字符串" z+ N& _' Q0 Y
统一响应参数6 q. g- O9 z+ h- b0 E( \
标准josn字符串
example:{code:1,msg:”测试”,result:”json数组”}1 a7 D- V8 t7 e' n) ~5 Y$ ~4 O" Q
统一code说明( P+ z$ S6 G( s4 a8 E
code:-2 msg:操作失败) f d( {) G, m0 l, q% J, i" c
code:-1 msg:系统异常
code: 0 msg:操作成功
1.1. 创建钱包地址
请求地址 http://IP:PORT/api/wallet
请求参数
{
"cmd":"wallet_create",/ t* E0 L" Q& y( g* t
"params": {& e+ U$ A. K$ _6 G4 M" Z
"password":"123456") o5 a9 i" \. B* G
}
}, s6 T: ~4 Q2 r+ ?5 S( H
参数说明$ ?9 J: [+ b' A; S2 t3 Y P7 g
参数名称 说明 必填
password 钱包密码 Y
响应参数
{
"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\"}}"5 Q' G) |3 |( E
}
}1 ?; }# d1 O B4 T, h
参数说明 address 钱包地址8 x$ M5 d0 d4 }6 e+ a
1.2. 导入钱包: |2 q# m! Y! U! R1 |: F" O3 t
请求地址 http://IP:PORT/api/wallet
请求参数* }3 S7 |! G8 e! K+ G9 t/ ?
{
"cmd":"wallet_import",
"params": {! z( y1 Z! R7 E- {# Q
"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\"}}",) n! [9 b+ O3 f
"password":"123456"
}
}( d, L% Q) o# u/ G: v
参数说明
参数名称 说明 必填6 R h. c* A6 {1 |, ?
keystore 钱包keystore Y
password 钱包密码 Y
响应参数
{
"code":"0"," u: u, z4 `( F* @5 B$ m5 p
"msg": "", I* s9 M( G; Y% ]9 @/ k. K
"result":{
"address": "0x113d79bea1f6ff0681a778dace3c64d5ff915c89"6 x3 s2 u. n% K0 [3 l
}0 S7 T, T( y- k. P/ Q
}* T) a3 r* i, b
参数说明 address 钱包地址
1.3. 查询余额
请求地址 http://IP:PORT/api/wallet
请求参数
{; ], T3 U) Y: Z. A
"cmd":"wallet_balance",
"params": {
"address":"0x78c001ad4409ceb94dc0e07e1f2cd9ac62f24d10"
}" F9 a. A# S& E$ o& H& t: }
}
参数说明+ _$ \( x3 e$ Y% y# @) v" N
参数名称 说明 必填, z1 D. a/ W$ Y; {; O8 r
keystore 钱包keystore Y
password 钱包密码 Y. }2 _% d; i: C0 n9 C( R
响应参数% ~7 P: @! Q1 v1 F
{! i+ s* u( o1 W! e
"code":"0",! n3 B; F* M! v0 F) F" Z: J
"msg": "",0 n/ d7 G: N8 K n( f. s+ S
"result":{9 n' o# P2 B6 [9 Y- \
"balance": "88.2",
"eth_balance": "0.03",
}
}
参数说明* Z9 g/ p' C& R9 j
eth_balance 以太币数量- B6 j5 j- S( D) G& W
balance 代币数量) k4 L% S: ]0 d+ c& @, o2 u7 x
1.4. 代币转账
请求地址 http://IP:PORT/api/wallet
请求参数
{4 u% A- x/ {; o
"cmd":"wallet_transaction",
"params": {
"from_address":"0x78c001ad4409ceb94dc0e07e1f2cd9ac62f24d10",
"password":"123",* w* p) ~- `9 L; m5 J
"to_address":"0x113d79bea1f6ff0681a778dace3c64d5ff915c89",
"cost": "0.00018",
"num":"0.22"
}
}8 H6 s0 t' L. e0 r4 h" }2 M
参数说明) A! C* F" Z# I( O% g2 F' V* ^
参数名称 说明 必填& k' k$ y) q1 p( c3 o# q+ B
from_address 转出钱包地址 Y% r; ]4 P4 n4 P7 Z
password 转出钱包的密码 Y7 d" _: t( i0 a3 H4 k1 [' B
to_address 转入钱包地址 Y7 y& |2 L: @) H: v( T q+ F2 {
cost 手续费,单位:以太币。(手续费越高,到账时间越短,过低的手续费可能导致交易失败)目前限制了最低手续费为 0.00018 Y. _* `' W9 n2 Q1 z
num 转出代币数量 Y" N/ N& A6 _6 W' g+ {
响应参数' g0 _7 b! P* W/ E7 I
{( q- N2 D4 c- n: \5 m2 t* B
"code": "0",
"msg": "",: k2 e2 y& x4 M. W& K6 `5 M: x
"result":{+ c+ R6 `) q6 I2 D& P3 s. {& S
"trans_hash": "0x601e124ffc98d7682ef9ea4c731efdab576f34f47e80bec84c5f17b5af7098d6"- y# A( R0 G' l3 X5 b2 j
}
}5 p1 d+ N2 ^, L5 T
参数说明 trans_hash 交易Hash值9 ?4 j- ~3 y1 v& T6 S# [$ c3 J* j1 X
1.5. 查询交易状态; T! g" e, c+ P& W. j [0 G5 C7 l9 R" M
请求地址 http://IP:PORT/api/wallet
请求参数
{
"cmd":"trans_status",! C7 F3 C* s7 u Y" }. |
"params": {
"trans_hash": "0x601e124ffc98d7682ef9ea4c731efdab576f34f47e80bec84c5f17b5af7098d6"
}
}) H" Z- E. a2 X) O. }& S5 k
参数说明$ L9 P/ w; x1 F/ v0 H* Z# x" l3 z
参数名称 说明 必填
trans_hash 交易hash值 Y2 |' |6 S7 ]% s! e+ d# U
响应参数
{
"code": "0",- m& U: F0 s& B A
"msg": "",
"result":{
"status": "1"! ~! x1 J% K/ ~- A
}$ }8 f6 r4 \3 K2 R1 a i
}; v8 A3 [1 }6 ?- }7 K: q: ?( Z2 |
参数说明 status 1 交易完成、 0 未完成 K9 v) v }4 y
1.6. 查询交易详情
请求地址 http://IP:PORT/api/wallet. w, [' r/ O9 L* O {
请求参数
{
"cmd":"trans_detail",: t% p0 a4 b- e7 y& D/ x: Q0 T
"params": {
"trans_hash": "0x601e124ffc98d7682ef9ea4c731efdab576f34f47e80bec84c5f17b5af7098d6"
}
}
参数说明2 X8 u+ P- s3 _% k- t8 b
参数名称 说明 必填4 @- p' A6 ?& D% J$ G9 j
trans_hash 交易hash值 Y
响应参数
{8 a, U) Q$ ?+ h. F8 `. Y# f
"code": "0",! I0 n9 z( t. S% x
"result":{
"num": "2",7 A/ }) ?! J' `& G+ N- g3 l
"from": "0x78c001ad4409ceb94dc0e07e1f2cd9ac62f24d10",
"to": "0x33852530794c67fac23a010e2e4a88fb84477ff2",
"timestamp": 1525774296$ D4 L, J! d% B" L' c( A
}
}# \8 I" {; p8 u( u
参数说明
1.7. 查询交易记录/ E4 V% }1 L$ {6 a: V. ?
请求地址 http://IP:PORT/api/wallet2 L" S# F, W8 N! E/ V4 p
请求参数6 N% [" {/ M. j( }$ b' v
{0 G% J7 D( P# X. z& i+ f2 E) y: W
"cmd":"trans_record",5 }& p6 P: B' c6 ^
"params": {
"address":"0x78c001ad4409ceb94dc0e07e1f2cd9ac62f24d10"
}4 E8 q1 l% ~8 Q2 K
}
参数说明
参数名称 说明 必填7 T% P0 R& l* e5 c' _, w
trans_hash 交易hash值 Y
响应参数' i4 F) K4 r, H$ j7 L+ B, S5 Y. A
{
"code": "0",
"result":{
"records":[{# G: q; n( V. r1 c% K
"num": "0.02",
"from": "0x06bf56bd88349c5b9f77d6bb79377d43f0f0abd8",
"to": "0x70550b9acd503d5154d21985426a0829612dc060",
"hash": "0x7c2ed817daca92c6ee29f18e31807c663b1b91d35f82365697ef14f6a272b208",
"timestamp": 1525774296: c7 n9 B7 u. ] r; V* N( ^* |
},{
"num": "0.01",
"from": "0x70550b9acd503d5154d21985426a0829612dc060",- Q, k; d" l! `8 @# l0 G; `
"to": "0x06bf56bd88349c5b9f77d6bb79377d43f0f0abd8",
"hash": "0x7c2ed817daca92c6ee29f18e31807c663b1b91d35f82365697ef14f6a272b208",
"timestamp": 1525774296
}]
}: q" h7 y- v) T( s9 v2 J
}
成为第一个吐槽的人