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 rate is not flat: the first two delegations after activation are charged at a higher rate, and from the third onward it follows how much energy your previous transfer actually consumed.

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

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