開發者

真策 API

免費、公開、免金鑰。以 JSON 取得大中華市場機率。

真策上的每一個市場,都可透過 HTTPS 以 JSON 取得。無須註冊、無須 API 金鑰,也不必洽談速率方案——直接發出請求即可讀取數字。

我們這麼做,是因為無法查證的預測沒有太大意義。記者引用一個數字時,讀者應該能自行驗證;研究者取得一組序列時,不該還要去爬網頁。

驗證方式

不需要。所有端點皆為公開且唯讀,並附帶寬鬆的 CORS 標頭,因此你可以直接從瀏覽器、Notebook 或新聞編輯室的儀表板呼叫,無須中介代理。

使用 API 不需要真策帳號。只有在網站上進行交易時才需要註冊帳號。

curl https://trueindex.io/api/v1/stats

端點

GET/api/v1/markets

列出市場,依成交量由高至低排序。

category — politics · technology · economy · cross-strait · hk-macau · overseas
status — open(預設)· resolved · all
limit — 1–200,預設 100

curl "https://trueindex.io/api/v1/markets?category=politics&limit=5"

GET/api/v1/markets/{slug}

單一市場,包含近期機率走勢。

curl https://trueindex.io/api/v1/markets/smic-ships-3nm-by-2027

GET/api/v1/stats

全站彙總數據——與首頁標頭顯示的數字相同。

curl https://trueindex.io/api/v1/stats

回應格式

每個回應都是包含 data 與 meta 的物件。價格同時提供 0 到 1 之間的明確機率與整數美分價格,避免對數字含義產生誤解。

{
  "data": [
    {
      "slug": "smic-ships-3nm-by-2027",
      "url": "https://trueindex.io/markets/smic-ships-3nm-by-2027",
      "question": { "en": "Will SMIC ship a 3nm-class chip before end of 2027?" },
      "category": "technology",
      "status": "open",
      "probability": 0.4241,
      "price_cents": { "yes": 42, "no": 58 },
      "volume_24h": 797018628,
      "liquidity": 130000,
      "ends_at": "2027-12-29T21:20:09Z",
      "opening_book": true
    }
  ],
  "meta": {
    "api_version": "v1",
    "generated_at": "2026-08-30T20:50:38Z",
    "data_mode": "opening_book",
    "count": 1
  }
}

資料狀態

標記為 opening_book 的市場顯示平台提供的開盤流動性,此時 meta.data_mode 顯示為「opening_book」。當交易量累積後,該標記會自動清除。

合理使用

回應在邊緣節點快取 60 秒,因此比這更頻繁的輪詢只會得到相同內容,對雙方都無益。目前沒有硬性速率限制;若日後調整,會先在此公告,而不會無聲執行。

使用條款

免費供商業與非商業用途使用,包含付費刊物。
歡迎標註來源:「資料來源:Trueindex.io」,並盡可能連結至回應中 url 欄位的市場頁面。
請將 opening_book 數據視為開盤流動性,而非參與者成交量。
不提供任何擔保。價格屬機率性質,可能出錯,請勿作為財務決策的唯一依據。

如有疑問、需要更高流量或批次匯出: [email protected]