Guía para desarrolladores10 min de lectura
Guía API de Polymarket: Mercados en vivo, WebSockets e investigación histórica
Polymarket expone interfaces sólidas del mercado actual. La decisión arquitectónica es dónde termina la superficie oficial en vivo y comienza un libro histórico grabado continuamente.
La superficie de desarrollo de Polymarket cubre descubrimiento de mercados, precios, operaciones y actualizaciones en vivo del CLOB order book. Usa documentación oficial para definiciones actuales de endpoints y comportamiento del venue. Para investigación histórica, primero decide si una serie de precios es suficiente o si la estrategia necesita la escalera de bid/ask que existía en cada momento de decisión; solo un archivo capturado continuamente puede proveer esto último después de que la actualización en vivo ha pasado.
Mapear la tarea a la superficie de datos
| Task | Datos necesarios | Fuente típica |
|---|---|---|
| Descubrir mercados actuales | Eventos, mercados, resultados e identificadores | APIs oficiales de Polymarket |
| Monitorear la liquidez actual | Ofertas, demandas, tamaños y cambios de precio en vivo | WebSocket oficial de CLOB |
| Graficar una serie de probabilidades | Precios históricos de resultados | Superficie oficial de historial de precios |
| Reproducción de ejecución | Escaleras completas pasadas con marcas de tiempo | Archivo registrado continuamente |
| Comparar con spot | Observaciones del libro unidas a una referencia subyacente | Proveedor de investigación normalizado |
Por qué los identificadores y las marcas de tiempo vienen primero
Una integración de Polymarket cruza identificadores de eventos, condiciones y tokens. Almacene esas relaciones con los valores fuente en bruto en lugar de tratar un título legible para humanos como clave. Un título puede cambiar; un estudio de ejecución debe aún unir el mismo token de resultado al mismo libro registrado.
Mantener separadas las marcas de tiempo de origen y de recepción. La hora de origen describe el evento en el venue, mientras que la hora de recepción describe cuándo su sistema lo observó. Colapsarlas en un solo campo hace imposible auditar errores de latencia y orden.
Lo que DepthFeed añade
DepthFeed registra actualizaciones event-driven del CLOB de Polymarket, construye observaciones normalizadas de libro completo y las sirve mediante las mismas formas REST y WebSocket usadas para Kalshi. Las filas históricas incluyen escaleras de precio y tamaño en lugar de solo un punto de probabilidad.
Ese registro soporta reproducción VWAP consciente de profundidad en el Backtest Lab, consultas históricas de API y auditorías de ejecución del siguiente libro para actividad pública de wallets. La cobertura faltante permanece explícita, y el archivo no afirma reproducir liquidez oculta, prioridad en cola ni impacto de mercado de una orden real.
Lista de verificación de integración
- Use la documentación oficial de Polymarket como autoridad para los endpoints actuales y las reglas de trading.
- Persistir identificadores de evento, condición y token de resultado juntos.
- Inicializa un libro completo antes de aplicar cambios incrementales de precio.
- Conservar las marcas de tiempo de origen y de recepción en lugar de sobrescribir una con la otra.
- Use el historial de precios para gráficos y las escaleras históricas completas para la reproducción de ejecuciones.
- Prueba huecos, reconexiones y actualizaciones duplicadas antes de confiar en un backtest.
Ejemplos de API
curl -sG "https://gamma-api.polymarket.com/markets" --data-urlencode "closed=false" --data-urlencode "limit=5"
curl -sG "https://clob.polymarket.com/book" --data-urlencode "token_id=<outcome_token_id>"curl -s "https://api.depthfeed.com/v3/btc/markets?limit=5" \
-H "Authorization: Bearer df_your_key"
curl -s "https://api.depthfeed.com/v3/btc/markets/<market_id>/snapshots?include_orderbook=true&interval=1m" \
-H "Authorization: Bearer df_your_key"Puntos clave
- 01La API oficial de Polymarket es la autoridad correcta para el estado actual del venue.
- 02Las actualizaciones en vivo del CLOB deben iniciarse y ordenarse para reconstruir un libro completo.
- 03Una serie histórica de probabilidades no revela la profundidad de reposo pasada.
- 04DepthFeed añade escaleras completas registradas y un esquema de investigación cross-venue.
- 05Los identificadores, las marcas de tiempo y el comportamiento ante datos faltantes deben diseñarse antes de la lógica de la estrategia.
Polymarket expone interfaces sólidas del mercado actual. La decisión arquitectónica es dónde termina la superficie oficial en vivo y comienza un libro histórico grabado continuamente.
Empieza gratis