POST /apiv2/time/order

Compre um número específico de ciclos de delegação de energia para um endereço e ative o Host Mode para ele.

URL do Endpoint

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

Autenticação

Forneça sua chave de API no corpo da requisição (api_key) ou no cabeçalho X-API-KEY. O IP da requisição deve estar na lista de permissões configurada para a sua chave de API.

Corpo da Requisição

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

Parâmetros

Parâmetro	Tipo	Obrigatório	Descrição
api_key	string	Sim	Chave de API (ou cabeçalho X-API-KEY).
address	string	Sim	Endereço TRON (TRC-20), ^T[1-9A-HJ-NP-Za-km-z]{33}$.
cycles	integer	Sim	Número de ciclos a comprar. Deve ser ≥ 1.

Preços e faturamento

• Fazer o pedido de ciclos não realiza cobranças antecipadas. Cada ciclo é cobrado no momento em que sua energia é delegada: a primeira delegação de uma ativação custa 4 TRX, cada uma das seguintes custa 2 ou 4 TRX dependendo da energia que a sua transferência anterior realmente consumiu (≤65.000 → 2 TRX, mais → 4 TRX). Consulte Host Mode → Ciclos e Preços para as regras completas, incluindo o mínimo diário de 8 TRX (em vigor a partir de 29-08-2026).
• O amount na resposta é uma estimativa (cycles × preço de referência), não o total final.
• Seu saldo é verificado antes que o pedido seja aceito; se ele não puder cobrir o pedido, a solicitação será rejeitada (erro -2).

Fazer um pedido define o endereço como ativo e cria um pedido aberto para o número solicitado de ciclos. O endereço então começa a receber delegações de energia ciclo a ciclo, e cada delegação é cobrada quando acontece.

Exemplos de Requisição

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));

Resposta

Sucesso (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 Resposta

Campo	Tipo	Descrição
code	integer	0 = sucesso, negativo = erro
msg	string	Mensagem legível por humanos
data.order_id	integer	Identificador interno do pedido
data.address	string	O endereço para o qual os ciclos foram comprados
data.cycles	integer	Número de ciclos comprados
data.amount	number	Total estimado do pedido, em TRX (apenas referência — a cobrança é por delegação)
data.status	string	"active" após um pedido bem-sucedido
data.timestamp	string	Timestamp ISO do pedido

Respostas de Erro

code	msg	Causa
-1	Invalid API key or IP not in whitelist	Falha na autenticação
-1	Invalid TRC-20 address format	Formato de endereço inválido
-1	Cycle count must be 1 or more	cycles < 1
-1	Database error processing order	Erro temporário do lado do servidor — tente novamente
-2	Insufficient balance. Required: X TRX, Available: Y TRX	Saldo abaixo do total do pedido
-6	Cannot buy cycles: There is an open order with … cycles for this address	Já existe um pedido aberto (incluindo infinito)

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

Endpoints Relacionados

• POST /apiv2/time/add — adicionar o endereço primeiro
• POST /apiv2/time/infinitystart — ciclos ilimitados em vez de uma quantidade fixa
• POST /apiv2/time/status — verificar os ciclos restantes
• POST /apiv2/time/stop — parar e fechar o pedido

Observações

• Se o endereço ainda não estiver no Host Mode, fazer o pedido também o registra e o ativa.
• É permitido apenas um pedido aberto por endereço de cada vez.
• Os ciclos comprados são consumidos a cada delegação (um por delegação); quando eles se esgotam, o endereço para automaticamente.