Polymarket
Accede a datos de mercados de predicción desde Polymarket
Polymarket es una plataforma descentralizada de mercados de predicción donde los usuarios pueden operar sobre el resultado de eventos futuros utilizando tecnología blockchain. Polymarket proporciona una API completa, permitiendo a desarrolladores y agentes acceder a datos de mercado en vivo, listados de eventos, información de precios y estadísticas de libro de órdenes para potenciar flujos de trabajo basados en datos y automatizaciones de IA.
Con la API de Polymarket y la integración de Cadense, puedes permitir que los agentes recuperen programáticamente información de mercados de predicción, exploren mercados abiertos y eventos asociados, analicen datos históricos de precios y accedan a libros de órdenes y puntos medios del mercado. Esto crea nuevas posibilidades para la investigación, análisis automatizado y desarrollo de agentes inteligentes que reaccionan a probabilidades de eventos en tiempo real derivadas de los precios del mercado.
Las características principales de la integración de Polymarket incluyen:
- Listado y filtrado de mercados: Lista todos los mercados de predicción actuales o históricos, filtra por etiqueta, ordena y navega por los resultados paginados.
- Detalle del mercado: Recupera detalles de un solo mercado por ID o slug, incluyendo sus resultados y estado.
- Listados de eventos: Accede a listas de eventos de Polymarket e información detallada de eventos.
- Libro de órdenes y datos de precios: Analiza el libro de órdenes, obtén los últimos precios del mercado, visualiza el punto medio u obtén información histórica de precios para cualquier mercado.
- Listo para automatización: Construye agentes o herramientas que reaccionan programáticamente a desarrollos del mercado, cambios en las probabilidades o resultados específicos de eventos.
Al utilizar estos endpoints de API documentados, puedes integrar perfectamente los ricos datos de mercados de predicción en cadena de Polymarket en tus propios flujos de trabajo de IA, paneles de control, herramientas de investigación y automatizaciones de trading.
Instrucciones de uso
Integra los mercados de predicción de Polymarket en el flujo de trabajo. Puede obtener mercados, mercado, eventos, evento, etiquetas, series, libro de órdenes, precio, punto medio, historial de precios, último precio de operación, diferencial, tamaño de tick, posiciones, operaciones y búsqueda.
Herramientas
polymarket_get_markets
Obtener una lista de mercados de predicción de Polymarket con filtrado opcional
Entrada
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
closed | string | No | Filtrar por estado cerrado (true/false). Use false para mostrar solo mercados activos. |
order | string | No | Campo de ordenación (p. ej., volumeNum, liquidityNum, startDate, endDate, createdAt) |
ascending | string | No | Dirección de ordenación (true para ascendente, false para descendente) |
tagId | string | No | Filtrar por ID de etiqueta |
limit | string | No | Número de resultados por página (máximo 50) |
offset | string | No | Desplazamiento de paginación (omitir esta cantidad de resultados) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
markets | array | Array de objetos de mercado |
polymarket_get_market
Obtener detalles de un mercado de predicción específico por ID o slug
Entrada
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
marketId | string | No | El ID del mercado. Requerido si no se proporciona el slug. |
slug | string | No | El slug del mercado (p. ej., "will-trump-win"). Requerido si no se proporciona marketId. |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
market | object | Objeto de mercado con detalles |
polymarket_get_events
Obtener una lista de eventos de Polymarket con filtrado opcional
Entrada
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
closed | string | No | Filtrar por estado cerrado (true/false). Use false para mostrar solo eventos activos. |
order | string | No | Campo de ordenación (p. ej., volume, liquidity, startDate, endDate, createdAt) |
ascending | string | No | Dirección de ordenación (true para ascendente, false para descendente) |
tagId | string | No | Filtrar por ID de etiqueta |
limit | string | No | Número de resultados por página (máximo 50) |
offset | string | No | Desplazamiento de paginación (omitir esta cantidad de resultados) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
events | array | Array de objetos de eventos |
polymarket_get_event
Obtener detalles de un evento específico por ID o slug
Entrada
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
eventId | string | No | El ID del evento. Requerido si no se proporciona el slug. |
slug | string | No | El slug del evento (ej., "2024-presidential-election"). Requerido si no se proporciona eventId. |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
event | object | Objeto de evento con detalles |
polymarket_get_tags
Obtener etiquetas disponibles para filtrar mercados de Polymarket
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
limit | string | No | Número de resultados por página (máx 50) |
offset | string | No | Desplazamiento de paginación (omitir esta cantidad de resultados) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
tags | array | Array de objetos de etiquetas con id, etiqueta y slug |
polymarket_search
Buscar mercados, eventos y perfiles en Polymarket
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
query | string | Sí | Término de búsqueda |
limit | string | No | Número de resultados por página (máx 50) |
offset | string | No | Desplazamiento de paginación |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
results | object | Resultados de búsqueda que contienen arrays de mercados, eventos y perfiles |
polymarket_get_series
Obtener series (grupos de mercados relacionados) de Polymarket
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
limit | string | No | Número de resultados por página (máx 50) |
offset | string | No | Desplazamiento de paginación (omitir esta cantidad de resultados) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Estado de éxito de la operación |
output | object | Datos de series y metadatos |
polymarket_get_series_by_id
Recuperar una serie específica (grupo de mercado relacionado) por ID desde Polymarket
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
seriesId | string | Sí | El ID de la serie |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Estado de éxito de la operación |
output | object | Datos de serie y metadatos |
polymarket_get_orderbook
Recuperar el resumen del libro de órdenes para un token específico
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
tokenId | string | Sí | El ID del token CLOB (de los clobTokenIds del mercado) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Estado de éxito de la operación |
output | object | Datos del libro de órdenes y metadatos |
polymarket_get_price
Recuperar el precio de mercado para un token y lado específicos
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
tokenId | string | Sí | El ID del token CLOB (de los clobTokenIds del mercado) |
side | string | Sí | Lado de la orden: compra o venta |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Estado de éxito de la operación |
output | object | Datos de precio de mercado y metadatos |
polymarket_get_midpoint
Recuperar el precio medio para un token específico
Entrada
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
tokenId | string | Sí | El ID del token CLOB (de los clobTokenIds del mercado) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Estado de éxito de la operación |
output | object | Datos de precio medio y metadatos |
polymarket_get_price_history
Recuperar datos históricos de precios para un token de mercado específico
Entrada
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
tokenId | string | Sí | El ID del token CLOB (de los clobTokenIds del mercado) |
interval | string | No | Duración que termina en el tiempo actual (1m, 1h, 6h, 1d, 1w, max). Mutuamente excluyente con startTs/endTs. |
fidelity | number | No | Resolución de datos en minutos (por ejemplo, 60 para datos por hora) |
startTs | number | No | Marca de tiempo de inicio (segundos Unix UTC) |
endTs | number | No | Marca de tiempo de fin (segundos Unix UTC) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Estado de éxito de la operación |
output | object | Datos del historial de precios y metadatos |
polymarket_get_last_trade_price
Recuperar el último precio de operación para un token específico
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
tokenId | string | Sí | El ID del token CLOB (de los clobTokenIds del mercado) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Estado de éxito de la operación |
output | object | Datos del último precio de operación y metadatos |
polymarket_get_spread
Recuperar el diferencial de oferta y demanda para un token específico
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
tokenId | string | Sí | El ID del token CLOB (de los clobTokenIds del mercado) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Estado de éxito de la operación |
output | object | Datos del diferencial de compra-venta y metadatos |
polymarket_get_tick_size
Recuperar el tamaño mínimo de tick para un token específico
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
tokenId | string | Sí | El ID del token CLOB (de los clobTokenIds del mercado) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Estado de éxito de la operación |
output | object | Datos del tamaño mínimo de tick y metadatos |
polymarket_get_positions
Recuperar las posiciones del usuario desde Polymarket
Entrada
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
user | string | Sí | Dirección de la cartera del usuario |
market | string | No | ID de mercado opcional para filtrar posiciones |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
success | boolean | Estado de éxito de la operación |
output | object | Datos de posiciones y metadatos |
polymarket_get_trades
Recuperar historial de operaciones de Polymarket
Entrada
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
user | string | No | Dirección de la cartera del usuario para filtrar operaciones |
market | string | No | ID de mercado para filtrar operaciones |
limit | string | No | Número de resultados por página (máximo 50) |
offset | string | No | Desplazamiento de paginación (omitir esta cantidad de resultados) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
trades | array | Array de objetos de operaciones |
Notas
- Categoría:
tools - Tipo:
polymarket
Entrada
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
user | string | Sí | Dirección de la cartera del usuario (con prefijo 0x) |
limit | string | No | Máximo de resultados a devolver (p. ej., "50"). Por defecto: 100, máx: 500. |
offset | string | No | Número de resultados a omitir para paginación (p. ej., "100"). Por defecto: 0, máx: 10000. |
market | string | No | ID de condiciones separados por comas (p. ej., "0x1234...abcd,0x5678...efgh"). Mutuamente excluyente con eventId. |
eventId | string | No | ID de eventos separados por comas (p. ej., "12345,67890"). Mutuamente excluyente con market. |
type | string | No | Filtro de tipo de actividad: TRADE, SPLIT, MERGE, REDEEM, REWARD, CONVERSION, MAKER_REBATE |
start | number | No | Marca de tiempo de inicio (segundos Unix) |
end | number | No | Marca de tiempo de fin (segundos Unix) |
sortBy | string | No | Campo de ordenación: TIMESTAMP, TOKENS o CASH (por defecto: TIMESTAMP) |
sortDirection | string | No | Dirección de ordenación: ASC o DESC (por defecto: DESC) |
side | string | No | Filtro de lado de operación: BUY o SELL (solo aplica a operaciones) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
activity | array | Array de entradas de actividad |
↳ proxyWallet | string | Dirección de la cartera proxy del usuario |
↳ timestamp | number | Marca de tiempo Unix de la actividad |
↳ conditionId | string | ID de condición del mercado |
↳ type | string | Tipo de actividad (TRADE, SPLIT, MERGE, REDEEM, REWARD, CONVERSION) |
↳ size | number | Tamaño en tokens |
↳ usdcSize | number | Tamaño en USDC |
↳ transactionHash | string | Hash de transacción de blockchain |
↳ price | number | Precio (para operaciones) |
↳ asset | string | ID de activo/token |
↳ side | string | Lado de operación (BUY/SELL) |
↳ outcomeIndex | number | Índice de resultado |
↳ title | string | Título del mercado |
↳ slug | string | Slug del mercado |
↳ icon | string | URL del icono del mercado |
↳ eventSlug | string | Slug del evento |
↳ outcome | string | Nombre del resultado |
↳ name | string | Nombre para mostrar del usuario |
↳ pseudonym | string | Seudónimo del usuario |
↳ bio | string | Biografía del usuario |
↳ profileImage | string | URL de imagen de perfil del usuario |
↳ profileImageOptimized | string | URL de imagen de perfil optimizada |
polymarket_get_leaderboard
Obtener clasificación de traders por ganancias/pérdidas o volumen
Entrada
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
category | string | No | Filtro de categoría: OVERALL, POLITICS, SPORTS, CRYPTO, CULTURE, MENTIONS, WEATHER, ECONOMICS, TECH, FINANCE (predeterminado: OVERALL) |
timePeriod | string | No | Período de tiempo: DAY, WEEK, MONTH, ALL (predeterminado: DAY) |
orderBy | string | No | Ordenar por: PNL o VOL (predeterminado: PNL) |
limit | string | No | Número de resultados a devolver (p. ej., "10"). Rango: 1-50, predeterminado: 25. |
offset | string | No | Número de resultados a omitir para paginación (p. ej., "25"). Rango: 0-1000, predeterminado: 0. |
user | string | No | Filtrar por dirección de cartera específica del usuario |
userName | string | No | Filtrar por nombre de usuario |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
leaderboard | array | Array de entradas de la clasificación |
↳ rank | string | Posición en la clasificación |
↳ proxyWallet | string | Dirección de cartera proxy del usuario |
↳ userName | string | Nombre de usuario |
↳ vol | number | Volumen de operaciones |
↳ pnl | number | Ganancias y pérdidas |
↳ profileImage | string | URL de imagen de perfil del usuario |
↳ xUsername | string | Nombre de usuario de Twitter/X |
↳ verifiedBadge | boolean | Si el usuario tiene insignia verificada |
polymarket_get_holders
Recuperar los principales tenedores de un token de mercado específico
Entrada
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
market | string | Sí | Lista de IDs de condición separados por comas (ej., "0x1234...abcd" o "0x1234...abcd,0x5678...efgh"). |
limit | string | No | Número de tenedores a devolver (ej., "10"). Rango: 0-20, predeterminado: 20. |
minBalance | string | No | Umbral mínimo de saldo (predeterminado: 1) |
Salida
| Parámetro | Tipo | Descripción |
|---|---|---|
holders | array | Array de grupos de tenedores de mercado por token |
↳ token | string | ID de token/activo |
↳ holders | array | Array de tenedores para este token |
↳ proxyWallet | string | Dirección de billetera del tenedor |
↳ bio | string | Biografía del tenedor |
↳ asset | string | ID de activo |
↳ pseudonym | string | Seudónimo del tenedor |
↳ amount | number | Cantidad poseída |
↳ displayUsernamePublic | boolean | Si el nombre de usuario se muestra públicamente |
↳ outcomeIndex | number | Índice de resultado |
↳ name | string | Nombre para mostrar del tenedor |
↳ profileImage | string | URL de imagen de perfil |
↳ profileImageOptimized | string | URL de imagen de perfil optimizada |