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 → Cycles and Pricing.

У 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

Пов'язані ендпоінти

• POST /apiv2/time/add — спочатку додайте адресу
• POST /apiv2/time/order — замість цього купіть фіксовану кількість циклів
• POST /apiv2/time/stop — зупиніть нескінченний режим
• POST /apiv2/time/status — перевірте статус

Примітки

• Нескінченний режим працює, доки ви не зупините його за допомогою /apiv2/time/stop.
• Підтримуйте достатній доступний баланс — плата за цикли стягується під час їх делегування.
• Використовуйте цей ендпоінт, щоб відновити роботу адреси, яка була раніше зупинена (вона має бути неактивною).