Activator — ativação de endereço

Ative um endereço TRON que nunca foi utilizado on-chain. Um endereço novinho em folha não possui registro de conta, portanto não pode receber delegação de Energy ou Bandwidth até ser ativado. Este endpoint cria a conta para você e retorna o hash da transação de ativação.

A ativação é uma operação única por endereço. Se o endereço já estiver ativo, o endpoint informa você sobre isso e não cobra nada.

URL base do endpoint

https://netts.io/apiv2/activator

O caminho legado https://netts.io/apiv2/activation é atendido pelo mesmo serviço e se comporta de maneira idêntica. Novas integrações devem usar /apiv2/activator.

Cabeçalhos da requisição

Cabeçalho	Obrigatório	Descrição
Content-Type	Sim	application/json
X-API-KEY	Sim	Sua chave de API do painel da Netts
X-Real-IP	Sim	Endereço IP da sua whitelist

Seu user_id é derivado da chave de API — você nunca o envia.

---

Ativar — POST /apiv2/activator

Corpo da requisição

{ "targetAddress": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE" }

Campo	Tipo	Obrigatório	Descrição
targetAddress	string	Sim	Endereço TRON a ser ativado. Deve corresponder a ^T[A-Za-z0-9]{33}$ (34 caracteres, começa com T).

Resposta — ativado (200, código 10000)

{
    "detail": {
        "code": 10000,
        "msg": "Address activated successfully, 1.1 TRX deducted",
        "data": {
            "orderId": "A123456",
            "targetAddress": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
            "activation_cost": 1.1,
            "user_balance_before": 500.00,
            "user_balance_after": 498.90,
            "hash": "0000000000000000000000000000000000000000000000000000000000000000"
        }
    }
}

Campo	Tipo	Descrição
orderId	string	Número do pedido de ativação, sempre A + dígitos. Use-o para reconciliação.
targetAddress	string	O endereço que foi ativado
activation_cost	float	Valor deduzido do seu saldo, em TRX
user_balance_before	float	Saldo antes da dedução
user_balance_after	float	Saldo após a dedução
hash	string	Hash da transação de ativação. Verifique-o em qualquer explorador da TRON.

Resposta — já ativo (200, código 2001)

Retornado quando o endereço já existe on-chain. Nada é cobrado.

{
    "detail": {
        "code": 2001,
        "msg": "Address is already activated",
        "data": {
            "targetAddress": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
            "status": "already_activated",
            "user_balance": 500.00,
            "activation_cost": 0,
            "activation_required": false
        }
    }
}

Verifique o code antes de assumir que ocorreu uma cobrança: 10000 significa que você pagou, 2001 significa que você não pagou.

Exemplo

curl -X POST https://netts.io/apiv2/activator \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: your_api_key" \
  -H "X-Real-IP: your_whitelisted_ip" \
  -d '{"targetAddress": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE"}'

---

Preço

Item	Valor
Ativação	1.1 TRX
Endereço já ativo	0

O valor é fixo e não depende do endereço nem das condições da rede. Ele é deduzido do seu saldo na Netts no momento em que a ativação for bem-sucedida — nunca antes. Uma ativação que falhar não custa nada.

Seu saldo deve cobrir o custo, caso contrário a requisição será rejeitada com 403 (1004) e nenhum pedido será criado.

---

Quando você precisa disso

• Antes de alugar Energy ou Bandwidth para um endereço novo. A delegação para uma conta inexistente falha. Ative primeiro e faça o pedido depois.
• Antes da primeira transferência de entrada para um endereço que você mesmo gerou.

Você não precisa chamar este endpoint para um endereço que já tenha recebido TRX ou um token — ele já está ativo, e a chamada simplesmente retornará 2001.

Solicitando Energy para um novo endereço

O endpoint de Energy de 1 hora ativa um destinatário inativo por conta própria como parte do pedido, e o custo de ativação é adicionado a esse pedido. Chame o ativador explicitamente quando quiser o endereço ativo antes de qualquer aluguel — por exemplo, para recarregar Bandwidth primeiro, o que exige uma conta ativa.

---

Tempo de processamento

A ativação é uma transação on-chain real. O endpoint responde após a transmissão e após a gravação do registro de ativação, normalmente em poucos segundos.

O endereço torna-se utilizável somente quando a transação for incluída em um bloco — até ~3 segundos após a resposta, já que esse é o intervalo de blocos da TRON. Se o seu próximo passo depender do fato de o endereço estar ativo (como pedir Bandwidth, por exemplo), confirme o estado on-chain por meio do hash retornado em vez de fazer a chamada imediatamente.

---

Referência de códigos de erro

Código	Descrição	Status HTTP
10000	Endereço ativado, saldo deduzido	200
2001	Endereço já ativado, nada cobrado	200
-1	Chave de API inválida / IP fora da whitelist	401
1004	Saldo insuficiente — a mensagem indica o que é necessário e o que você possui	403
-	Formato inválido de targetAddress (deve ter 34 caracteres, começar com T)	422
5003	Falha na ativação ou serviço temporariamente indisponível — tente novamente mais tarde	503
5000	Erro interno do servidor	500

Um 503 significa que nenhuma cobrança ocorreu e nenhum endereço foi ativado: a requisição pode ser repetida com segurança.

Limites de taxa

Limitado por IP de origem:

Período	Limite
1 segundo	5 requisições
1 minuto	60 requisições

Limite de taxa excedido (429)

{ "message": "API rate limit exceeded" }

Observações

• A idempotência é sua responsabilidade. O endpoint não possui chave de idempotência. Repetir uma requisição para um endereço que já está ativo é seguro e gratuito (2001), mas duas requisições simultâneas para o mesmo endereço novinho em folha podem prosseguir simultaneamente. Serialize a ativação por endereço do seu lado.
• O formato de orderId é A + dígitos e é exclusivo entre as ativações.
• Nenhum webhook é enviado para ativação atualmente — a resposta e o hash são a confirmação. Atualmente, os webhooks cobrem apenas delegações de Energy confirmadas; consulte Webhooks.