Kresmion

npx add-mcp 'https://kresmion.com/api/mcp'

Inteligência de mercado para bots e aplicativos. Uma API HTTP sobre mercados de previsão, fluxos cripto on-chain, ações e macro, com uma fonte citada por trás de cada registro. Autentique com uma chave Bearer, leia a especificação OpenAPI ao vivo, assine webhooks e baixe CSV em massa para backfills. É apenas informativo e não fornece aconselhamento de investimento.

URL base: https://kresmion.com/api/v1 Auth: Authorization: Bearer krm_...Especificação: openapi.json

Início rápido

Gere uma chave em /settings/api-keys e busque cinco mercados de previsão. Envie a chave como token Bearer em cada requisição.

curl -s "https://kresmion.com/api/v1/prediction/markets?limit=5" \
  -H "Authorization: Bearer krm_your_key_here"

Produtos

Seis áreas de produtos, cada uma com endpoints representativos. A lista completa e autoritativa está na referência ao vivo abaixo.

Mercados de Previsão

Mercados Polymarket e Kalshi, histórico de preços, livros de ofertas, fluxo de dinheiro inteligente, divergência entre plataformas, calibração e resoluções.

• GET /v1/prediction/markets
• GET /v1/prediction/markets/{id}/history
• GET /v1/prediction/divergence
• GET /v1/prediction/calibration

Cripto

Transferências de baleias rotuladas, participações em carteiras de exchanges, fluxos de ETFs à vista e funding de derivativos, juros em aberto e opções.

• GET /v1/crypto/whales
• GET /v1/crypto/exchange-holdings
• GET /v1/crypto/etf-flows
• GET /v1/crypto/derivatives

Ações

Pontuações de sinais, clusters de insiders do Formulário 4 da SEC, negociações do Congresso, posicionamento institucional 13F e histórico OHLCV.

• GET /v1/equities/signals
• GET /v1/equities/insiders
• GET /v1/equities/congress
• GET /v1/equities/institutional

Macro

A pontuação de regime entre ativos, além do CFTC Commitments of Traders, fluxos TIC do Tesouro e indicadores sistêmicos do BIS.

• GET /v1/macro/regime
• GET /v1/macro/cot
• GET /v1/macro/tic
• GET /v1/macro/bis

Sinais

O motor de sinais entre ativos: um feed de eventos pontuados em ações, cripto, macro e mercados de previsão.

• GET /v1/signals
• GET /v1/signals/{asset_class}
• GET /v1/status

Inteligência

O histórico publicado de sinais (retornos futuros após cada sinal, incluindo perdas), compósitos de confluência entre famílias com pernas listadas, divergência de probabilidade implícita entre previsão e opções, pontuações de dinheiro inteligente por ticker e um feed delta para agentes de polling.

• GET /v1/track-record
• GET /v1/confluence
• GET /v1/prediction/options-divergence
• GET /v1/equities/smart-money
• GET /v1/changes

Em massa

Exportações CSV gzip por intervalo de datas para backfills e pesquisa: histórico, resoluções, baleias e sinais.

• GET /v1/bulk/polymarket_history
• GET /v1/bulk/kalshi_history
• GET /v1/bulk/whales
• GET /v1/bulk/signals

Referência da API

Renderizada ao vivo a partir da especificação OpenAPI: cada endpoint agrupado por tag, com parâmetros e respostas. Expanda uma linha para detalhes.

Carregando a referência da API ao vivo...

Limites de taxa e níveis

Toda conta registrada pode gerar uma chave de API por autoatendimento. Requisições acima do limite por minuto recebem um 429 com um cabeçalho Retry-After informando quanto tempo esperar.

Nível	Chamadas mensais	Limite de taxa	Acima do limite	Acesso
Gratuito (registrado)	10.000	120 req / min	429 + Retry-After	Chave por autoatendimento
Superior	Sob consulta	Sob consulta	429 + Retry-After	Fale conosco

Precisa de limites maiores ou de um nível dedicado? Envie um e-mail para inquiry@kresmion.com.

Protegendo uma chave

Toda chave é uma credencial somente leitura: a API não pode gravar, excluir ou mover nada. Você pode bloquear uma chave para endereços de origem específicos em /settings/api-keys. Uma chave na lista de permissões é rejeitada com um 401 quando apresentada de qualquer outro endereço. A lista de permissões aceita endereços IPv4 e IPv6 exatos; deixe-a vazia para aceitar qualquer endereço. As chaves são exibidas por completo apenas uma vez na criação, podem ser revogadas a qualquer momento, e você pode manter até cinco chaves ativas por conta.

