API для розробників · платформа Alvo

API для РДН, BESS і контрольованих рішень.

Підключайте Alvo до внутрішніх кабінетів, BI, партнерських продуктів або трейдерських процесів. V1 готує перевірні розрахунки, пояснення, ризик-звіт і журнал дій, але не подає заявки без відповідального трейдера.

Відкрити OpenAPI JSON Запустити робочий простір

OpenAPI 3.1готовий API-ключпідтвердження трейдера

Ринкові дані

OREE покриває ціни, індекси й результати торгів, а УЕБ додає орієнтир РДД BASE.

Рушій рішень

РДН-стратегія, BESS і бектестинг працюють з єдиною моделлю PricePoint.

Шар контролю

Звіт ризиків, події аудиту, режим API-ключа та ліміти запитів для безпечного запуску.

Модель безпеки

Демо може бути відкритим. Бойовий доступ закривається API-ключем.

ALVO_REQUIRE_API_KEY=true переводить API у захищений режим. Ключ приймається через x-alvo-api-key або Authorization: Bearer. Усі відповіді мають no-store, X-Alvo-API-Version і заголовки режиму безпеки.

Секрети на серверіALVO_API_KEY не потрапляє у браузер і клієнтський пакет.

Ліміти запитівALVO_RATE_LIMIT_PER_MINUTE і ALVO_RATE_LIMIT_WINDOW_MS захищають API від шуму.

Без автоподачі заявокV1 не відправляє заявки на ринок і потребує підтвердження трейдера.

Процес

Типова інтеграція проходить пʼять контрольованих кроків.

01Завантажити ринок

GET /api/oree/prices, /api/oree/indexes, /api/oree/trading-results і /api/ueex/electricity-indexes або власний CSV-шар.

02Побудувати план

POST /api/strategy/plan і POST /api/bess/plan.

03Перевірити ризик

POST /api/risk/report перед експортом або підтвердженням.

04Записати аудит

POST /api/audit/events для ключових дій.

05Підключити сигнали

POST /api/notifications/subscriptions для PWA-каналів без автоподачі заявок.

GET/api/health

ОпераціїПеревірка стану

Операційна готовність API, режим безпеки, ліміти запитів, рушії розрахунків і залежності ринкових даних.

GET/api/oree/prices

Ринкові даніЦіни Оператора ринку

Місячна книга погодинних цін для РДН або ВДР з публічних даних Оператора ринку.

GET/api/oree/indexes

Ринкові даніІндекси РДН

Base, Peak, OffPeak, мінімальна, максимальна та середньозважена ціни РДН за датами.

GET/api/oree/trading-results

Ринкові даніРезультати торгів OREE

Щоденні підсумки торгів РДН/ВДР: погодинна ціна, обсяги купівлі/продажу та заявлені обсяги.

GET/api/ueex/electricity-indexes

Ринкові даніІндекси УЕБ

Публічні індекси РДД BASE Української енергетичної біржі для ринкового орієнтира.

GET/api/forecast

Ринкові даніПрогноз цін

Помісячний імовірнісний прогноз: погодинні коридори p10/p50/p90, обрана модель і її точність (rMAE проти сезонно-наївного бенчмарку).

POST/api/strategy/plan

СтратегіяРДН-план

Рекомендовані години купівлі/продажу, очікуваний результат, спреди, обсяг і комісії.

POST/api/bess/plan

BESSBESS-план

Цикли заряду/розряду, прибуток з урахуванням ефективності, деградації та еквівалентних циклів.

POST/api/backtest/summary

БектестингПідсумок бектестингу

Багатоденна ефективність РДН-стратегії та BESS, частка прибуткових днів, найкращий/найгірший день і денні рядки.

POST/api/risk/report

РизикЗвіт ризиків

Покриття даних, аномалії, експозиція, цикли BESS і ризик-обмеження перед підтвердженням трейдера.

POST/api/ai/trading-brief

AIТрейдерський висновок

Локалізований детермінований висновок для трейдера українською або англійською мовою.

GET/api/billing/plans

BillingКаталог підписок

Публічний контракт тарифів, AI/API лімітів, add-ons і політики overage перед майбутнім checkout.

POST/api/audit/events

АудитПодія аудиту

Типізовані події prices_loaded, csv_imported, ai_brief_generated і plan_exported для журналу дій.

