POST /apiv2/time/delete

Remove a TRON address from Host Mode entirely. The address must be inactive (stopped) and have no open orders.

Endpoint URL

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

Authentication

Provide your API key in the request body (api_key) or the X-API-KEY header. The request IP must be in the whitelist configured for your API key.

Request Body

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

Parameters

Parameter	Type	Required	Description
api_key	string	Yes	API key (or X-API-KEY header).
address	string	Yes	TRON (TRC-20) address, ^T[1-9A-HJ-NP-Za-km-z]{33}$. Must belong to your account.

Behaviour

• The address must be inactive — stop it first with /apiv2/time/stop if it is active.
• The address must have no open orders.
• On success, the address is removed from Host Mode and its registered callback URL (if any) is deleted.
• The same address can be added again later with /apiv2/time/add.

Example Requests

cURL

curl -X POST https://netts.io/apiv2/time/delete \
  -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/delete",
    json={"api_key": "YOUR_API_KEY_HERE", "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE"},
    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',
}).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));

Response

Success (200 OK)

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

Response Fields

Field	Type	Description
code	integer	0 = success, negative = error
msg	string	Human-readable message
data.address	string	The address that was removed
data.timestamp	string	ISO timestamp

Error Responses

All errors use code = -1:

msg	Cause
API key required in X-API-KEY header or request body	No API key provided
Invalid API key or IP not in whitelist	Authentication failed
Invalid TRC-20 address format	Bad address format
Address not found or does not belong to you	Address is not registered under your account
Cannot delete an active address. Stop Host mode first	Address is active — call /apiv2/time/stop first
Cannot delete address with active orders	The address still has open orders
Failed to delete address	The address could not be removed — retry
Database error deleting address	Temporary server-side error — retry
Internal server error	Unexpected error — retry or contact support

{ "code": -1, "msg": "Cannot delete an active address. Stop Host mode first", "data": null }

HTTP status codes

Endpoint errors are returned with HTTP 200 and a negative code — check code, not the HTTP status. Error bodies always include "data": null.

Some errors are returned before the request reaches the endpoint. They use a non-200 status and a different body shape:

HTTP	Body	Cause
403	{"detail": {"code": 1005, "msg": "API key is blocked. Contact support."}}	The API key is blocked — contact support
422	{"detail": [ … ]}	Request body failed validation: a required field is missing or has the wrong type. Note there is no code field in this response

Deleting an address is always available regardless of your account balance.

Related Endpoints

• POST /apiv2/time/stop — stop the address before deleting
• POST /apiv2/time/status — check status and open orders
• POST /apiv2/time/add — add the address again later

Notes

• Deleting also removes the address's callback URL.
• Delete is only allowed for inactive addresses with no open orders — stop it first if needed.
• The same address can be re-added at any time.