Цены — Справочник API

Таблица цен, котировки и предварительный расчет стоимости.

Сгенерировано из openapi.yaml во время сборки. Базовый URL https://api.tenergy.me/v1 или https://api-nile.tenergy.me/v1 в сети Nile (Окружения). Каждый запрос ниже подписывается в соответствии с разделом Аутентификация, если в строке Аутентификация не указано иное.

Текущая таблица цен

GET /v1/prices · getPrices

Аутентификация: Публичный — учетные данные не требуются; запрос с API-ключом (HMAC) также принимается.

Все доступные для покупки ресурсы с ценами для каждого тарифа и объема. Цены меняются в зависимости от времени суток, поэтому ответ содержит окно актуальности (valid_until), текущий тарифный период и суточное расписание schedule с часовой ценой энергии для каждого периода.

Используйте этот эндпоинт для отображения тарифов. Чтобы зафиксировать цену для заказа, запросите котировку (POST /v1/quotes) — записи в таблице цен носят справочный характер и не являются обязывающими.

Публичный. Учетные данные не требуются; для анонимных вызовов действует лимит по IP. Подписанный запрос расходует лимит вызовов соответствующего ключа.

Параметры

Ответы

Поля ответа (PriceTable)

Пример ответа 200 из контракта (значения для иллюстрации):

{
  "network": "mainnet",
  "as_of": "2026-09-11T18:04:05.123Z",
  "valid_until": "2026-09-11T18:09:05.123Z",
  "period": {"id":"peak_late","label":"Late peak","start":"16:00","end":"00:00"},
  "schedule": [
    {
      "id": "drop",
      "label": "Drop",
      "start_utc_minute": 0,
      "end_utc_minute": 60,
      "factor_bps": 13500,
      "price_sun_per_unit": 27
    },
    {
      "id": "off_peak",
      "label": "Off-peak",
      "start_utc_minute": 60,
      "end_utc_minute": 540,
      "factor_bps": 10000,
      "price_sun_per_unit": 20
    },
    {
      "id": "ramp_9",
      "label": "Morning ramp",
      "start_utc_minute": 540,
      "end_utc_minute": 660,
      "factor_bps": 11000,
      "price_sun_per_unit": 22
    },
    {
      "id": "ramp_11",
      "label": "Midday ramp",
      "start_utc_minute": 660,
      "end_utc_minute": 720,
      "factor_bps": 12000,
      "price_sun_per_unit": 24
    },
    {
      "id": "ramp_12",
      "label": "Pre-peak ramp",
      "start_utc_minute": 720,
      "end_utc_minute": 840,
      "factor_bps": 15000,
      "price_sun_per_unit": 30
    },
    {
      "id": "peak",
      "label": "Peak",
      "start_utc_minute": 840,
      "end_utc_minute": 960,
      "factor_bps": 17000,
      "price_sun_per_unit": 34
    },
    {
      "id": "peak_late",
      "label": "Late peak",
      "start_utc_minute": 960,
      "end_utc_minute": 1440,
      "factor_bps": 15000,
      "price_sun_per_unit": 30
    }
  ],
  "available_energy": 412000000,
  "delivered_today": 80600000,
  "available_bandwidth": 1800000,
  "items": [
    {
      "resource": "energy",
      "tier": "1h",
      "price_sun_per_unit": 30,
      "min_amount": 32000,
      "max_amount": 3000000,
      "volume_tiers": []
    }
  ],
  "activation": {"price_sun":1200000}
}

Публичная витрина рынка аренды энергии

GET /v1/market · getMarket

Аутентификация: Публичный — учетные данные не требуются; запрос с API-ключом (HMAC) также принимается.

Последние собранные цены на энергию на 1 час и 1 день по публичным поставщикам (обновляется каждые 5 минут), плюс строка TEnergy. Сортировка по price_sun_1h по возрастанию. savings_pct = 1 − price / burn_sun; stale = данные старше 15 минут.

Ответы

Поля ответа (MarketBoard)

История цен конкретного провайдера

GET /v1/market/history · getMarketHistory

