Binance 預測市場 API:端點、驗證與涵蓋範圍
一份實用的參考,介紹 Binance Wallet 預測市場專用的 REST 命名空間,包含每個端點回傳什麼,以及歷史紀錄從何時開始。
DepthFeed 在 /v3/binance-prediction 之下開放由 Predict.fun 提供支援的 Binance Wallet 市場,並提供相容的別名 /v3/predictfun。客戶使用 DepthFeed API 金鑰驗證——而不是 Binance 金鑰或個人錢包——並可查詢市場發掘、最新訂單簿、歷史快照與獨立的價格序列指標。
API 涵蓋範圍
這個專用命名空間把 Binance 預測市場紀錄與網站的 Polymarket、Kalshi 與 Limitless 路由分開,同時保留熟悉的回應格式與游標分頁。
| 端點 | 用途 |
|---|---|
| GET /v3/binance-prediction/markets | 依幣種、時間窗口與狀態發掘並篩選市場 |
| GET /v3/binance-prediction/{market_id}/orderbook/latest | 回傳最新記錄的完整 L2 訂單簿 |
| GET /v3/binance-prediction/{market_id}/snapshots | 以游標瀏覽記錄下來的歷史完整 L2 快照 |
| GET /v3/binance-prediction/{market_id}/timeseries | 查詢機率、顯示價格或最新成交樣本 |
| GET /v3/binance-prediction/{market_id}/trades | 保留路由;歷史成交紀錄仍在重建中 |
驗證不使用 Binance 金鑰
API 客戶送出的是自己的 DepthFeed bearer 金鑰。他們不需要提供 Binance 唯讀金鑰、配對 Binance Agentic Wallet,或維護 Predict.fun 工作階段。DepthFeed 使用一個穩定的封存供應商,與公開的 Predict.fun 目錄相對應。
Binance 預測市場路由僅提供給付費的 DepthFeed 方案。驗證方式與錯誤回應格式,與 DepthFeed V3 API 的其他部分一致。
一筆市場紀錄包含什麼
市場發掘會回傳 Binance 主題識別碼與 Predict.fun 市場識別碼,連同條件與結果 token 的元資料。紀錄還包含資產、市場窗口、時間戳、狀態、結算結果、勝出結果、成交量、流動性、參與人數、鏈別,以及交易所合約欄位(如果有的話)。
把這些識別碼保留在一起,在短天期市場到期之後尤其重要:研究者能保留完整的市場身分與結果標籤,而不必試著從標題字串去推斷。
價格指標刻意分開
timeseries 路由接受 chance、price 與 last_trade 三種指標。它們不是同義詞:顯示機率是介面的機率訊號,顯示價格是它報出的市場價值,last_trade 則是最新的成交樣本。模型可以選擇自己需要的訊號,而不會在不知不覺中把三者混成同一欄。
歷史紀錄的邊界
決定性的 5 分鐘與 15 分鐘目錄、結算、成交量與流動性歷史,對 BTC 回填至 2026 年 5 月 5 日,對 ETH 與 BNB 回填至 2026 年 6 月 29 日。三項採樣價格指標從 7 月 17 日開始。標準化的 BTC 15 分鐘完整 L2 生命週期面板從 6 月 26 日開始,更廣泛、穩定的每分鐘前向深度擷取則從 7 月 26 日開始。
trades 路由目前在 BNB Smart Chain 的成交紀錄重建完成之前,回傳空的歷史資料集。較早的鏈下掛單無法從結算日誌還原,因此 API 不會捏造擷取之前的訂單簿歷史。
Key takeaways
- 01使用 /v3/binance-prediction 作為專用 API;/v3/predictfun 是相容的別名。
- 02客戶以 DepthFeed 驗證,不需要 Binance 金鑰或錢包工作階段。
- 03提供市場發掘、最新訂單簿、歷史快照,以及獨立的價格指標。
- 04BTC 目錄歷史從 2026 年 5 月 5 日開始;ETH 與 BNB 從 6 月 29 日開始。BTC 15 分鐘生命週期 L2 面板從 6 月 26 日開始,更廣泛的前向深度從 7 月 26 日開始。
- 05保留中的 trades 路由目前尚未包含歷史成交。
一份實用的參考,介紹 Binance Wallet 預測市場專用的 REST 命名空間,包含每個端點回傳什麼,以及歷史紀錄從何時開始。
免費開始