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. Wallet pairing belongs to the capture infrastructure rather than the customer integration.
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. Recorded full-depth books and the three sampled price metrics begin July 17, 2026.
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.
- 04Catalogue history starts May 5, 2026; recorded books and price samples start July 17, 2026.
- 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