POST /apiv2/time/delete

从 Host Mode 中完全移除一个 TRON 地址。默认情况下，该地址必须已处于未激活（已停止）状态且没有未结订单；传入 "stop": true 可以在单次调用中停止并删除它。

端点 URL

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

认证

在请求体（api_key）或 X-API-KEY 请求头中提供您的 API 密钥。请求 IP 必须处于为您 API 密钥配置的白名单中。

请求体

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

参数

参数	类型	必填	描述
api_key	string	是	API 密钥（或 X-API-KEY 请求头）。
address	string	是	TRON (TRC-20) 地址，^T[1-9A-HJ-NP-Za-km-z]{33}$。必须属于您的账户。
stop	boolean	否	true — 在删除前停止该地址的 Host Mode，而不是拒绝调用。免去单独向 /apiv2/time/stop 发起请求。默认为 false。

行为

• 如果不带 stop，地址必须处于未激活状态 — 如果处于激活状态，请先通过 /apiv2/time/stop 停止它 — 并且必须没有未结订单。否则调用将被拒绝并返回以下错误，且不会发生任何更改。
• 成功后，该地址将从 Host Mode 中移除，其注册的回调 URL（如果有）也将被删除。
• 相同地址后续可以通过 /apiv2/time/add 重新添加。

stop

带有 "stop": true 时，处于激活状态的地址将在单次调用中被停止并删除 — 其效果等同于先调用 /apiv2/time/stop 然后调用 /apiv2/time/delete，执行的操作也完全相同：关闭该地址的所有未结订单，关闭 Host Mode，重置周期计数器，并将停止操作记录到您的操作历史中。只有在完成这些之后，地址才会被删除。

这两个步骤在同一个事务中运行：要么地址被停止并删除，要么完全不发生任何更改。绝不会出现地址已停止但仍处于注册状态的情况。

该标志仅在有需要停止的内容时才会生效。对于已经处于未激活状态且没有未结订单的地址，它不会改变任何行为 — 调用的行为与不带该标志时完全一致，响应也是常规的删除响应。

计费不受影响：停止不会退还任何费用，删除也不会收取任何费用。已经代理的周期仍将计费，当前代理到该地址的 Energy 将按正常计划回收。请参阅 Host Mode → 周期与定价。

请求示例

cURL

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

单次调用中停止并删除：

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,  # optional: stop Host Mode on the address instead of failing
    },
    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, // optional: stop Host Mode on the address instead of failing
}).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));

响应

成功 (200 OK)

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

先停止地址后的成功响应 ("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"
    }
}

响应字段

字段	类型	描述
code	integer	0 = 成功，负数 = 错误
msg	string	人类可读的消息。当地址作为调用的一部分被停止时，显示为 Address stopped and deleted from Host Mode successfully
data.address	string	被移除的地址
data.stopped	boolean	仅在 Host Mode 作为本次调用的一部分被停止时出现。常规删除时不存在
data.orders_closed	integer	该次停止所关闭的未结订单数量。仅与 stopped 一同出现
data.timestamp	string	ISO 时间戳

错误响应

所有错误均使用 code = -1：

msg	原因
API key required in X-API-KEY header or request body	未提供 API 密钥
Invalid API key or IP not in whitelist	认证失败
Invalid TRC-20 address format	地址格式错误
Address not found or does not belong to you	地址未在您的账户下注册
Cannot delete an active address. Stop Host mode first	地址处于激活状态且未设置 stop — 请先调用 /apiv2/time/stop，或传入 "stop": true 重试
Cannot delete address with active orders	地址仍有未结订单且未设置 stop — 请传入 "stop": true 重试
Failed to delete address	无法移除地址 — 请重试
Database error deleting address	服务端临时错误 — 请重试
Internal server error	意外错误 — 请重试或联系客服

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

HTTP 状态码

端点错误以 HTTP 200 和负数 code 返回 — 请检查 code，而不是 HTTP 状态码。错误响应体始终包含 "data": null。

部分错误会在请求到达端点之前返回。它们使用非 200 状态码和不同的响应体结构：

HTTP	响应体	原因
403	{"detail": {"code": 1005, "msg": "API key is blocked. Contact support."}}	API 密钥已被封禁 — 请联系客服
422	{"detail": [ … ]}	请求体未通过验证：缺少必填字段或类型错误。注意此响应中没有 code 字段

无论您的账户余额如何，删除地址始终可用。

相关端点

• POST /apiv2/time/stop — 在删除前停止地址
• POST /apiv2/time/status — 检查状态和未结订单
• POST /apiv2/time/add — 后续重新添加地址

注意事项

• 删除同时也会移除该地址的回调 URL。
• 仅允许删除没有未结订单的未激活地址 — 请先通过 /apiv2/time/stop 停止它，或在此处传入 "stop": true 由系统为您停止。
• 相同地址可以随时重新添加。