POST /apiv2/time/order

Compre un número específico de ciclos de delegación de Energy para una dirección y active el Host Mode para la misma.

URL del endpoint

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

Autenticación

Proporcione su clave 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 su clave API.

Cuerpo de la solicitud

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

Parámetros

Parámetro	Tipo	Requerido	Descripción
api_key	string	Sí	Clave API (o encabezado X-API-KEY).
address	string	Sí	Dirección TRON (TRC-20), ^T[1-9A-HJ-NP-Za-km-z]{33}$.
cycles	integer	Sí	Número de ciclos a comprar. Debe ser ≥ 1.

Precios y facturación

• Ordenar ciclos no genera un cargo por adelantado. Cada ciclo se factura en el momento en que se delega su Energy: 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 su transferencia anterior haya consumido realmente (≤65.000 → 2 TRX, más → 4 TRX). Consulte Host Mode → Ciclos y precios para conocer las reglas completas, incluido el mínimo diario de 8 TRX (a partir del 2026-08-29).
• El campo amount en la respuesta es una estimación (cycles × precio de referencia), no el total final.
• Su saldo se verifica antes de que se acepte la orden; si no puede cubrir la orden, la orden se rechaza (error -2).

Realizar una orden establece la dirección como activa y crea una orden abierta para el número solicitado de ciclos. A continuación, la dirección comienza a recibir delegaciones de Energy ciclo por ciclo, y cada delegación se cobra cuando ocurre.

Solicitudes de ejemplo

cURL

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

Python

import requests

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

if result["code"] == 0:
    d = result["data"]
    print(f"Order {d['order_id']}: {d['cycles']} cycles for {d['amount']} TRX")
else:
    print("Error:", result["msg"])

Node.js

const axios = require('axios');

axios.post('https://netts.io/apiv2/time/order', {
    api_key: 'YOUR_API_KEY_HERE',
    address: 'TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE',
    cycles: 10,
}).then(({ data: result }) => {
    if (result.code === 0) {
        const d = result.data;
        console.log(`Order ${d.order_id}: ${d.cycles} cycles for ${d.amount} TRX`);
    } else {
        console.error('Error:', result.msg);
    }
}).catch(err => console.error('Request failed:', err.response?.data || err.message));

Respuesta

Éxito (200 OK)

{
    "code": 0,
    "msg": "Cycles purchased and host mode activated successfully",
    "data": {
        "order_id": 5426,
        "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
        "cycles": 10,
        "amount": 23.5,
        "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 para humanos
data.order_id	integer	Identificador interno de la orden
data.address	string	La dirección para la que se compraron los ciclos
data.cycles	integer	Número de ciclos comprados
data.amount	number	Total estimado de la orden, en TRX (solo como referencia — la facturación es por delegación)
data.status	string	"active" después de una orden exitosa
data.timestamp	string	Marca de tiempo ISO de la orden

Respuestas de error

code	msg	Causa
-1	Invalid API key or IP not in whitelist	La autenticación falló
-1	Invalid TRC-20 address format	Formato de dirección incorrecto
-1	Cycle count must be 1 or more	cycles < 1
-1	Database error processing order	Error temporal del lado del servidor — reintentar
-2	Insufficient balance. Required: X TRX, Available: Y TRX	Saldo inferior al total de la orden
-6	Cannot buy cycles: There is an open order with … cycles for this address	Ya existe una orden abierta (incluida infinita)

{
    "code": -2,
    "msg": "Insufficient balance. Required: 23.5 TRX, Available: 10.0 TRX"
}

Endpoints relacionados

• POST /apiv2/time/add — agregue la dirección primero
• POST /apiv2/time/infinitystart — ciclos ilimitados en lugar de una cantidad fija
• POST /apiv2/time/status — consultar los ciclos restantes
• POST /apiv2/time/stop — detener y cerrar la orden

Notas

• Si la dirección aún no está en Host Mode, realizar el pedido también la registra y la activa.
• Solo se permite una orden abierta por dirección a la vez.
• Los ciclos comprados se consumen a razón de uno por delegación; cuando se agotan, la dirección se detiene automáticamente.