Webhooks

Assine eventos push em vez de fazer polling. Gerencie até cinco webhooks por conta em /settings/webhooks. Cada entrega é assinada para que você possa verificar que veio da Kresmion.

Evento	Dispara quando
signal.created	Um novo sinal entre ativos foi detectado.
whale.transfer	Uma grande transferência on-chain cruzou o limite de relatório.
prediction.repricing	Um mercado de previsão rastreado se moveu bruscamente.
prediction.divergence	Duas plataformas divergiram no mesmo contrato.
etf.flow	Um valor diário de fluxo líquido de ETF foi publicado.

{
  "id": "evt_01J8XM2QF3",
  "event": "whale.transfer",
  "created_at": "2026-07-16T14:03:22Z",
  "data": {
    "asset": "ETH",
    "amount_usd": 8250000,
    "direction": "to_exchange",
    "counterparty": "Binance",
    "chain": "ethereum"
  }
}

import hashlib
import hmac

def verify(secret: str, raw_body: bytes, signature: str) -> bool:
    expected = hmac.new(secret.encode(), raw_body, hashlib.sha256).hexdigest()
    return hmac.compare_digest(expected, signature)

# In your handler, read the raw request body and the signature header:
#   sig = request.headers["X-Kresmion-Signature"]
#   if not verify(WEBHOOK_SECRET, raw_body, sig):
#       return 401  # reject a forged payload

Dados em massa

Para backfills e pesquisa, baixe conjuntos de dados inteiros como CSV gzip, com intervalo por datas de início e fim. Transmita-os diretamente para um arquivo.

Conjunto de dados	Conteúdo
polymarket_history	Séries temporais de probabilidade e volume por mercado.
kalshi_history	Séries temporais de preço e volume por contrato.
resolutions	Resultados de mercados resolvidos com datas de liquidação.
whales	Transferências on-chain rotuladas acima do limite de relatório.
signals	Eventos de sinais entre ativos pontuados com atribuição de fonte.

curl -s "https://kresmion.com/api/v1/bulk/whales?from=2026-06-01&to=2026-06-30" \
  -H "Authorization: Bearer krm_your_key_here" \
  --output whales_2026_06.csv.gz

MCP para agentes de IA

Agentes de IA se conectam à Kresmion por meio do Model Context Protocol. O servidor hospedado expõe 35 ferramentas cobrindo mercados de previsão, fluxos on-chain, fluxos de ETF, derivativos, sinais de ações, participações 13F, IPOs e ofertas de ações, valor relativo entre pares, o regime macro, taxas de política dos bancos centrais, mercados monetários e o corredor do Fed, liquidez do Fed, a curva do Tesouro ao longo da história, histórico curado de séries FRED, o índice de surpresa econômica, o histórico publicado de sinais, compósitos de confluência entre famílias, divergência entre previsão e opções, pontuações de dinheiro inteligente por ticker e um feed delta para polling eficiente. Cada resposta de ferramenta carrega o mesmo envelope e carimbo de atualização da API HTTP, e as mesmas chave, cota e limites de taxa se aplicam.

Endpoint hospedado (HTTP transmissível), para Claude Desktop e outros clientes MCP:

{
  "mcpServers": {
    "kresmion": {
      "type": "http",
      "url": "https://kresmion.com/api/mcp",
      "headers": { "Authorization": "Bearer krm_your_key_here" }
    }
  }
}

Uma linha no Claude Code:

claude mcp add --transport http kresmion https://kresmion.com/api/mcp \
  --header "Authorization: Bearer krm_your_key_here"

Prefere executar localmente? Baixe o servidor stdio autônomo e defina sua chave no ambiente:

# download the standalone server, then register it over stdio
curl -sO https://kresmion.com/sdk/kresmion_mcp.py
pip install mcp httpx

{
  "mcpServers": {
    "kresmion": {
      "command": "python",
      "args": ["kresmion_mcp.py"],
      "env": { "KRESMION_API_KEY": "krm_your_key_here" }
    }
  }
}

A API é gratuita durante o beta. Ainda não há SLA de disponibilidade, e os números podem ficar defasados em relação às fontes upstream ou ser revisados. Leia a metodologia e ressalvas de dados antes de construir algo com um número. Apenas informativo, não é aconselhamento de investimento.