Gamma API

La Gamma API de Polymarket es la API REST pública que expone datos a nivel de mercado: markets, events, tags, series y profiles. Desarrolladores y traders la usan para listar mercados, obtener metadatos de eventos y construir páginas índice o directorios de mercados sin autenticación.

Puntos clave

• La Gamma API es pública y no requiere autenticación para lecturas. Úsala para listar markets, events, tags, series y profiles.
• /markets tiene límite de tasa: 300 solicitudes por 10 segundos. La paginación usa cursor after_cursor (offset es rechazado).
• Parámetros útiles incluyen limit (máx. 1000), after_cursor, arrays de filtro como slug o condition_ids, y flags booleanos como closed o active.
• Combina /markets y /events con cuidado: el límite combinado de listing es 900 req / 10 s; el límite global del API es 4000 req / 10 s.

Cómo se usa la Gamma API

La Gamma API es la superficie pública canónica para datos orientados a la visualización sobre los markets de Polymarket. Front-ends, agregadores y herramientas de investigación llaman endpoints como /markets y /events para poblar listas de mercados, páginas de categorías y filtros por tags.

Parámetros y comportamientos importantes

• limit: Controla el tamaño de la página. Por defecto es 20, máximo 1000.
• after_cursor: Paginación basada en cursor; offset es rechazado con HTTP 422—no uses offsets.
• Filtrado: Varios query params aceptan arrays (por ejemplo slug, id, condition_ids, clob_token_ids, question_ids, market_maker_address).
• Flags: closed (por defecto false), active y archived filtran por el estado del market.
• Orden: El parámetro order acepta una lista de campos separada por comas (por ejemplo volume24hr,volume,liquidity,endDate), combinado con ascending (booleano).

Límites de tasa y guía práctica

• Límite específico de /markets: 300 solicitudes por 10 segundos.
• Límite combinado de listing para /markets + /events: 900 solicitudes por 10 segundos.
• Superficie general de la Gamma API: 4000 solicitudes por 10 segundos.

Si planeas indexación de alto rendimiento, implementa retroceso exponencial (exponential backoff) y respeta el patrón de paginación basado en cursor. Cachea los listados cuando corresponda; evita sondear el mismo recurso de forma agresiva.

Example request (curl)

curl "https://gamma-api.polymarket.com/markets?limit=50&order=volume24hr&ascending=false"

En el contexto de Polymarket

Gamma es la API pública y no autenticada que usarás cuando necesites metadata de mercados para listas de UI, páginas de tags o integraciones que no requieren estado on-chain (para posiciones on-chain y trades usa la Data API; para operaciones del order-book usa la CLOB API). Como Gamma es de solo lectura y pública, es el lugar adecuado para construir directorios de mercados y herramientas exploratorias.

See also

• /glossary/data-api
• /glossary/clob-api

Nota final

Polymarket Gamma API es el primer punto de referencia para metadata de mercados. Usa los parámetros documentados y respeta los límites de tasa para evitar solicitudes rechazadas.