跳转到主要内容
POST
创建订阅

创建订阅

为一个地址创建自动带宽订阅。从下一次检查起——通常在几秒之内——我们会为该地址保持委托 volume 带宽,并在每笔用完它的转账后续期。续期、费用和状态的工作方式参见概述。 请求本身不收取任何费用,但您的余额必须足以支付前 24 小时和一笔转账——如果地址在链上尚不存在,还要加上激活费用——否则返回 402 INSUFFICIENT_BALANCE。需要 buy_bandwidth 权限。如需先查看价格,请使用自动带宽报价。

请求体

string
必填
需要保持带宽的 TRON 地址——即发出转账的地址(T… 格式,34 个字符)。不接受合约地址。
number
默认值:"350"
要在地址上保持的带宽。范围 1 至 5,000。一笔 USDT 或 USDD 转账约需 345,一笔 TRX 转账约需 270。
string
默认值:"USDT"
地址发送的代币:"USDT"、"TRX"、"USDD"、"CUSTOM" 或 "OWN"。它并不限制覆盖哪些转账——参见代币。
string
来自您的代币列表的 TRC-20 合约地址。token: "CUSTOM" 时必填,"OWN" 时可选,其他代币不接受。
string
您为订阅起的名称,最多 50 个字符。可选。
boolean
默认值:"false"
当地址的免费带宽至少为 threshold 时,不持有任何带宽。
number
默认值:"600"
用于 auto_pause 和 notify_free_bw 的免费带宽水平。范围 1 至 600;开启其中任一选项时,必须介于 volume 与 345 中较大者和 600 之间。未开启 auto_pause 时,volume 高于 600 允许取 600。
boolean
默认值:"false"
每当地址的免费带宽恢复到 threshold 时,发送 Telegram 和电子邮件消息。
boolean
默认值:"false"
在其代币的下一笔转账之后暂停订阅。

响应

新建的订阅,字段与列出订阅中的相同。刚创建时,delegated_bw 为 0,paid_until 为 null:首次委托会在几秒之内进行。

示例

Response

错误

超时后重试创建请求是安全的。如果第一次请求已经成功,重试会返回 409 AUTO_BW_ADDRESS_TAKEN,而不会创建第二个订阅;列出您的订阅即可获取其 id。