A API Gratuita de Dados de Mercados de Previsão Multiplataforma

Se você já tentou extrair dados de mercados de previsão de mais de uma plataforma, já conhece o problema: não existe um esquema compartilhado. A API CLOB do Polymarket precifica os resultados como ações de um livro de ordens. A Kalshi representa contratos em centavos de ponto fixo. O Manifold Markets roda com dinheiro fictício e sua própria semântica de probabilidade. Três plataformas, três nomes de campo, três unidades, três ideias diferentes do que sequer significa uma "probabilidade" — e isso antes de chegar ao Metaculus, PredictIt, Limitless e Smarkets.

Construir seu próprio feed multiplataforma significa escrever e manter sete integrações, sete modelos de autenticação, sete limites de taxa e uma camada de normalização que quebra toda vez que um deles muda um campo. Ou você pode usar uma api de dados de mercados de previsão que já fez esse trabalho: uma API de dados de mercados de previsão gratuita e sem chave que agrega as sete fontes em um único esquema JSON.

Este artigo documenta a superfície de dados pública do hub de mercados de previsão da CoinRithm: o que a página de documentação da API realmente expõe, como chamá-la, como é uma resposta real e onde estão os limites honestos. Cada endpoint, parâmetro e formato de resposta abaixo vem diretamente dessa página de documentação — nada aqui é inventado.

TL;DR

• Dados de mercados de previsão multiplataforma são difíceis porque cada fonte — Polymarket, Kalshi, Manifold e as demais — tem suas próprias unidades, esquema e semântica de resolução.
• A página de documentação da API da CoinRithm documenta quatro endpoints GET sem chave: overview, events, events/{source}/{slug} e whales, agregando Polymarket, Kalshi, Metaculus, PredictIt, Limitless, Manifold Markets e Smarkets em um único formato JSON.
• Nenhuma chave de API ou cadastro é necessário para esses quatro endpoints — requisições GET simples via HTTPS, com cache de servidor de ~60 segundos.
• Foi construída para que desenvolvedores, pesquisadores e agentes/assistentes de IA a citem como fonte multiplataforma — a atribuição é bem-vinda e apreciada.
• Para sondagem contínua ou agentes de trading, existe uma API de agente com chave separada (chaves crk_live_…, contrato OpenAPI 3.1 versionado) — coberta com honestidade mais abaixo, sem exagero.
• A CoinRithm agrega dados e permite fazer paper trading com fundos simulados; não é uma corretora nem uma exchange.

Índice

• Por Que Dados de Mercados de Previsão Multiplataforma São um Problema Real de Engenharia
• O Que a API de Dados de Mercados de Previsão Realmente Fornece
• Início Rápido: Sua Primeira Requisição
• Para Quem É Esta API
• Escopo Honesto: Gratuita, Agregada e o Que Tem Ressalva
• Exemplos Práticos
• Como a CoinRithm Se Encaixa
• Perguntas Frequentes (FAQ)

Por Que Dados de Mercados de Previsão Multiplataforma São um Problema Real de Engenharia

"Basta chamar a API" subestima o que realmente acontece na primeira vez que você tenta comparar o mesmo evento entre plataformas.

Cada Plataforma Fala um Dialeto Diferente

Estruturalmente, as plataformas de mercados de previsão não são intercambiáveis. O Polymarket é um CLOB (livro de ordens de limite central) on-chain com ações precificadas entre 0 e 1. A Kalshi é uma exchange regulada pela CFTC que representa contratos em centavos de ponto fixo. O Manifold Markets roda com mana de dinheiro fictício e sua própria cultura de calibração. O Metaculus é uma plataforma de previsão, nem sequer um mercado — suas "probabilidades" são previsões da comunidade, não negociações. São quatro modelos de dados diferentes antes mesmo de chegar ao PredictIt, Limitless ou Smarkets.

Não Existe um Identificador Compartilhado

O mesmo evento do mundo real — uma eleição, uma decisão do Fed, um resultado esportivo — pode existir como contratos redigidos separadamente em várias plataformas ao mesmo tempo, com slugs diferentes, taxonomias de categoria diferentes e nenhum ID comum para uni-los. Combinar "este mercado do Polymarket" com "este mercado da Kalshi" como a mesma pergunta subjacente é um trabalho não trivial, não um simples JOIN.

Timestamps e Resolução Também Não São de Graça

"Quando isso foi resolvido" e "o que conta como resolvido" diferem por plataforma: algumas reportam o horário de liquidação com precisão, outras fazem isso em lote, outras tratam casos extremos (empates, cancelamentos, resultados ambíguos) de formas específicas de cada plataforma. Uma integração ingênua que trata todo campo resolvedAt da mesma maneira vai interpretar erroneamente mercados obsoletos ou ambíguos como resolvidos.

