激活地址
POST/activate
激活一个从未收到过任何转账的波场(TRON)地址,按当前激活价格从你的余额中扣费。能量和带宽只能委托给已激活的地址;POST /buy 会自行激活其接收地址(除非 activate_address 为 false),因此只有在想激活地址而不为其购买能量时,才需要调用此端点。
当前价格即 GET /estimate?receiver_address= 对未激活的接收地址(receiver_activated: false)返回的 activation_fee_sun。激活通常在几秒内完成:轮询 查询激活,直到 status 为 COMPLETED 或 FAILED。FAILED 的激活会退款到你的余额(refunded: true)。
如果你的 TRX 余额不足且开启了 usdt_cover_shortfall(见 GET /account),会先将恰好够用的 USDT 余额兑换为 TRX,与 POST /buy 相同。
请求
Responses
- 201
- 400
- 401
- 403
- 409
- 422
- 429
- 500
- 503
激活费用已支付,激活正在进行中(PENDING)。
激活被拒绝;未扣取任何费用:
invalid_address——address不是有效的波场地址insufficient_balance——你的余额低于激活价格,且你的 USDT 无法补足差额(无message;带有以 SUN 计的current_balance和required_amount)invalid_idempotency_key——Idempotency-Key超过 128 个字符
X-API-Key 请求头缺失、无效或已撤销。detail 为纯字符串:API key required、Invalid API key 或 User not found。
账户已被封禁(纯字符串 detail:Account is blocked),或 ip_not_allowed——请求的来源 IP 不在该密钥的 IP 白名单内。
未扣取任何费用:
already_activated——该地址已激活,无需激活activation_in_progress——该地址的一次激活已在进行中(若该激活属于你,则带有activation_id)duplicate_request——具有相同Idempotency-Key的请求仍在处理中
请求体校验失败(例如缺少 address 或包含未知字段)——detail 为字段错误数组。
Rate limit exceeded——你的账户每分钟请求超过 1,000 次(由该账户的所有 API 密钥与工作台会话共用)。detail 为纯字符串;等待 Retry-After 给出的秒数后再重试。
Response Headers
距离限流窗口重置的秒数。
internal_error——意外错误;未扣取任何费用。请稍后重试。
activation_unavailable——地址激活暂时不可用;未扣取任何费用。请稍后重试。