Binance Prediction Market API: Endpoints, Autenticação e Cobertura
Uma referência prática ao namespace dedicado REST para mercados de predição da Binance Wallet, incluindo o que cada endpoint retorna e onde o registro histórico começa.
DepthFeed expõe os mercados da Binance Wallet com suporte do Predict.fun sob /v3/binance-prediction, com /v3/predictfun como um alias compatível. Os clientes se autenticam com uma chave DepthFeed API — não uma chave Binance ou carteira pessoal — e podem consultar descoberta de mercados, livros mais recentes, snapshots históricos e métricas separadas de séries de preços.
A superfície API
O namespace dedicado mantém os registros de mercado de predição Binance separados das rotas Polymarket, Kalshi e Limitless do site, preservando envelopes de resposta familiares e paginação por cursor.
| Endpoint | Propósito |
|---|---|
| GET /v3/binance-prediction/markets | Descobrir e filtrar mercados por moeda, janela e status |
| GET /v3/binance-prediction/{market_id}/orderbook/latest | Retornar o livro full-L2 mais recente registrado |
| GET /v3/binance-prediction/{market_id}/snapshots | Percorrer com cursor os snapshots históricos full-L2 registrados |
| GET /v3/binance-prediction/{market_id}/timeseries | Consultar amostras de chance, preço exibido ou último trade |
| GET /v3/binance-prediction/{market_id}/trades | Rota reservada; os fills históricos ainda estão sendo reconstruídos |
A autenticação não usa uma chave Binance
Os clientes API enviam sua chave bearer DepthFeed. Eles não fornecem uma chave somente leitura Binance, não pareiam uma Binance Agentic Wallet nem mantêm uma sessão no Predict.fun. O DepthFeed usa um provedor de arquivo estável correspondente ao catálogo público do Predict.fun.
As rotas de predição Binance estão disponíveis nos planos pagos DepthFeed. O envelope de autenticação e erro corresponde ao restante da DepthFeed V3 API.
O que um registro de mercado contém
A descoberta de mercado retorna identificadores de tópico Binance e identificadores de mercado do Predict.fun, juntamente com metadados de condição e token de resultado. Os registros também incluem o ativo, janela de mercado, timestamps, status, resolução, resultado vencedor, volume, liquidez, contagem de participantes, chain e campos de contrato de exchange quando disponíveis.
Manter esses identificadores juntos é importante após o vencimento de mercados de curto prazo: um pesquisador pode reter a identidade completa do mercado e o rótulo do resultado em vez de tentar inferi-los a partir de uma string de título.
As métricas de preço são deliberadamente separadas
A rota de timeseries aceita as métricas chance, price e last_trade. Elas não são sinônimos. A probabilidade exibida é o sinal de probabilidade da interface, o preço exibido é seu valor de mercado cotado e last_trade é a amostra de execução mais recente. Um modelo pode escolher o sinal pretendido sem colapsar silenciosamente os três em uma única coluna.
Limites históricos
Histórico determinístico de catálogo de 5-minuto e 15-minuto, resolução, volume e liquidez é preenchido retroativamente a partir de maio de 5, 2026 para BTC e junho de 29, 2026 para ETH e BNB. As três métricas de preço amostradas começam em julho de 17. Um painel padronizado de ciclo de vida full-L2 de BTC 15-minuto começa em junho de 26, enquanto a captura mais ampla e estável de profundidade forward de um minuto começa em julho de 26.
A rota de trades atualmente retorna um dataset histórico vazio enquanto os fills da BNB Smart Chain são reconstruídos. Ordens de repouso off-chain anteriores não podem ser recuperadas dos logs de liquidação, portanto o API não fabrica histórico de livro pré-captura.
Key takeaways
- 01Use /v3/binance-prediction para o API dedicado; /v3/predictfun é um alias compatível.
- 02Os clientes se autenticam com DepthFeed e não precisam de uma chave Binance ou sessão de carteira.
- 03Descoberta de mercado, livros mais recentes, snapshots históricos e métricas de preço separadas estão disponíveis.
- 04Histórico do catálogo BTC começa em maio de 5, 2026; ETH e BNB começam em junho de 29. O painel de ciclo de vida L2 de BTC 15-minuto começa em junho de 26 e a profundidade forward mais ampla começa em julho de 26.
- 05A rota de trades reservada ainda não contém fills históricos.
Uma referência prática ao namespace dedicado REST para mercados de predição da Binance Wallet, incluindo o que cada endpoint retorna e onde o registro histórico começa.
Começar grátis