# Taiwan Real-Time Quote & Depth API
> Live intraday quotes and order-book depth for the Taiwan market (the TWSE main board and the TPEx over-the-counter exchange), with no key. Read the live intraday quote for one or more stocks by code (current price, open/high/low, previous close, change and cumulative volume); and the five-level order book (the top five bid and ask prices and sizes). The Taiwan-equities / real-time / level-2-depth layer for trading dashboards and execution tools — distinct from end-of-day readers, this is the live intraday tape with order-book depth, across both TSE and TPEx. Live; short cache only.

## 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/taiwanrealtime-api/..."
```

## Pricing
- **Free** (Free) — 18,000 calls/Mo, 3 req/s
- **Starter** ($22/Mo) — 360,000 calls/Mo, 8 req/s
- **Pro** ($52/Mo) — 1,800,000 calls/Mo, 20 req/s
- **Enterprise** ($122/Mo) — 8,900,000 calls/Mo, 60 req/s

## Endpoints

### Real-Time

#### `GET /v1/orderbook` — Five-level order book

**Parameters:**
- `code` (query, required, string) — Taiwan stock code, e.g. 2330 Example: `2330`
- `market` (query, optional, string) — tse or otc; default tse Example: `tse`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/taiwanrealtime-api/v1/orderbook?code=2330&market=tse"
```

**Response:**
```json
{
    "data": {
        "asks": [
            {
                "size": 655,
                "price": 2360
            },
            {
                "size": 1327,
                "price": 2365
            },
            {
                "size": 656,
                "price": 2370
            },
            {
                "size": 475,
                "price": 2375
            },
            {
                "size": 606,
                "price": 2380
            }
        ],
        "bids": [
            {
                "size": 57,
                "price": 2355
            },
            {
                "size": 233,
                "price": 2350
            },
            {
                "size": 344,
                "price": 2345
            },
            {
                "size": 401,
                "price": 2340
            },
            {
                "size": 561,
                "price": 2335
            }
        ],
        "code": "2330",
        "name": "台積電",
        "note": "The five-level order book for one Taiwan stock — the top five bid and ask prices with sizes. Pass code (e.g. 2330) and market (tse or otc; default tse). The live level-2 depth, available during Taiwan trading hours.",
        "price": null,
        "market": "tse",
        "source": "Taiwan Exchange (mis.twse)",
        "trade_time": "10:10:40"
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:46.199Z",
        "request_id": "29427746-4e6d-410c-b762-545d1c524e11
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/quote` — Live intraday quote

**Parameters:**
- `codes` (query, required, string) — Taiwan stock codes, comma-separated, e.g. 2330 (TSMC), 2317 (Hon Hai) Example: `2330,2317`
- `market` (query, optional, string) — tse (main board) or otc (TPEx); default tse Example: `tse`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/taiwanrealtime-api/v1/quote?codes=2330%2C2317&market=tse"
```

**Response:**
```json
{
    "data": {
        "note": "The live intraday quote for one or more Taiwan stocks — current price, open/high/low, previous close, change and cumulative volume each. Pass codes (comma-separate up to 10, e.g. 2330,2317) and market (tse for the main board, otc for TPEx; default tse). Real-time during Taiwan trading hours.",
        "count": 2,
        "market": "tse",
        "quotes": [
            {
                "low": 2345,
                "code": "2330",
                "high": 2365,
                "name": "台積電",
                "open": 2360,
                "price": null,
                "change": null,
                "market": "tse",
                "volume": 10406,
                "full_name": "台灣積體電路製造股份有限公司",
                "trade_time": "10:10:40",
                "change_percent": null,
                "previous_close": 2310,
                "last_trade_volume": null
            },
            {
                "low": 265,
                "code": "2317",
                "high": 272.5,
                "name": "鴻海",
                "open": 271,
                "price": null,
                "change": null,
                "market": "tse",
                "volume": 25295,
                "full_name": "鴻海精密工業股份有限公司",
                "trade_time": "10:10:39",
                "change_percent": null,
                "previous_close": 260.5,
                "last_trade_volume": null
            }
     
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Endpoints & source

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

**Response:**
```json
{
    "data": {
        "sample": {
            "tsmc": null
        },
        "source": "Taiwan Exchange real-time market info (mis.twse.com.tw), keyless",
        "markets": [
            "tse",
            "otc"
        ],
        "service": "taiwanrealtime-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/quote": "Live intraday quote (codes, market).",
            "GET /v1/orderbook": "Five-level order book (code, market)."
        },
        "description": "Live intraday quotes and order-book depth for the Taiwan market (TWSE main board and TPEx OTC) with no key: the live intraday quote for one or more stocks (current price, open/high/low, previous close, change, cumulative volume), and the five-level order book (top five bids and asks with sizes). The Taiwan-equities / real-time / level-2-depth layer for trading dashboards and execution tools. Distinct from end-of-day readers — the live intraday tape with order-book depth across TSE and TPEx. Live, short cache only.",
        "upstream_status": "ok"
    },
    "meta": {
        "timestamp": "2026-06-15T02:10:46.565Z",
        "request_id": "23ad77bf-f44e-4613-b747-eb6055fea45e"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


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