POST /apiv2/time/stop

Detiene el Host Mode para una dirección TRON: cierra sus órdenes abiertas y la desactiva. La dirección permanece registrada en Host Mode y puede reactivarse más tarde.

URL del endpoint

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

Autenticación

Proporcione su clave API en el cuerpo de la solicitud (api_key) o en el encabezado X-API-KEY. La IP de la solicitud debe estar en la lista blanca configurada para su clave API.

Cuerpo de la solicitud

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

Parámetros

Parámetro	Tipo	Requerido	Descripción
api_key	string	Sí	Clave API (o encabezado X-API-KEY).
address	string	Sí	Dirección TRON (TRC-20), ^T[1-9A-HJ-NP-Za-km-z]{33}$. Debe estar en Host Mode y actualmente activa.

Comportamiento

Detener una dirección:

• Cierra todas sus órdenes abiertas.
• Establece el Host Mode como inactivo (status = 0, cycle_set = 0).
• Restablece el contador de ciclos utilizados para la dirección.
• No se delega nueva Energy hasta que la reactive (con /apiv2/time/order o /apiv2/time/infinitystart).

La dirección en sí permanece en Host Mode; para eliminarla por completo utilice /apiv2/time/delete.

Solicitudes de ejemplo

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

Respuesta

Éxito (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 respuesta

Campo	Tipo	Descripción
code	integer	0 = éxito, negativo = error
msg	string	Mensaje legible por humanos
data.address	string	La dirección que fue detenida
data.orders_closed	integer	Número de órdenes abiertas que se cerraron
data.status	string	"inactive"
data.timestamp	string	Marca de tiempo ISO

Respuestas de error

code	msg	Causa
-1	API key required in X-API-KEY header or request body	No se proporcionó la clave API
-1	Invalid API key or IP not in whitelist	La autenticación falló
-1	Invalid TRC-20 address format	Formato de dirección inválido
-1	Database error stopping host mode	Error temporal del lado del servidor — reintente
-1	Internal server error	Error inesperado — reintente o contacte a soporte
-4	Address not found	La dirección no está en Host Mode en su cuenta
-7	Host mode is already inactive	La dirección ya está detenida

{ "code": -7, "msg": "Host mode is already inactive", "data": null }

Códigos de estado HTTP

Los errores del endpoint se devuelven con HTTP 200 y un code negativo — verifique code, no el estado HTTP. Los cuerpos de error siempre incluyen "data": null.

Algunos errores se devuelven antes de que la solicitud llegue al endpoint. Utilizan un estado distinto de 200 y una estructura de cuerpo diferente:

HTTP	Cuerpo	Causa
403	{"detail": {"code": 1005, "msg": "API key is blocked. Contact support."}}	La clave API está bloqueada — contacte a soporte
422	{"detail": [ … ]}	El cuerpo de la solicitud falló la validación: falta un campo requerido o tiene el tipo incorrecto. Tenga en cuenta que no hay un campo code en esta respuesta

Detener una dirección siempre está disponible independientemente del saldo de su cuenta.

Detener vs Eliminar

	Detener	Eliminar
Registro en Host Mode	Se conserva	Se elimina
Órdenes abiertas	Cerradas	No debe haber ninguna
Reactivación	order / infinitystart	Se debe usar add nuevamente
URL de callback	Se conserva	Se elimina

Endpoints relacionados

• POST /apiv2/time/infinitystart — reactivar la dirección (infinito)
• POST /apiv2/time/order — reactivar con un número fijo de ciclos
• POST /apiv2/time/status — verificar el estado
• POST /apiv2/time/delete — eliminar la dirección por completo

Notas

• Detener mantiene la dirección en Host Mode; se puede reactivar en cualquier momento.
• Los ciclos ordenados restantes no se transfieren — el contador de ciclos utilizados se restablece al detener.