POST /apiv2/time/delete

Remove um endereço TRON do Host Mode completamente. Por padrão, o endereço já deve estar inativo (parado) e não ter pedidos abertos; passe "stop": true para pará-lo e excluí-lo em uma única chamada.

URL do Endpoint

POST https://netts.io/apiv2/time/delete

Autenticação

Forneça sua chave de API no corpo da requisição (api_key) ou no cabeçalho X-API-KEY. O IP da requisição deve estar na whitelist configurada para sua chave de API.

Corpo da Requisição

json

{
    "api_key": "your_api_key",
    "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
    "stop": true
}

Parâmetros

Parâmetro	Tipo	Obrigatório	Descrição
api_key	string	Sim	Chave de API (ou cabeçalho `X-API-KEY`).
address	string	Sim	Endereço TRON (TRC-20), `^T[1-9A-HJ-NP-Za-km-z]{33}$`. Deve pertencer à sua conta.
stop	boolean	Não	`true` — para o Host Mode no endereço antes de excluí-lo, em vez de recusar a chamada. Evita uma requisição separada para `/apiv2/time/stop`. O padrão é `false`.

Comportamento

Sem stop, o endereço deve estar inativo — pare-o primeiro com /apiv2/time/stop caso esteja ativo — e não deve ter pedidos abertos. Caso contrário, a chamada é recusada com os erros abaixo e nada é alterado.
Em caso de sucesso, o endereço é removido do Host Mode e sua URL de callback registrada (se houver) é excluída.
O mesmo endereço pode ser adicionado novamente mais tarde com /apiv2/time/add.

stop

Com "stop": true, um endereço ativo é parado e excluído em uma única chamada — o mesmo resultado de chamar /apiv2/time/stop e depois /apiv2/time/delete, e exatamente as mesmas ações: todos os pedidos abertos para o endereço são encerrados, o Host Mode é desativado, o contador de ciclos é zerado e a interrupção é registrada no seu histórico de ações. Somente então o endereço é excluído.

Ambas as etapas são executadas em uma única transação: ou o endereço é parado e excluído, ou absolutamente nada muda. Não existe estado em que o endereço termine parado, mas ainda registrado.

A flag só tem efeito quando há algo para parar. Em um endereço que já está inativo e não possui pedidos abertos, ela não altera nada — a chamada se comporta exatamente como sem ela, e a resposta é a resposta comum de exclusão.

O faturamento não é afetado: parar não reembolsa nada e excluir não cobra nada. Ciclos já delegados continuam cobrados, e a energy atualmente delegada ao endereço é recuperada em seu cronograma normal. Consulte Host Mode → Cycles and Pricing.

Exemplos de Requisição

cURL

bash

curl -X POST https://netts.io/apiv2/time/delete \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "YOUR_API_KEY_HERE",
    "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE"
  }'

Parar e excluir em uma única chamada:

bash

curl -X POST https://netts.io/apiv2/time/delete \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "YOUR_API_KEY_HERE",
    "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
    "stop": true
  }'

Python

python

import requests

resp = requests.post(
    "https://netts.io/apiv2/time/delete",
    json={
        "api_key": "YOUR_API_KEY_HERE",
        "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
        # "stop": True,  # optional: stop Host Mode on the address instead of failing
    },
    timeout=30,
)
result = resp.json()

if result["code"] == 0:
    print("Deleted:", result["data"]["address"])
else:
    print("Error:", result["msg"])

Node.js

javascript

const axios = require('axios');

axios.post('https://netts.io/apiv2/time/delete', {
    api_key: 'YOUR_API_KEY_HERE',
    address: 'TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE',
    // stop: true, // optional: stop Host Mode on the address instead of failing
}).then(({ data: result }) => {
    if (result.code === 0) console.log('Deleted:', result.data.address);
    else console.error('Error:', result.msg);
}).catch(err => console.error('Request failed:', err.response?.data || err.message));

Resposta

Sucesso (200 OK)

json

{
    "code": 0,
    "msg": "Address deleted from Host Mode successfully",
    "data": {
        "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
        "timestamp": "2026-07-13T05:30:15.123456"
    }
}

