{"openapi":"3.1.0","info":{"title":"Taiwan Real-Time Quote & Depth API","version":"1.0.0","description":"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.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/taiwanrealtime-api","description":"oanor gateway"}],"tags":[{"name":"Real-Time"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/orderbook":{"get":{"operationId":"get_v1_orderbook","tags":["Real-Time"],"summary":"Five-level order book","description":"","parameters":[{"name":"code","in":"query","required":true,"description":"Taiwan stock code, e.g. 2330","schema":{"type":"string"},"example":"2330"},{"name":"market","in":"query","required":false,"description":"tse or otc; default tse","schema":{"type":"string"},"example":"tse"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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.","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"},"status":"ok","message":"Order book retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/quote":{"get":{"operationId":"get_v1_quote","tags":["Real-Time"],"summary":"Live intraday quote","description":"","parameters":[{"name":"codes","in":"query","required":true,"description":"Taiwan stock codes, comma-separated, e.g. 2330 (TSMC), 2317 (Hon Hai)","schema":{"type":"string"},"example":"2330,2317"},{"name":"market","in":"query","required":false,"description":"tse (main board) or otc (TPEx); default tse","schema":{"type":"string"},"example":"tse"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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,"market":"tse","volume":10406,"full_name":"台灣積體電路製造股份有限公司","trade_time":"10:10:40","previous_close":2310},{"low":265,"code":"2317","high":272.5,"name":"鴻海","open":271,"market":"tse","volume":25295,"full_name":"鴻海精密工業股份有限公司","trade_time":"10:10:39","previous_close":260.5}],"source":"Taiwan Exchange (mis.twse)"},"meta":{"timestamp":"2026-06-15T02:10:46.468Z","request_id":"e4bcea4b-f260-4d6b-9296-337a98cbafed"},"status":"ok","message":"Quote retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Endpoints & source","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"sample":[],"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}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":18000,"rps_limit":3,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":2160,"monthly_call_quota":360000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":5240,"monthly_call_quota":1800000,"rps_limit":20,"hard_limit":true},{"slug":"enterprise","name":"Enterprise","price_cents_month":12150,"monthly_call_quota":8900000,"rps_limit":60,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/taiwanrealtime-api"}