Аутентификация: Публичный — учетные данные не требуются; запрос с API-ключом (HMAC) также принимается.

Точки исторических данных по поставщику (от старых к новым). Неизвестный slug возвращает пустой ряд.

Параметры

Ответы

Поля ответа

Книга заявок (ask ladder) по ресурсу и тарифу

GET /v1/orderbook · getOrderBook

Аутентификация: Публичный — учетные данные не требуются.

Гарантированная поставка по ступенчатой цене. Платформа публикует лестницу уровней (объем @ цена, от дешевых к дорогим). Заказ последовательно заполняет уровни: первые единицы берутся с самого дешевого уровня, следующие — со следующего. Больший объем оплачивается по средневзвешенной цене. Дефицита нет: статус «распродано» исключен.

Классы исполнения:

Параметры

Ответы

Поля ответа (OrderBook)

Пример ответа 200 из контракта (значения для иллюстрации):

{
  "resource": "energy",
  "tier": "1h",
  "as_of": "2026-09-19T18:04:05.123Z",
  "valid_until": "2026-09-19T18:04:08.123Z",
  "floor_sun": 20,
  "depth": 14200000,
  "levels": [
    {"price_sun":30,"amount":1200000,"class":"instant"},
    {"price_sun":34,"amount":3000000,"class":"market"},
    {"price_sun":58,"amount":10000000,"class":"deep"}
  ],
  "walk": null,
  "cheaper_from": "2026-09-20T01:00:00.000Z"
}

Быстрый предварительный расчет стоимости

GET /v1/estimate · estimateOrder

Аутентификация: Публичный — учетные данные не требуются; запрос с API-ключом (HMAC) также принимается.

Ориентировочная стоимость заказа прямо сейчас без создания объектов и резервирования цен. Легковесный запрос, безопасен для вызова на каждый ввод пользователя.

Расчет не является обязывающим. Для фиксации точной стоимости создайте котировку (POST /v1/quotes) и укажите quote_id при создании заказа.

Параметры

Ответы

Поля ответа (Estimate)

Пример ответа 200 из контракта (значения для иллюстрации):

{
  "resource": "energy",
  "amount": 65000,
  "tier": "1h",
  "receiver": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
  "price_sun_per_unit": 20,
  "energy_amount_sun": 1300000,
  "activate_amount_sun": 0,
  "total_amount_sun": 1300000,
  "receiver_activated": true,
  "as_of": "2026-09-11T18:04:05.123Z"
}

Создание фиксированной котировки

POST /v1/quotes · createQuote

Аутентификация: API-ключ (HMAC).

Фиксирует цену на короткий промежуток времени. Передайте полученный id в поле quote_id при создании заказа, и с вас будет списана точная сумма total_amount_sun, даже если за это время сменился тарифный период.

Котировка бронирует цену, но не резервирует объем. Если объем исчерпан до размещения заказа, заказ завершится с ошибкой 5001 insufficient_supply без списания средств.

Параметры

Тело запроса

JSON (QuoteRequest), обязательно.

Пример тела запроса из контракта (значения для иллюстрации):

{"resource":"energy","amount":65000,"tier":"1h","receiver":"TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE"}

Ответы

Поля ответа (Quote)

Пример ответа 201 из контракта (значения для иллюстрации):

{
  "id": "qt_01J9Z5NB2K4R",
  "resource": "energy",
  "amount": 65000,
  "tier": "1h",
  "receiver": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
  "price_sun_per_unit": 20,
  "energy_amount_sun": 1300000,
  "activate_amount_sun": 0,
  "total_amount_sun": 1300000,
  "created_at": "2026-09-11T18:04:05.123Z",
  "expires_at": "2026-09-11T18:06:05.123Z"
}

Получение котировки

GET /v1/quotes/{quoteId} · getQuote

Аутентификация: API-ключ (HMAC).

Возвращает котировку и проверяет, действительна ли она (expires_at в будущем).

Параметры

Ответы

Поля ответа (Quote)

Те же поля, что в ответе POST /v1/quotes.