# Budapest Stock Exchange (BUX) API
> Live Hungarian equity data from the Budapest Stock Exchange (BÉT): real-time quotes for any listed stock by ticker (price, % change, intraday OHLC, volume, market cap in HUF), a ranking screener for gainers, losers, most-active and top market-cap local primary listings, and the Budapest index family (BUX, BUMIX and CETOP). Foreign depositary receipts are filtered out so you get only genuine Hungarian companies such as OTP Bank, MOL and Gedeon Richter.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/hungary-stock-api/..."
```

## Pricing
- **Free** (Free) — 1,800 calls/Mo, 2 req/s
- **Basic** ($12/Mo) — 48,000 calls/Mo, 5 req/s
- **Pro** ($36/Mo) — 195,000 calls/Mo, 15 req/s
- **Business** ($77/Mo) — 790,000 calls/Mo, 40 req/s

## Endpoints

### Quotes

#### `GET /v1/quote` — Live quote for one or more BÉT stocks

**Parameters:**
- `symbols` (query, required, string) — Comma-separated BÉT tickers (up to 20) Example: `OTP,MOL,RICHTER`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/hungary-stock-api/v1/quote?symbols=OTP%2CMOL%2CRICHTER"
```

**Response:**
```json
{
    "data": {
        "count": 3,
        "market": "BET",
        "quotes": [
            {
                "low": 41500,
                "high": 42490,
                "last": 42490,
                "name": "OTP Bank Nyrt",
                "open": 41500,
                "pe_ttm": 9.6415,
                "sector": "Finance",
                "symbol": "OTP",
                "ticker": "BET:OTP",
                "volume": 437583,
                "currency": "HUF",
                "change_abs": 1610,
                "change_pct": 3.9384,
                "market_cap": 11435534894714
            },
            {
                "low": 3820,
                "high": 3960,
                "last": 3826,
                "name": "MOL Hungarian Oil & Gas Plc Class A",
                "open": 3940,
                "pe_ttm": 13.21,
                "sector": "Energy Minerals",
                "symbol": "MOL",
                "ticker": "BET:MOL",
                "volume": 529481,
                "currency": "HUF",
                "change_abs": -104,
                "change_pct": -2.6463,
                "market_cap": 3065630635833
            },
            {
                "low": 11700,
                "high": 11950,
                "last": 11930,
                "name": "Chemical Works of Gedeon Richter Plc",
                "open": 11790,
                "pe_ttm": 9.5021,
                "sector": "Health Technology",
                "symbol": "RICHTER",
                "ticker": "BET:
…(truncated, see openapi.json for full schema)
```

### Screener

#### `GET /v1/screener` — Rank local primary listings

**Parameters:**
- `sort` (query, optional, string) — Sort field: market_cap, change or volume Example: `market_cap`
- `order` (query, optional, string) — asc or desc Example: `desc`
- `limit` (query, optional, string) — Number of results (1-100) Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/hungary-stock-api/v1/screener?sort=market_cap&order=desc&limit=25"
```

**Response:**
```json
{
    "data": {
        "sort": "market_cap",
        "count": 25,
        "order": "desc",
        "market": "BET",
        "results": [
            {
                "low": 41500,
                "high": 42490,
                "last": 42490,
                "name": "OTP Bank Nyrt",
                "open": 41500,
                "pe_ttm": 9.6415,
                "sector": "Finance",
                "symbol": "OTP",
                "ticker": "BET:OTP",
                "volume": 437583,
                "currency": "HUF",
                "change_abs": 1610,
                "change_pct": 3.9384,
                "market_cap": 11435534894714
            },
            {
                "low": 3820,
                "high": 3960,
                "last": 3826,
                "name": "MOL Hungarian Oil & Gas Plc Class A",
                "open": 3940,
                "pe_ttm": 13.21,
                "sector": "Energy Minerals",
                "symbol": "MOL",
                "ticker": "BET:MOL",
                "volume": 529481,
                "currency": "HUF",
                "change_abs": -104,
                "change_pct": -2.6463,
                "market_cap": 3065630635833
            },
            {
                "low": 2702,
                "high": 2740,
                "last": 2730,
                "name": "Magyar Telekom Telecommunications PLC",
                "open": 2702,
                "pe_ttm": 11.3911,
                "sector": "Communications",
                
…(truncated, see openapi.json for full schema)
```

### Indices

#### `GET /v1/index` — Budapest index family (BUX, BUMIX, CETOP)

**Parameters:**
- `symbol` (query, optional, string) — Optional specific index symbol(s) Example: `BUX`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/hungary-stock-api/v1/index?symbol=BUX"
```

**Response:**
```json
{
    "data": {
        "count": 1,
        "market": "BET",
        "indices": [
            {
                "low": 133519.6,
                "high": 135809.23,
                "name": "Budapest Stock Exchange Index",
                "open": 133519.6,
                "index": "BUX",
                "value": 135724.68,
                "change_abs": 2195.99,
                "change_pct": 1.6446
            }
        ]
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:20.119Z",
        "request_id": "664c4717-b97d-416b-b5ad-1901f0c2ff26"
    },
    "status": "ok",
    "message": "Index retrieved successfully",
    "success": true
}
```

### Meta

#### `GET /v1/meta` — Market metadata & endpoint guide

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/hungary-stock-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "market": "Budapest Stock Exchange (BÉT)",
        "source": "TradingView screener (hungary market), keyless",
        "country": "Hungary",
        "indices": [
            "BUX",
            "BUMIX",
            "CETOP"
        ],
        "currency": "HUF",
        "examples": {
            "index": "/v1/index",
            "quote": "/v1/quote?symbols=OTP,MOL,RICHTER",
            "screener": "/v1/screener?sort=change&order=desc&limit=10"
        },
        "endpoints": {
            "/v1/index": "Budapest index family (BUX, BUMIX, CETOP)",
            "/v1/quote": "live quote for one or more BÉT stocks by ticker (symbols=OTP,MOL,RICHTER)",
            "/v1/screener": "rank local primary listings by market_cap | change | volume (sort, order, limit)"
        },
        "cache_ttl_ms": 20000
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:20.202Z",
        "request_id": "9f4624ad-3f42-47e0-a937-6731d207413e"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/hungary-stock-api
OpenAPI spec: https://www.oanor.com/api/hungary-stock-api/openapi.json