PredictionToolkit
¿Qué es Polymarket CLOB API?
Usa las ofertas de compra y venta del libro público para mostrar niveles de precio junto con sus restricciones de negociación. El punto medio, el diferencial y los datos de la última operación proceden de endpoints de referencia; comprueba el lado del precio y los identificadores del resultado antes de incorporar la captura a una interfaz o servicio de ejecución.
Una consulta pública CTF registrada en las fuentes devolvió identificadores que coincidían con el resultado seleccionado en Gamma. Esto es más limitado que probar acceso privado: no se ejercitaron firma, envío, cancelación, ejecuciones ni latencia sostenida. Las credenciales API y la autorización de la orden por la cartera siguen siendo requisitos de implementación distintos.
A quién va dirigido
- Desarrolladores que crean interfaces de trading o servicios de ejecución.
- Investigadores que miden diferenciales y profundidad disponible.
- Aplicaciones que necesitan controlar directamente la firma y el transporte.
Datos y métodos de la API
- Libros de tokens de resultado
Consulta bids, asks, tamaño de tick, tamaño mínimo de orden, hash de estado e identificadores del mercado.
- Precios por lado
BUY devuelve el mejor ask y SELL devuelve el mejor bid.
- Precios de referencia
Obtén por separado el punto medio, el diferencial y el último precio negociado.
- Solicitudes por lotes
Las solicitudes compatibles de libros y precios aceptan hasta 500 elementos.
- Gestión de órdenes
Utiliza la superficie autenticada para enviar órdenes firmadas, cancelarlas y gestionar su estado.
- Capas de autenticación
La firma de cartera L1 crea o deriva credenciales; L2 firma solicitudes privadas, mientras otra firma de cartera autoriza la orden.
- Relación de identificadores observada
La muestra pública devolvió market, asset_id, timestamp, bids y asks. market coincidió con conditionId de Gamma y asset_id con el token de resultado solicitado.
Tareas de integración
Muestra precios ejecutables
Obtén los tokens mediante Gamma, consulta el libro y muestra mejor bid, ask y profundidad. Identifica el punto medio por separado de los precios disponibles en el libro.
Construye un servicio de órdenes
Crea o deriva las credenciales de API, implementa la firma exacta de las solicitudes y sigue el estado de las órdenes enviadas. Añade cancelación y conciliación antes de automatizar la generación de órdenes; una firma de cartera independiente debe autorizar la orden.
Valida el paso de mercado a libro
En el libro recibido, comprueba que asset_id corresponde al token del resultado elegido y market al conditionId de Gamma antes de usar las ofertas de compra o venta. Conserva el timestamp de la captura con sus niveles: una lectura correcta no demuestra que una orden se ejecutaría al precio cotizado.
Precios y coste total
Las lecturas públicas de mercado no requieren credenciales. La guía de integración no indica una suscripción API independiente; se aplican comisiones de la plataforma a las operaciones elegibles.
Acceso y configuración de la API
- Descubre el mercado y los identificadores de tokens asociados a cada resultado mediante Gamma.
- Consulta el libro o el precio público del resultado etiquetado. En una respuesta de libro, haz coincidir asset_id con su token de resultado y market con la condición antes de usar los niveles.
- Respeta el tamaño de tick y el tamaño mínimo de orden.
- Para operaciones privadas, configura la firma de cartera y las credenciales L2.
- Mantén la serialización exacta del cuerpo coherente con su firma.
Enlaces útiles
Qué revisar
- La documentación sitúa los mejores niveles de compra y venta al final de los arrays del libro.
- El punto medio no es necesariamente un precio ejecutable.
- Un token que nunca se ha negociado puede devolver null como última operación.
- Gamma market id, conditionId e identificador de token de resultado son diferentes.
- Solo se comprobó una captura pública; no se probaron órdenes privadas, ejecuciones ni latencia sostenida.
Observaciones del libro público
Se consultó sin autenticación un libro CTF utilizando un token de resultado elegido en Gamma.
Vincular el libro al resultado elegido
- Acción
- Se solicitó /book con el token_id elegido y se compararon los identificadores de la respuesta con Gamma.
- Resultado
- HTTP 200 devolvió asset_id coincidente con el token y market coincidente con su conditionId. La respuesta incluía bids, asks, timestamp, tick_size y min_order_size.
- Alcance y límites
- Solo se comprobó un libro público. No se utilizó una cartera ni se probaron firmas, envío, cancelación o ejecución de órdenes.
Examinar orden y campos numéricos
- Acción
- Se contaron los niveles y se examinaron price, size y las restricciones de negociación en la respuesta guardada.
- Resultado
- La instantánea contenía 20 niveles de compra y 139 de venta. Las compras aumentaban y las ventas disminuían dentro de sus listas, dejando el mejor precio al final. Price y size eran cadenas decimales; tick_size era 0,001 y min_order_size era 5.
- Alcance y límites
- Son valores fechados de este libro, no configuraciones universales ni una medición de latencia de ejecución. La cantidad disponible puede cambiar antes de una orden.
El libro responde qué se cotizaba para un resultado en ese momento. Los metadatos de Gamma y los totales de actividad de Data API responden a otras preguntas; ni el último precio negociado ni un agregado sustituyen la instantánea de profundidad de ese resultado.
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
Crea aplicaciones tipadas con lecturas públicas, consultas reanudables, temas en vivo y acciones autenticadas separadas.
- Idioma TypeScript · JavaScript
Consulta posiciones, operaciones, titulares y rankings conservando IDs y contexto de paginación.
- 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 CLOB API
¿Necesito una cartera para consultar precios públicos?
No. Las lecturas públicas de mercado no requieren credenciales.
¿Dónde encuentro los identificadores de tokens?
Utiliza el descubrimiento y los metadatos de mercado de Gamma.
¿El punto medio es el precio de compra?
No. La compra utiliza el ask; el punto medio promedia el mejor bid y ask.
¿Por qué hacen falta firmas API y de cartera?
L2 autentica la solicitud y la firma de cartera autoriza la orden.
¿book.market debe coincidir con Gamma id?
No en la muestra CTF comprobada: market coincidió con conditionId hexadecimal. Gamma id identifica el registro de metadatos y book.asset_id identifica el token de resultado elegido.