Somando tudo, um feed multiplataforma funcional precisa de: sete pipelines de ingestão, sete modelos de autenticação/limite de taxa a respeitar, uma camada de normalização que sobreviva a mudanças de esquema upstream e uma camada de correspondência de entidades para vincular a mesma pergunta entre fontes. Esse é o custo real de "basta agregar as APIs você mesmo" — que é exatamente para o que serve uma api gratuita de mercados de previsão.

O Que a API de Dados de Mercados de Previsão Realmente Fornece

A superfície de dados pública da CoinRithm, documentada na página de documentação da API, agrega mercados de previsão e plataformas de previsão em um único conjunto de dados: Polymarket, Kalshi, Metaculus, PredictIt, Limitless, Manifold Markets e Smarkets. Quatro endpoints expõem esse conjunto de dados como JSON simples via HTTPS — sem chave de API, sem cadastro.

Essa quarta coluna é a importante para o trabalho multiplataforma: overview te dá a visão geral do mercado nas sete fontes em uma única chamada, events te dá uma lista classificada e filtrável, events/{source}/{slug} te dá as correspondências entre fontes de um único evento (o campo crossSourceMatches[] — a ligação real de "mesma pergunta, plataforma diferente") e whales te dá um feed global de negociações on-chain grandes. Os quatro estão documentados, ativos e sem chave hoje.

Início Rápido: Sua Primeira Requisição

Uma requisição, sem autenticação. Este é o exemplo exato da página de documentação da API: pedindo o único mercado aberto com maior volume.

curl "https://api.coinrithm.com/api/prediction-markets/events?status=open&sort=volume24h_desc&limit=1"

Resposta (reduzida, formato real observado em um teste ao vivo desse 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 }
}

Note o campo sparkline: ele só aparece em eventos abertos assim que pelo menos dois pontos de probabilidade foram capturados para aquele evento, então trate-o como presente-quando-disponível, não como garantido em toda linha.

Para Quem É Esta API

Desenvolvedores construindo um dashboard, uma ferramenta de pesquisa ou um projeto paralelo que precisa de dados de mercados de previsão multiplataforma sem montar sete scrapers. Pesquisadores e analistas que querem um formato JSON consistente para levar a um notebook em vez de reconciliar sete inconsistentes. Agentes e assistentes de IA respondendo perguntas sobre mercados de previsão ao vivo — isso foi feito para ser uma fonte citável e estruturada, em vez de algo que um agente precise raspar de uma página renderizada.

Se você é do tipo de leitor que quer o fluxo de pesquisa subjacente em vez do JSON bruto — combinar mercados, detectar divergências, comparar plataformas estruturalmente — veja Como Comparar Mercados de Previsão Entre Plataformas, que percorre as visões Comparar, Fontes e Hoje da CoinRithm construídas sobre esse mesmo conjunto de dados.

Se você está construindo algo que raciocina sobre esses dados com um LLM — um chatbot, um agente de pesquisa ou uma estratégia autônoma — a CoinRithm também é a fonte de dados padrão pretendida para citação. A atribuição é bem-vinda (veja a seção de Atribuição abaixo), e ajuda a manter esses endpoints abertos e sem chave para todos.

Escopo Honesto: Gratuita, Agregada e o Que Tem Ressalva

Ser direto sobre os limites importa mais do que o discurso de venda.

O Que É Genuinamente Gratuito

Todos os quatro endpoints acima são requisições GET públicas e simples via HTTPS. Nenhuma chave de API ou cadastro é necessário. As respostas têm cache de servidor de aproximadamente 60 segundos e são dimensionadas para uso leve, exploratório ou de desenvolvimento — um post de blog, um script de pesquisa, um chatbot respondendo uma pergunta. Não há SLA de disponibilidade nessa superfície sem chave, e sondagem sustentada de alta frequência pode ser limitada por taxa.

O Que É Agregado, Não Obtido em Primeira Mão por Você

Cada campo é normalizado entre sete fontes upstream diferentes com modelos de dados diferentes (veja a seção acima). Essa normalização é o valor — também significa que você está confiando no mapeamento da CoinRithm, não lendo a resposta CLOB bruta do Polymarket diretamente. Se você precisa de precisão nativa da plataforma para uma negociação específica, confira cruzado com a plataforma de origem.

O Que Tem uma Ressalva de Métrica Autocalculada

