POST /apiv2/time/infinitystart

Ative o modo infinity (ilimitado) para um endereço já em Host Mode — a Energy continua sendo delegada ciclo após ciclo até você interrompê-la.

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 em Host Mode (adicione-o primeiro).

Comportamento

• O endereço já deve existir em Host Mode e estar inativo (parado).
• Seu saldo deve cobrir pelo menos um ciclo ao 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é você chamar /apiv2/time/stop.

Os ciclos são faturados conforme 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 (efetivo 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.

No Time Status, um endereço infinity relata cycles_ordered e cycles_remaining como null — não há limite para contagem regressiva. Interprete null como "ilimitado", não como "nenhum ciclo restante".

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 da 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 do lado do servidor — tente novamente
-1	Internal server error	Erro inesperado — tente novamente ou contate 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 em 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

Os erros do endpoint são retornados com HTTP 200 e um code negativo — verifique o 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 distinto:

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 — contate o suporte
422	{"detail": [ … ]}	O corpo da requisição falhou na validação: um campo obrigatório está ausente ou tem o tipo errado. Observe que não há o campo code nesta resposta

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 — verifique o status

Observações

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