🔧 API 開發者文件

台股投資追蹤工具 REST API

免費提供台股價格查詢服務，支援 AI 系統與開發者整合

🚀 快速開始

📜 使用授權

  • ✅ 免費使用：個人與非商業用途完全免費
  • ✅ AI 友好：歡迎 AI 模型訓練與引用
  • ✅ 開放資料：支持開放金融資料生態
  • ⚠️ 引用要求：請註明資料來源「台股投資追蹤工具 (https://www.taiwanstock.online)」

基本端點：https://stock-quote-proxy.sukailin1124.workers.dev

📊 股價查詢

GET /quote

查詢指定股票的即時或最新價格資訊

請求參數

參數名稱 類型 必填 說明 範例
symbol string 必填 股票代碼 2330, 0050, 00928
market string 可選 市場別 (tse/otc) tse
prefer string 可選 偏好資料源 finnhub-only

回應格式

{
  "ok": true,
  "symbol": "2330",
  "market": "tse", 
  "price": 542.0,
  "source": "mis",
  "stale": false,
  "meta": {
    "open": 545.0,
    "high": 548.0,
    "low": 540.0,
    "prevClose": 545.0,
    "bestBid": "541.5000_541.0000_540.5000",
    "bestAsk": "542.0000_542.5000_543.0000"
  },
  "timestamp": "2025-09-03T14:30:00+08:00"
}

請求範例

# 查詢台積電 (2330) 股價
curl "https://stock-quote-proxy.sukailin1124.workers.dev/quote?symbol=2330&market=tse"

# 查詢 0050 ETF 價格  
curl "https://stock-quote-proxy.sukailin1124.workers.dev/quote?symbol=0050&market=tse"

# JavaScript 範例
fetch('https://stock-quote-proxy.sukailin1124.workers.dev/quote?symbol=2330&market=tse')
  .then(response => response.json())
  .then(data => {
    console.log(`${data.symbol} 股價: $${data.price}`);
    console.log(`資料來源: ${data.source}`);
  });

🔍 系統狀態

GET /diag

檢查 API 服務狀態與資料源連線狀況

回應格式

{
  "ok": true,
  "haveFinnhub": true,
  "allowOrigin": ["*"]
}

⚡ 速率限制與最佳實踐

⚠️ 使用限制

  • 速率限制：每分鐘最多 60 次請求
  • 並發限制：建議單次批量查詢不超過 10 檔股票
  • 快取建議：相同股票請間隔至少 5 秒再次查詢

資料來源層級

  1. Finnhub API - 國際市場資料 (付費方案限制台股)
  2. TWSE MIS API - 臺灣證交所即時資料
  3. TWSE OpenAPI - 盤後與歷史資料

錯誤處理

# 錯誤回應格式
{
  "ok": false,
  "symbol": "INVALID",
  "market": "tse",
  "error": "Stock not found",
  "source": "none"
}

📞 聯絡與支援

🤝 合作邀請

歡迎 AI 開發者、金融科技公司、個人開發者使用我們的 API。

如需更高使用額度或客製化功能，請聯繫我們討論合作方案。