¿Qué es Polymarket Gamma API?

Un evento agrupa preguntas; un mercado binario es un contrato YES/NO con reglas y fechas propias. Separa ID, slug y tokens en vez de tratar cada URL de evento como un mercado ejecutable.

La respuesta revisada de /markets/keyset contiene markets y next_cursor. Una muestra de mercado CTF incluía id, conditionId y arrays outcomes y clobTokenIds codificados como JSON; las etiquetas de resultado y los tokens deben mantener sus índices alineados. La muestra no acredita campos idénticos ni un libro CLOB disponible en cada versión del protocolo.

A quién va dirigido

Crear catálogos buscables.
Obtener definiciones y etiquetas para investigación.
Enlazar juegos, equipos y contratos deportivos.

Datos y métodos de la API

Eventos
Consulta un evento o pagina su lista.
Mercados
Obtén contratos binarios e identificadores.
Etiquetas y filtros
Acota categoría, estado y atributos compatibles.
Series
Agrupa eventos recurrentes por tema.
Deportes
Descubre ligas, equipos, ganador, hándicap y totales.
Vínculo con partidos
Usa ID de juego para mercados relacionados sin adivinar slugs.
Respuesta keyset
Lee markets y next_cursor y analiza arrays codificados de resultados/tokens cuando existan.

Tareas de integración

Crear catálogo

Pagina eventos abiertos, conserva ID y slugs y relaciona resultados y tokens. Actualiza estado aparte de precios.

Enlazar deportes

Identifica el partido y el orden de equipos y usa su ID para descubrir mercados de estadísticas específicas y líneas adicionales.

Resolver un enlace

Busca evento o mercado por URL o slug y pasa identificadores a consultas de libros.

Relacionar libro CTF

Separa id Gamma y conditionId. Mantén el orden de resultados y tokens; usa el token en CLOB y detente si falta token o libro habilitado.

Precios y coste total

El descubrimiento público no exige autenticación. La guía no indica suscripción aparte para estas consultas.

Acceso y configuración de la API

Elige nivel de evento, mercado o serie.
Solicita una página filtrada de tamaño acotado. Usa next_cursor como after_cursor manteniendo los mismos filtros y la selección de protocolo.
Conserva ID, slugs, etiquetas y correspondencias de tokens.
Usa CLOB para precios ejecutables y libros.

Leer documentación API Polymarket

Enlaces útiles

Entrar en Discord Polymarket

Qué revisar

El catálogo completo requiere paginación.
Reglas y fechas corresponden a cada contrato.
El orden local/visitante puede cambiar con reprogramaciones.
Los campos CTF muestreados no garantizan tokens o libros en toda versión.

Observaciones de la API pública

Se realizaron dos consultas de descubrimiento acotadas sin credenciales y se comprobaron identificadores de un mercado CTF devuelto.

Seguir una página de cursor

Acción completadaFecha de observación 2026-11-03T12:51:47.585132+00:00

Acción: Se consultó /markets/keyset con closed=false y limit=2; después se usó su next_cursor como after_cursor manteniendo los filtros.
Resultado: Ambas solicitudes devolvieron HTTP 200. Cada una contenía 2 mercados; la segunda página tenía identificadores distintos. Ambas respuestas incluían markets y next_cursor.
Alcance y límites: Solo se leyeron estas dos páginas. No se establecen cobertura completa, orden estable ante cualquier actualización ni tamaño máximo de página.

Fuente consultada

Alinear resultados e identificadores

Acción completadaFecha de observación 2026-11-03T12:51:47.585132+00:00

Acción: Se decodificaron outcomes y clobTokenIds de un mercado devuelto y se utilizó su primer resultado etiquetado en una consulta CLOB independiente.
Resultado: El registro de muestra tenía version v1, id de mercado y conditionId. Sus 2 etiquetas de resultado y 2 identificadores de token eran cadenas con JSON, que debían decodificarse y alinearse por índice.
Alcance y límites: Es una muestra CTF. El protocolo V2 puede usar identificadores de posición; esta forma observada no garantiza el esquema de todos los mercados.

Fuente consultada

Gamma proporcionó el registro de descubrimiento; CLOB confirmó el libro del resultado elegido y Data API aceptó los identificadores de condición y evento para agregados. Estos identificadores resuelven uniones distintas; el título de un evento no los sustituye.

En detalle

Valoraciones y reseñas

Valoración editorial

4,0de 5

0 reseñas de usuarios

Redacción de PredictionToolkit

Nuestra opinión sobre Polymarket Gamma API

Descubrimiento público y metadatos estructurados facilitan iniciar un catálogo. La cobertura completa exige paginación y separar eventos y contratos.

Criterios de evaluación: Utilidad para la tarea, alcance documentado, claridad de configuración y transparencia del acceso y los costes.
Fecha de evaluación: 2026-10-01
Documentación revisada: 2026-10-01

Evaluación basada en documentación. Cómo valoramos

Reseñas de usuarios 0

El umbral de reseñas publicadas para que la nota principal pase a las valoraciones de usuarios es 5.

Sé la primera persona en compartir su experiencia

Un ejemplo concreto ayuda a la siguiente persona a elegir la herramienta adecuada.

Herramientas relacionadas

Explorar la categoría

Guías y flujos de trabajo

Preguntas frecuentes sobre Polymarket Gamma API

¿Evento y mercado son distintos?

Un evento agrupa preguntas; un mercado binario representa una pregunta YES/NO.

¿Gamma envía órdenes?

No. Corresponde a CLOB.

¿Cómo encuentro mercados deportivos relacionados?

Usa el ID del juego y el flujo de listado actual.

¿Toda lista es un array directo?

No. /markets/keyset devolvió un objeto con markets y next_cursor. Adapta el analizador a cada ruta.

Polymarket Gamma API: API de descubrimiento de eventos y mercados

Capturas e interfaz