POST /apiv2/time/stop

Interrompe o Host Mode para um endereço TRON: fecha suas ordens abertas e o desativa. O endereço permanece registrado no Host Mode e pode ser reativado posteriormente.

URL do Endpoint

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

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"
}

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}$. Deve estar no Host Mode e atualmente ativo.

Comportamento

Interromper um endereço:

• Fecha todas as suas ordens abertas.
• Define o Host Mode como inativo (status = 0, cycle_set = 0).
• Redefine o contador de ciclos utilizados para o endereço.
• Nenhuma nova Energy é delegada até que você o reative (com /apiv2/time/order ou /apiv2/time/infinitystart).

O endereço em si permanece no Host Mode; para removê-lo completamente, utilize /apiv2/time/delete.

Exemplos de Requisição

cURL

curl -X POST https://netts.io/apiv2/time/stop \
  -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/stop",
    json={"api_key": "YOUR_API_KEY_HERE", "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE"},
    timeout=30,
)
result = resp.json()

if result["code"] == 0:
    print("Stopped. Orders closed:", result["data"]["orders_closed"])
else:
    print("Error:", result["msg"])

Node.js

const axios = require('axios');

axios.post('https://netts.io/apiv2/time/stop', {
    api_key: 'YOUR_API_KEY_HERE',
    address: 'TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE',
}).then(({ data: result }) => {
    if (result.code === 0) console.log('Stopped. Orders closed:', result.data.orders_closed);
    else console.error('Error:', result.msg);
}).catch(err => console.error('Request failed:', err.response?.data || err.message));

Resposta

Sucesso (200 OK)

{
    "code": 0,
    "msg": "Host mode stopped successfully, closed 1 order(s)",
    "data": {
        "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
        "orders_closed": 1,
        "status": "inactive",
        "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 que foi interrompido
data.orders_closed	integer	Número de ordens abertas que foram fechadas
data.status	string	"inactive"
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 informada
-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	Database error stopping host mode	Erro temporário do lado do servidor — tente novamente
-1	Internal server error	Erro inesperado — tente novamente ou contate o suporte
-4	Address not found	O endereço não está no Host Mode sob a sua conta
-7	Host mode is already inactive	O endereço já está interrompido

{ "code": -7, "msg": "Host mode is already inactive", "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. O corpo de erro sempre inclui "data": null.

Alguns erros são retornados antes que a requisição alcance o endpoint. Eles utilizam um status diferente de 200 e uma estrutura de corpo distinta:

HTTP	Corpo	Causa
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 incorreto. Note que não há o campo code nesta resposta

Interromper um endereço está sempre disponível, independentemente do saldo da sua conta.

Parar vs Excluir

	Parar	Excluir
Registro no Host Mode	Mantido	Removido
Ordens abertas	Fechadas	Não deve haver nenhuma
Reativação	order / infinitystart	Deve executar add novamente
URL de callback	Mantida	Removida

Endpoints Relacionados

• POST /apiv2/time/infinitystart — reativa o endereço (infinito)
• POST /apiv2/time/order — reativa com um número fixo de ciclos
• POST /apiv2/time/status — consulta o status
• POST /apiv2/time/delete — remove o endereço completamente

Observações

• A interrupção mantém o endereço no Host Mode; ele pode ser reativado a qualquer momento.
• Os ciclos contratados restantes não são acumulados — o contador de ciclos utilizados é redefinido na interrupção.