POST /apiv2/time/infinitystart

Habilita el modo infinity (ilimitado) para una dirección que ya está en Host Mode; la energy se sigue delegando ciclo tras ciclo hasta que la detengas.

URL del Endpoint

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

Autenticación

Proporciona tu clave de API 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 tu clave de API.

Cuerpo de la Solicitud

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

Parámetros

Parámetro	Tipo	Requerido	Descripción
api_key	string	Sí	Clave de API (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égala primero).

Comportamiento

• La dirección ya debe existir en Host Mode y estar inactiva (detenida).
• Tu 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 continúa delegando energy ciclo tras ciclo hasta que llames 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 según la energy que tu transferencia anterior realmente consumió (≤ 65.000 → 2 TRX, más → 4 TRX). El mínimo diario de 8 TRX (efectivo a partir del 2026-08-29) y el apagado por inactividad de 2 días también se aplican en el modo infinity; consulta Host Mode → Ciclos y Precios.

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

Solicitudes de Ejemplo

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 la 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ó la clave de API
-1	Invalid API key or IP not in whitelist	Error de autenticación
-1	Invalid TRC-20 address format	Formato de dirección incorrecto
-1	Failed to activate host mode	No se pudo activar la dirección; reintenta
-1	Database error activating infinity mode	Error temporal del lado del servidor; reintenta
-1	Internal server error	Error inesperado; reintenta o contacta 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	La dirección no está 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; comprueba el 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 clave de API está bloqueada; contacta a soporte
422	{"detail": [ … ]}	El cuerpo de la solicitud falló la validación: falta un campo requerido o tiene el tipo incorrecto. Ten en cuenta que no hay un campo code en esta respuesta

Endpoints Relacionados

• POST /apiv2/time/add — añade la dirección primero
• POST /apiv2/time/order — compra un número fijo de ciclos en su lugar
• POST /apiv2/time/stop — detén el modo infinity
• POST /apiv2/time/status — consulta el estado

Notas

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