全部端點免金鑰、回傳乾淨 JSON（gzip）、CORS 全開——歡迎接 AI 助理、試算表或自動化程式。 資料來自台灣官方交易所公開資訊，伺服器端有快取與禮貌節流。
GET /api/snapshot | 全市場快照（2,300+ 檔：價量、PE/PB/殖利率、產業、52 週） |
GET /api/market | 大盤總覽：恐懼貪婪六因子、寬度、法人、融資水位、期貨未平倉、Put/Call、台幣匯率、夜盤前瞻 |
GET /api/cycle | 大盤週期：站上 60/240 日均線比例＋騰落線（十年價格庫計算） |
GET /api/kline/2330?months=6&period=day&adj=1 | 個股 K 線（day/week/month；adj=1 還原權息） |
GET /api/taiex?months=12&period=week | 加權指數 K 線 |
GET /api/stock/2330 | 個股彙總：報價/基本資料/月營收/法人/資券/季損益趨勢/財務結構(負債比/流動比/ROE)/薪資/股利/警示/重大訊息(近30日) |
GET /api/msgs?codes=2330,0050 | 批量重大訊息（近 30 日主旨，自選清單用；codes 必帶、上限 100 檔） |
GET /api/evidence/2330?days=30 | 單股證據時間軸：近 N 日重要變化事件（法人連買賣轉折/外資持股率窗變/借券窗變/董監月變/雷達異動/重大訊息/申報轉讓/除權息/營收年增），side 標證據方向非指令 |
GET /api/insttrend/2330?days=60 | 三大法人買賣超逐日（外資/投信/自營） |
GET /api/yearstats | 52 週高低/年報酬（含息）/52 週位置（全市場） |
GET /api/fundmap | 基本面速查：連續配息年數/年度股利（分割減資已換算今日股數基準）/累計EPS/營益率/券資比/單季EPS・營收年增/ROE/負債比/董監質押/盈餘品質（金融業 null）/填息率・平均填息天數（近8筆）（全市場） |
GET /api/intraday | 盤中雷達：交易時段每 5 分掃描成交值前 240 檔（急拉/重挫/觸停/創52週高低）；收盤後回當日收盤照（frozen=true） |
GET /api/signals | 盤後訊號掃描＋法人排行＋連買天數表 |
GET /api/exdiv | 行事曆：即將除權息＋股東會＋法說會＋停券預告 suspensions（融券回補時間軸，上市櫃官方公告） |
GET /api/fghistory | 恐懼貪婪指數每日歷史（digest 存檔回讀） |
GET /api/futoi | 三大法人台指期淨未平倉 60 日趨勢（期交所官網源） |
GET /api/bigtrader | 大額交易人台指期淨部位 60 日（前十大全體/特定法人＋全市場OI） |
GET /api/optinst | 外資臺指選擇權 CALL/PUT 未平倉淨額 60 日（口） |
GET /api/dcarank | 定期定額交易戶數月排行（個股/ETF 各前 20，證交所；含資料月＋戶數月增） |
GET /api/dcahist | 定期定額戶數全史趨勢（2020-10 起全史；曾進榜標的聯集，含已掉榜者歷史） |
GET /api/qfiis | 全體外資及陸資持股比率＋5 日變化 chg5（%，上市＋上櫃全市場，日更） |
GET /api/insider | 全體董監持股比 pct＋質押比 pledge（%，上市＋上櫃，月更；證交法 26 條口徑、排除法人代表人列） |
GET /api/etfnav | ETF 折溢價＋申贖單位變化（市價/預估淨值/折溢價%，MIS 即時估） |
GET /api/etfnavtrend/0050 | 單一 ETF 折溢價/申贖逐日趨勢（收盤終值快照，2026-08 起累積） |
GET /api/sbl | 借券賣出餘額（股；上市＋上櫃全市場，法人放空主管道，日更） |
GET /api/qfiitrend/2330 | 個股外資持股率逐日趨勢（上市回補 60 交易日；上櫃自 2026-08 起累積） |
GET /api/attention | 處置與注意股票（上市＋上櫃公告） |
GET /api/salary | 非主管員工薪資平均/中位數（ESG 年度申報） |
GET /api/realtime?symbols=tse_2330.tw|otc_5483.tw | 延遲即時報價（白名單格式） |
GET /api/news?page=1 | 台股新聞 |
GET /api/broker/2330 | 券商分點買賣超——端口預留（固定 501＋status=reserved；上游驗證碼受阻，接通後回 branches 形狀） |
GET /api/health | 服務健康探針（UptimeRobot 等） |
curl -s "https://luvai.me/api/stock/2330" | jq .snapshot.cl
專案內建零依賴 MCP Server（mcp/stocklens_mcp.py），Claude Desktop / Claude Code 一段設定即可讓 AI 直接調用上表全部資料；
機器可讀規格見 /openapi.json、AI 爬蟲導引見 /llms.txt。
公平使用：公開部署每 IP 150 請求/分鐘；Pro 會員可在帳戶頁產生 API 金鑰（標頭 X-API-Key），專屬額度 600 次/分鐘、按金鑰計不受共用 IP 影響。行情為交易所盤後/延遲資訊，僅供參考，不構成投資建議。