{"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.2.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/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/macro/latest":{"get":{"tags":["Macro Regime & Risk Gate"],"summary":"取得當前美股宏觀風控狀態與建議曝險","description":"即時評估美股三大核心指標（S&P 500、VIX 恐慌指數、SOX 費城半導體），回傳當前全球環境與建議倉位比例。","operationId":"get_latest_macro_api_v1_macro_latest_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MacroRegimeResponse"}}}}}}},"/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/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"}}}}}}},"/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":{"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.2.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},"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":"費城半導體是否站穩季線"},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings","description":"風控警示清單"},"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"},"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 日累計買賣超 (張)"},"tags":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tags","description":"綜合標籤 (如 🏆三重共振 | 土洋合買)"}},"type":"object","required":["ticker"],"title":"StockPredictionItem"},"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"}}}}