PredictionToolkit
¿Qué es Polymarket Data API?
Una cartera necesita más que P&L total: relaciona posiciones y resultados, conserva lado, precio, tamaño y fecha y separa exposición abierta, resultados cerrados y volumen. Los titulares se paginan por resultado; agrupa por asset ID.
Los rankings requieren período y métrica explícitos. La muestra pública v2 guardada usó data/pagination; limit=1 devolvió una página con más resultados. Esa observación limitada no valida contabilidad, todos los endpoints ni órdenes privadas.
A quién va dirigido
- Desarrolladores de paneles de carteras.
- Investigadores de participación pública.
- Aplicaciones que concilian posiciones e historial.
Funciones y cobertura
- Posiciones y actividad
Lee exposición y actividad públicas para conciliar carteras.
- Registros de operaciones
Usa lado, precio, tamaño, resultado, cartera y fecha.
- Titulares y P&L por resultado
Une páginas por asset ID. includePnl requiere una condición y tamaño máximo 100.
- Interés abierto y volumen
Consulta el interés abierto de hasta 20 condition IDs o el total global. Distingue el volumen en directo de un evento del volumen negociado por una cartera.
- Estado de resolución
Revisa el estado, los pagos y la hora de actualización. expected_settlement_time estima el momento más temprano posible de la liquidación, no una fecha límite.
- Rankings de traders y builders
Consulta el puesto del trader y las estadísticas de volumen y usuarios activos de builders. Una cartera fuera del ranking puede no tener puesto. Por defecto se usan el período de un día y la clasificación por P&L.
- Paginación y tipos
Sigue la estructura de respuesta y el cursor de cada endpoint. Usa los tipos del SDK cuando estén disponibles e inspecciona los campos originales de la API para detectar propiedades nuevas.
- Estructura v2 guardada
La muestra expuso data y pagination (limit, offset, has_more, next_cursor) y filas user_id, rank, pnl, volume y user_name, distintas de Gamma.
Flujos de trabajo con Polymarket Data API
Crea una vista de cartera
Consulta posiciones y actividad, une los identificadores de token o condición con Gamma y muestra por separado la exposición abierta, los resultados de posiciones cerradas y el volumen negociado.
Estudia participación
Consulta las operaciones y las páginas de titulares de participaciones de una condición, agrupa por asset ID y añade el interés abierto.
Compara rankings con criterio
Usa período y métrica iguales; conserva empates y ausencias sin convertirlas en cero.
Importa páginas completas
Guarda time_period y métrica, lee data y conserva el cursor opaco; una fila no prueba cobertura completa.
Precios y coste total
La guía no lista suscripción independiente. Análisis público y operaciones autorizadas tienen requisitos distintos.
Primeros pasos
Antes de empezar: No mezcles titulares de resultados distintos.
- Lee las guías de análisis y actividad y elige consulta.
- Gestiona estructura y paginación y une IDs estables.
- Usa SecureClient solo para operaciones que requieren autorización.
Las páginas de titulares son por resultado; une por asset ID.
Enlaces útiles
Qué revisar
- No mezcles titulares de resultados distintos.
- includePnl requiere una condición y página ≤100.
- Elige período explícito; por defecto es día y P&L.
- Las estimaciones no son plazos; revisa estado y pagos.
- La comprobación guardada de una página no valida contabilidad, todos los esquemas, paginación completa u órdenes privadas.
En detalle
Valoraciones y reseñas
Reseñas de usuarios 0
El umbral de reseñas publicadas para que la nota principal pase a las valoraciones de usuarios es 5.
Un ejemplo concreto ayuda a la siguiente persona a elegir la herramienta adecuada.
Herramientas relacionadas
Explorar la categoría
Replica ejecuciones, posiciones y saldos para analítica, aplicaciones y alertas propias.
- Acceso API · CLI
Consulta precios y profundidad por token de resultado y gestiona órdenes autenticadas mediante un proceso de firma separado.
- Acceso API
Descubre contratos e identificadores antes de consultar precios ejecutables o crear un catálogo.
- Acceso API
Guías y flujos de trabajo
Preguntas frecuentes sobre Polymarket Data API
¿Puede enviar órdenes?
Usa CLOB para trading.
¿En qué difiere de Gamma?
Gamma describe eventos y mercados; Data API cubre posiciones, actividad y participación.
¿Una respuesta es todo el historial?
Sigue la paginación hasta completar el rango.
¿limit=1 significa que solo hay un trader?
No. La respuesta guardada incluía has_more y next_cursor: era una página, no toda la población.