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
}
}
}
Параметры ответа
Параметр | Тип | Описание |
---|---|---|
1h | string | Цена за 1 час аренды энергии в TRX |
24h | string | Цена за 24 часа аренды энергии в TRX |
weekly | string | Цена за неделю аренды энергии в TRX |
monthly | string | Цена за месяц аренды энергии в TRX |
current_period | string | Текущий период (peak/off_peak/normal) |
peak_hours | object | Информация о пиковых часах |
peak_hours.start | string | Начало пиковых часов (UTC) |
peak_hours.end | string | Конец пиковых часов (UTC) |
peak_hours.price_multiplier | float | Множитель цены в пиковые часы |
off_peak_hours | object | Информация о непиковых часах |
off_peak_hours.start | string | Начало непиковых часов (UTC) |
off_peak_hours.end | string | Конец непиковых часов (UTC) |
off_peak_hours.price_multiplier | float | Множитель цены в непиковые часы |
Ошибки
Ошибка аутентификации (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 минут