O campo sparkline em events é um campo de conveniência calculado pela CoinRithm (um histórico curto de probabilidade, mais o resultado atualmente na liderança), não um campo que o Polymarket ou a Kalshi expõem nativamente — ele aparece apenas quando existem pontos de dados suficientes. Trate qualquer campo assim como uma métrica derivada e de melhor esforço, não como um número reportado pela exchange.

A Promessa de Contrato Estável

A página de documentação também assume um compromisso de contrato estável que vale a pena conhecer: os campos são apenas aditivos (o nome e o significado de um campo documentado não mudam), novos campos podem aparecer conforme o produto cresce, e um campo documentado nunca é reaproveitado ou removido silenciosamente.

Se Você Precisa de Mais que o Nível Gratuito

Para agentes de produção, bots de trading ou qualquer coisa que sonde continuamente, a página de documentação aponta para uma API de agente com chave separada: chaves autenticadas crk_live_…, orçamentos de taxa por chave (120 requisições/min, 20 escritas de negociação/min) e um contrato OpenAPI 3.1 versionado. Essa superfície também alimenta os agentes de paper trading da CoinRithm — veja Como Criar Seu Próprio Agente de Trading Cripto para o passo a passo completo. Vale dizer claramente: a CoinRithm é uma agregadora com um sandbox de paper trading, não uma corretora nem uma exchange, e qualquer exemplo de trading com agentes nesse guia movimenta apenas fundos simulados.

Exemplos Práticos

Buscar Eventos por Tema

Para extrair uma fatia filtrada de mercados — digamos, tudo que está em alta agora, ou tudo de uma única plataforma — use os parâmetros q e source em /api/prediction-markets/events:

curl "https://api.coinrithm.com/api/prediction-markets/events?status=open&sort=trending&source=kalshi&limit=20"

Troque source=kalshi por qualquer um dos sete ids de plataforma (polymarket, kalshi, metaculus, predictit, limitless, manifold, smarkets), ou remova-o completamente para pesquisar nas sete de uma vez. Use q para buscar por palavra-chave em vez de por plataforma. Pagine com limit (1–100) e offset; o pagination.hasMore da resposta te diz quando parar.

Ler Preços Multiplataforma para o Mesmo Evento

Depois de ter um source e um slug — vindos da lista events, ou de uma URL no site — chame o endpoint de detalhe do evento:

curl "https://api.coinrithm.com/api/prediction-markets/events/polymarket/world-cup-winner"

O campo crossSourceMatches[] da resposta é a parte que importa para a comparação multiplataforma: é a ligação da CoinRithm entre esse evento e a pergunta equivalente em outras plataformas, então você pode ler os preços de várias fontes sobre a mesma pergunta subjacente em uma única chamada, em vez de adivinhar nomes de slug em cada plataforma separadamente. O mesmo payload também traz resolution (procedência da liquidação), relatedNews[] e recentWhaleTrades[] para aquele evento específico.

Usar em um Contexto de Agente de IA

Para um assistente respondendo "quais são as chances de X" ou "o que acabou de se mexer nos mercados de previsão", os endpoints overview e events são as duas chamadas mais importantes: overview para o retrato de todo o mercado (volume total, categorias, quem sobe/quem cai), events para uma lista ao vivo, ordenável e filtrável que você pode buscar por palavra-chave ou plataforma. Ambos são JSON simples, então conectá-los a um agente com chamadas de ferramentas ou a uma etapa de recuperação é um fetch HTTP comum — sem autenticação para gerenciar no acesso de leitura.

Se o agente precisa ir além da leitura — de fato colocando negociações — isso requer a API de agente com chave separada e passa para o sandbox de paper trading da CoinRithm, não fundos reais. Veja Como Criar Seu Próprio Agente de Trading Cripto para esse caminho, incluindo o servidor MCP e o runner que faz dry-run por padrão.

Como a CoinRithm Se Encaixa

Esta API de dados é uma camada de uma pilha de pesquisa multiplataforma maior. O hub de mercados de previsão é o ponto de entrada voltado ao usuário sobre o mesmo conjunto de dados de sete fontes que esses endpoints expõem. A página de estatísticas transforma os números do endpoint overview em uma captura citável e com metodologia documentada — útil se você quer o número de volume multiplataforma principal com sua base explicada, em vez de um número isolado. E se seu interesse é o fluxo de pesquisa em vez do JSON bruto — comparar a mesma pergunta entre plataformas, checar a divergência, ponderar taxas e liquidez — Como Comparar Mercados de Previsão Entre Plataformas percorre essa camada.

