Binance Mercado de Predicción API: Endpoints, Autenticación y Cobertura
Una referencia práctica al espacio de nombres dedicado REST para los mercados de predicción de Binance Wallet, que incluye lo que devuelve cada endpoint y dónde comienza el registro histórico.
DepthFeed expone los mercados de Binance Wallet respaldados por Predict.fun bajo /v3/binance-prediction, con /v3/predictfun como un alias compatible. Los clientes se autentican con una clave DepthFeed API —no una clave Binance ni una billetera personal— y pueden consultar descubrimiento de mercado, libros más recientes, instantáneas históricas y métricas separadas de series de precios.
La superficie API
El espacio de nombres dedicado mantiene los registros del mercado de predicción Binance separados de las rutas Polymarket, Kalshi y Limitless del sitio, conservando al mismo tiempo los envoltorios de respuesta familiares y la paginación por cursor.
| Endpoint | Propósito |
|---|---|
| GET /v3/binance-prediction/markets | Descubrir y filtrar mercados por moneda, ventana y estado |
| GET /v3/binance-prediction/{market_id}/orderbook/latest | Devuelve el libro completo-L2 más reciente registrado |
| GET /v3/binance-prediction/{market_id}/snapshots | Desplazarse por las instantáneas históricas registradas de libro completo-L2 con cursor |
| GET /v3/binance-prediction/{market_id}/timeseries | Consultar muestras de probabilidad, precio mostrado o última operación |
| GET /v3/binance-prediction/{market_id}/trades | Ruta reservada; las ejecuciones históricas aún se están reconstruyendo |
La autenticación no utiliza una clave Binance
Los clientes API envían su clave de portador DepthFeed. No proporcionan una clave de solo lectura Binance, no vinculan una Binance Agentic Wallet ni mantienen una sesión de Predict.fun. DepthFeed utiliza un proveedor de archivo estable alineado con el catálogo público de Predict.fun.
Las rutas de predicción Binance están disponibles en los planes DepthFeed de pago. La autenticación y el envoltorio de errores coinciden con el resto de DepthFeed V3 API.
Qué contiene un registro de mercado
El descubrimiento de mercados devuelve identificadores de tema Binance e identificadores de mercado de Predict.fun junto con metadatos de condición y token de resultado. Los registros también incluyen el activo, la ventana de mercado, las marcas de tiempo, el estado, la resolución, el resultado ganador, el volumen, la liquidez, el número de participantes, la cadena y los campos de contrato de intercambio cuando estén disponibles.
Mantener esos identificadores juntos es importante después de que los mercados de corta duración expiren: un investigador puede conservar la identidad completa del mercado y la etiqueta de resultado en lugar de intentar inferirlos a partir de una cadena de título.
Las métricas de precios están deliberadamente separadas
La ruta de series temporales acepta métricas de chance, price y last_trade. No son sinónimos. La probabilidad mostrada es la señal de probabilidad de la interfaz, el precio mostrado es su valor de mercado cotizado y last_trade es la muestra de ejecución más reciente. Un modelo puede elegir la señal deseada sin colapsar silenciosamente los tres en una sola columna.
Límites históricos
El catálogo determinista de 5-minute y 15-minute, la resolución, el volumen y el historial de liquidez se rellenan retroactivamente desde May 5, 2026 para BTC y June 29, 2026 para ETH y BNB. Las tres métricas de precios muestreadas comienzan en July 17. Un panel de ciclo de vida estandarizado BTC de 15-minute full-L2 comienza en June 26, mientras que la captura de profundidad forward estable one-minute más amplia comienza en July 26.
La ruta de trades actualmente devuelve un conjunto de datos histórico vacío mientras se reconstruyen las ejecuciones de BNB Smart Chain. Las órdenes en reposo off-chain anteriores no se pueden recuperar de los registros de liquidación, por lo que API no fabrica historial de libro pre-captura.
Key takeaways
- 01Usa /v3/binance-prediction para el API dedicado; /v3/predictfun es un alias compatible.
- 02Los clientes se autentican con DepthFeed y no necesitan una clave Binance ni una sesión de wallet.
- 03El descubrimiento de mercados, los libros más recientes, las instantáneas históricas y las métricas de precios separadas están disponibles.
- 04El historial del catálogo BTC comienza en May 5, 2026; ETH y BNB comienzan en June 29. El panel de ciclo de vida L2 de BTC 15-minute comienza en June 26 y la profundidad forward más amplia comienza en July 26.
- 05La ruta de trades reservada aún no contiene ejecuciones históricas.
Una referencia práctica al espacio de nombres dedicado REST para los mercados de predicción de Binance Wallet, que incluye lo que devuelve cada endpoint y dónde comienza el registro histórico.
Empieza gratis