GET/api/audit/events

АудитЖурнал подій тенанта

Tenant-scoped перелік недавніх подій (тільки роль audit.read коли RBAC увімкнено). Підтримує параметри limit і before для пагінації.

GET/api/coupling/flows

ENTSO-EТранскордонні потоки

Погодинні MW-потоки на одному з UA-кордонів (за замовчуванням UA↔PL): leg.fromTo, leg.toFrom і netFlowMw. Live з ENTSO-E A11 (Aggregated cross-border physical flow); fixture коли токен відсутній.

GET/api/multi-zone/prices

ENTSO-EРегіональні ціни РДН

Погодинні ціни day-ahead для сусідів UA (PL, SK, HU, RO) і DE-LU як ЄС-бенчмарк, у нативній валюті кожної зони. Live з ENTSO-E A44; fixture коли токен відсутній.

GET/api/system-operations

ENTSO-EЕнергосистема UA

Погодинне навантаження + мікс генерації UA (ядерна / вугілля / газ / гідро / вітер / сонце). Live з ENTSO-E A65 + A75; fixture коли UA TSO не публікує (поточний стан).

POST/api/account/api-keys

БезпекаСтворити API-ключ

Згенерувати tenant-scoped API-ключ для програмного доступу. Plaintext повертається один раз — збережіть його. Доступ за роллю api.manage (owner).

GET/api/account/api-keys

БезпекаСписок API-ключів

Активні API-ключі тенанта (без plaintext): назва, prefix, lastUsedAt, createdAt.

DELETE/api/account/api-keys/{id}

БезпекаВідкликати API-ключ

Soft-revoke ключа (записує revokedAt + actorId). Видалені ключі неможливо відновити — лише замінити новими.

POST/api/notifications/subscriptions

НотифікаціїPWA-підписка

Контракт Web Push для цінових оновлень, ризик-сигналів, BESS-вікон і готовності експорту без торгової дії.

Запит звіту ризиків

curl -X POST "$ALVO_URL/api/risk/report" \
  -H "content-type: application/json" \
  -H "x-alvo-api-key: $ALVO_API_KEY" \
  -d '{
    "tradeDate": "13.05.2026",
    "prices": [
      { "hour": 0, "priceUahMwh": 5575 },
      { "hour": 1, "priceUahMwh": 5100 },
      { "hour": 2, "priceUahMwh": 100 },
      { "hour": 3, "priceUahMwh": 70 },
      { "hour": 4, "priceUahMwh": 100 },
      { "hour": 5, "priceUahMwh": 4800 },
      { "hour": 6, "priceUahMwh": 5880 },
      { "hour": 7, "priceUahMwh": 5267 },
      { "hour": 8, "priceUahMwh": 3878 },
      { "hour": 9, "priceUahMwh": 3050 },
      { "hour": 10, "priceUahMwh": 49 },
      { "hour": 11, "priceUahMwh": 10 },
      { "hour": 12, "priceUahMwh": 11 },
      { "hour": 13, "priceUahMwh": 11 },
      { "hour": 14, "priceUahMwh": 10 },
      { "hour": 15, "priceUahMwh": 12 },
      { "hour": 16, "priceUahMwh": 110 },
      { "hour": 17, "priceUahMwh": 1900 },
      { "hour": 18, "priceUahMwh": 6200 },
      { "hour": 19, "priceUahMwh": 7400 },
      { "hour": 20, "priceUahMwh": 6900 },
      { "hour": 21, "priceUahMwh": 6100 },
      { "hour": 22, "priceUahMwh": 5400 },
      { "hour": 23, "priceUahMwh": 4800 }
    ],
    "strategySettings": {
      "volumeMwh": 5,
      "minSpreadUah": 250,
      "maxTradesPerDay": 4,
      "feeUahPerMwh": 12
    },
    "bessSettings": {
      "capacityMwh": 10,
      "powerMw": 5,
      "roundTripEfficiency": 0.9,
      "maxCyclesPerDay": 2,
      "degradationCostUahMwh": 80
    }
  }'

Відповідь ризик-обмежень

{
  "tradeDate": "13.05.2026",
  "report": {
    "overallStatus": "needsReview",
    "score": 76,
    "reviewCount": 3,
    "blockCount": 0
  }
}