POST /apiv2/time/order

Заказ определенного количества циклов для адреса в Host Mode.

URL эндпоинта

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

Заголовки запроса

Заголовок	Обязательный	Описание
Content-Type	Да	application/json
X-API-KEY	Да	Ваш API ключ

Тело запроса

{
    "address": "TExampleAddress1234567890123456789",
    "cycles": 10
}

Параметры запроса

Параметр	Тип	Обязательный	Описание
address	string	Да	TRC-20 адрес из вашего Host Mode списка
cycles	integer	Да	Количество циклов для заказа (положительное число)

Примеры запросов

cURL

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

Python

import requests

url = "https://netts.io/apiv2/time/order"
headers = {"X-API-KEY": "your_api_key"}
data = {
    "address": "TExampleAddress1234567890123456789",
    "cycles": 10
}

response = requests.post(url, headers=headers, json=data)
result = response.json()

if response.status_code == 200:
    print(f"Заказано {result['data']['cycles_ordered']} циклов")
    print(f"Всего циклов: {result['data']['new_total_cycles']}")
else:
    print(f"Ошибка: {result.get('msg')}")

Node.js

const axios = require('axios');

const url = 'https://netts.io/apiv2/time/order';
const headers = {'X-API-KEY': 'your_api_key'};
const data = {
    address: 'TExampleAddress1234567890123456789',
    cycles: 10
};

async function orderCycles() {
    try {
        const response = await axios.post(url, data, { headers });
        const result = response.data.data;
        console.log(`Заказано ${result.cycles_ordered} циклов`);
        console.log(`Всего циклов: ${result.new_total_cycles}`);
    } catch (error) {
        console.error('Error:', error.response.data.msg);
    }
}

orderCycles();

PHP

<?php
$url = 'https://netts.io/apiv2/time/order';
$headers = ['Content-Type: application/json', 'X-API-KEY: your_api_key'];
$data = json_encode([
    'address' => 'TExampleAddress1234567890123456789',
    'cycles' => 10
]);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($httpCode == 200) {
    $result = json_decode($response, true);
    echo "Заказано: " . $result['data']['cycles_ordered'] . " циклов\n";
    echo "Всего: " . $result['data']['new_total_cycles'] . " циклов\n";
} else {
    $error = json_decode($response, true);
    echo "Ошибка: " . $error['msg'] . "\n";
}
?>

Ответ

Успешный ответ (200 OK)

{
    "code": 0,
    "msg": "Cycles ordered successfully",
    "data": {
        "address": "TExampleAddress1234567890123456789",
        "cycles_ordered": 10,
        "new_total_cycles": 15,
        "cost_trx": "2.50",
        "order_timestamp": "2025-08-16T10:40:30"
    }
}

Параметры ответа

Параметр	Тип	Описание
address	string	TRC-20 адрес
cycles_ordered	integer	Количество заказанных циклов
new_total_cycles	integer	Общее количество циклов после заказа
cost_trx	string	Стоимость заказа в TRX
order_timestamp	string	Время создания заказа

Ошибки

Адрес не найден (404)

{
    "code": -4,
    "msg": "Address not found in Host Mode",
    "data": null
}

Недостаточный баланс (400)

{
    "code": -3,
    "msg": "Insufficient balance",
    "data": {
        "required": "2.50",
        "available": "1.20"
    }
}

Неверное количество циклов (400)

{
    "code": -4,
    "msg": "Invalid cycles value",
    "data": null
}

Примечания

• Один цикл обеспечивает энергией примерно на 3 дня
• Стоимость зависит от текущих цен на энергию
• Циклы добавляются к существующему количеству
• Минимальный заказ: 1 цикл, максимальный: 100 циклов за один запрос