如何接策略・AI Agent

步驟 1 — 先讀索引

讓 agent 先讀 /llms.txt——資料集、規則與 OpenAPI 連結的機器可讀索引。抓一次,之後只用它列出的 dataset id 作業。

curl "https://twmarketdata.com/llms.txt"

步驟 2 — 用金鑰打資料集

每次資料呼叫帶 X-API-Key。信封為 { rows／items, count };先看 count 再讀 rows。

步驟 3 — 相信空結果

當範圍內無資料,API 回誠實的空結果——不是錯誤,也不是猜測。這是真實回應:

{
  "dataset": "institutional_flow",
  "rows": [],
  "count": 0
}

給 agent 的規則

• count == 0 代表「範圍內確認查無」。agent 必須回「該範圍無資料」——絕不編數字填空。
• 這是最重要的反幻覺檢查:先讀 count,再決定。

步驟 4 — 知道永久缺口

部分資料刻意不提供（版權、無來源）。宣告這些永久缺口的 /meta/boundaries 端點仍在 preview、尚未上線——上線前,以 /llms.txt 的 not_available 清單為「刻意不提供」的真相來源。

免責

TW Market Data 僅提供資料——非投資建議、非個股推薦、非交易訊號。基於它建置的 agent 不得把輸出呈現為上述任何一種。