- 向客服人员申请一对API Key和API Secret, 并提供需要绑定的ip白名单
- 在发送请求头部传入KEY,即API密钥对的 Key
- 在发送请求头部传入Timestamp,即请求发送的时间,格式是秒级精度的 Unix 时间戳.同时该时间不能与当前时间差距超过 60 秒
- 在发送请求头部传入SIGN,即将请求生成签名字符串并用 API Secret 加密后生成的签名
- 加密算法为 HexEncode(HMAC_SHA512(secret, signature_string)),即通过 HMAC-SHA512 加密算法,将 API Secret 作为加密密钥,签名字符串作为加密消息, 生成加密结果的 16 进制输出
- 确保发送请求的客户端IP地址在所使用的密钥的IP地址白名单里
- 签名字符串按照如下方式拼接生成 (Query String或Request Payload没有则用空字符串“”替代)
Request Method + "\n" + Request URL + "\n" + Query String + "\n" + HexEncode(SHA512(Request Payload)) + "\n" + Timestamp
- 请求方法,全大写, 如 POST, GET
- 不包括服务地址和端口,如 /api/spot/withdraw
-
没有使用 URL 编码的请求参数,请求参数在参与计算签名时的顺序一定要保证和实际请求里的顺序一致。 如 status=finished&limit=50
-
如果没有请求参数,使用空字符串 ("")
- 将请求体字符串使用 SHA512 哈希之后的结果。如果没有请求体,使用空字符串的哈希结果,即 cf83e1357eefb8bdf1542850d66d8007d620e4050b5715dc83f4a921d36ce9ce47d0d13c5d85f2b0ff8318d2877eec2f63b931bd47417a81a538327af927da3e
- 设置在请求头部 Timestamp 里的值 格式是秒级精度的 Unix 时间戳 数据类型为整型
交易所名称需要大写: BINANCE, HUOBI, GATE, OKEX
请求
POST https://${url}/api/spot/withdraw
Content-Type: application/json
KEY: <api-key>
Timestamp: 1234567890
SIGN: <sign>
{
"withdrawExchange": "BINANCE",
"depositExchange": "GATE",
"withdrawMainAccountId": "",
"withdrawSubAccountId": "binance@gatexfer.com",
"depositMainAccountId": "",
"depositSubAccountId": "123456789",
"currency": "usdt",
"amount": 100000
}
返回
{
"code": 代码
"data": 请求成功 返回任务ID 用来查询状态
"msg": 请求成功返回success 请求失败返回错误信息
}
充提的母账户&子账户ID 每个请求需要传两个 规则如下
提现账户类型 | 充值账户类型 | 传参 |
---|---|---|
母账户 | 子账户 | withdrawMainAccountId + depositSubAccountId |
母账户 | 母账户 | withdrawMainAccountId + depositMainAccountId |
子账户 | 子账户 | withdrawSubAccountId + depositSubAccountId |
子账户 | 母账户 | withdrawSubAccountId + depositMainAccountId |
请求
GET https://${url}/api/spot/withdraw/{id}
失败的划转任务查询返回
{
"code": 0,
"data": {
"id": "606e037ab0e57",
"status": "-4",
"msg": "error processing withdraw:User has insufficient balance",
"txId": ""
},
"msg": "success"
}
成功的划转任务查询返回
{
"code": 0,
"data": {
"id": "c0dbe274c2a58",
"status": "9",
"txId": "0x12345678987654321abcdefghijklmnoqprstuvwxyz",
"msg": "task completed successfully"
},
"msg": "success"
}
状态列表
值 | 描述 |
---|---|
-1 | 任务取消 |
-2 | 提现账户内部划转失败 |
-4 | 主账户提现失败 |
-7 | 主账户充值失败 |
-8 | 充值账户内部划转失败 |
-9 | 任务失败 |
1 | 新建请求 |
2 | 提现账户的内部划转请求已发出 |
3 | 提现账户的内部划转已完成 |
4 | 提现账户的提现请求审核中 |
5 | 链上转账进行中 |
6 | 充值账户的充值确认中 |
7 | 充值账户的充值已发出 |
8 | 充值账户的内部划转请求已发出 |
9 | 任务成功完成 |
0 | 已取消 |
请求
GET https://${url}/api/public/ping
所有HTTP请求都会按照以下格式返回数据
{
"code": 代码
"data": 数据
"msg": 信息
}
Exchange | SubAccountId |
---|---|
BINANCE | Sub-account email |
HUOBI | Sub user’s UID |
GATE | Sub account user ID |
GATEHK | Sub account user ID |
OKX | sub-account name |