讓 Agent 查 GUYI 收錄的資料

接入你的 Agent

1. 外部 Agent 使用 GET 查詢；現有公開 GET 端點不需要登入憑證。POST 適用 LUVAI 網站的同源程式，仍受既有來源驗證保護。
2. 先選需要的資料類別，並指定小筆數；例如只查個股時使用 types=stocks。
3. 回答時保留結果的來源連結與日期，檢查是否為你要的股票或事件；未找到資料時回報缺少，不補造數字。

GET 範例

curl --get "https://stock.luvai.net/api/v1/kb/query" --data-urlencode "q=2330" --data-urlencode "types=stocks" --data-urlencode "limit=5"

{"q":"2330","limit":5,"types":["stocks"]}

查詢參數與回傳

q

文字，最多 200 字。個股、主題、事件比對完整輸入；新聞以空白分詞，搜尋前 8 個詞中任一符合項目。標點會作為文字處理，不能用來執行搜尋運算子。空白查詢回傳空結果。

limit

整數，預設 10，每類最多 20 筆；超出範圍的整數會限制到 1–20。

types

stocks、topics、events、news，預設全部。GET 使用逗號分隔，POST 使用字串陣列；可只取需要的類別。

結果位於 results 的四個類別；meta.total_matches 是本次回傳筆數，meta.query_ms 是查詢耗時。回傳筆數不等於全庫命中總數。

meta.data_queried_at 依類別標示上次成功查詢的 ISO 時間。查詢可能沿用舊快取，這些時間會保留；不是新聞發布時間、事件日期或最新行情。沒有選取的類別不會有查詢時間，請保留各筆資料原有日期與來源。

• 個股：用 code 開啟 /stock/<code>。
• 主題：用 URL 編碼後的 slug 開啟 /topics/<slug>。
• 事件／新聞：用 id 開啟 /events/<id> 或 /news/<id>，並保留事件／發布日期與來源。

沒有結果或查詢失敗時

• 200、空結果：縮短關鍵字或換成代號；不要當成資料不存在的永久結論。
• 400：修正 JSON 或參數；error_code 與 field 可指出問題。
• 403、invalid_origin：POST 未通過來源驗證；外部 Agent 請使用 GET。
• 429：依 Retry-After 等待再試；目前每 IP 每分鐘最多 30 次。
• 503、query_paused：新的公開查詢暫停，沒有可用快取；依 Retry-After 等待，不要連續重送。這不是查無資料；有可用快取時仍回傳 200。
• 500：資料查詢暫時無法完成，稍後再試；服務不會改跑新聞全文模糊掃描。

查詢的是 GUYI 已收錄資料，可能延遲或不完整。輸入前請確認沒有個人敏感資訊；資料僅供研究與教學參考，不構成投資建議。