提币

发起链上提币。API 提币强制限制在地址簿白名单地址内。建议先调用 提币聚合配置 获取可用链、金额限制、精度、memo 要求、账户余额和白名单地址。

请求频率限制：1/1s

鉴权使用 接入指南 中的标准 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"
  }
}

提币​

请求地址​

请求参数​

请求示例​

响应参数​

响应示例​

提币

请求地址

请求参数

请求示例

响应参数

响应示例