POST /apiv2/time/delete

Elimina una dirección TRON de Host Mode por completo. Por defecto, la dirección ya debe estar inactiva (detenida) y no tener órdenes abiertas; pase "stop": true para detenerla y eliminarla en una sola llamada.

URL del Endpoint

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

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",
    "stop": true
}

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 pertenecer a su cuenta.
stop	boolean	No	true — detiene Host Mode en la dirección antes de eliminarla, en lugar de rechazar la llamada. Ahorra una solicitud separada a /apiv2/time/stop. El valor por defecto es false.

Comportamiento

• Sin stop, la dirección debe estar inactiva — deténgala primero con /apiv2/time/stop si está activa — y no debe tener órdenes abiertas. De lo contrario, la llamada se rechaza con los errores detallados a continuación y no se modifica nada.
• En caso de éxito, la dirección se elimina de Host Mode y su URL de callback registrada (si existe) se elimina.
• La misma dirección puede volver a agregarse más tarde con /apiv2/time/add.

stop

Con "stop": true, una dirección activa se detiene y se elimina en una sola llamada — el mismo resultado que llamar a /apiv2/time/stop y luego a /apiv2/time/delete, y exactamente las mismas acciones: se cierran todas las órdenes abiertas para la dirección, se desactiva Host Mode, se restablece el contador de ciclos y la detención se registra en su historial de acciones. Solo entonces se elimina la dirección.

Ambos pasos se ejecutan en una sola transacción: o bien la dirección se detiene y se elimina, o no cambia nada en absoluto. No existe ningún estado en el que la dirección quede detenida pero todavía registrada.

El flag solo tiene relevancia cuando hay algo que detener. En una dirección que ya está inactiva y no tiene órdenes abiertas no cambia nada — la llamada se comporta exactamente igual que sin él, y la respuesta es la respuesta de eliminación simple.

La facturación no se ve afectada: detener no reembolsa nada y eliminar no genera ningún cargo. Los ciclos ya delegados permanecen cobrados, y la Energy actualmente delegada a la dirección se recupera según su cronograma habitual. Consulte Host Mode → Ciclos y Precios.

Solicitudes de Ejemplo

cURL

curl -X POST https://netts.io/apiv2/time/delete \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "YOUR_API_KEY_HERE",
    "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE"
  }'

Detener y eliminar en una sola llamada:

curl -X POST https://netts.io/apiv2/time/delete \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "YOUR_API_KEY_HERE",
    "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
    "stop": true
  }'

Python

import requests

resp = requests.post(
    "https://netts.io/apiv2/time/delete",
    json={
        "api_key": "YOUR_API_KEY_HERE",
        "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
        # "stop": True,  # opcional: detiene Host Mode en la dirección en lugar de fallar
    },
    timeout=30,
)
result = resp.json()

if result["code"] == 0:
    print("Deleted:", result["data"]["address"])
else:
    print("Error:", result["msg"])

Node.js

const axios = require('axios');

axios.post('https://netts.io/apiv2/time/delete', {
    api_key: 'YOUR_API_KEY_HERE',
    address: 'TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE',
    // stop: true, // opcional: detiene Host Mode en la dirección en lugar de fallar
}).then(({ data: result }) => {
    if (result.code === 0) console.log('Deleted:', result.data.address);
    else console.error('Error:', result.msg);
}).catch(err => console.error('Request failed:', err.response?.data || err.message));

Respuesta

Éxito (200 OK)

{
    "code": 0,
    "msg": "Address deleted from Host Mode successfully",
    "data": {
        "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
        "timestamp": "2026-07-13T05:30:15.123456"
    }
}

Éxito cuando la dirección se detuvo primero ("stop": true)

{
    "code": 0,
    "msg": "Address stopped and deleted from Host Mode successfully",
    "data": {
        "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
        "stopped": true,
        "orders_closed": 1,
        "timestamp": "2026-07-13T05:30:15.123456"
    }
}

Campos de la Respuesta

Campo	Tipo	Descripción
code	integer	0 = éxito, negativo = error
msg	string	Mensaje legible por humanos. Address stopped and deleted from Host Mode successfully cuando la dirección se detuvo como parte de la llamada
data.address	string	La dirección que fue eliminada
data.stopped	boolean	Presente únicamente cuando Host Mode se detuvo como parte de esta llamada. Ausente en una eliminación simple
data.orders_closed	integer	Cantidad de órdenes abiertas cerradas por esa detención. Presente solo junto con stopped
data.timestamp	string	Marca de tiempo ISO

Respuestas de Error

Todos los errores utilizan code = -1:

msg	Causa
API key required in X-API-KEY header or request body	No se proporcionó la clave API
Invalid API key or IP not in whitelist	Error de autenticación
Invalid TRC-20 address format	Formato de dirección inválido
Address not found or does not belong to you	La dirección no está registrada en su cuenta
Cannot delete an active address. Stop Host mode first	La dirección está activa y no se estableció stop — llame primero a /apiv2/time/stop, o repita con "stop": true
Cannot delete address with active orders	La dirección todavía tiene órdenes abiertas y no se estableció stop — repita con "stop": true
Failed to delete address	No se pudo eliminar la dirección — reintente
Database error deleting address	Error temporal del lado del servidor — reintente
Internal server error	Error inesperado — reintente o contacte a soporte

{ "code": -1, "msg": "Cannot delete an active address. Stop Host mode first", "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 obligatorio o tiene un tipo incorrecto. Tenga en cuenta que no hay un campo code en esta respuesta

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

Endpoints Relacionados

• POST /apiv2/time/stop — detener la dirección antes de eliminarla
• POST /apiv2/time/status — verificar el estado y las órdenes abiertas
• POST /apiv2/time/add — volver a agregar la dirección más tarde

Notas

• Eliminar también remueve la URL de callback de la dirección.
• La eliminación solo está permitida para direcciones inactivas sin órdenes abiertas — deténgala primero con /apiv2/time/stop, o pase "stop": true aquí para que se detenga por usted.
• La misma dirección puede volver a agregarse en cualquier momento.