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.
• Поддерживайте достаточный баланс — списание за циклы происходит по мере их делегирования.
• Используйте этот эндпоинт для возобновления работы адреса, который ранее был остановлен (он должен быть неактивным).