API & data
How to call the API, query datasets, and resolve common response issues.
▸How do I get an API key?
Sign in to the dashboard, open the API keys section, create a new key, and copy it immediately. Store it securely; if it leaks, revoke it and create a new one right away.
▸How do I call the API?
Send an HTTPS GET request to the /v2/datasets/* endpoints with your key in the X-API-Key header. See /docs/quick-start for examples.
▸How do I query Taiwan stock prices?
Start from /v2/datasets/twse-daily-price or /v2/datasets/tpex-daily-price, passing query parameters such as symbol and limit.
▸What is requestId?
Every request returns an X-Request-Id, which makes it easier to trace errors, reconcile records, and let support investigate.
▸How are credits calculated?
Each dataset endpoint maps to a fixed cost, and the response header carries X-TWMD-Credits-Cost (estimated or actually charged depending on the mode).
▸Why do I get 502 / 504 errors?
These usually come from an upstream backend timeout, a cold start, or a temporary service fluctuation. Record the requestId, retry later, or contact us.