--- url: "https://predictiontoolkit.com/es/guides/polymarket-api-endpoints/" publisher: "PredictionToolkit" dateModified: "2026-11-02" --- [← Guías de Polymarket]() # Endpoints Polymarket: host e identificador correctos Por PredictionToolkit · Actualizado el 2026-11-02 **Contenido** - [Empieza por la tarea]() - [Conserva identificadores separados]() - [Comprueba el paso al libro]() - [Elige lectura de cartera]() - [Separa operadores y builders]() - [Comprueba resultado]() - [Límites y operaciones privadas]() Gamma, CLOB y Data API responden a preguntas distintas. Esta guía separa las solicitudes documentadas de las comprobaciones públicas registradas en las fuentes; los servicios los operan sus proveedores, no este directorio. ## Empieza por la tarea - Descubrimiento: https://gamma-api.polymarket.com GET /markets/keyset?closed=false&limit=1. - Libro: https://clob.polymarket.com GET /book?token\_id={outcome token ID}. - Ranking: https://data-api.polymarket.com GET /v2/leaderboard?time\_period=day&limit=1. Las tres consultas públicas no necesitan credenciales. ## Conserva identificadores separados Un evento agrupa mercados. Gamma id identifica los metadatos y conditionId la condición on-chain. En el mercado CTF de muestra, outcomes y clobTokenIds eran arrays codificados en JSON y emparejados por índice. Analiza ambos y comprueba que tengan la misma longitud antes de seleccionar un token. Detente si faltan los campos, no están alineados o no son adecuados para el protocolo. No sustituyas una condición o token por el Gamma id numérico. ## Comprueba el paso al libro El registro obtuvo un mercado abierto y su libro sin autenticación, ambos HTTP 200. Gamma devolvió markets y next\_cursor; CLOB, market, asset\_id, bids, asks y timestamp. market coincidió con conditionId y asset\_id con el token. Repetir puede dar otro mercado, vacío o error/libro ausente. El precio de muestra no es cotización actual. ## Elige lectura de cartera Las rutas documentadas de Data incluyen GET /v2/positions?user={proxy wallet}&limit=1 y GET /v2/activity?user={proxy wallet}. Usa una dirección pública de cartera proxy que estés autorizado a examinar; no se consultó ninguna cartera en la comprobación registrada. Las posiciones usan OPEN por defecto. Usa condition como filtro de condición, no Gamma id. Las lecturas paginadas esperan data y pagination, con condition\_id y token\_id en las posiciones. Sigue el next\_cursor opaco hasta null; pagination.offset es metadato de visualización, no un parámetro de solicitud. Comprueba valores predeterminados, filtros, límites y resultados vacíos de cada ruta. ## Separa operadores y builders La solicitud de traders devolvió HTTP 200 y una fila user\_id, con data/pagination, has\_more y next\_cursor; solo se comprobó la primera página. GET /v2/builders/leaderboard?time\_period=day&limit=1 describe, en cambio, integraciones builder\_code, volumen atribuido y usuarios activos; se revisó solo en documentación. Etiqueta PNL frente a VOLUME, periodo y unidades. El P&L diario valorado difiere del P&L realizado de toda la vida; el volumen son participaciones de resultado, no USD ni beneficio garantizado. Los rankings no identifican personas ni prueban integraciones. ## Comprueba resultado - Anota host, ruta y acceso público/privado. - Separa Gamma id, conditionId y token; compara book.market y asset\_id. - Conserva data/pagination y cursores, no números de página. - Declara user\_id o builder\_code, métrica, periodo y unidades. ## Límites y operaciones privadas El CLOB privado GET /data/orders necesita autenticación HMAC L2; enviar una orden requiere además firma de cartera. La actividad pública de una cartera no es el estado de sus órdenes privadas ni una identidad humana. Las comprobaciones registradas cubrieron una página Gamma, un libro CTF y una página de traders, no contabilidad de carteras, todas las páginas, solicitudes privadas, firmas, órdenes ni latencia. No garantizan historia ni disponibilidad futura. No envíes direcciones, claves, secretos ni firmas al directorio. ## Seguir investigando - [Polymarket Gamma API: API de descubrimiento de eventos y mercados]() · contexto: Revisa descubrimiento. - [Polymarket CLOB API: libros y gestión de órdenes]() · contexto: Revisa libros y órdenes privadas. - [Polymarket Data API: convierte actividad pública en análisis de carteras]() · contexto: Revisa posiciones y rankings. - [Clave de API y autenticación de Polymarket]() · contexto: Comprende autenticación. - [API y proveedores de datos de Polymarket]() · contexto: Compara API.