POST /apiv2/time/order

Придбати визначену кількість циклів делегування Energy для адреси та активувати для неї Host Mode.

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

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

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

Вкажіть ваш API-ключ у тілі запиту (api_key) або в заголовку X-API-KEY. IP-адреса запиту має бути у білому списку, налаштованому для вашого API-ключа.

Тіло запиту

{
    "api_key": "your_api_key",
    "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
    "cycles": 10
}

Параметри

Параметр	Тип	Обов'язковий	Опис
api_key	string	Так	API-ключ (або заголовок X-API-KEY).
address	string	Так	TRON (TRC-20) адреса, ^T[1-9A-HJ-NP-Za-km-z]{33}$.
cycles	integer	Так	Кількість циклів для купівлі. Має бути ≥ 1.

Ціноутворення та тарифікація

• Замовлення циклів не стягує кошти авансом. Кожен цикл оплачується в момент делегування відповідної Energy: перше делегування активації коштує 4 TRX, кожне наступне — 2 або 4 TRX залежно від Energy, яку фактично спожив ваш попередній переказ (≤65 000 → 2 TRX, більше → 4 TRX). Дивіться Host Mode → Cycles and Pricing для ознайомлення з повними правилами, включно з денним мінімумом у 8 TRX (набуває чинності з 2026-08-29).
• Значення amount у відповіді є оцінкою (cycles × reference price), а не остаточною сумою.
• Ваш баланс перевіряється перед прийняттям замовлення; якщо він не може покрити замовлення, воно відхиляється (помилка -2).

Оформлення замовлення переводить адресу в стан active і створює відкрите замовлення на запитану кількість циклів. Після цього адреса починає отримувати делегування Energy цикл за циклом, і кожне делегування оплачується безпосередньо під час його здійснення.

Приклади запитів

cURL

curl -X POST https://netts.io/apiv2/time/order \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "YOUR_API_KEY_HERE",
    "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
    "cycles": 10
  }'

Python

import requests

resp = requests.post(
    "https://netts.io/apiv2/time/order",
    json={
        "api_key": "YOUR_API_KEY_HERE",
        "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
        "cycles": 10,
    },
    timeout=30,
)
result = resp.json()

if result["code"] == 0:
    d = result["data"]
    print(f"Order {d['order_id']}: {d['cycles']} cycles for {d['amount']} TRX")
else:
    print("Error:", result["msg"])

Node.js

const axios = require('axios');

axios.post('https://netts.io/apiv2/time/order', {
    api_key: 'YOUR_API_KEY_HERE',
    address: 'TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE',
    cycles: 10,
}).then(({ data: result }) => {
    if (result.code === 0) {
        const d = result.data;
        console.log(`Order ${d.order_id}: ${d.cycles} cycles for ${d.amount} TRX`);
    } else {
        console.error('Error:', result.msg);
    }
}).catch(err => console.error('Request failed:', err.response?.data || err.message));

Відповідь

Успішно (200 OK)

{
    "code": 0,
    "msg": "Cycles purchased and host mode activated successfully",
    "data": {
        "order_id": 5426,
        "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
        "cycles": 10,
        "amount": 23.5,
        "status": "active",
        "timestamp": "2026-07-13T05:30:15.123456"
    }
}

Поля відповіді

Поле	Тип	Опис
code	integer	0 = успіх, від'ємне = помилка
msg	string	Зрозуміле для людини повідомлення
data.order_id	integer	Внутрішній ідентифікатор замовлення
data.address	string	Адреса, для якої було придбано цикли
data.cycles	integer	Кількість придбаних циклів
data.amount	number	Орієнтовна загальна вартість замовлення у TRX (лише для довідки — тарифікація здійснюється за кожне делегування)
data.status	string	"active" після успішного замовлення
data.timestamp	string	ISO-мітка часу замовлення

Відповіді з помилками

code	msg	Причина
-1	Invalid API key or IP not in whitelist	Помилка автентифікації
-1	Invalid TRC-20 address format	Невірний формат адреси
-1	Cycle count must be 1 or more	cycles < 1
-1	Database error processing order	Тимчасова помилка на стороні сервера — повторіть спробу
-2	Insufficient balance. Required: X TRX, Available: Y TRX	Баланс нижчий за загальну суму замовлення
-6	Cannot buy cycles: There is an open order with … cycles for this address	Відкрите замовлення вже існує (включно з нескінченним)

{
    "code": -2,
    "msg": "Insufficient balance. Required: 23.5 TRX, Available: 10.0 TRX"
}

Пов'язані кінцеві точки

• POST /apiv2/time/add — спочатку додати адресу
• POST /apiv2/time/infinitystart — необмежена кількість циклів замість фіксованої кількості
• POST /apiv2/time/status — перевірити залишок циклів
• POST /apiv2/time/stop — зупинити та закрити замовлення

Примітки

• Якщо адреса ще не перебуває в режимі Host Mode, замовлення також реєструє та активує її.
• Одночасно дозволено лише одне відкрите замовлення на одну адресу.
• Придбані цикли витрачаються по одному на кожне делегування; коли вони закінчуються, робота адреси автоматично зупиняється.