Sucesso quando o endereço foi parado primeiro (`"stop": true`)

json

{
    "code": 0,
    "msg": "Address stopped and deleted from Host Mode successfully",
    "data": {
        "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
        "stopped": true,
        "orders_closed": 1,
        "timestamp": "2026-07-13T05:30:15.123456"
    }
}

Campos da Resposta

Campo	Tipo	Descrição
code	integer	`0` = sucesso, negativo = erro
msg	string	Mensagem legível para humanos. `Address stopped and deleted from Host Mode successfully` quando o endereço foi parado como parte da chamada
data.address	string	O endereço que foi removido
data.stopped	boolean	Presente apenas quando o Host Mode foi parado como parte desta chamada. Ausente em uma exclusão simples
data.orders_closed	integer	Número de pedidos abertos fechados por essa parada. Presente apenas junto com `stopped`
data.timestamp	string	Carimbo de data/hora ISO

Respostas de Erro

Todos os erros usam code = -1:

msg	Causa
`API key required in X-API-KEY header or request body`	Nenhuma chave de API fornecida
`Invalid API key or IP not in whitelist`	Falha na autenticação
`Invalid TRC-20 address format`	Formato de endereço inválido
`Address not found or does not belong to you`	O endereço não está registrado sob a sua conta
`Cannot delete an active address. Stop Host mode first`	O endereço está ativo e `stop` não foi definido — chame `/apiv2/time/stop` primeiro ou repita com `"stop": true`
`Cannot delete address with active orders`	O endereço ainda possui pedidos abertos e `stop` não foi definido — repita com `"stop": true`
`Failed to delete address`	Não foi possível remover o endereço — tente novamente
`Database error deleting address`	Erro temporário do lado do servidor — tente novamente
`Internal server error`	Erro inesperado — tente novamente ou entre em contato com o suporte

json

{ "code": -1, "msg": "Cannot delete an active address. Stop Host mode first", "data": null }

Códigos de status HTTP

Os erros de endpoint são retornados com HTTP 200 e um code negativo — verifique o code, não o status HTTP. Os corpos de erro sempre incluem "data": null.

Alguns erros são retornados antes que a requisição alcance o endpoint. Eles usam um status diferente de 200 e um formato de corpo diferente:

HTTP	Corpo	Causa
403	`{"detail": {"code": 1005, "msg": "API key is blocked. Contact support."}}`	A chave de API está bloqueada — entre em contato com o suporte
422	`{"detail": [ … ]}`	O corpo da requisição falhou na validação: um campo obrigatório está ausente ou tem o tipo incorreto. Observe que não há campo `code` nesta resposta

A exclusão de um endereço está sempre disponível, independentemente do saldo da sua conta.

Endpoints Relacionados

POST /apiv2/time/stop — parar o endereço antes de excluir
POST /apiv2/time/status — verificar status e pedidos abertos
POST /apiv2/time/add — adicionar o endereço novamente mais tarde

Notas

A exclusão também remove a URL de callback do endereço.
A exclusão só é permitida para endereços inativos sem pedidos abertos — pare-o primeiro com /apiv2/time/stop, ou passe "stop": true aqui para que ele seja parado para você.
O mesmo endereço pode ser adicionado novamente a qualquer momento.

POST /apiv2/time/delete ​

URL do Endpoint ​

Autenticação ​

Corpo da Requisição ​

Parâmetros ​

Comportamento ​

stop ​

Exemplos de Requisição ​

cURL ​

Python ​

Node.js ​

Resposta ​

Sucesso (200 OK) ​

Sucesso quando o endereço foi parado primeiro ("stop": true) ​

Campos da Resposta ​

Respostas de Erro ​

Códigos de status HTTP ​

Endpoints Relacionados ​

Notas ​

POST /apiv2/time/delete

URL do Endpoint

Autenticação

Corpo da Requisição

Parâmetros

Comportamento

stop

Exemplos de Requisição

cURL

Python

Node.js

Resposta

Sucesso (200 OK)

Sucesso quando o endereço foi parado primeiro (`"stop": true`)

Campos da Resposta

Respostas de Erro

Códigos de status HTTP

Endpoints Relacionados

Notas