POST /apiv2/time/stop

为 TRON 地址停止 Host Mode：关闭其未完成的订单并将其停用。该地址仍保留在 Host Mode 的注册列表中，并可在日后重新激活。

接口 URL

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

认证

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

请求体

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

参数

参数	类型	必填	说明
api_key	string	是	API 密钥（或 X-API-KEY 请求头）。
address	string	是	TRON (TRC-20) 地址，^T[1-9A-HJ-NP-Za-km-z]{33}$。必须处于 Host Mode 且当前为活跃状态。

行为

停止一个地址：

• 关闭其所有未完成的订单。
• 将 Host Mode 设置为未激活（status = 0，cycle_set = 0）。
• 重置该地址的已使用周期计数器。
• 在您重新激活它之前（使用 /apiv2/time/order 或 /apiv2/time/infinitystart），不会委托新的 Energy。

该地址本身仍保留在 Host Mode 中；如需彻底移除，请使用 /apiv2/time/delete。

请求示例

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

响应

成功 (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"
    }
}

响应字段

字段	类型	说明
code	integer	0 = 成功，负数 = 错误
msg	string	人类可读的消息
data.address	string	被停止的地址
data.orders_closed	integer	已关闭的未完成订单数量
data.status	string	"inactive"
data.timestamp	string	ISO 时间戳

错误响应

code	msg	原因
-1	API key required in X-API-KEY header or request body	未提供 API 密钥
-1	Invalid API key or IP not in whitelist	认证失败
-1	Invalid TRC-20 address format	地址格式错误
-1	Database error stopping host mode	临时服务端错误 — 请重试
-1	Internal server error	未知错误 — 请重试或联系客服
-4	Address not found	该地址未在您的账户下开启 Host Mode
-7	Host mode is already inactive	该地址已经处于停止状态

{ "code": -7, "msg": "Host mode is already inactive", "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 字段

无论您的账户余额如何，停止地址操作始终可用。

Stop 与 Delete 的区别

	Stop	Delete
Host Mode 注册状态	保留	移除
未完成订单	关闭	必须为零
重新激活	order / infinitystart	必须重新 add
回调 URL	保留	移除

相关接口

• POST /apiv2/time/infinitystart — 重新激活地址（无限模式）
• POST /apiv2/time/order — 按固定周期数重新激活
• POST /apiv2/time/status — 查询状态
• POST /apiv2/time/delete — 彻底移除地址

注意事项

• 停止操作会保留该地址在 Host Mode 中的状态；可随时重新激活。
• 剩余的订购周期不会结转 — 已使用周期计数器会在停止时重置。