POST /apiv2/time/infinitystart

Включение бесконечного (unlimited) режима для адреса, уже находящегося в Host Mode — энергия продолжает делегироваться цикл за циклом, пока вы её не остановите.

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 продолжает делегировать энергию цикл за циклом, пока вы не вызовете /apiv2/time/stop.

Оплата за циклы списывается по мере их делегирования (один цикл за делегирование). Первое делегирование при активации стоит 4 TRX; каждое последующее стоит 2 или 4 TRX в зависимости от того, сколько энергии фактически потребил ваш предыдущий перевод (≤ 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	Не удалось активировать 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.
• Поддерживайте достаточный доступный баланс — оплата за циклы списывается по мере их делегирования.
• Используйте этот эндпоинт для возобновления работы адреса, который ранее был остановлен (он должен быть неактивным).