認證

一把金鑰放進標頭，就能呼叫所有資料端點。

This documentation page is currently available in Chinese only; English versions are coming soon.

Every request carries the X-API-Key header. Create, rotate, and revoke keys yourself in the dashboard — no need to contact us.

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

A few habits

Keep the key in the header, not the URL — So it doesn't end up in server logs or browsing history.
One key per environment — Keep development and production separate, so you revoke only the leaked one (multiple keys are available by plan).
Quota follows your plan — Each key's per-minute requests and monthly usage are metered by plan.

401 missing_api_key — API key missing or invalid (except the five no-key symbols 2330/2317/2454/0050/2603, which return 200 directly).
402 not_entitled_for_dataset — your plan is not entitled to this dataset (paywall).
429 — quota or rate limit exceeded.

Building an AI agent? Start with /llms.txt for the full site index.

Overview

一把金鑰放進標頭，就能呼叫所有資料端點。

This documentation page is currently available in Chinese only; English versions are coming soon.

Every request carries the X-API-Key header. Create, rotate, and revoke keys yourself in the dashboard — no need to contact us.

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

Keep the key in the header, not the URL — So it doesn't end up in server logs or browsing history.
One key per environment — Keep development and production separate, so you revoke only the leaked one (multiple keys are available by plan).
Quota follows your plan — Each key's per-minute requests and monthly usage are metered by plan.

401 missing_api_key — API key missing or invalid (except the five no-key symbols 2330/2317/2454/0050/2603, which return 200 directly).
402 not_entitled_for_dataset — your plan is not entitled to this dataset (paywall).
429 — quota or rate limit exceeded.