Saltar al contenido principal
POST
Crear suscripción

Crear suscripción

Crea una suscripción de Bandwidth automático para una dirección. A partir de la siguiente comprobación — normalmente en unos segundos — mantenemos volume de ancho de banda delegado a la dirección y lo renovamos después de cada transferencia que lo agota. Consulta la descripción general para ver cómo funcionan la renovación, el coste y los estados. La solicitud en sí no cobra nada, pero tu saldo debe cubrir las primeras 24 horas y una transferencia — más la activación, si la dirección todavía no existe on-chain — o devuelve 402 INSUFFICIENT_BALANCE. Requiere el alcance buy_bandwidth. Para ver antes el precio, usa Cotización de Bandwidth automático.

Cuerpo de la solicitud

string
requerido
Dirección TRON en la que se mantendrá el ancho de banda — la dirección que envía las transferencias (formato T…, 34 caracteres). Las direcciones de contrato se rechazan.
number
predeterminado:"350"
Ancho de banda que se mantendrá en la dirección. De 1 a 5,000. Una transferencia USDT o USDD consume unos 345, una transferencia TRX unos 270.
string
predeterminado:"USDT"
El token que envía la dirección: "USDT", "TRX", "USDD", "CUSTOM" u "OWN". No limita qué transferencias se cubren — ver Token.
string
Dirección de un contrato TRC-20 de tu lista de tokens. Obligatorio con token: "CUSTOM", opcional con "OWN", no se acepta con los demás tokens.
string
Tu propio nombre para la suscripción, hasta 50 caracteres. Opcional.
boolean
predeterminado:"false"
No mantener ancho de banda mientras la dirección tenga al menos threshold de ancho de banda gratuito.
number
predeterminado:"600"
Nivel de ancho de banda gratuito para auto_pause y notify_free_bw. De 1 a 600; cuando alguna de las dos opciones está activada, debe estar entre el mayor de volume y 345, y 600. Sin auto_pause, un volume superior a 600 permite 600.
boolean
predeterminado:"false"
Enviar un mensaje por Telegram y por correo cada vez que el ancho de banda gratuito de la dirección se recupere hasta threshold.
boolean
predeterminado:"false"
Pausar la suscripción después de la siguiente transferencia de su token.

Respuesta

La nueva suscripción, con los mismos campos que en Listar suscripciones. Justo después de crearla, delegated_bw es 0 y paid_until es null: la primera delegación llega en unos segundos.

Ejemplo

Response

Errores

Reintentar una creación tras agotarse el tiempo de espera es seguro. Si la primera solicitud se completó, el reintento devuelve 409 AUTO_BW_ADDRESS_TAKEN en lugar de crear una segunda suscripción; lista tus suscripciones para obtener su id.