POST /apiv2/time/infinitystart

Увімкнути нескінченний (unlimited) режим для адреси, яка вже перебуває в Host Mode — Energy продовжує делегуватися цикл за циклом, доки ви її не зупините.

URL кінцевої точки

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

Автентифікація

Вкажіть ваш API-ключ у тілі запиту (api_key) або в заголовку X-API-KEY. 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 → Цикли та ціноутворення і Денний мінімум.

У Time Status нескінченна адреса повертає значення 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.
• Підтримуйте достатній доступний баланс — плата за цикли стягується в міру їх делегування.
• Використовуйте цей ендпоінт для відновлення роботи адреси, яку раніше було зупинено (вона має бути неактивною).