提币
提币
发起链上提币。API 提币强制限制在地址簿白名单地址内。建议先调用 提币聚合配置 获取可用链、金额限制、精度、memo 要求、账户余额和白名单地址。
鉴权使用 接入指南 中的标准 REST 私有接口请求头，不需要额外的提币专用请求头。
请求地址
POST /deepcoin/asset/withdrawal
请求参数
| 字段名 | 是否必填 | 类型 | 字段描述 |
|---|---|---|---|
| ccy | 是 | string | 币种，例如 USDT |
| chain | 是 | string | withdraw-config 返回的链，例如 USDT-TRC20 |
| amt | 是 | string | 提币数量 |
| addressId | 是 | string | 地址簿白名单 ID |
| toAddr | 否 | string | 提币地址。传入时仅用于和地址簿白名单做一致性校验 |
| memo | 否 | string | memo/tag/payment_id。needMemo=true 或白名单地址带 memo 时必填；白名单地址带 memo 时必须与 addresses[].memo 一致 |
| accountTypes | 否 | array | 扣款账户类型：funding、spot、swap。当前仅支持传 1 个。不传默认 funding |
| clientId | 否 | string | 客户端请求 ID，最大 32 个字符 |
| remark | 否 | string | 备注 |
请求示例
{
"ccy": "USDT",
"chain": "USDT-TRC20",
"amt": "30",
"addressId": "574",
"toAddr": "TEV1gDkDST3kUtv27SCYfbAoz7ukLMwJdS",
"accountTypes": ["funding"],
"clientId": "withdraw_golang_example_001",
"remark": "golang example withdrawal"
}
accountTypes 是公开请求字段，用于指定扣款账户。单次提币请求最多传 1 个账户类型。
使用带 memo 的白名单地址时，提币请求需要传入相同的 memo 值。
| accountTypes | 扣款账户 |
|---|---|
| funding | 资金账户 |
| spot | 现货账户 |
| swap | 合约账户 |
响应参数
| 字段名 | 类型 | 字段描述 |
|---|---|---|
| wdId | string | 提币单 ID |
| clientId | string | 客户端请求 ID |
| ccy | string | 币种 |
| chain | string | 链 |
| amt | string | 提币数量 |
| fee | string | 手续费 |
| state | string | 提币状态 |
| cTime | string | 创建时间 |
响应示例
{
"code": "0",
"msg": "",
"data": {
"wdId": "339288",
"clientId": "withdraw_golang_example_001",
"ccy": "USDT",
"chain": "USDT-TRC20",
"amt": "30",
"state": "pending",
"cTime": "1777970397179"
}
}