開發者文件
快速開始
三分鐘內接入金晰數據 REST API。設定 Base URL 與 Authorization header 後，回應皆為 JSON，欄位名稱固定，可匯入 pandas。
BASE URLhttps://api.clarifindata.com
第一步：註冊帳號
前往 /signup 註冊免費帳號。Free 方案建立後即可使用，無需信用卡。
立即註冊 ↗第二步：取得 API Key
登入後開啟 Dashboard 即可查看 API Key。完整金鑰只會在建立時顯示一次，請立即複製並妥善保存。
⚠
前往 Dashboard ↗完整金鑰僅在建立當下顯示一次，請立即保存。遺失時可於 Dashboard 撤銷原金鑰並重新產生，原金鑰即時失效。
第三步：發出第一個請求
將 YOUR_API_KEY 替換為 Dashboard 產生的金鑰，執行以下請求：
cURL
bash
curl -H "Authorization: Bearer YOUR_API_KEY" \
"https://api.clarifindata.com/v1/data/TaiwanStockPrice?stock_id=2330&limit=5"Python (requests)
python
import requests
resp = requests.get(
"https://api.clarifindata.com/v1/data/TaiwanStockPrice",
headers={"Authorization": "Bearer YOUR_API_KEY"},
params={"stock_id": "2330", "limit": 5},
)
data = resp.json()
print(data["count"], "rows")Python SDK
python
# pip install clarifindata
from clarifindata import Client
cfd = Client("YOUR_API_KEY")
df = cfd.get("TaiwanStockPrice", stock_id="2330", limit=5)
print(df.head())回應 — 200 OK
json
{
"dataset": "TaiwanStockPrice",
"tier_used": "free",
"count": 5,
"data": [
{
"stock_id": "2330",
"trade_date": "2026-06-11",
"open": "1020.0000",
"high": "1025.0000",
"low": "1015.0000",
"close": "1020.0000",
"volume": 15384000,
"turnover": "15691680000",
"trade_count": 28441,
"spread": "10.0000"
}
],
"cursor": null
}✓
每個回應都會包含 X-RateLimit-Limit、X-RateLimit-Remaining、X-RateLimit-Window 三個 header，可用於確認目前視窗的剩餘配額。