Binance Prediction Market API: Endpoints, Authentication and Coverage
A practical reference to the dedicated REST namespace for Binance Wallet prediction markets, including what each endpoint returns and where the historical record begins.
DepthFeed exposes Predict.fun-backed Binance Wallet markets under /v3/binance-prediction, with /v3/predictfun as a compatible alias. Customers authenticate with a DepthFeed API key—not a Binance key or personal wallet—and can query market discovery, latest books, historical snapshots and separate price-series metrics.
The API surface
The dedicated namespace keeps Binance prediction-market records separate from the site's Polymarket, Kalshi and Limitless routes while preserving familiar response envelopes and cursor pagination.
| Endpoint | Purpose |
|---|---|
| GET /v3/binance-prediction/markets | Discover and filter markets by coin, window and status |
| GET /v3/binance-prediction/{market_id}/orderbook/latest | Return the newest recorded full-L2 book |
| GET /v3/binance-prediction/{market_id}/snapshots | Cursor through recorded historical full-L2 snapshots |
| GET /v3/binance-prediction/{market_id}/timeseries | Query chance, displayed price or latest-trade samples |
| GET /v3/binance-prediction/{market_id}/trades | Reserved route; historical fills are still being reconstructed |
Authentication does not use a Binance key
API customers send their DepthFeed bearer key. They do not provide a Binance read-only key, pair a Binance Agentic Wallet or maintain a Predict.fun session. DepthFeed uses a stable archive provider matched to the public Predict.fun catalogue.
The Binance prediction routes are available on paid DepthFeed plans. The authentication and error envelope match the rest of the DepthFeed V3 API.
What a market record contains
Market discovery returns Binance topic identifiers and Predict.fun market identifiers alongside condition and outcome-token metadata. Records also include the asset, market window, timestamps, status, resolution, winning outcome, volume, liquidity, participant count, chain and exchange-contract fields when available.
Keeping those identifiers together matters after short-dated markets expire: a researcher can retain the complete market identity and outcome label instead of trying to infer them from a title string.
Price metrics are deliberately separate
The timeseries route accepts chance, price and last_trade metrics. They are not synonyms. Displayed probability is the interface's probability signal, displayed price is its quoted market value, and last_trade is the newest execution sample. A model can choose the intended signal without silently collapsing all three into one column.
Historical boundaries
Deterministic 5-minute and 15-minute catalogue, resolution, volume and liquidity history is backfilled from May 5, 2026 for BTC and June 29, 2026 for ETH and BNB. The three sampled price metrics begin July 17. A standardized BTC 15-minute full-L2 lifecycle panel begins June 26, while broader stable one-minute forward depth capture begins July 26.
The trades route currently returns an empty historical dataset while BNB Smart Chain fills are reconstructed. Earlier off-chain resting orders cannot be recovered from settlement logs, so the API does not manufacture pre-capture book history.
Key takeaways
- 01Use /v3/binance-prediction for the dedicated API; /v3/predictfun is a compatible alias.
- 02Customers authenticate with DepthFeed and do not need a Binance key or wallet session.
- 03Market discovery, latest books, historical snapshots and separate price metrics are available.
- 04BTC catalogue history starts May 5, 2026; ETH and BNB start June 29. The BTC 15-minute lifecycle L2 panel starts June 26 and broader forward depth starts July 26.
- 05The reserved trades route does not yet contain historical fills.
DepthFeed serves Binance prediction-market history and recorded full-depth books over the REST API. Free Explorer tier, no card.
Start freeView pricing