Saltar para o conteúdo principal
POST
Criar assinatura

Criar assinatura

Cria uma assinatura de Bandwidth automático para um endereço. A partir da verificação seguinte — normalmente em segundos — mantemos volume de largura de banda delegada ao endereço e a renovamos após cada transferência que a esgota. Veja a visão geral para entender como funcionam a renovação, o custo e os status. A requisição em si não cobra nada, mas o seu saldo deve cobrir as primeiras 24 horas e uma transferência — mais a ativação, se o endereço ainda não existe na blockchain — ou ela retorna 402 INSUFFICIENT_BALANCE. Exige o escopo buy_bandwidth. Para ver o preço antes, use a Cotação do Bandwidth automático.

Corpo da requisição

string
obrigatório
Endereço TRON onde manter largura de banda — o endereço que envia as transferências (formato T…, 34 caracteres). Endereços de contrato são recusados.
number
padrão:"350"
Largura de banda a manter no endereço. De 1 a 5.000. Uma transferência USDT ou USDD consome cerca de 345, uma transferência de TRX cerca de 270.
string
padrão:"USDT"
O token que o endereço envia: "USDT", "TRX", "USDD", "CUSTOM" ou "OWN". Ele não limita quais transferências são cobertas — veja Token.
string
Endereço de um contrato TRC-20 da sua lista de tokens. Obrigatório com token: "CUSTOM", opcional com "OWN", não aceito com os outros tokens.
string
Um nome próprio para a assinatura, até 50 caracteres. Opcional.
boolean
padrão:"false"
Não segurar largura de banda enquanto o endereço tem ao menos threshold de largura de banda gratuita.
number
padrão:"600"
Nível de largura de banda gratuita para auto_pause e notify_free_bw. De 1 a 600; quando qualquer uma das opções está ligada, deve ficar entre o maior valor entre volume e 345, e 600. Sem auto_pause, um volume acima de 600 permite 600.
boolean
padrão:"false"
Enviar uma mensagem por Telegram e e-mail toda vez que a largura de banda gratuita do endereço volta a threshold.
boolean
padrão:"false"
Pausar a assinatura após a próxima transferência do seu token.

Resposta

A nova assinatura, com os mesmos campos de Listar assinaturas. Logo após a criação, delegated_bw é 0 e paid_until é null: a primeira delegação vem em segundos.

Exemplo

Response

Erros

Repetir uma criação após um timeout é seguro. Se a primeira requisição foi processada, a repetição retorna 409 AUTO_BW_ADDRESS_TAKEN em vez de criar uma segunda assinatura; liste as suas assinaturas para obter o id dela.