POST /apiv2/time/order

Compre um número específico de ciclos de delegação de energy 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 faz cobranças adiantadas. Cada ciclo é faturado no momento em que sua energy é delegada: a primeira delegação de uma ativação custa 4 TRX, cada uma das seguintes custa 2 ou 4 TRX dependendo da energy que sua transferência anterior de fato consumiu (≤65.000 → 2 TRX, mais → 4 TRX). Consulte Host Mode → Ciclos e Preços para as regras completas e Mínimo diário para 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 de o pedido ser aceito; caso não possa cobrir o pedido, ele será rejeitado (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 energy ciclo por 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 da 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 — o faturamento é 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 no 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	Um pedido aberto já existe (incluindo infinito)

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

Endereço de destino não permitido (403)

O endereço é verificado antes de o pedido ser aceito. Se a delegação de recursos para ele não for permitida, a requisição é rejeitada com HTTP 403 e nada é gravado — nenhum pedido é criado e o endereço não é adicionado nem ativado. O corpo usa o formato detail:

code	msg	Significado
1006	Address is blocked. Contact support.	O endereço está bloqueado
1007	Energy rental to smart contracts is not supported.	O endereço é um smart contract (endereços de carteira GasFree também são smart contracts)
1010	Resource delegation to this address is not available.	A delegação de recursos para este endereço não está disponível
1011	This address is frozen and cannot receive resource delegation.	O endereço está congelado

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

Endpoints Relacionados

• POST /apiv2/time/add — adicione o endereço primeiro
• POST /apiv2/time/infinitystart — ciclos ilimitados em vez de uma quantidade fixa
• POST /apiv2/time/status — verifique os ciclos restantes
• POST /apiv2/time/stop — pare e encerre o pedido

Notas

• Se o endereço ainda não estiver no Host Mode, o pedido também o registra e o ativa.
• É permitido apenas um pedido aberto por endereço por vez.
• Os ciclos comprados são consumidos um por delegação; quando acabam, o endereço para automaticamente.