POST /apiv2/time/infinitystart

Habilite o modo infinity (ilimitado) para um endereço que já esteja no Host Mode — a energy continua sendo delegada ciclo após ciclo até que você a interrompa.

URL do endpoint

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

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 whitelist configurada para sua chave de API.

Corpo da requisição

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

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}$. O endereço já deve estar no Host Mode (adicione-o primeiro).

Comportamento

• O endereço já deve existir no Host Mode e estar inativo (parado).
• Seu saldo deve cobrir pelo menos um ciclo no preço atual (verificado antes da ativação).
• O endpoint ativa o endereço, cria um pedido infinity aberto e o Host Mode continua delegando energy ciclo após ciclo até que você chame /apiv2/time/stop.

Os ciclos são cobrados à medida que são delegados (um ciclo por delegação). 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 realmente consumiu (≤ 65.000 → 2 TRX, mais → 4 TRX). O mínimo diário de 8 TRX (em vigor a partir de 29/08/2026) e o encerramento por inatividade de 2 dias também se aplicam no modo infinity — consulte Host Mode → Ciclos e Preços e Mínimo diário.

Em Status de Tempo, um endereço infinity reporta cycles_ordered e cycles_remaining como null — não há limite para contagem regressiva. Interprete null como "ilimitado", não como "sem ciclos restantes".

Exemplos de Requisições

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

Resposta

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

Campo	Tipo	Descrição
code	integer	0 = sucesso, negativo = erro
msg	string	Mensagem legível para humanos
data.address	string	O endereço ativado no modo infinity
data.order_id	integer	Identificador interno do pedido
data.mode	string	"infinity"
data.status	string	"active"
data.timestamp	string	Timestamp ISO

Respostas de Erro

code	msg	Causa
-1	API key required in X-API-KEY header or request body	Nenhuma chave de API fornecida
-1	Invalid API key or IP not in whitelist	Falha na autenticação
-1	Invalid TRC-20 address format	Formato de endereço incorreto
-1	Failed to activate host mode	O endereço não pôde ser ativado — tente novamente
-1	Database error activating infinity mode	Erro temporário no lado do servidor — tente novamente
-1	Internal server error	Erro inesperado — tente novamente ou entre em contato com o suporte
-2	Insufficient balance. Required: X TRX, Available: Y TRX	Saldo inferior ao preço de um ciclo
-4	Address not found. Please add address first	Endereço não encontrado no Host Mode
-5	Host mode is already active for this address	O endereço já está em execução
-6	There is already an open order for this address	Já existe um pedido aberto

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

Códigos de status HTTP

Erros de endpoint são retornados com HTTP 200 e um code negativo — verifique code, não o status HTTP. Os corpos de erro sempre incluem "data": null.

Alguns erros são retornados antes que a requisição chegue ao endpoint. Eles utilizam um status diferente de 200 e um formato de corpo diferente:

HTTP	Corpo	Causa
402	{"detail": {"code": 1004, "msg": "Insufficient funds. Minimum balance is 4 TRX. Please top up your account."}}	O saldo da conta é muito baixo
403	{"detail": {"code": 1005, "msg": "API key is blocked. Contact support."}}	A chave de API está bloqueada — entre em contato com o suporte
422	{"detail": [ … ]}	O corpo da requisição falhou na validação: um campo obrigatório está ausente ou tem o tipo incorreto. Observe que não há campo code nesta resposta

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

O endereço é verificado antes de ser ativado. Se a delegação de recursos para ele não for permitida, a requisição será rejeitada com HTTP 403 e nada será gravado — o endereço permanece inativo e nenhum pedido é criado. O corpo utiliza 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 contrato inteligente (endereços de carteira GasFree também são contratos inteligentes)
1010	Resource delegation to this address is not available.	A delegação 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/order — compre um número fixo de ciclos em vez disso
• POST /apiv2/time/stop — interrompa o modo infinity
• POST /apiv2/time/status — consulte o status

Notas

• O modo infinity é executado até que você o interrompa com /apiv2/time/stop.
• Mantenha saldo disponível suficiente — os ciclos são cobrados à medida que são delegados.
• Use este endpoint para retomar um endereço que foi interrompido anteriormente (ele deve estar inativo).