{"openapi":"3.1.0","info":{"title":"888 Stock Quant Platform API","description":"\n    🚀 **888 Stock Quant 多維量化交易決策系統 REST API**\n    \n    支援基於 DuckDB 高效能時序資料庫之即時量化訊號查詢：\n    * 🗡️ **玄鐵重劍策略**：MA60/120 均線趨勢回調技術買點\n    * 🤖 **LSTM 深度學習**：下一交易日價格預測與漲跌幅排行榜\n    * ⭐ **多維共振篩選**：技術 ∩ 籌碼 ∩ ML ∩ 估值 之 `🏆三重共振` / `土洋合買`\n    * 🌐 **美股宏觀門檻**：S&P 500 / VIX / 費城半導體 即時曝險評估\n    * 🦆 **DuckDB 引擎**：支援 560,000+ 歷史時序與籌碼數據零拷貝秒級查詢\n    ","version":"2.4.0"},"paths":{"/api/v1/predictions/latest":{"get":{"tags":["Predictions & Quant Signals"],"summary":"取得最新量化日報批次預測與指標","description":"查詢最新量化批次運算結果。預設 (batch_only=True) 僅回傳最新成功執行批次之標的，並附帶 batch_date, data_as_of, age_hours 與 is_stale 狀態。","operationId":"get_latest_predictions_api_v1_predictions_latest_get","parameters":[{"name":"index_name","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"指數篩選 (台灣50, 台灣中型100, S&P500)","title":"Index Name"},"description":"指數篩選 (台灣50, 台灣中型100, S&P500)"},{"name":"model_name","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"策略篩選 (玄鐵重劍, LSTM, 多維共振)","title":"Model Name"},"description":"策略篩選 (玄鐵重劍, LSTM, 多維共振)"},{"name":"batch_only","in":"query","required":false,"schema":{"type":"boolean","description":"是否僅回傳最新執行批次 (預設: True；設為 False 則回傳各標的歷史最新一筆)","default":true,"title":"Batch Only"},"description":"是否僅回傳最新執行批次 (預設: True；設為 False 則回傳各標的歷史最新一筆)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"description":"回傳數量","default":50,"title":"Limit"},"description":"回傳數量"},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"description":"分頁偏移量","default":0,"title":"Offset"},"description":"分頁偏移量"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PredictionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/predictions/resonance":{"get":{"tags":["Predictions & Quant Signals"],"summary":"查詢多策略交集與 🏆 三重共振焦點股","description":"篩選同時符合「技術面均線買點 ∩ LSTM 看漲 ∩ 投信/法人鎖碼」的多策略共振股票。","operationId":"get_resonance_candidates_api_v1_predictions_resonance_get","parameters":[{"name":"index_name","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"指數篩選","title":"Index Name"},"description":"指數篩選"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"description":"回傳數量上限","default":50,"title":"Limit"},"description":"回傳數量上限"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PredictionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/predictions/xuantie":{"get":{"tags":["Predictions & Quant Signals"],"summary":"查詢玄鐵重劍技術面均線回調買點","description":"篩選處於中長期多頭趨勢且當前股價剛好回踩 MA60 季線或 MA120 半年線之支撐買點標的。","operationId":"get_xuantie_candidates_api_v1_predictions_xuantie_get","parameters":[{"name":"index_name","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"指數篩選","title":"Index Name"},"description":"指數篩選"},{"name":"pullback_type","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"均線回調篩選 (MA60, MA120)","title":"Pullback Type"},"description":"均線回調篩選 (MA60, MA120)"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"description":"回傳數量上限","default":50,"title":"Limit"},"description":"回傳數量上限"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PredictionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/predictions/lstm/top-bullish":{"get":{"tags":["Predictions & Quant Signals"],"summary":"查詢 LSTM 預測漲幅 TOP N 潛力股","description":"依據 LSTM 深度學習模型輸出之潛在漲幅百分比（Potential %）由高到低排序，取得短線看漲排行。","operationId":"get_top_bullish_api_v1_predictions_lstm_top_bullish_get","parameters":[{"name":"index_name","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"指數篩選","title":"Index Name"},"description":"指數篩選"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"取得前 N 檔","default":10,"title":"Limit"},"description":"取得前 N 檔"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PredictionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/predictions/lstm/top-bearish":{"get":{"tags":["Predictions & Quant Signals"],"summary":"查詢 LSTM 預測跌幅 TOP N 避險/做空股","description":"依據 LSTM 深度學習模型輸出之潛在跌幅由大到小排序，用於避險或潛在放空觀察。","operationId":"get_top_bearish_api_v1_predictions_lstm_top_bearish_get","parameters":[{"name":"index_name","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"指數篩選","title":"Index Name"},"description":"指數篩選"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"取得前 N 檔","default":10,"title":"Limit"},"description":"取得前 N 檔"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PredictionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/predictions/timesfm/top-bullish":{"get":{"tags":["Predictions & Quant Signals"],"summary":"查詢 Google TimesFM 預測漲幅 TOP N 潛力股","description":"依據 Google TimesFM 時序大模型輸出之潛在漲幅百分比（Potential %）由高到低排序，取得看漲排行。","operationId":"get_timesfm_top_bullish_api_v1_predictions_timesfm_top_bullish_get","parameters":[{"name":"index_name","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"指數篩選","title":"Index Name"},"description":"指數篩選"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"取得前 N 檔","default":10,"title":"Limit"},"description":"取得前 N 檔"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PredictionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/predictions/timesfm/top-bearish":{"get":{"tags":["Predictions & Quant Signals"],"summary":"查詢 Google TimesFM 預測跌幅 TOP N 避險股","description":"依據 Google TimesFM 時序大模型輸出之潛在跌幅由大到小排序，用於避險或潛在破底防禦。","operationId":"get_timesfm_top_bearish_api_v1_predictions_timesfm_top_bearish_get","parameters":[{"name":"index_name","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"指數篩選","title":"Index Name"},"description":"指數篩選"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"取得前 N 檔","default":10,"title":"Limit"},"description":"取得前 N 檔"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PredictionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/predictions/history/{ticker}":{"get":{"tags":["Predictions & Quant Signals"],"summary":"查詢單一標的歷史預測軌跡","description":"取得指定股票代號（如 2330.TW、AAPL）的時間序列歷史預測與實際走勢軌跡，便於回測與可視化。","operationId":"get_ticker_history_api_v1_predictions_history__ticker__get","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string","title":"Ticker"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":365,"minimum":1,"description":"回溯筆數","default":30,"title":"Limit"},"description":"回溯筆數"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PredictionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/predictions/resolve/{query}":{"get":{"tags":["Predictions & Quant Signals"],"summary":"解析股票代號或公司名稱","description":"將股票代號、英文名稱或中文公司名稱解析為可查詢的標準代號。","operationId":"resolve_stock_ticker_api_v1_predictions_resolve__query__get","parameters":[{"name":"query","in":"path","required":true,"schema":{"type":"string","title":"Query"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TickerResolutionResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/macro/latest":{"get":{"tags":["Macro Regime & Risk Gate"],"summary":"取得當前大盤/宏觀風控狀態與建議曝險","description":"即時評估台股或美股大盤核心指標，回傳當前市場情境與建議倉位比例。\n支援 market=tw (加權指數/費半連動) 或 market=us (S&P500/VIX/費半)。\n同時整合 Investing.com 之聯準會降息機率與重磅催化劑事件。","operationId":"get_latest_macro_api_v1_macro_latest_get","parameters":[{"name":"market","in":"query","required":false,"schema":{"type":"string","default":"us","title":"Market"}},{"name":"index_name","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Index Name"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MacroRegimeResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/macro/investing/summary":{"get":{"tags":["Macro Regime & Risk Gate"],"summary":"取得 Investing.com 宏觀數據與美股行事曆彙整","description":"取得聯準會利率機率、美股重量級財報、大宗原物料與重磅總經行事曆之彙整資料","operationId":"get_investing_summary_api_v1_macro_investing_summary_get","parameters":[{"name":"refresh","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Refresh"}},{"name":"force_refresh","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Force Refresh"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/macro/investing/fed-rate":{"get":{"tags":["Macro Regime & Risk Gate"],"summary":"取得 CME 聯準會利率監控工具 (FedWatch) 降息機率","description":"取得下次 FOMC 會議時間與各目標利率區間機率分布","operationId":"get_fed_rate_api_v1_macro_investing_fed_rate_get","parameters":[{"name":"refresh","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Refresh"}},{"name":"force_refresh","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Force Refresh"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/macro/investing/earnings-calendar":{"get":{"tags":["Macro Regime & Risk Gate"],"summary":"取得美股重要企業財報行事曆","description":"取得近期即將公佈財報的美股企業、預估 EPS、預估營收與市值","operationId":"get_earnings_calendar_api_v1_macro_investing_earnings_calendar_get","parameters":[{"name":"refresh","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Refresh"}},{"name":"force_refresh","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Force Refresh"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/macro/investing/economic-calendar":{"get":{"tags":["Macro Regime & Risk Gate"],"summary":"取得重磅總體經濟數據行事曆","description":"取得美國與全球重要總經指標公佈行事曆 (CPI, PCE, 非農, FOMC, GDP)","operationId":"get_economic_calendar_api_v1_macro_investing_economic_calendar_get","parameters":[{"name":"refresh","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Refresh"}},{"name":"force_refresh","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Force Refresh"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/macro/investing/commodities":{"get":{"tags":["Macro Regime & Risk Gate"],"summary":"取得關鍵大宗商品與原物料行情","description":"取得黃金、銅博士、WTI 原油之即時行情與週期漲跌","operationId":"get_commodities_api_v1_macro_investing_commodities_get","parameters":[{"name":"refresh","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Refresh"}},{"name":"force_refresh","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Force Refresh"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/macro/polymarket/sentiment":{"get":{"tags":["Macro Regime & Risk Gate"],"summary":"取得 Polymarket 真金白銀預測市場宏觀情緒與重大催化劑","description":"透過 2MD 與 DoH (8.8.8.8 / 1.1.1.1) 取得 Polymarket 真金白銀預測市場數據：\n包含聯準會降息/維持利率機率、地緣關稅風險、科技七巨頭動向與美國經濟衰退預期。","operationId":"get_polymarket_sentiment_api_v1_macro_polymarket_sentiment_get","parameters":[{"name":"refresh","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Refresh"}},{"name":"force_refresh","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Force Refresh"}},{"name":"category","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Category"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/stats/summary":{"get":{"tags":["Database & System Stats"],"summary":"取得本地 DuckDB 時序庫全盤統計","description":"查詢 DuckDB 總記錄筆數、獨立標的數量、資料涵蓋之最早/最新時間戳記與指數範圍。","operationId":"get_database_summary_api_v1_stats_summary_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DBStatsResponse"}}}}}}},"/api/v1/market/stats":{"get":{"tags":["Market Data & Institutional Flows"],"summary":"取得時序庫行情與法人籌碼整體統計","description":"查詢 DuckDB 中台股全市場日 K 棒、三大法人歷史進出表、券商分點主力與預測記錄之數據量。","operationId":"get_market_statistics_api_v1_market_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketStatsResponse"}}}}}}},"/api/v1/market/universe":{"get":{"tags":["Market Data & Institutional Flows"],"summary":"取得全球證券清冊與快取 freshness","description":"回傳最近清冊；上游失敗時以 stale 欄位明確表示仍使用最後成功快照。","operationId":"get_market_universe_api_v1_market_universe_get","parameters":[{"name":"source_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"來源: TW, US-NASDAQ-TRADER, HK-HKEX","title":"Source Id"},"description":"來源: TW, US-NASDAQ-TRADER, HK-HKEX"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarketUniverseResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/market/institutional/top":{"get":{"tags":["Market Data & Institutional Flows"],"summary":"取得三大法人買賣超排行榜","description":"查詢三大法人（外資、投信、自營商）當日買超與賣超排行焦點股。","operationId":"get_top_institutional_flows_api_v1_market_institutional_top_get","parameters":[{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"指定日期 (YYYY-MM-DD)，預設為最新交易日","title":"Date"},"description":"指定日期 (YYYY-MM-DD)，預設為最新交易日"},{"name":"order_by","in":"query","required":false,"schema":{"type":"string","description":"排序依據: total_net, foreign_net, trust_net, dealer_net","default":"total_net","title":"Order By"},"description":"排序依據: total_net, foreign_net, trust_net, dealer_net"},{"name":"sort_dir","in":"query","required":false,"schema":{"type":"string","description":"排序方向: desc (買超榜), asc (賣超榜)","default":"desc","title":"Sort Dir"},"description":"排序方向: desc (買超榜), asc (賣超榜)"},{"name":"market","in":"query","required":false,"schema":{"type":"string","description":"市場篩選: ALL, TWSE, TPEX","default":"ALL","title":"Market"},"description":"市場篩選: ALL, TWSE, TPEX"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"回傳數量","default":20,"title":"Limit"},"description":"回傳數量"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/InstitutionalFlowItem"},"title":"Response Get Top Institutional Flows Api V1 Market Institutional Top Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/market/institutional/dates":{"get":{"tags":["Market Data & Institutional Flows"],"summary":"取得法人籌碼所有可用歷史交易日","description":"回傳 DuckDB 中 tw_institutional_daily 所有歷史交易日期清單 (降冪排序)。","operationId":"get_available_institutional_dates_api_v1_market_institutional_dates_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":500,"minimum":1,"description":"回傳天數上限","default":60,"title":"Limit"},"description":"回傳天數上限"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"string"},"title":"Response Get Available Institutional Dates Api V1 Market Institutional Dates Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/market/institutional/{ticker}":{"get":{"tags":["Market Data & Institutional Flows"],"summary":"取得單一個股歷史法人進出時序","description":"查詢特定標的（如 2330.TW）過去 60 個交易日之三大法人連續進出時序。","operationId":"get_ticker_institutional_history_api_v1_market_institutional__ticker__get","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string","title":"Ticker"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":250,"minimum":1,"description":"歷史天數","default":60,"title":"Limit"},"description":"歷史天數"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/InstitutionalFlowItem"},"title":"Response Get Ticker Institutional History Api V1 Market Institutional  Ticker  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/market/broker/summary/{ticker}":{"get":{"tags":["Market Data & Institutional Flows"],"summary":"取得個股券商分點主力買賣超摘要","description":"查詢特定標的在過去 N 個交易日內，買超前 15 名與賣超前 15 名之券商分點合計統計。","operationId":"get_ticker_broker_summary_api_v1_market_broker_summary__ticker__get","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string","title":"Ticker"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":120,"minimum":1,"description":"統計天數區間","default":20,"title":"Days"},"description":"統計天數區間"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/market/broker/trades/{ticker}":{"get":{"tags":["Market Data & Institutional Flows"],"summary":"取得個股近期券商分點明細","description":"查詢特定標的最近的券商分點每日進出明細紀錄。","operationId":"get_ticker_broker_trades_api_v1_market_broker_trades__ticker__get","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string","title":"Ticker"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"description":"明細筆數","default":60,"title":"Limit"},"description":"明細筆數"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/market/broker/trend/{ticker}":{"get":{"tags":["Market Data & Institutional Flows"],"summary":"取得個股目標券商分點累計買賣超趨勢時序","description":"計算特定標的各關鍵券商分點在歷史區間內的每日「累計買賣超 (張)」時間序列，用於繪製分點走勢圖。","operationId":"get_ticker_broker_trend_api_v1_market_broker_trend__ticker__get","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"type":"string","title":"Ticker"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","maximum":120,"minimum":5,"description":"時序天數","default":30,"title":"Days"},"description":"時序天數"},{"name":"top_n","in":"query","required":false,"schema":{"type":"integer","maximum":20,"minimum":2,"description":"取買賣超最顯著之分點數量","default":8,"title":"Top N"},"description":"取買賣超最顯著之分點數量"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/market/company-profile":{"get":{"tags":["Market Data & Institutional Flows"],"summary":"取得個股公司簡介與即時新聞 (2md / Yahoo)","description":"透過 2md.aiurl.tw 與 Yahoo 股市實時提取公司繁體中文簡介、核心營運業務與最新新聞。","operationId":"get_company_profile_endpoint_api_v1_market_company_profile_get","parameters":[{"name":"ticker","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ticker"}},{"name":"query","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"股票代號或名稱，如 9945.TW, 2330, 台積電, AAPL","title":"Query"},"description":"股票代號或名稱，如 9945.TW, 2330, 台積電, AAPL"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyProfileResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/market/company-profile/{ticker}":{"get":{"tags":["Market Data & Institutional Flows"],"summary":"取得個股公司簡介與即時新聞 (2md / Yahoo)","description":"透過 2md.aiurl.tw 與 Yahoo 股市實時提取公司繁體中文簡介、核心營運業務與最新新聞。","operationId":"get_company_profile_endpoint_api_v1_market_company_profile__ticker__get","parameters":[{"name":"ticker","in":"path","required":true,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ticker"}},{"name":"query","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"股票代號或名稱，如 9945.TW, 2330, 台積電, AAPL","title":"Query"},"description":"股票代號或名稱，如 9945.TW, 2330, 台積電, AAPL"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyProfileResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/market/company-profiles":{"get":{"tags":["Market Data & Institutional Flows"],"summary":"並發批次取得多支股票之公司簡介與即時新聞","description":"並發非同步取得多支股票之公司簡介、營運摘要與最新新聞，專為前端背景預載設計。","operationId":"get_company_profiles_batch_endpoint_api_v1_market_company_profiles_get","parameters":[{"name":"tickers","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"逗號分隔的股票代號，如 2330.TW,9945.TW,MDT,NEM","title":"Tickers"},"description":"逗號分隔的股票代號，如 2330.TW,9945.TW,MDT,NEM"}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/BatchCompanyProfilesRequest"},{"type":"null"}],"title":"Payload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/market/company-profiles/batch":{"post":{"tags":["Market Data & Institutional Flows"],"summary":"並發批次取得多支股票之公司簡介與即時新聞","description":"並發非同步取得多支股票之公司簡介、營運摘要與最新新聞，專為前端背景預載設計。","operationId":"get_company_profiles_batch_endpoint_api_v1_market_company_profiles_batch_post","parameters":[{"name":"tickers","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"逗號分隔的股票代號，如 2330.TW,9945.TW,MDT,NEM","title":"Tickers"},"description":"逗號分隔的股票代號，如 2330.TW,9945.TW,MDT,NEM"}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/BatchCompanyProfilesRequest"},{"type":"null"}],"title":"Payload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/health":{"get":{"tags":["Health Check"],"summary":"Health Check","operationId":"health_check_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}}}}}}},"components":{"schemas":{"BatchCompanyProfilesRequest":{"properties":{"tickers":{"items":{"type":"string"},"type":"array","title":"Tickers"}},"type":"object","required":["tickers"],"title":"BatchCompanyProfilesRequest"},"CompanyProfileResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"ticker":{"type":"string","title":"Ticker"},"raw_code":{"type":"string","title":"Raw Code"},"name":{"type":"string","title":"Name"},"industry":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Industry","default":"綜合產業"},"business_summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Business Summary","default":""},"chairman":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Chairman","default":""},"market_cap":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Market Cap","default":""},"established":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Established","default":""},"recent_news":{"items":{"additionalProperties":{"type":"string"},"type":"object"},"type":"array","title":"Recent News","default":[]},"links":{"additionalProperties":{"type":"string"},"type":"object","title":"Links","default":{}},"source":{"type":"string","title":"Source","default":"2md"}},"type":"object","required":["ticker","raw_code","name"],"title":"CompanyProfileResponse"},"DBStatsResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"total_records":{"type":"integer","title":"Total Records","description":"DuckDB 總記錄筆數"},"distinct_tickers":{"type":"integer","title":"Distinct Tickers","description":"涵蓋之獨立股票數量"},"earliest_timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Earliest Timestamp","description":"最早期預測時間戳記"},"latest_timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Latest Timestamp","description":"最新預測時間戳記"},"indices":{"items":{"type":"string"},"type":"array","title":"Indices","description":"已分析指數清單"},"models":{"items":{"type":"string"},"type":"array","title":"Models","description":"已啟用模型清單"}},"type":"object","required":["total_records","distinct_tickers"],"title":"DBStatsResponse"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HealthResponse":{"properties":{"status":{"type":"string","title":"Status","default":"healthy"},"timestamp":{"type":"string","title":"Timestamp"},"version":{"type":"string","title":"Version","default":"2.4.0"},"duckdb_records":{"type":"integer","title":"Duckdb Records"}},"type":"object","required":["timestamp","duckdb_records"],"title":"HealthResponse"},"InstitutionalFlowItem":{"properties":{"date":{"type":"string","title":"Date"},"ticker":{"type":"string","title":"Ticker"},"raw_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Raw Code"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"foreign_net":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Foreign Net","default":0},"trust_net":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Trust Net","default":0},"dealer_net":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Dealer Net","default":0},"total_net":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Net","default":0},"foreign_ratio":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Foreign Ratio","default":0.0},"market":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Market"}},"type":"object","required":["date","ticker"],"title":"InstitutionalFlowItem"},"MacroRegimeResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"market":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Market","description":"所屬市場 (TW 或 US)","default":"US"},"regime_name":{"type":"string","title":"Regime Name","description":"大盤/宏觀環境 (全面多頭, 多頭回調, 避險防禦, 極度恐慌)"},"exposure":{"type":"number","title":"Exposure","description":"建議投資曝險比例 (0.0 ~ 1.0)"},"vix":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Vix","description":"VIX 恐慌指數"},"spy_above_ma60":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Spy Above Ma60","description":"S&P500 是否站穩季線"},"sox_above_ma60":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Sox Above Ma60","description":"費城半導體是否站穩季線"},"twii_above_ma60":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Twii Above Ma60","description":"台灣加權指數是否站穩季線"},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings","description":"風控警示清單"},"fed_rate":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Fed Rate","description":"聯準會降息機率 (Investing.com CME FedWatch)"},"commodities":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Commodities","description":"關鍵大宗商品 (黃金、銅博士、原油)"},"earnings_calendar":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Earnings Calendar","description":"美股重量級財報行事曆"},"economic_calendar":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Economic Calendar","description":"重磅總經行事曆"},"catalyst_alerts":{"items":{"type":"string"},"type":"array","title":"Catalyst Alerts","description":"催化劑事件預警"},"polymarket":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Polymarket","description":"Polymarket 真金白銀預測市場宏觀情緒"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp"}},"type":"object","required":["regime_name","exposure"],"title":"MacroRegimeResponse"},"MarketStatsResponse":{"properties":{"total_bars":{"type":"integer","title":"Total Bars"},"total_institutional_records":{"type":"integer","title":"Total Institutional Records"},"total_broker_records":{"type":"integer","title":"Total Broker Records","default":0},"total_predictions":{"type":"integer","title":"Total Predictions"},"latest_market_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Latest Market Date"},"latest_institutional_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Latest Institutional Date"}},"type":"object","required":["total_bars","total_institutional_records","total_predictions"],"title":"MarketStatsResponse"},"MarketUniverseResponse":{"properties":{"source_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Id"},"count":{"type":"integer","title":"Count"},"stale":{"type":"boolean","title":"Stale"},"snapshot_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Snapshot Date"},"last_success_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Success At"},"cache_age_days":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Cache Age Days"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"items":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Items"}},"type":"object","required":["count","stale","items"],"title":"MarketUniverseResponse"},"PredictionResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"batch_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Batch Date","description":"最新批次分析日期 (YYYY-MM-DD)"},"latest_batch_timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Latest Batch Timestamp","description":"最新批次完整時間戳記"},"is_stale":{"type":"boolean","title":"Is Stale","description":"整個批次資料是否已逾期 (> 48h)","default":false},"count":{"type":"integer","title":"Count","description":"符合條件的記錄總數"},"data":{"items":{"$ref":"#/components/schemas/StockPredictionItem"},"type":"array","title":"Data","description":"預測結果清單"}},"type":"object","required":["count"],"title":"PredictionResponse"},"StockPredictionItem":{"properties":{"index_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Index Name","description":"指數名稱 (台灣50, 台灣中型100, S&P500 等)"},"model_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model Name","description":"模型/策略名稱 (玄鐵重劍, LSTM, 多維共振)"},"strategy_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Strategy Type","description":"策略類別"},"ticker":{"type":"string","title":"Ticker","description":"股票代號 (如 2330.TW, AAPL)"},"current_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Current Price","description":"當前/最新收盤價"},"predicted_price":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Predicted Price","description":"預測明日目標價"},"potential":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Potential","description":"預期漲跌幅百分比 (%)"},"ma5":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Ma5","description":"5日均線"},"ma10":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Ma10","description":"10日均線"},"ma60":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Ma60","description":"60日均線 (季線)"},"ma120":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Ma120","description":"120日均線 (半年線)"},"ma250":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Ma250","description":"250日均線 (年線)"},"pullback_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pullback Type","description":"均線回調類型 (如 MA60 (+2.1%))"},"pe":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pe","description":"本益比 (Price to Earnings)"},"pb":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Pb","description":"股價淨值比 (Price to Book)"},"forward_pe":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Forward Pe","description":"預估本益比"},"ev_ebitda":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Ev Ebitda","description":"企業價值倍數"},"period":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Period","description":"訓練週期"},"timestamp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timestamp","description":"預測產出時間戳記 (ISO 8601)"},"analysis_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Analysis Date","description":"分析所屬日期 (YYYY-MM-DD)"},"data_as_of":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Data As Of","description":"資料產生時間戳記 (ISO 8601)"},"age_hours":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Age Hours","description":"資料產生迄今經過小時數"},"is_stale":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Is Stale","description":"資料是否已超過 48 小時過期"},"macro_regime":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Macro Regime","description":"當時美股宏觀市場環境"},"trust_net_5d":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Trust Net 5D","description":"投信 5 日累計買賣超 (張)"},"foreign_net_5d":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Foreign Net 5D","description":"外資 5 日累計買賣超 (張)"},"risk_reward_ratio":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Risk Reward Ratio","description":"盈虧比 (TimesFM 90%分位數上行 / 10%下行)"},"tags":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tags","description":"綜合標籤 (如 🏆三重共振 | 土洋合買)"}},"type":"object","required":["ticker"],"title":"StockPredictionItem"},"TickerResolutionResponse":{"properties":{"success":{"type":"boolean","title":"Success","default":true},"query":{"type":"string","title":"Query"},"ticker":{"type":"string","title":"Ticker"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"matched_by":{"type":"string","title":"Matched By"}},"type":"object","required":["query","ticker","matched_by"],"title":"TickerResolutionResponse"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}