Com APIueex.com.ua ↗
Access natural gas trading results, electricity price indices, commodity quotations, and trading calendar data from the Ukrainian Energy Exchange via a structured API.
What is the Com API?
This API exposes 7 endpoints covering the Ukrainian Energy Exchange (ueex.com.ua), returning structured data on natural gas short-term and medium/long-term markets, electricity BASE load indices, and commodity quotations for coal, LPG, timber, oil products, and fertilizers. The get_natural_gas_trading_results endpoint filters by market type (Within Day, Day Ahead, Week, Month) and returns per-trade volume and exchange rates. All responses use typed JSON fields ready for time-series analysis or price monitoring.
curl -X GET 'https://api.parse.bot/scraper/22f05eac-3c53-4513-a2e5-9707ae0a31da/get_natural_gas_trading_results?period=01.2025&market_type=1' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace ueex-com-ua-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.ueex_ukrainian_energy_exchange_api import UEEX, MarketType, CommodityType
ueex = UEEX()
# Fetch natural gas short-term trading results for Day Ahead market
for result in ueex.naturalgases.short_term_results(market_type=MarketType.DAY_AHEAD):
print(result.trading_day, result.product, result.price_without_vat)
# Fetch electricity auction quotations (BASE load prices)
for quotation in ueex.electricities.quotations():
print(quotation.date, quotation.price_uah_per_mwh)
# Fetch coal commodity quotations
coal = ueex.commodity(slug=CommodityType.COAL_PRODUCTS)
for q in coal.quotations():
print(q.date, q.product, q.price_uah_vat, q.deviation_pct)
# Fetch trading calendar days
for day in ueex.calendars.days(year="2026", month="05"):
print(day.day, day.trade_count, day.title)
Fetch trading results for natural gas standardized products on the short-term market. Returns tabular data including trading day, product type (WD/DA/W/M), supply conditions, volume in thousands of cubic meters, and exchange rates with and without VAT per thousand cubic meters. Results are filtered by period and market type.
| Param | Type | Description |
|---|---|---|
| period | string | Period in MM.YYYY format (e.g., '01.2025'). Omitting defaults to current month. |
| market_type | string | Market type: '1' (Within Day), '2' (Day Ahead), '3' (Week), '4' (Month). |
{
"type": "object",
"fields": {
"results": "array of trading result objects with Ukrainian-language keys for trading day, product, supply conditions, volume, and exchange rates with/without VAT"
},
"sample": {
"data": {
"results": [
{
"Продукт": "WD",
"Торговий день": "09.06.2026",
"Обсяг, тис. куб. м.": "121,00",
"Умови постачання": "ГТС",
"Біржовий курс, грн, з ПДВ/тис. куб. м.": "25 784,42",
"Біржовий курс, грн, без ПДВ/тис. куб. м.": "21 487,02"
}
]
},
"status": "success"
}
}About the Com API
Natural Gas Market Data
The get_natural_gas_trading_results endpoint covers the short-term natural gas market. It accepts a period parameter in MM.YYYY format and a market_type parameter ('1' through '4', mapping to Within Day, Day Ahead, Week, and Month). Each result object in the results array includes trading day, product type, supply conditions, traded volume, and exchange rates both with and without VAT. The get_natural_gas_medium_longterm_market endpoint returns a separate dataset for medium- and long-term contracts, with fields for resource period, trade date, supply conditions, payment conditions, volume, and quotation price.
Electricity Indices and Auction Quotations
get_electricity_indices returns BASE load price indices for the Ukrainian Power System split across four tables: table_0 for monthly indices, table_2 for half-year/quarterly indices, and table_3 for decade (10-day) indices. table_1 may be empty depending on current published data. The get_electricity_auction_quotations endpoint returns auction price quotation tables as nested arrays, structured to mirror the published quotation pages.
Commodity Quotations and Trading Calendar
get_commodity_quotations accepts five optional filters — day, month, year, commodity (slugs: coal-products, lpg, timber, oil-products, fertilizers), and section_id — and returns quotation objects with date, product name, delivery basis, volume, prices in UAH, USD, and EUR, and price deviation. The get_trading_calendar endpoint returns a list of days for a given year and month, each containing an array of events with title and link fields. The get_glossary endpoint returns Ukrainian-language energy trading terms as term/definition pairs.
The Com API is a managed, monitored endpoint for ueex.com.ua — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when ueex.com.ua changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official ueex.com.ua API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Track daily natural gas spot prices across Within Day and Day Ahead market segments using
get_natural_gas_trading_results. - Build electricity price dashboards by pulling monthly and decade BASE load indices from
get_electricity_indices. - Monitor coal and LPG quotation changes in UAH, USD, and EUR using
get_commodity_quotationswith commodity slug filters. - Automate alerts for upcoming exchange auction events by parsing the
eventsarray fromget_trading_calendar. - Analyze medium- and long-term natural gas contract pricing trends using resource period and quotation price fields from
get_natural_gas_medium_longterm_market. - Build a localized energy trading glossary tool from the Ukrainian-language term/definition pairs returned by
get_glossary. - Compare electricity auction quotations over time by storing successive responses from
get_electricity_auction_quotations.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does UEEX have an official developer API?+
How do I filter commodity quotations by product type and date?+
get_commodity_quotations accepts independent day (DD), month (MM), and year (YYYY) string parameters alongside a commodity slug (coal-products, lpg, timber, oil-products, or fertilizers). You can also pass a numeric section_id for finer filtering. Omitting any parameter broadens the result set.Does the API return historical natural gas trading data beyond the current month?+
get_natural_gas_trading_results endpoint accepts a period parameter in MM.YYYY format, so you can request any month that the exchange has published. However, the depth of available historical data depends on what UEEX has on its site; very old periods may return empty results if the source no longer publishes them.Does the API cover biomass, renewables, or green certificate trading data?+
Are individual trade-level order book details available?+
results array in get_natural_gas_trading_results provides per-session volume and rate summaries. You can fork this API on Parse and revise it to target any order detail pages the exchange publishes.