Quick start

Step 0 · Try one call with zero sign-up (no key)

These 5 symbols work without a key: 2330 TSMC / 2317 Hon Hai / 2454 MediaTek / 0050 / 2603. Paste this to your AI or run curl directly:

curl "https://api.twmarketdata.com/v2/datasets/twse-daily-price?symbol=2330&limit=1"

(Other stocks / other datasets need the API key below.)

1. Get an API key

Register in the dashboard and create an API key there. Put the key in the request header, not in the URL.

2. Make your first request

Every data endpoint is GET /v2/datasets/{dataset}, with the key passed in the X-API-Key header.

curl "https://api.twmarketdata.com/v2/datasets/monthly-revenue?symbol=2330&limit=12" \
  -H "X-API-Key: $TWMD_API_KEY"

import requests

r = requests.get(
    "https://api.twmarketdata.com/v2/datasets/monthly-revenue",
    params={"symbol": "2330", "limit": 12},
    headers={"X-API-Key": TWMD_API_KEY},
)
data = r.json()

3. Read the response

You get typed JSON, each record carrying its source; missing data is left empty rather than filled in. Field definitions are on each dataset page.