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	无法激活地址 —— 请重试
-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 字段

目标地址不允许 (403)

在地址开启之前会对其进行检查。如果不允许向其委托资源，请求将被拒绝并返回 HTTP 403，且不会写入任何内容 —— 该地址保持未激活状态，也不会创建订单。响应体采用 detail 结构：

code	msg	含义
1006	Address is blocked. Contact support.	该地址已被封禁
1007	Energy rental to smart contracts is not supported.	该地址为智能合约（GasFree 钱包地址也是智能合约）
1010	Resource delegation to this address is not available.	无法向该地址委托资源
1011	This address is frozen and cannot receive resource delegation.	该地址已被冻结，无法接收资源委托

{ "detail": { "code": 1007, "msg": "Energy rental to smart contracts is not supported." } }

相关端点

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

说明

• 无限模式将持续运行，直到您调用 /apiv2/time/stop 将其停止。
• 请保持足够的可用余额 —— 周期在委托时扣费。
• 使用此端点可以恢复先前已停止的地址（该地址必须处于未激活状态）。