Skip to content

POST /apiv2/prices

Получение текущих цен на аренду энергии для разных периодов времени.

URL эндпоинта

POST https://netts.io/apiv2/prices

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

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

Тело запроса

json
{}

Запрос не требует параметров в теле.

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

cURL

bash
curl -X POST https://netts.io/apiv2/prices \
  -H "Content-Type: application/json" \
  -H "X-API-KEY: your_api_key" \
  -H "X-Real-IP: your_whitelisted_ip" \
  -d '{}'

Python

python
import requests
import json

url = "https://netts.io/apiv2/prices"
headers = {
    "Content-Type": "application/json",
    "X-API-KEY": "your_api_key",
    "X-Real-IP": "your_whitelisted_ip"
}

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

if response.status_code == 200:
    print("Текущие цены на энергию:")
    prices = data.get('data', {})
    for period, price in prices.items():
        print(f"{period}: {price} TRX")
else:
    print(f"Ошибка: {data.get('msg')}")

Node.js

javascript
const axios = require('axios');

const url = 'https://netts.io/apiv2/prices';
const headers = {
    'Content-Type': 'application/json',
    'X-API-KEY': 'your_api_key',
    'X-Real-IP': 'your_whitelisted_ip'
};

async function getPrices() {
    try {
        const response = await axios.post(url, {}, { headers });
        const prices = response.data.data;
        console.log('Текущие цены на энергию:');
        Object.entries(prices).forEach(([period, price]) => {
            console.log(`${period}: ${price} TRX`);
        });
    } catch (error) {
        console.error('Error:', error.response.data);
    }
}

getPrices();

PHP

php
<?php
$url = 'https://netts.io/apiv2/prices';
$headers = [
    'Content-Type: application/json',
    'X-API-KEY: your_api_key',
    'X-Real-IP: your_whitelisted_ip'
];

$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, '{}');

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

if ($httpCode == 200) {
    $data = json_decode($response, true);
    echo "Текущие цены на энергию:\n";
    foreach ($data['data'] as $period => $price) {
        echo "$period: $price TRX\n";
    }
} else {
    echo "Error: HTTP $httpCode\n";
    echo $response;
}
?>

Ответ

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

json
{
    "code": 0,
    "msg": "Success",
    "data": {
        "1h": "0.50",
        "24h": "10.00",
        "weekly": "65.00",
        "monthly": "250.00",
        "current_period": "peak",
        "peak_hours": {
            "start": "11:00",
            "end": "21:00",
            "price_multiplier": 1.2
        },
        "off_peak_hours": {
            "start": "23:00",
            "end": "07:00",
            "price_multiplier": 0.8
        }
    }
}

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

ПараметрТипОписание
1hstringЦена за 1 час аренды энергии в TRX
24hstringЦена за 24 часа аренды энергии в TRX
weeklystringЦена за неделю аренды энергии в TRX
monthlystringЦена за месяц аренды энергии в TRX
current_periodstringТекущий период (peak/off_peak/normal)
peak_hoursobjectИнформация о пиковых часах
peak_hours.startstringНачало пиковых часов (UTC)
peak_hours.endstringКонец пиковых часов (UTC)
peak_hours.price_multiplierfloatМножитель цены в пиковые часы
off_peak_hoursobjectИнформация о непиковых часах
off_peak_hours.startstringНачало непиковых часов (UTC)
off_peak_hours.endstringКонец непиковых часов (UTC)
off_peak_hours.price_multiplierfloatМножитель цены в непиковые часы

Ошибки

Ошибка аутентификации (401)

json
{
    "code": -1,
    "msg": "Invalid API key or IP not in whitelist",
    "data": null
}

Превышен лимит запросов (429)

json
{
    "code": -5,
    "msg": "Rate limit exceeded",
    "data": null
}

Примечания

  • Все цены указаны в TRX
  • Цены могут изменяться в зависимости от времени суток (UTC)
  • Пиковые часы обычно с 11:00 до 21:00 UTC
  • В непиковые часы действует скидка до 20%
  • Цены обновляются каждые 5 минут