POST /apiv2/time/infinitystart

Enable infinity (unlimited) mode for an address already in Host Mode — energy keeps being delegated cycle after cycle until you stop it.

Endpoint URL

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

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}$. The address must already be in Host Mode (add it first).

Behaviour

• The address must already exist in Host Mode and be inactive (stopped).
• Your balance must cover at least one cycle at the current price (checked before activation).
• The endpoint activates the address, creates an open infinity order, and Host Mode keeps delegating energy cycle after cycle until you call /apiv2/time/stop.

Cycles are billed as they are delegated (one cycle per delegation). The first delegation of an activation costs 4 TRX; every next one costs 2 or 4 TRX depending on the energy your previous transfer actually consumed (≤ 65,000 → 2 TRX, more → 4 TRX). The 8 TRX daily minimum (effective 2026-08-29) and the 2-day idle shutdown apply in infinity mode too — see Host Mode → Cycles and Pricing and Daily minimum.

In Time Status an infinity address reports cycles_ordered and cycles_remaining as null — there is no limit to count down. Read null as “unlimited”, not as “no cycles left”.

Example Requests

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

Response

Success (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"
    }
}

Response Fields

Field	Type	Description
code	integer	0 = success, negative = error
msg	string	Human-readable message
data.address	string	The address activated in infinity mode
data.order_id	integer	Internal order identifier
data.mode	string	"infinity"
data.status	string	"active"
data.timestamp	string	ISO timestamp

Error Responses

code	msg	Cause
-1	API key required in X-API-KEY header or request body	No API key provided
-1	Invalid API key or IP not in whitelist	Authentication failed
-1	Invalid TRC-20 address format	Bad address format
-1	Failed to activate host mode	The address could not be activated — retry
-1	Database error activating infinity mode	Temporary server-side error — retry
-1	Internal server error	Unexpected error — retry or contact support
-2	Insufficient balance. Required: X TRX, Available: Y TRX	Balance below one cycle price
-4	Address not found. Please add address first	Address not in Host Mode
-5	Host mode is already active for this address	Address is already running
-6	There is already an open order for this address	An open order already exists

{ "code": -4, "msg": "Address not found. Please add address 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
402	{"detail": {"code": 1004, "msg": "Insufficient funds. Minimum balance is 4 TRX. Please top up your account."}}	Account balance is too low
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

Destination address not allowed (403)

The address is checked before it is switched on. If resource delegation to it is not allowed, the request is rejected with HTTP 403 and nothing is written — the address stays inactive and no order is created. The body uses the detail shape:

code	msg	Meaning
1006	Address is blocked. Contact support.	The address is blocked
1007	Energy rental to smart contracts is not supported.	The address is a smart contract (GasFree wallet addresses are smart contracts too)
1010	Resource delegation to this address is not available.	Delegation to this address is not available
1011	This address is frozen and cannot receive resource delegation.	The address is frozen

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

Related Endpoints

• POST /apiv2/time/add — add the address first
• POST /apiv2/time/order — buy a fixed number of cycles instead
• POST /apiv2/time/stop — stop infinity mode
• POST /apiv2/time/status — check status

Notes

• Infinity mode runs until you stop it with /apiv2/time/stop.
• Keep enough balance available — cycles are charged as they are delegated.
• Use this endpoint to resume an address that was previously stopped (it must be inactive).