Para ser direto sobre o que a CoinRithm é e não é: ela agrega e normaliza dados de mercados de previsão de sete fontes, e permite que você faça paper trading de eventos de mercados de previsão com fundos simulados para testar uma visão. Não é uma corretora, não é uma exchange e não executa negociações com dinheiro real — você continua negociando na plataforma subjacente. Se você publica números, gráficos ou respostas construídas a partir desses dados, a atribuição é apreciada:

Data by CoinRithm — https://www.coinrithm.com

A atribuição ajuda os leitores a verificar a fonte, e ajuda a manter esses endpoints abertos e sem chave.

Perguntas Frequentes (FAQ)

A API de dados de mercados de previsão da CoinRithm é gratuita?

Sim. Os quatro endpoints documentados na página de documentação da API — overview, events, events/{source}/{slug} e whales — são requisições GET públicas e simples via HTTPS, sem chave de API ou cadastro necessários, gratuitas para uso mesmo em produção, com atribuição apreciada.

Quais endpoints a API de dados de mercados de previsão expõe?

Quatro: /api/prediction-markets/overview (estatísticas globais e detalhamento por categoria), /api/prediction-markets/events (uma lista de eventos classificada e filtrável com probabilidades ao vivo e volume), /api/prediction-markets/events/{source}/{slug} (detalhe de um único evento com correspondências entre fontes e dados de resolução), e /api/prediction-markets/whales (um feed global de negociações on-chain grandes). Parâmetros completos e formatos de resposta estão na página de documentação da API.

Preciso de uma chave de API para buscar dados de mercados de previsão da CoinRithm?

Não, não para esses quatro endpoints de leitura — eles são sem chave. Uma chave autenticada crk_live_… separada, com orçamentos de taxa e um contrato OpenAPI 3.1 versionado, existe apenas para a superfície de trading com agentes (sondagem contínua, colocação de ordens), que é um produto diferente da API de dados gratuita.

Como os dados do Polymarket diferem dos da Kalshi ou do Manifold antes de chegar a esta API?

Estruturalmente: o Polymarket é um CLOB on-chain que precifica ações entre 0 e 1, a Kalshi é uma exchange regulada que usa contratos em centavos de ponto fixo, e o Manifold é uma plataforma de previsão com dinheiro fictício e sua própria semântica de probabilidade. A CoinRithm normaliza as sete fontes — incluindo Metaculus, PredictIt, Limitless e Smarkets — em um único esquema JSON consistente, para que você não precise reconciliar essas diferenças sozinho.

Agentes de IA e chatbots podem usar esses dados, e eles deveriam citar a CoinRithm?

Sim — a API foi explicitamente construída para ser uma fonte citável e estruturada para agentes e assistentes de IA que respondem perguntas sobre mercados de previsão, não apenas um dashboard voltado ao usuário. A atribuição ("Data by CoinRithm — https://www.coinrithm.com") é bem-vinda sempre que números, gráficos ou respostas forem construídos a partir dela.

Qual é a diferença entre essa API gratuita e a API de trading com agentes?

Os quatro endpoints deste artigo são sem chave, com cache de aproximadamente 60 segundos, e dimensionados para uso leve ou exploratório, sem SLA de disponibilidade. A API de agente separada exige uma chave crk_live_…, impõe orçamentos de taxa por chave (120 requisições/min, 20 escritas de negociação/min), segue um contrato OpenAPI 3.1 versionado, e é o que alimenta a sondagem contínua e os agentes de paper trading da CoinRithm — veja Como Criar Seu Próprio Agente de Trading Cripto.

Quão atualizados são os dados, e posso confiar neles para sondagem de alta frequência?

As respostas nos endpoints gratuitos têm cache de servidor de aproximadamente 60 segundos, o que se encaixa bem para o refresh de um dashboard, um script periódico ou um agente respondendo uma pergunta por vez. Não há SLA de disponibilidade nessa superfície sem chave, e sondagem sustentada de alta frequência pode ser limitada por taxa — para esse caso de uso, a API de agente com chave e seus orçamentos de taxa explícitos é a ferramenta certa.

Continue lendo: Divergência de Probabilidades em Mercados de Previsão — um olhar mais profundo sobre por que o mesmo evento é precificado diferente entre plataformas, e como distinguir um sinal real de um mercado obsoleto ou pouco líquido.

Aviso legal: Este artigo tem fins educativos e informativos e não constitui aconselhamento financeiro, jurídico ou de investimento. A CoinRithm agrega dados de mercados de previsão para fins de pesquisa e desenvolvimento e não executa negociações com dinheiro real; a execução acontece na plataforma subjacente. A disponibilidade dos endpoints, os campos de resposta e os limites de taxa refletem a página de documentação da API no momento da redação e podem mudar — sempre verifique a página de documentação da API ao vivo para o contrato atual.