POST /apiv2/time/infinitystart

为已处于 Host Mode 的地址启用无限（infinity）模式 —— Energy 将在一个接一个的周期中持续被质押代理，直到您主动停止。

端点 URL

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

身份验证

在请求体（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 中且处于非活跃（已停止）状态。
• 您的余额必须足以支付当前价格下的至少一个周期（在激活前检查）。
• 该端点会激活该地址，创建一个开放的无限模式订单，并且 Host Mode 会持续逐个周期质押代理 Energy，直到您调用 /apiv2/time/stop。

周期在质押代理发生时扣费（每次代理计为一个周期）。激活后的首次代理费用为 4 TRX；随后的每次代理费用为 2 或 4 TRX，取决于您上一次转账实际消耗的 Energy（≤ 65,000 → 2 TRX，超出 → 4 TRX）。每日 8 TRX 的最低消费（自 2026-08-29 起生效）以及 2 天闲置自动停机规则同样适用于无限模式 —— 详见 Host Mode → 周期与定价。

在时间状态中，处于无限模式的地址其 cycles_ordered 和 cycles_remaining 会报告为 null —— 因为没有需要倒计时的上限限制。请将 null 理解为“无限制”，而非“无剩余周期”。

请求示例

cURL

curl -X POST https://netts.io/apiv2/time/infinitystart \
  -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/infinitystart",
    json={"api_key": "YOUR_API_KEY_HERE", "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE"},
    timeout=30,
)
result = resp.json()

if result["code"] == 0:
    print("Infinity mode active, order:", result["data"]["order_id"])
else:
    print("Error:", result["msg"])

Node.js

const axios = require('axios');

axios.post('https://netts.io/apiv2/time/infinitystart', {
    api_key: 'YOUR_API_KEY_HERE',
    address: 'TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE',
}).then(({ data: result }) => {
    if (result.code === 0) console.log('Infinity mode active, order:', result.data.order_id);
    else console.error('Error:', result.msg);
}).catch(err => console.error('Request failed:', err.response?.data || err.message));

响应

成功 (200 OK)

{
    "code": 0,
    "msg": "Infinity mode activated successfully",
    "data": {
        "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
        "order_id": 5427,
        "mode": "infinity",
        "status": "active",
        "timestamp": "2026-07-13T05:30:15.123456"
    }
}

响应字段

字段	类型	描述
code	integer	0 = 成功，负数 = 错误
msg	string	人类可读的消息
data.address	string	在无限模式下激活的地址
data.order_id	integer	内部订单标识符
data.mode	string	"infinity"
data.status	string	"active"
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	Failed to activate host mode	无法激活 Host Mode —— 请重试
-1	Database error activating infinity mode	激活无限模式时发生临时服务端错误 —— 请重试
-1	Internal server error	非预期错误 —— 请重试或联系支持人员
-2	Insufficient balance. Required: X TRX, Available: Y TRX	余额低于单周期价格
-4	Address not found. Please add address first	地址不在 Host Mode 中
-5	Host mode is already active for this address	该地址已处于运行状态
-6	There is already an open order for this address	该地址已存在未完成的订单

{ "code": -4, "msg": "Address not found. Please add address first", "data": null }

HTTP 状态码

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

某些错误会在请求到达端点之前返回。它们使用非 200 状态码以及不同的响应体格式：

HTTP	响应体	原因
402	{"detail": {"code": 1004, "msg": "Insufficient funds. Minimum balance is 4 TRX. Please top up your account."}}	账户余额过低
403	{"detail": {"code": 1005, "msg": "API key is blocked. Contact support."}}	API 密钥已被封禁 —— 请联系支持人员
422	{"detail": [ … ]}	请求体未通过验证：缺少必填字段或类型错误。请注意，此响应中没有 code 字段

相关端点

• POST /apiv2/time/add — 先添加地址
• POST /apiv2/time/order — 改为购买固定数量的周期
• POST /apiv2/time/stop — 停止无限模式
• POST /apiv2/time/status — 查询状态

注意事项

• 无限模式将持续运行，直到您使用 /apiv2/time/stop 停止它。
• 请保持足够的可用余额 —— 费用将在周期质押代理发生时收取。
• 使用此端点可以恢复之前已停止的地址（该地址必须处于非活跃状态）。