開發者文件
快速開始
三分鐘上手 Clarifindata REST API。一個 base URL,一個 header,回應永遠是 JSON,欄位命名永遠一致,直接餵進 pandas。
BASE URLhttps://api.clarifindata.com
第一步:註冊帳號
前往 /signup 建立免費帳號。Free 等級立即開通,不需填信用卡。
立即註冊 →第二步:取得 API Key
登入後前往 Dashboard,你的 API Key 會顯示在頁面上。Key 只在首次顯示時完整呈現,請立刻複製並妥善保管。
⚠
前往 Dashboard →API Key 只在 Dashboard 頁面顯示一次,完整 key 不會再顯示。如果遺失,請聯絡客服重新發放。
第三步:發出第一個請求
把 YOUR_API_KEY 換成你在 Dashboard 拿到的 key,即可執行:
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,方便你追蹤剩餘配額。