Activator — activación de direcciones

Activa una dirección de TRON que nunca se ha utilizado en la cadena. Una dirección completamente nueva no tiene registro de cuenta, por lo que no puede recibir Energy o Bandwidth delegados hasta que sea activada. Este endpoint crea la cuenta por ti y devuelve el hash de la transacción de activación.

La activación es una operación de única vez por dirección. Si la dirección ya está activa, el endpoint te lo indica y no cobra nada.

URL base del endpoint

https://netts.io/apiv2/activator

La ruta heredada https://netts.io/apiv2/activation es atendida por el mismo servicio y se comporta de manera idéntica. Las nuevas integraciones deben utilizar /apiv2/activator.

Encabezados de solicitud

Encabezado	Requerido	Descripción
Content-Type	Sí	application/json
X-API-KEY	Sí	Tu clave de API del panel de control de Netts
X-Real-IP	Sí	Dirección IP de tu lista blanca

Tu user_id se deriva de la clave de API; nunca lo envías.

---

Activar — POST /apiv2/activator

Cuerpo de la solicitud

{ "targetAddress": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE" }

Campo	Tipo	Requerido	Descripción
targetAddress	string	Sí	Dirección de TRON a activar. Debe coincidir con ^T[A-Za-z0-9]{33}$ (34 caracteres, comienza con T).

Respuesta — activada (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	Descripción
orderId	string	Número de orden de activación, siempre A + dígitos. Utilízalo para la conciliación.
targetAddress	string	La dirección que fue activada
activation_cost	float	Cantidad deducida de tu saldo, en TRX
user_balance_before	float	Saldo antes de la deducción
user_balance_after	float	Saldo después de la deducción
hash	string	Hash de la transacción de activación. Verifícalo en cualquier explorador de TRON.

Respuesta — ya activa (200, código 2001)

Se devuelve cuando la dirección ya existe en la cadena. No se cobra nada.

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

Comprueba code antes de asumir que se realizó un cobro: 10000 significa que pagaste, 2001 significa que no.

Ejemplo

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"}'

---

Precio

Concepto	Cantidad
Activación	1.1 TRX
Dirección ya activa	0

La cantidad es fija y no depende de la dirección ni de las condiciones de la red. Se deduce de tu saldo de Netts en el momento en que la activación tiene éxito, nunca antes. Una activación fallida no cuesta nada.

Tu saldo debe cubrir el costo; de lo contrario, la solicitud se rechaza con 403 (1004) y no se crea ninguna orden.

---

Cuándo necesitas esto

• Antes de alquilar Energy o Bandwidth para una dirección nueva. La delegación a una cuenta inexistente falla. Activa primero, luego ordena.
• Antes de la primera transferencia entrante a una dirección que hayas generado tú mismo.

No necesitas llamar a este endpoint para una dirección que alguna vez haya recibido TRX o un token; ya está activa y la llamada simplemente devolvería 2001.

Ordenar Energy para una nueva dirección

El endpoint de Energy de 1 hora activa un destinatario no activo por sí mismo como parte de la orden, y el costo de activación se agrega a dicha orden. Llama al activador explícitamente cuando desees que la dirección esté activa antes de cualquier alquiler; por ejemplo, para recargar Bandwidth primero, lo cual requiere una cuenta activa.

---

Tiempos

La activación es una transacción real en la cadena. El endpoint responde después de que se transmite y se escribe el registro de activación, normalmente en unos pocos segundos.

La dirección se vuelve utilizable solo una vez que la transacción se incluye en un bloque, hasta ~3 segundos después de la respuesta, ya que ese es el intervalo de bloques de TRON. Si tu siguiente paso depende de que la dirección esté activa (ordenar Bandwidth, por ejemplo), confirma el estado en la cadena mediante el hash devuelto en lugar de llamar inmediatamente.

---

Referencia de códigos de error

Código	Descripción	Estado HTTP
10000	Dirección activada, saldo deducido	200
2001	Dirección ya activada, no se cobró nada	200
-1	Clave de API no válida / IP no incluida en la lista blanca	401
1004	Fondos insuficientes: el mensaje indica lo que se requiere y lo que tienes	403
-	Formato de targetAddress no válido (debe tener 34 caracteres, comenzar con T)	422
5003	Error de activación o servicio temporalmente no disponible; vuelve a intentarlo más tarde	503
5000	Error interno del servidor	500

Un 503 significa que no se realizó ningún cobro y no se activó ninguna dirección: la solicitud se puede reintentar de forma segura.

Límites de tasa

Limitado por IP de origen:

Período	Límite
1 segundo	5 solicitudes
1 minuto	60 solicitudes

Límite de tasa excedido (429)

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

Notas

• La idempotencia corre por tu cuenta. El endpoint no tiene clave de idempotencia. Repetir una solicitud para una dirección que ya está activa es seguro y gratuito (2001), pero dos solicitudes simultáneas para la misma dirección completamente nueva pueden procesarse ambas. Serializa la activación por dirección de tu lado.
• El formato de orderId es A + dígitos y es único entre todas las activaciones.
• Hoy no se envía ningún webhook para la activación: la respuesta y el hash son la confirmación. Actualmente, los webhooks solo cubren las delegaciones confirmadas de Energy, consulta Webhooks.