钱包接口

提币 (USER_DATA)

• POST /api/v1/account/withdraw

提交一个提币请求。

权重: 1

响应

{
  "success": true,
  "needBrokerAudit": false, // 是否需要券商审核
  "id": "423885103582776064", // 提币成功订单id
  "refuseReason": "" // 失败拒绝原因
}

参数

参数名称	类型	是否必需	描述
coin	STRING	YES	资产
clientOrderId	LONG	YES	自定义提币ID
address	STRING	YES	收款标识。addressType 为空或为 BLOCK_CHAIN 时表示链上提币地址（注意：链上提币地址必须是在 PC 端或者 APP 端维护在常用地址列表里面的地址）；addressType 为 PHONE_NUMBER 时表示手机号内部划转收款标识，格式为 国家码 手机号，国家码与手机号码之间必须有空格，例如 86 13812345678；addressType 为 EMAIL / UID 时分别表示邮箱或 UID 内部划转收款标识
addressExt	STRING	NO	tag
quantity	DECIMAL	YES	提币数量
chainType	STRING	NO	chain type, USDT的chainType分别是OMNI ERC20 TRC20，默认OMNI
addressType	STRING	NO	收款标识类型。为空时默认 BLOCK_CHAIN；仅支持枚举名称 BLOCK_CHAIN、PHONE_NUMBER、EMAIL、UID，不支持枚举数字或小写名称。PHONE_NUMBER、EMAIL、UID 表示平台内部划转
vaspCode	STRING	NO	vasp码
targetPersonFirstName	STRING	NO	提币目标人姓
targetPersonLastName	STRING	NO	提币目标人名

请求示例

链上提币：

POST /api/v1/account/withdraw
Content-Type: application/x-www-form-urlencoded

coin=USDT&clientOrderId=123456&address=0x815bF1c3cc0f49b8FC66B21A7e48fCb476051209&quantity=10&chainType=ERC20&addressType=BLOCK_CHAIN&timestamp=1780000000000&signature=<signature>

手机号内部划转：

POST /api/v1/account/withdraw
Content-Type: application/x-www-form-urlencoded

clientOrderId=123457&address=86 13812345678&coin=USDT&quantity=10&addressType=PHONE_NUMBER&timestamp=1780000000000&signature=<signature>

计算 signature 时使用的签名原文为 clientOrderId=123457&address=86 13812345678&coin=USDT&quantity=10&addressType=PHONE_NUMBER&timestamp=1780000000000，其中 address 的国家码与手机号之间是普通空格。

邮箱内部划转：

POST /api/v1/account/withdraw
Content-Type: application/x-www-form-urlencoded

clientOrderId=123458&address=user@example.com&coin=USDT&quantity=10&addressType=EMAIL&timestamp=1780000000000&signature=<signature>

UID 内部划转：

POST /api/v1/account/withdraw
Content-Type: application/x-www-form-urlencoded

clientOrderId=123459&address=10000001&coin=USDT&quantity=10&addressType=UID&timestamp=1780000000000&signature=<signature>

获取提币记录 (USER_DATA)

• GET /api/v1/account/withdrawOrders (HMAC SHA256)

权重: 5

响应

[
    {
        "time": "1536232111669",
        "id ": "90161227158286336",
        "accountId": "517256161325920",
        "coinId ": "BHC",
        "coinName": "BHC",
        "address": "0x815bF1c3cc0f49b8FC66B21A7e48fCb476051209",
        "addressExt": "address tag",
        "quantity": "14", // 提币金额
        "arriveQuantity": "14", // 到账金额
        "statusCode": "PROCESSING_STATUS",
        "status": 3,
        "txId ": "",
        "txIdUrl ": "",
        "walletHandleTime": "1536232111669",
        "feeCoinId ": "BHC",
        "feeCoinName ": "BHC",
        "fee": "0.1",
        "requiredConfirmTimes ": 0, // 要求确认数
        "confirmTimes ": 0, // 确认数
        "kernelId": "", // BEAM 和 GRIN 独有
        "isInternalTransfer": false // 是否内部转账
    }
]

status 枚举说明

status 为提币订单的数值状态，statusCode 为对应的状态标识。

status	statusCode	状态说明
0	WITHDRAWAL_STATUS_UNKNOWN	提现中
1	BROKER_AUDITING_STATUS	审核中
2	BROKER_REJECT_STATUS	提现拒绝/驳回
3	AUDITING_STATUS	提现中
6	WITHDRAWAL_SUCCESS_STATUS	提现成功
7	WITHDRAWAL_FAILURE_STATUS	提现失败
9	WITHDRAWAL_CANCELLED_STATUS	提现已取消
10	WAIT_MERCHANT_PASS	待解冻
11	APPLY_CANCEL	申请取消中
其他值	-	提现中

参数

参数名称	类型	是否必需	描述
coin	STRING	NO	资产
startTime	LONG	NO	开始时间戳
endTime	LONG	NO	结束时间戳
fromId	LONG	NO	从哪个OrderId起开始抓取
withdrawOrderId	LONG	NO	提现订单ID
limit	INT	NO	默认 500; 最大 1000
recvWindow	LONG	NO	recv窗口
timestamp	LONG	YES	时间戳

获取充值地址 (USER_DATA)

• GET /api/v1/account/deposit/address (HMAC SHA256)

权重: 1

响应

{
    "canDeposit": false, // 是否可充值
    "address": "0x815bF1c3cc0f49b8FC66B21A7e48fCb476051209", // 地址
    "addressExt": "address tag",
    "minQuantity": "100", // 最小金额
    "requiredConfirmTimes ": 1, // 到账确认数
    "canWithdrawConfirmNum ": 12, // 提币确认数
    "chainType": "ERC20"
}

参数

参数名称	类型	是否必需	描述
coin	STRING	YES	资产
chainType	STRING	YES	chain type, USDT的chainType分别是OMNI ERC20 TRC20，默认OMNI

获取充值历史 (USER_DATA)

• GET /api/v1/account/depositOrders (HMAC SHA256)

权重: 5

响应

[
  {
        "id": 100234,
        "coin": "EOS",
        "coinName": "EOS",
        "address": "deposit2bb",
        "addressTag": "19012584",
        "fromAddress": "clarkkent",
        "fromAddressTag": "19029901",
        "time": 1499865549590,
        "quantity": "1.01",
        "status": "2", // 2=成功, 11=拒绝, 12=审核中
        "statusCode": "DEPOSIT_CAN_WITHDRAW",
        "requiredConfirmTimes": "5",
        "confirmTimes": "5",
        "txId": "98A3EA560C6B3336D348B6C83F0F95ECE4F1F5919E94BD006E5BF3BF264FACFC",
        "txIdUrl": ""
  }
]

请求参数

参数名称	类型	是否必需	描述
coin	STRING	NO	资产：例如BTC
startTime	LONG	NO	开始时间戳
endTime	LONG	NO	结束时间戳
fromId	LONG	NO	从哪个Id起开始抓取
limit	INT	NO	默认 500; 最大 1000
recvWindow	LONG	NO	recv窗口
timestamp	LONG	YES	时间戳

注意：

• 如果fromId设定好了，会筛选订单小于id的。否则会返回最近的订单信息。