POST /apiv2/time/infinitystart

Habilite el modo infinity (ilimitado) para una dirección que ya esté en Host Mode — la Energy continúa delegándose ciclo tras ciclo hasta que usted la detenga.

URL del endpoint

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

Autenticación

Proporcione su API key en el cuerpo de la solicitud (api_key) o en el encabezado X-API-KEY. La IP de la solicitud debe estar en la lista blanca configurada para su API key.

Cuerpo de solicitud

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

Parámetros

Parámetro	Tipo	Requerido	Descripción
api_key	string	Sí	API key (o encabezado X-API-KEY).
address	string	Sí	Dirección TRON (TRC-20), ^T[1-9A-HJ-NP-Za-km-z]{33}$. La dirección ya debe estar en Host Mode (agréguela primero).

Comportamiento

• La dirección ya debe existir en Host Mode y estar inactiva (detenida).
• Su saldo debe cubrir al menos un ciclo al precio actual (se verifica antes de la activación).
• El endpoint activa la dirección, crea una orden infinity abierta y Host Mode sigue delegando Energy ciclo tras ciclo hasta que llame a /apiv2/time/stop.

Los ciclos se facturan a medida que se delegan (un ciclo por delegación). La primera delegación de una activación cuesta 4 TRX; cada una de las siguientes cuesta 2 o 4 TRX dependiendo de la Energy que su transferencia anterior haya consumido realmente (≤ 65,000 → 2 TRX, más → 4 TRX). El mínimo diario de 8 TRX (efectivo desde 2026-08-29) y el apagado por inactividad de 2 días se aplican también en el modo infinity — consulte Host Mode → Ciclos y Precios y Mínimo diario.

En Time Status una dirección en infinity reporta cycles_ordered y cycles_remaining como null — no hay un límite para una cuenta regresiva. Interprete null como “ilimitado”, no como “no quedan ciclos”.

Ejemplos de Solicitudes

cURL

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

Python

import requests

resp = requests.post(
    "https://netts.io/apiv2/time/infinitystart",
    json={"api_key": "YOUR_API_KEY_HERE", "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE"},
    timeout=30,
)
result = resp.json()

if result["code"] == 0:
    print("Infinity mode active, order:", result["data"]["order_id"])
else:
    print("Error:", result["msg"])

Node.js

const axios = require('axios');

axios.post('https://netts.io/apiv2/time/infinitystart', {
    api_key: 'YOUR_API_KEY_HERE',
    address: 'TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE',
}).then(({ data: result }) => {
    if (result.code === 0) console.log('Infinity mode active, order:', result.data.order_id);
    else console.error('Error:', result.msg);
}).catch(err => console.error('Request failed:', err.response?.data || err.message));

Respuesta

Éxito (200 OK)

{
    "code": 0,
    "msg": "Infinity mode activated successfully",
    "data": {
        "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
        "order_id": 5427,
        "mode": "infinity",
        "status": "active",
        "timestamp": "2026-07-13T05:30:15.123456"
    }
}

Campos de Respuesta

Campo	Tipo	Descripción
code	integer	0 = éxito, negativo = error
msg	string	Mensaje legible por humanos
data.address	string	La dirección activada en modo infinity
data.order_id	integer	Identificador interno de la orden
data.mode	string	"infinity"
data.status	string	"active"
data.timestamp	string	Marca de tiempo ISO

Respuestas de Error

code	msg	Causa
-1	API key required in X-API-KEY header or request body	No se proporcionó API key
-1	Invalid API key or IP not in whitelist	Error de autenticación
-1	Invalid TRC-20 address format	Formato de dirección inválido
-1	Failed to activate host mode	No se pudo activar la dirección — reintente
-1	Database error activating infinity mode	Error temporal del lado del servidor — reintente
-1	Internal server error	Error inesperado — reintente o contacte a soporte
-2	Insufficient balance. Required: X TRX, Available: Y TRX	Saldo por debajo del precio de un ciclo
-4	Address not found. Please add address first	Dirección no encontrada en Host Mode
-5	Host mode is already active for this address	La dirección ya está en ejecución
-6	There is already an open order for this address	Ya existe una orden abierta

{ "code": -4, "msg": "Address not found. Please add address first", "data": null }

Códigos de estado HTTP

Los errores del endpoint se devuelven con HTTP 200 y un code negativo — verifique code, no el estado HTTP. Los cuerpos de error siempre incluyen "data": null.

Algunos errores se devuelven antes de que la solicitud llegue al endpoint. Utilizan un estado distinto de 200 y una estructura de cuerpo diferente:

HTTP	Cuerpo	Causa
402	{"detail": {"code": 1004, "msg": "Insufficient funds. Minimum balance is 4 TRX. Please top up your account."}}	El saldo de la cuenta es demasiado bajo
403	{"detail": {"code": 1005, "msg": "API key is blocked. Contact support."}}	La API key está bloqueada — contacte a soporte
422	{"detail": [ … ]}	El cuerpo de la solicitud no superó la validación: falta un campo obligatorio o tiene un tipo incorrecto. Tenga en cuenta que no hay campo code en esta respuesta

Dirección de destino no permitida (403)

La dirección se verifica antes de activarse. Si la delegación de recursos hacia ella no está permitida, la solicitud se rechaza con HTTP 403 y no se escribe nada — la dirección permanece inactiva y no se crea ninguna orden. El cuerpo utiliza la estructura detail:

code	msg	Significado
1006	Address is blocked. Contact support.	La dirección está bloqueada
1007	Energy rental to smart contracts is not supported.	La dirección es un smart contract (las direcciones de billeteras GasFree también son smart contracts)
1010	Resource delegation to this address is not available.	La delegación hacia esta dirección no está disponible
1011	This address is frozen and cannot receive resource delegation.	La dirección está congelada

{ "detail": { "code": 1007, "msg": "Energy rental to smart contracts is not supported." } }

Endpoints Relacionados

• POST /apiv2/time/add — agregue la dirección primero
• POST /apiv2/time/order — compre un número fijo de ciclos en su lugar
• POST /apiv2/time/stop — detenga el modo infinity
• POST /apiv2/time/status — consulte el estado

Notas

• El modo infinity se ejecuta hasta que lo detenga con /apiv2/time/stop.
• Mantenga suficiente saldo disponible — los ciclos se cobran a medida que se delegan.
• Use este endpoint para reanudar una dirección que se detuvo previamente (debe estar inactiva).