API de Polymarket
Polymarket es un mercado de predicción on-chain. markets y events buscan mercados y eventos por palabras del título y orden; trades lista las operaciones on-chain más recientes de un mercado.
Un evento agrupa mercados relacionados; cada mercado tiene resultados cuyo price va de 0 a 1 y se lee como probabilidad implícita, y un mercado resuelto indica su winning_outcome. Pasa el slug o condition_id de una fila de markets a trades.
Disponibilidad de la plataforma
- Salud 24 h
- Normal
Últimos 30 días
Funciones disponibles
Cada acción de Polymarket, qué hace, su precio y su salud en las últimas 24 horas. Abre una acción para ver sus parámetros, campos de respuesta y ejemplos de código.
| Capacidad | Qué hace | Por 1.000 | Salud en 24 horas |
|---|---|---|---|
Buscar mercados de Polymarketmarkets | Envía una keyword opcional (3 o más caracteres), status y sort y recibe hasta 100 mercados con title, outcomes y sus precios, volume_usd, liquidity_usd, volumen reciente, winning_outcome, el evento padre y fechas. | $6.81 por 1.000 solicitudes | Normal |
Buscar eventos de Polymarketevents | Envía una keyword opcional, status, sort y category y recibe hasta 100 eventos con título, descripción, volumen, liquidez, interés abierto, número de mercados, fechas y hasta 10 markets anidados. | $6.81 por 1.000 solicitudes | Normal |
Operaciones de un mercado de Polymarkettrades | Envía un market (slug, condition ID 0x o enlace) y recibe sus operaciones más recientes, hasta 100, con side, outcome, price, shares, amount_usd, fee_usd, traded_at, tx_hash y las billeteras públicas de las dos partes. | $6.81 por 1.000 solicitudes | Normal |
Abre una capacidad para ver sus parámetros, campos de respuesta, ejemplos de código y prueba.
¿Qué acepta cada acción de Polymarket?
Cada respuesta enlaza una acción ejecutable con sus entradas reales. El significado y los valores permitidos pertenecen a esa acción; un nombre parecido no conserva automáticamente el mismo sentido en otra plataforma.
Las fuentes oficiales se enlazan solo para precisar el término de la plataforma indicado a su lado. No implican autorización ni respaldo y no añaden a EveryInfra funciones del sitio oficial.
| Acción | Obligatorios | Opcionales | Entrega | Límite | Por 1.000 | Campos de respuesta |
|---|---|---|---|---|---|---|
marketsBuscar mercados de Polymarket Envía una | keyword, sort, status | Entrega síncrona | El catálogo declara defaultLimit = 20 y maxLimit = 100 para el límite de esta acción. Según la acción, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $6.81 por 1.000 solicitudes | id · condition_id · slug · url · title · description · status · winning_outcome · outcomes · volume_usd · liquidity_usd · volume_24h_usd · volume_7d_usd · trades_24h · tags · event_id · event_slug · event_title · image_url · start_at · end_at · closed_at · created_at · platform | |
eventsBuscar eventos de Polymarket Envía una | category, keyword, sort, status | Entrega síncrona | El catálogo declara defaultLimit = 20 y maxLimit = 100 para el límite de esta acción. Según la acción, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $6.81 por 1.000 solicitudes | id · slug · url · title · description · tags · status · market_count · volume_usd · liquidity_usd · open_interest_usd · volume_24h_usd · trade_count · resolution_source · image_url · start_at · end_at · closed_at · created_at · markets · platform | |
tradesOperaciones de un mercado de Polymarket Envía un | market | — | Entrega síncrona | El catálogo declara defaultLimit = 50 y maxLimit = 100 para el límite de esta acción. Según la acción, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $6.81 por 1.000 solicitudes | tx_hash · order_hash · side · outcome · price · shares · amount_usd · fee_usd · traded_at · market_slug · condition_id · token_id · title · maker_wallet · taker_wallet · platform |
¿Qué significan los parámetros de Polymarket markets?
Envía una keyword opcional (3 o más caracteres), status y sort y recibe hasta 100 mercados con title, outcomes y sus precios, volume_usd, liquidity_usd, volumen reciente, winning_outcome, el evento padre y fechas.
keywordOpcional- Palabras del título del mercado o evento, al menos 3 caracteres, como
bitcoinoelection; sin ella lista todo según el orden elegido. sortOpcional- Orden de la lista.
markets: volume (por defecto), open_interest, price_desc, price_asc, expiration, created, volume_1d, volume_7d, trades_1d.events: created (por defecto), start_date, end_date, volume_1d, volume_7d, volume_all_time, open_interest, trades_1d.Valores permitidos:createdexpirationopen_interestprice_ascprice_desctrades_1dvolumevolume_1dvolume_7d statusOpcional- open (en negociación) o closed (terminado); sin él, ambos.Valores permitidos:
closedopen
¿Qué significan los parámetros de Polymarket events?
Envía una keyword opcional, status, sort y category y recibe hasta 100 eventos con título, descripción, volumen, liquidez, interés abierto, número de mercados, fechas y hasta 10 markets anidados.
categoryOpcional- Categoría del evento para
events, como Crypto, Sports o Politics. keywordOpcional- Palabras del título del mercado o evento, al menos 3 caracteres, como
bitcoinoelection; sin ella lista todo según el orden elegido. sortOpcional- Orden de la lista.
markets: volume (por defecto), open_interest, price_desc, price_asc, expiration, created, volume_1d, volume_7d, trades_1d.events: created (por defecto), start_date, end_date, volume_1d, volume_7d, volume_all_time, open_interest, trades_1d.Valores permitidos:createdend_dateopen_intereststart_datetrades_1dvolume_1dvolume_7dvolume_all_time statusOpcional- open (en negociación) o closed (terminado); sin él, ambos.Valores permitidos:
closedopen
¿Qué significan los parámetros de Polymarket trades?
Envía un market (slug, condition ID 0x o enlace) y recibe sus operaciones más recientes, hasta 100, con side, outcome, price, shares, amount_usd, fee_usd, traded_at, tx_hash y las billeteras públicas de las dos partes.
marketObligatorio- El mercado para
trades: su slug (comowill-donald-trump-win-the-2024-us-presidential-election), su condition ID 0x o su enlace de polymarket.com, tomado de una fila demarkets.Documentación de Polymarket: mercados y eventos — La documentación oficial de Polymarket describe un evento como la pregunta que ve el usuario y cada mercado como una condición Sí/No identificada por su slug y su condition ID, por eso `market` acepta cualquiera de los dos. Las operaciones vienen de la cadena, no de esta fuente. · Consultada
Cómo usar la API de Polymarket
- 01Consulta el catálogo público y elige una acción de la plataforma.
- 02Envía los parámetros platform y action, junto con los campos obligatorios, a POST /api/v1/social.
- 03Procesa el resultado síncrono o consulta el identificador de trabajo cuando la acción se ejecute de forma asíncrona.
- 04Guarda los campos de la respuesta estructurada que necesita tu aplicación.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"polymarket","action":"markets","params":{}}'
Preguntas sobre la API de Polymarket
¿Cómo llamo a la API de Polymarket?
Envía POST /api/v1/social con platform igual a polymarket, elige uno de los identificadores de acción indicados e incluye sus parámetros obligatorios.
¿Qué devuelve la API de Polymarket?
Devuelve JSON estructurado. Por ejemplo, el esquema de markets incluye condition_id, slug, title y description. Cada acción tiene su propia lista de campos; que un campo esté declarado no garantiza que todos los registros tengan un valor.
¿Qué matiz de la documentación oficial conviene conservar al usar datos de Polymarket?
La documentación oficial de Polymarket describe un evento como la pregunta que ve el usuario y cada mercado como una condición Sí/No identificada por su slug y su condition ID, por eso market acepta cualquiera de los dos. Las operaciones vienen de la cadena, no de esta fuente.
¿Qué parámetros son obligatorios?
Depende de la acción. markets no requiere parámetros obligatorios; events no requiere parámetros obligatorios; trades requiere market.
¿Las acciones de Polymarket responden de inmediato?
Las acciones marcadas como asíncronas devuelven un identificador de trabajo que se consulta por sondeo. Cualquier otra acción también puede ejecutarse de forma asíncrona: añade "mode": "async" al cuerpo de la solicitud para recibir el identificador de inmediato, útil para tareas lentas o límites altos.