金晰數據
開發者文件

快速開始

三分鐘上手 Clarifindata REST API。一個 base URL,一個 header,回應永遠是 JSON,欄位命名永遠一致,直接餵進 pandas。

BASE URLhttps://api.clarifindata.com

第一步:註冊帳號

前往 /signup 建立免費帳號。Free 等級立即開通,不需填信用卡。

立即註冊 →

第二步:取得 API Key

登入後前往 Dashboard,你的 API Key 會顯示在頁面上。Key 只在首次顯示時完整呈現,請立刻複製並妥善保管。

API Key 只在 Dashboard 頁面顯示一次,完整 key 不會再顯示。如果遺失,請聯絡客服重新發放。
前往 Dashboard →

第三步:發出第一個請求

把 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,方便你追蹤剩餘配額。