API 與 MCP 說明
重點摘要：本站提供免費、免註冊的台股題材與高股息 ETF 配息 API 及 5 個 MCP 工具；進階端點用 x402 收費，每次 0.01 或 0.05 USDC，沒付款時回傳 HTTP 402 與付款資訊。
基本 API 與 MCP 免費、不用註冊。進階端點用 x402 收費（USDC，Base 網路）：沒付款時回 HTTP 402 與付款資訊，支援 x402 的 AI 代理會自動付款。
| 端點 | 說明 |
|---|---|
GET /api/themes | 四個題材的摘要（檔數、漲跌家數、平均漲跌幅） |
GET /api/themes/{ai-server|semi-equipment|liquid-cooling|cpo} | 題材成分股、業務說明、最新收盤 |
GET /api/stock/{代號} | 個股最新收盤、所屬題材、近 60 個交易日 |
GET /api/etf-dividends | 高股息 ETF 配息總表與 2027 估算 |
GET /api/etf/{代號} | 單一 ETF 每期配息與估算 |
GET /api/status | 資料更新時間 |
GET /api/pro/history?code=2330&days=365 | 付費 0.01 USDC：本站累積的每日收盤歷史 |
GET /api/pro/income-plan?budget=1000000&codes=0056,00878,00919 | 付費 0.01 USDC：預算平均分配到指定 ETF，估算 2027 年領多少現金 |
GET /api/pro/export | 付費 0.05 USDC：全部題材股價、ETF 配息與估算一次匯出 |
POST /mcp | MCP 工具：list_stock_themes、get_theme_stocks、get_stock、get_etf_dividends、estimate_etf_dividend_2027 |
本站整理公開資料，不構成投資建議，也不推薦買賣任何證券。股價為證交所、櫃買中心公布的每日收盤資料；題材分類依財經媒體常見歸類；ETF 配息估算為依歷史紀錄的機械式推算，實際以投信公告為準。
常見問題
有哪些免費 API 端點？
包含 /api/themes（4 個題材摘要）、/api/themes/{題材}（成分股與最新收盤）、/api/stock/{代號}（近 60 個交易日）、/api/etf-dividends（ETF 配息總表與 2027 估算）、/api/etf/{代號} 與 /api/status（資料更新時間）。
MCP 提供哪些工具？
對 /mcp 發送 POST 可使用 5 個工具：list_stock_themes、get_theme_stocks、get_stock、get_etf_dividends、estimate_etf_dividend_2027，適合 AI 代理人直接查詢。
付費端點多少錢？提供什麼？
每日收盤歷史與 ETF 領息試算各 0.01 USDC，全部題材股價、ETF 配息與估算一次匯出為 0.05 USDC，透過 Base 網路以 x402 付款，支援 x402 的 AI 代理會自動付款。
API 的原始資料來源是什麼？
股價來自臺灣證券交易所與櫃買中心公布的每日收盤資料，ETF 配息來自臺灣證券交易所的 ETF 收益分配資料；API 內容同樣不構成投資建議。