# Ueex — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access real-time and historical pricing data for Ukrainian energy commodities including natural gas, electricity, coal, LPG, and timber directly from official exchange quotations and auction results. Monitor trading indices, check medium long-term market rates, and view the trading calendar to stay informed on energy market trends.

**Category:** Finance & Markets | **Website:** [ueex.com.ua/](https://ueex.com.ua/) | **Docs:** [parse.bot/marketplace/a50007f3-ac53-4d80-95f9-c6fd4a1871ee/ueex-com-ua-api](https://parse.bot/marketplace/a50007f3-ac53-4d80-95f9-c6fd4a1871ee/ueex-com-ua-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-ueex-com-ua-api-a50007f3/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_commodity_quotations

Fetch quotations for various commodities traded on the exchange (Coal, LPG, Timber, Oil Products, Fertilizers). Returns pricing data including date, product name, delivery basis, volume, prices in UAH/USD/EUR with VAT, and price deviation from previous quotation.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `commodity` | string | No | Commodity slug: 'coal-products', 'lpg', 'timber', 'oil-products', 'fertilizers'. |
| `day` | string | No | Day for filtering in DD format (e.g., '15'). Omitting returns all days. |
| `month` | string | No | Month for filtering in MM format (e.g., '01'). Omitting returns all months. |
| `section_id` | string | No | Numeric section ID for filtering results within a commodity category. |
| `year` | string | No | Year for filtering in YYYY format (e.g., '2025'). Omitting returns all available data. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ueex-com-ua-api-a50007f3/get_commodity_quotations \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"commodity":"<string>","day":"<string>","month":"<string>","section_id":"<string>","year":"<string>"}'
```

### get_electricity_auction_quotations

Fetch electricity auction price quotations (BASE load weighted average prices) for the Ukrainian Power System. Returns daily prices in UAH per MWh for the last 30 days based on bilateral contract auction results. Data is extracted from the chart on the electricity quotations page.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ueex-com-ua-api-a50007f3/get_electricity_auction_quotations \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_electricity_indices

Fetch electricity price indices (BASE load indices) for the Ukrainian Power System. Returns multiple tables organized by period type: monthly indices, additional indices, half-year/quarterly indices, and decade (10-day period) indices. No input parameters required.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ueex-com-ua-api-a50007f3/get_electricity_indices \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_glossary

Fetch terms and definitions from the exchange glossary. Returns Ukrainian-language energy trading terminology with term names and their definitions extracted from the glossary page.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ueex-com-ua-api-a50007f3/get_glossary \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_natural_gas_medium_longterm_market

Fetch medium- and long-term natural gas market trading results. Returns data including resource period (month of supply), last sale date, supply conditions, payment conditions, sales volume in thousands of cubic meters, and quotation price in UAH per thousand cubic meters with percentage change.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ueex-com-ua-api-a50007f3/get_natural_gas_medium_longterm_market \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_natural_gas_trading_results

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.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `market_type` | string | No | Market type: '1' (Within Day), '2' (Day Ahead), '3' (Week), '4' (Month). |
| `period` | string | No | Period in MM.YYYY format (e.g., '01.2025'). Omitting defaults to current month. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ueex-com-ua-api-a50007f3/get_natural_gas_trading_results \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"market_type":"<string>","period":"<string>"}'
```

### get_trading_calendar

Fetch the trading calendar showing the number of trading sessions per day. Each day entry includes the day number, count of trades, a title with trade count summary, and a link to detailed daily results. Weekends and holidays have zero trade count.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `month` | string | No | Month in MM format (e.g., '05'). Omitting defaults to current month. |
| `year` | string | No | Year in YYYY format (e.g., '2026'). Omitting defaults to current year. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ueex-com-ua-api-a50007f3/get_trading_calendar \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"month":"<string>","year":"<string>"}'
```