{"openapi": "3.0.3", "info": {"title": "股鏡 StockLens 台股公開 API", "version": "1.0", "description": "免金鑰台股資料：快照/K線(還原權息)/法人/資券/行事曆/訊號。官方交易所公開資料，delayed，僅供參考非投資建議。"}, "servers": [{"url": "https://luvai.me"}], "paths": {"/api/snapshot": {"get": {"summary": "全市場快照（2,300+ 檔：價量、PE/PB/殖利率、產業、52 週）", "responses": {"200": {"description": "JSON", "content": {"application/json": {"schema": {"type": "object"}}}}}}}, "/api/market": {"get": {"summary": "大盤總覽：恐懼貪婪六因子、寬度、法人、融資水位、期貨未平倉、Put/Call、台幣匯率、夜盤前瞻", "responses": {"200": {"description": "JSON", "content": {"application/json": {"schema": {"type": "object"}}}}}}}, "/api/cycle": {"get": {"summary": "大盤週期：站上 60/240 日均線比例＋騰落線（十年價格庫計算）", "responses": {"200": {"description": "JSON", "content": {"application/json": {"schema": {"type": "object"}}}}}}}, "/api/kline/{code}": {"get": {"summary": "個股 K 線（day/week/month；adj=1 還原權息）", "responses": {"200": {"description": "JSON", "content": {"application/json": {"schema": {"type": "object"}}}}}, "parameters": [{"name": "code", "in": "path", "required": true, "schema": {"type": "string"}, "example": "2330"}]}}, "/api/taiex": {"get": {"summary": "加權指數 K 線", "responses": {"200": {"description": "JSON", "content": {"application/json": {"schema": {"type": "object"}}}}}}}, "/api/stock/{code}": {"get": {"summary": "個股彙總：報價/基本資料/月營收/法人/資券/季損益趨勢/財務結構(負債比/流動比/ROE)/薪資/股利/警示/重大訊息(近30日)", "responses": {"200": {"description": "JSON", "content": {"application/json": {"schema": {"type": "object"}}}}}, "parameters": [{"name": "code", "in": "path", "required": true, "schema": {"type": "string"}, "example": "2330"}]}}, "/api/msgs": {"get": {"summary": "批量重大訊息（近 30 日主旨，自選清單用；codes 必帶、上限 100 檔）", "responses": {"200": {"description": "JSON", "content": {"application/json": {"schema": {"type": "object"}}}}}}}, "/api/evidence/{code}": {"get": {"summary": "單股證據時間軸：近 N 日重要變化事件（法人連買賣轉折/外資持股率窗變/借券窗變/董監月變/雷達異動/重大訊息/申報轉讓/除權息/營收年增），side 標證據方向非指令", "responses": {"200": {"description": "JSON", "content": {"application/json": {"schema": {"type": "object"}}}}}, "parameters": [{"name": "code", "in": "path", "required": true, "schema": {"type": "string"}, "example": "2330"}]}}, "/api/insttrend/{code}": {"get": {"summary": "三大法人買賣超逐日（外資/投信/自營）", "responses": {"200": {"description": "JSON", "content": {"application/json": {"schema": {"type": "object"}}}}}, "parameters": [{"name": "code", "in": "path", "required": true, "schema": {"type": "string"}, "example": "2330"}]}}, "/api/yearstats": {"get": {"summary": "52 週高低/年報酬（含息）/52 週位置（全市場）", "responses": {"200": {"description": "JSON", "content": {"application/json": {"schema": {"type": "object"}}}}}}}, "/api/fundmap": {"get": {"summary": "基本面速查：連續配息年數/年度股利（分割減資已換算今日股數基準）/累計EPS/營益率/券資比/單季EPS・營收年增/ROE/負債比/董監質押/盈餘品質（金融業 null）/填息率・平均填息天數（近8筆）（全市場）", "responses": {"200": {"description": "JSON", "content": {"application/json": {"schema": {"type": "object"}}}}}}}, "/api/intraday": {"get": {"summary": "盤中雷達：交易時段每 5 分掃描成交值前 240 檔（急拉/重挫/觸停/創52週高低）；收盤後回當日收盤照（frozen=true）", "responses": {"200": {"description": "JSON", "content": {"application/json": {"schema": {"type": "object"}}}}}}}, "/api/signals": {"get": {"summary": "盤後訊號掃描＋法人排行＋連買天數表", "responses": {"200": {"description": "JSON", "content": {"application/json": {"schema": {"type": "object"}}}}}}}, "/api/exdiv": {"get": {"summary": "行事曆：即將除權息＋股東會＋法說會＋停券預告 suspensions（融券回補時間軸，上市櫃官方公告）", "responses": {"200": {"description": "JSON", "content": {"application/json": {"schema": {"type": "object"}}}}}}}, "/api/fghistory": {"get": {"summary": "恐懼貪婪指數每日歷史（digest 存檔回讀）", "responses": {"200": {"description": "JSON", "content": {"application/json": {"schema": {"type": "object"}}}}}}}, "/api/futoi": {"get": {"summary": "三大法人台指期淨未平倉 60 日趨勢（期交所官網源）", "responses": {"200": {"description": "JSON", "content": {"application/json": {"schema": {"type": "object"}}}}}}}, "/api/bigtrader": {"get": {"summary": "大額交易人台指期淨部位 60 日（前十大全體/特定法人＋全市場OI）", "responses": {"200": {"description": "JSON", "content": {"application/json": {"schema": {"type": "object"}}}}}}}, "/api/optinst": {"get": {"summary": "外資臺指選擇權 CALL/PUT 未平倉淨額 60 日（口）", "responses": {"200": {"description": "JSON", "content": {"application/json": {"schema": {"type": "object"}}}}}}}, "/api/dcarank": {"get": {"summary": "定期定額交易戶數月排行（個股/ETF 各前 20，證交所；含資料月＋戶數月增）", "responses": {"200": {"description": "JSON", "content": {"application/json": {"schema": {"type": "object"}}}}}}}, "/api/dcahist": {"get": {"summary": "定期定額戶數全史趨勢（2020-10 起全史；曾進榜標的聯集，含已掉榜者歷史）", "responses": {"200": {"description": "JSON", "content": {"application/json": {"schema": {"type": "object"}}}}}}}, "/api/qfiis": {"get": {"summary": "全體外資及陸資持股比率＋5 日變化 chg5（%，上市＋上櫃全市場，日更）", "responses": {"200": {"description": "JSON", "content": {"application/json": {"schema": {"type": "object"}}}}}}}, "/api/insider": {"get": {"summary": "全體董監持股比 pct＋質押比 pledge（%，上市＋上櫃，月更；證交法 26 條口徑、排除法人代表人列）", "responses": {"200": {"description": "JSON", "content": {"application/json": {"schema": {"type": "object"}}}}}}}, "/api/etfnav": {"get": {"summary": "ETF 折溢價＋申贖單位變化（市價/預估淨值/折溢價%，MIS 即時估）", "responses": {"200": {"description": "JSON", "content": {"application/json": {"schema": {"type": "object"}}}}}}}, "/api/etfnavtrend/0050": {"get": {"summary": "單一 ETF 折溢價/申贖逐日趨勢（收盤終值快照，2026-08 起累積）", "responses": {"200": {"description": "JSON", "content": {"application/json": {"schema": {"type": "object"}}}}}}}, "/api/sbl": {"get": {"summary": "借券賣出餘額（股；上市＋上櫃全市場，法人放空主管道，日更）", "responses": {"200": {"description": "JSON", "content": {"application/json": {"schema": {"type": "object"}}}}}}}, "/api/qfiitrend/{code}": {"get": {"summary": "個股外資持股率逐日趨勢（上市回補 60 交易日；上櫃自 2026-08 起累積）", "responses": {"200": {"description": "JSON", "content": {"application/json": {"schema": {"type": "object"}}}}}, "parameters": [{"name": "code", "in": "path", "required": true, "schema": {"type": "string"}, "example": "2330"}]}}, "/api/attention": {"get": {"summary": "處置與注意股票（上市＋上櫃公告）", "responses": {"200": {"description": "JSON", "content": {"application/json": {"schema": {"type": "object"}}}}}}}, "/api/salary": {"get": {"summary": "非主管員工薪資平均/中位數（ESG 年度申報）", "responses": {"200": {"description": "JSON", "content": {"application/json": {"schema": {"type": "object"}}}}}}}, "/api/realtime": {"get": {"summary": "延遲即時報價（白名單格式）", "responses": {"200": {"description": "JSON", "content": {"application/json": {"schema": {"type": "object"}}}}}}}, "/api/news": {"get": {"summary": "台股新聞", "responses": {"200": {"description": "JSON", "content": {"application/json": {"schema": {"type": "object"}}}}}}}, "/api/broker/{code}": {"get": {"summary": "券商分點買賣超——端口預留（固定 501＋status=reserved；上游驗證碼受阻，接通後回 branches 形狀）", "responses": {"200": {"description": "JSON", "content": {"application/json": {"schema": {"type": "object"}}}}}, "parameters": [{"name": "code", "in": "path", "required": true, "schema": {"type": "string"}, "example": "2330"}]}}, "/api/health": {"get": {"summary": "服務健康探針（UptimeRobot 等）", "responses": {"200": {"description": "JSON", "content": {"application/json": {"schema": {"type": "object"}}}}}}}}}