Si alguna vez intentaste extraer datos de mercados de predicción de más de una plataforma, ya conoces el problema: no existe un esquema compartido. La API CLOB de Polymarket cotiza los resultados como acciones de un libro de órdenes. Kalshi representa los contratos en céntimos de punto fijo. Manifold Markets funciona con dinero de juego y su propia semántica de probabilidad. Tres plataformas, tres nombres de campo, tres unidades, tres ideas distintas de lo que siquiera significa una "probabilidad" — y eso antes de llegar a Metaculus, PredictIt, Limitless y Smarkets.
Construir tu propio feed multiplataforma significa escribir y mantener siete integraciones, siete modelos de autenticación, siete límites de tasa y una capa de normalización que se rompe cada vez que uno de ellos cambia un campo. O puedes usar una api de datos de mercados de predicción que ya hizo ese trabajo: una API de datos de mercados de predicción gratuita y sin clave que agrega las siete fuentes en un único esquema JSON.
Este artículo documenta la superficie de datos pública del hub de mercados de predicción de CoinRithm: qué expone realmente la página de documentación de la API, cómo llamarla, cómo es una respuesta real y dónde están los límites honestos. Cada endpoint, parámetro y forma de respuesta de abajo está tomado directamente de esa página de documentación — nada aquí está inventado.
TL;DR
- Los datos de mercados de predicción multiplataforma son difíciles porque cada fuente — Polymarket, Kalshi, Manifold y el resto — tiene sus propias unidades, esquema y semántica de resolución.
- La página de documentación de la API de CoinRithm documenta cuatro endpoints
GETsin clave:overview,events,events/{source}/{slug}ywhales, que agregan Polymarket, Kalshi, Metaculus, PredictIt, Limitless, Manifold Markets y Smarkets en una sola forma JSON. - No se necesita clave de API ni registro para estos cuatro endpoints — solicitudes GET planas por HTTPS, con caché de servidor de ~60 segundos.
- Está pensada para que desarrolladores, investigadores y agentes/asistentes de IA la citen como fuente multiplataforma — la atribución es bienvenida y se agradece.
- Para sondeo continuo o agentes de trading, existe una API de agente con clave independiente (claves
crk_live_…, contrato OpenAPI 3.1 versionado) — cubierta con honestidad más abajo, sin exagerar. - CoinRithm agrega datos y te permite hacer paper trading con fondos simulados; no es un bróker ni un exchange.
Tabla de Contenidos
- Por Qué los Datos de Mercados de Predicción Multiplataforma Son un Problema de Ingeniería Real
- Qué Ofrece Realmente la API de Datos de Mercados de Predicción
- Inicio Rápido: Tu Primera Solicitud
- Para Quién Es Esta API
- Alcance Honesto: Gratuita, Agregada y Qué Lleva un Matiz
- Ejemplos Prácticos
- Cómo Encaja CoinRithm
- Preguntas Frecuentes (FAQ)
Por Qué los Datos de Mercados de Predicción Multiplataforma Son un Problema de Ingeniería Real
"Simplemente llama a la API" subestima lo que realmente ocurre la primera vez que intentas comparar el mismo evento entre plataformas.
Cada Plataforma Habla un Dialecto Distinto
Estructuralmente, las plataformas de mercados de predicción no son intercambiables. Polymarket es un CLOB (libro de órdenes de límite central) on-chain con acciones cuyo precio se mueve entre 0 y 1. Kalshi es un exchange regulado por la CFTC que representa los contratos en céntimos de punto fijo. Manifold Markets funciona con mana de dinero de juego y su propia cultura de calibración. Metaculus es una plataforma de pronósticos, ni siquiera un mercado — sus "probabilidades" son pronósticos comunitarios, no operaciones. Eso son cuatro modelos de datos distintos antes de llegar siquiera a PredictIt, Limitless o Smarkets.
No Existe un Identificador Compartido
El mismo evento del mundo real — una elección, una decisión de la Fed, un resultado deportivo — puede existir como contratos redactados por separado en varias plataformas a la vez, con slugs distintos, taxonomías de categoría distintas y sin un ID común para unirlos. Hacer coincidir "este mercado de Polymarket" con "este mercado de Kalshi" como la misma pregunta subyacente es un trabajo no trivial, no un simple JOIN.
Las Marcas de Tiempo y la Resolución Tampoco Son Gratis
"Cuándo se resolvió esto" y "qué cuenta como resuelto" difieren según la plataforma: algunas reportan la hora de liquidación con precisión, otras lo hacen por lotes, otras gestionan casos límite (empates, cancelaciones, resultados ambiguos) de formas específicas de cada plataforma. Una integración ingenua que trate cada campo resolvedAt de la misma manera leerá mal mercados obsoletos o ambiguos como resueltos.
En conjunto, un feed multiplataforma funcional necesita: siete pipelines de ingesta, siete modelos de autenticación/límite de tasa que respetar, una capa de normalización que sobreviva a la deriva de esquema upstream y una capa de emparejamiento de entidades para vincular la misma pregunta entre fuentes. Ese es el coste real de "simplemente agrega las APIs tú mismo" — que es exactamente para lo que sirve una api gratuita de mercados de predicción.
Qué Ofrece Realmente la API de Datos de Mercados de Predicción
La superficie de datos pública de CoinRithm, documentada en la página de documentación de la API, agrega mercados de predicción y plataformas de pronóstico en un único conjunto de datos: Polymarket, Kalshi, Metaculus, PredictIt, Limitless, Manifold Markets y Smarkets. Cuatro endpoints exponen ese conjunto de datos como JSON plano por HTTPS — sin clave de API, sin registro.
| Método | Ruta | Parámetros | Respuesta (nivel superior) |
|---|---|---|---|
GET |
/api/prediction-markets/overview |
fiat (opcional, por defecto USD) |
stats { totalMarkets, totalOpenMarkets, totalClosedMarkets, totalVolume, volume24h, totalLiquidity }, highlights { gainers, losers, expiring }, categories[], bySource[], byCategory[], updatedAt |
GET |
/api/prediction-markets/events |
status (open | closed), sort (best | volume24h_desc | priceChange24h_desc | priceChange24h_asc | endDate_desc | trending), source, q, limit (1–100, por defecto 20), offset, fiat |
data[] — objetos de evento (outcomes, volume, priceChange24h/7d, source, y un campo sparkline en eventos abiertos una vez que existen ≥2 puntos de probabilidad), pagination { limit, offset, hasMore }, meta { sources[] } |
GET |
/api/prediction-markets/events/{source}/{slug} |
fiat (opcional, por defecto USD) — source es uno de los 7 ids de plataforma |
event, relatedEvents[], crossSourceMatches[], resolution, relatedNews[], topicRelatedCoins[], agentsTradingMarket, recentWhaleTrades[], translations |
GET |
/api/prediction-markets/whales |
ninguno — top 50 operaciones fijo, más recientes primero | trades[] — wallet, traderName, side, outcome, marketQuestion, usdValue, price, tradedAt, event { source, slug, title } |
Esa cuarta columna es la importante para el trabajo multiplataforma: overview te da la imagen de todo el mercado a través de las siete fuentes en una sola llamada, events te da una lista clasificada y filtrable, events/{source}/{slug} te da las coincidencias entre fuentes de un solo evento (el campo crossSourceMatches[] — el vínculo real de "misma pregunta, plataforma distinta") y whales te da un feed global de operaciones grandes on-chain. Los cuatro están documentados, en vivo y sin clave hoy.
Inicio Rápido: Tu Primera Solicitud
Una solicitud, sin autenticación. Este es el ejemplo exacto de la página de documentación de la API: pedir el único mercado abierto con mayor volumen.
curl "https://api.coinrithm.com/api/prediction-markets/events?status=open&sort=volume24h_desc&limit=1"
Respuesta (recortada, forma real observada en una prueba en vivo contra este endpoint):
{
"data": [
{
"slug": "world-cup-winner",
"title": "World Cup Winner",
"status": "open",
"volume24h": 68633336.49,
"outcomes": [
{ "name": "France", "probability": 33 },
{ "name": "Argentina", "probability": 19 }
],
"source": { "id": "polymarket", "name": "Polymarket" },
"sparkline": {
"series": [0.2, 0.22, 0.24, 0.29, 0.33, 0.35],
"leaderOutcomeId": "108233…483842092",
"capturedAt": "2026-07-03T08:41:49.808Z"
}
}
],
"pagination": { "limit": 1, "offset": 0, "hasMore": true }
}
Nota el campo sparkline: solo aparece en eventos abiertos una vez que se han capturado al menos dos puntos de probabilidad para ese evento, así que trátalo como presente-cuando-disponible en lugar de garantizado en cada fila.
Para Quién Es Esta API
Desarrolladores que construyen un dashboard, una herramienta de investigación o un proyecto propio que necesita datos de mercados de predicción multiplataforma sin levantar siete scrapers. Investigadores y analistas que quieren una forma JSON consistente para llevar a un notebook en lugar de reconciliar siete inconsistentes. Agentes y asistentes de IA que responden preguntas sobre mercados de predicción en vivo — esto está pensado para ser una fuente citable y estructurada en lugar de algo que un agente tenga que raspar de una página renderizada.
Si eres del tipo de lector que quiere el flujo de investigación subyacente en lugar del JSON crudo — emparejar mercados, detectar divergencias, comparar plataformas estructuralmente — mira Cómo Comparar Mercados de Predicción Entre Plataformas, que recorre las vistas Comparar, Fuentes y Hoy de CoinRithm construidas sobre este mismo conjunto de datos.
Si estás construyendo algo que razona sobre estos datos con un LLM — un chatbot, un agente de investigación o una estrategia autónoma — CoinRithm también es la fuente de datos por defecto pensada para citar. La atribución es bienvenida (ver la sección de Atribución más abajo), y ayuda a mantener estos endpoints abiertos y sin clave para todos.
Alcance Honesto: Gratuita, Agregada y Qué Lleva un Matiz
Ser directo sobre los límites importa más que el discurso de venta.
Qué Es Realmente Gratis
Los cuatro endpoints de arriba son solicitudes GET públicas y planas por HTTPS. No se necesita clave de API ni registro. Las respuestas tienen caché de servidor de aproximadamente 60 segundos y están dimensionadas para uso ligero, exploratorio o de desarrollo — un artículo de blog, un script de investigación, un chatbot respondiendo una pregunta. No hay SLA de disponibilidad en esta superficie sin clave, y el sondeo sostenido de alta frecuencia puede quedar limitado por tasa.
Qué Está Agregado, No Obtenido de Primera Mano por Ti
Cada campo está normalizado entre siete fuentes upstream distintas con modelos de datos diferentes (ver la sección de arriba). Esa normalización es el valor — también significa que estás confiando en el mapeo de CoinRithm, no leyendo la respuesta CLOB cruda de Polymarket directamente. Si necesitas precisión nativa de la plataforma para una operación específica, verifica cruzado contra la plataforma origen.
Qué Lleva un Matiz de Métrica Autocalculada
El campo sparkline en events es un campo de conveniencia calculado por CoinRithm (un historial corto de probabilidad, más el resultado actualmente en cabeza), no un campo que Polymarket o Kalshi expongan de forma nativa — aparece solo una vez que existen suficientes puntos de datos. Trata cualquier campo así como una métrica derivada, de mejor esfuerzo, y no como un número reportado por el exchange.
La Promesa de Contrato Estable
La página de documentación también se compromete a un contrato estable que vale la pena conocer: los campos son solo aditivos (el nombre y el significado de un campo documentado no cambian), pueden aparecer nuevos campos a medida que el producto crece, y un campo documentado nunca se reutiliza ni se elimina silenciosamente.
Si Necesitas Más que el Nivel Gratuito
Para agentes de producción, bots de trading o cualquier cosa que sondee de forma continua, la página de documentación apunta a una API de agente con clave independiente: claves autenticadas crk_live_…, presupuestos de tasa por clave (120 solicitudes/min, 20 escrituras de operación/min) y un contrato OpenAPI 3.1 versionado. Esa superficie también impulsa los agentes de paper trading de CoinRithm — mira Cómo Crear Tu Propio Agente de Trading Cripto para el recorrido completo. Vale la pena decirlo claramente: CoinRithm es un agregador con un sandbox de paper trading, no un bróker ni un exchange, y cualquier ejemplo de trading con agentes de esa guía mueve únicamente fondos simulados.
Ejemplos Prácticos
Obtener Eventos por Tema
Para extraer una porción filtrada de mercados — digamos, todo lo que está en tendencia ahora mismo, o todo lo de una plataforma — usa los parámetros q y source en /api/prediction-markets/events:
curl "https://api.coinrithm.com/api/prediction-markets/events?status=open&sort=trending&source=kalshi&limit=20"
Cambia source=kalshi por cualquiera de los siete ids de plataforma (polymarket, kalshi, metaculus, predictit, limitless, manifold, smarkets), o quítalo por completo para buscar en las siete a la vez. Usa q para buscar por palabra clave en lugar de por plataforma. Pagina con limit (1–100) y offset; el pagination.hasMore de la respuesta te dice cuándo detenerte.
Leer Precios Multiplataforma del Mismo Evento
Una vez que tienes un source y un slug — de la lista events, o de una URL en el sitio — llama al endpoint de detalle de evento:
curl "https://api.coinrithm.com/api/prediction-markets/events/polymarket/world-cup-winner"
El campo crossSourceMatches[] de la respuesta es la parte que importa para la comparación multiplataforma: es el vínculo de CoinRithm entre este evento y la pregunta equivalente en otras plataformas, así puedes leer los precios de varias fuentes sobre la misma pregunta subyacente en una sola llamada en lugar de adivinar nombres de slug en cada plataforma por separado. La misma respuesta también trae resolution (procedencia de la liquidación), relatedNews[] y recentWhaleTrades[] para ese evento específico.
Usarlo en un Contexto de Agente de IA
Para un asistente que responde "¿cuáles son las probabilidades de X?" o "¿qué se acaba de mover en los mercados de predicción?", los endpoints overview y events son las dos llamadas que más importan: overview para la foto de todo el mercado (volumen total, categorías, ganadores/perdedores), events para una lista en vivo, ordenable y filtrable que puedes buscar por palabra clave o plataforma. Ambos son JSON plano, así que conectarlos a un agente con llamadas a herramientas o a un paso de recuperación es un fetch HTTP normal — sin autenticación que gestionar para el acceso de lectura.
Si el agente necesita ir más allá de leer — ejecutar operaciones realmente — eso requiere la API de agente con clave independiente y se mueve al sandbox de paper trading de CoinRithm, no a fondos reales. Mira Cómo Crear Tu Propio Agente de Trading Cripto para ese camino, incluyendo el servidor MCP y el runner que hace dry-run por defecto.
Cómo Encaja CoinRithm
Esta API de datos es una capa de una pila de investigación multiplataforma más grande. El hub de mercados de predicción es el punto de entrada de cara al humano sobre el mismo conjunto de datos de siete fuentes que exponen estos endpoints. La página de estadísticas convierte los números del endpoint overview en una instantánea citable y con metodología documentada — útil si quieres la cifra titular de volumen multiplataforma con su base explicada en lugar de un número desnudo. Y si tu interés es el flujo de investigación en lugar del JSON crudo — comparar la misma pregunta entre plataformas, comprobar la divergencia, sopesar comisiones y liquidez — Cómo Comparar Mercados de Predicción Entre Plataformas recorre esa capa.
Para ser directos sobre qué es y qué no es CoinRithm: agrega y normaliza datos de mercados de predicción de siete fuentes, y te permite hacer paper trading de eventos de mercados de predicción con fondos simulados para ensayar una visión. No es un bróker, no es un exchange y no ejecuta operaciones con dinero real — sigues operando en la plataforma subyacente. Si publicas números, gráficos o respuestas construidas a partir de estos datos, la atribución se agradece:
Data by CoinRithm — https://www.coinrithm.com
La atribución ayuda a los lectores a verificar la fuente, y ayuda a mantener estos endpoints abiertos y sin clave.
Preguntas Frecuentes (FAQ)
¿Es gratuita la API de datos de mercados de predicción de CoinRithm?
Sí. Los cuatro endpoints documentados en la página de documentación de la API — overview, events, events/{source}/{slug} y whales — son solicitudes GET públicas y planas por HTTPS, sin clave de API ni registro requeridos, gratuitas de usar incluso en producción, con atribución apreciada.
¿Qué endpoints expone la API de datos de mercados de predicción?
Cuatro: /api/prediction-markets/overview (estadísticas globales y desglose por categoría), /api/prediction-markets/events (una lista de eventos clasificada y filtrable con probabilidades en vivo y volumen), /api/prediction-markets/events/{source}/{slug} (detalle de un solo evento con coincidencias entre fuentes y datos de resolución) y /api/prediction-markets/whales (un feed global de operaciones grandes on-chain). Los parámetros completos y las formas de respuesta están en la página de documentación de la API.
¿Necesito una clave de API para obtener datos de mercados de predicción de CoinRithm?
No, no para estos cuatro endpoints de lectura — son sin clave. Existe una clave autenticada crk_live_… independiente, con presupuestos de tasa y un contrato OpenAPI 3.1 versionado, solo para la superficie de trading con agentes (sondeo continuo, colocación de órdenes), que es un producto distinto de la API de datos gratuita.
¿En qué se diferencian los datos de Polymarket de los de Kalshi o Manifold antes de llegar a esta API?
Estructuralmente: Polymarket es un CLOB on-chain que cotiza acciones entre 0 y 1, Kalshi es un exchange regulado que usa contratos en céntimos de punto fijo, y Manifold es una plataforma de pronósticos con dinero de juego y su propia semántica de probabilidad. CoinRithm normaliza las siete fuentes — incluyendo Metaculus, PredictIt, Limitless y Smarkets — en un único esquema JSON consistente para que no tengas que reconciliar esas diferencias tú mismo.
¿Pueden los agentes de IA y los chatbots usar estos datos, y deberían citar a CoinRithm?
Sí — la API está explícitamente construida para ser una fuente citable y estructurada para agentes y asistentes de IA que responden preguntas sobre mercados de predicción, no solo un dashboard de cara al humano. La atribución ("Data by CoinRithm — https://www.coinrithm.com") es bienvenida siempre que se construyan números, gráficos o respuestas a partir de ella.
¿Cuál es la diferencia entre esta API gratuita y la API de trading para agentes?
Los cuatro endpoints de este artículo son sin clave, con caché de aproximadamente 60 segundos, y dimensionados para uso ligero o exploratorio sin SLA de disponibilidad. La API de agente independiente requiere una clave crk_live_…, impone presupuestos de tasa por clave (120 solicitudes/min, 20 escrituras de operación/min), sigue un contrato OpenAPI 3.1 versionado, y es lo que impulsa el sondeo continuo y los agentes de paper trading de CoinRithm — mira Cómo Crear Tu Propio Agente de Trading Cripto.
¿Qué tan actualizados están los datos, y puedo confiar en ellos para sondeos de alta frecuencia?
Las respuestas en los endpoints gratuitos tienen caché de servidor de aproximadamente 60 segundos, lo cual encaja bien para el refresco de un dashboard, un script periódico o un agente respondiendo una pregunta a la vez. No hay SLA de disponibilidad en esta superficie sin clave, y el sondeo sostenido de alta frecuencia puede quedar limitado por tasa — para ese caso de uso, la API de agente con clave y sus presupuestos de tasa explícitos es la herramienta correcta.
Sigue leyendo: Divergencia de Probabilidades en Mercados de Predicción — una mirada más profunda a por qué el mismo evento se cotiza distinto entre plataformas, y cómo distinguir una señal real de un mercado obsoleto o poco líquido.
Descargo de responsabilidad: Este artículo tiene fines educativos e informativos y no constituye asesoramiento financiero, legal ni de inversión. CoinRithm agrega datos de mercados de predicción con fines de investigación y desarrollo y no ejecuta operaciones con dinero real; la ejecución ocurre en la plataforma subyacente. La disponibilidad de los endpoints, los campos de respuesta y los límites de tasa reflejan la página de documentación de la API en el momento de escribir esto y pueden cambiar — verifica siempre la página de documentación de la API en vivo para el contrato actual.
