创建提现
POST /api/v1/account/withdrawal请求体
string
必填
目标 TRON 地址
string
必填
提现金额,以 TRX 计
string
TRX(默认)或 USDT。使用 USDT 时,amount_trx 填写要发送的 USDT 金额。string
双重验证码(如已启用双重验证)
请求头
string
可选,最多 64 个字符。每次新的提现都发送一个新键(例如 UUID);重试未收到响应的请求时使用同一个键——重试会返回第一次的提现,而不会创建第二笔。
安全重试
- 同一个键且
to_address、amount_trx、currency相同时,返回200及第一次请求创建的提现(当前状态),不会重复扣款。 - 同一个键但请求体不同,将以
422和代码IDEMPOTENCY_KEY_REUSED拒绝;键超过 64 个字符,以422和IDEMPOTENCY_KEY_TOO_LONG拒绝。键仅在您的账户内有效,且不会过期——切勿将同一个键用于另一笔提现。 - 同一时间只能有一笔未完成的提现(
pending、scheduled或processing):存在时再次请求会收到400和You already have a pending withdrawal。 - 使用
Idempotency-Key创建提现后,5 秒后即可创建下一笔;不带该请求头时,间隔仍为 60 秒(429,参见速率限制)。
示例
Response
提现列表
GET /api/v1/account/withdrawalsResponse
提现状态
通过 API 密钥创建的提现会立即发送,不会经过
scheduled。在网页后台创建的记录带有 execute_after 字段——若未提前取消,即为发送时刻。
更改邮箱后的安全锁定
账户邮箱更改后的 24 小时内,创建提现会被拒绝,返回403 和错误码 WITHDRAWAL_EMAIL_COOLDOWN。响应中包含 retry_after_seconds,即距离提现解锁还剩多少秒:
Response
withdraw 权限的 API 密钥。如果您本人没有更改账户邮箱,请立即联系客服。