CryptoStruct
oficialServidor MCP remoto para dados históricos de criptomoedas e mercados de previsão: pesquise ~500K instrumentos, estatísticas de mercado ao vivo (OHLC, volume, spreads, profundidade, slippage) e compra de tick-data. Sem chave para catálogo e estatísticas; OAuth opcional para ferramentas de conta. Endpoint: https://cryptostruct.com/mcp
O que você pode fazer com CryptoStruct MCP?
Pesquise dados históricos de cripto e mercados de previsão, obtenha estatísticas ao vivo e compre arquivos de tick por meio do servidor MCP do CryptoStruct.
- Pesquise o catálogo de instrumentos — Use
search_instrumentspara encontrar ~500 mil instrumentos em 35 venues, incluindo Kalshi e Polymarket. - Obtenha snapshots de mercado ao vivo — Use
get_market_snapshotpara OHLC de 60 min e 24 h, VWAP, spreads e profundidade de topo de livro. - Busque agregados diários — Use
get_daily_statspara OHLC diário, volume e métricas (30–180 dias grátis). - Arquivos de dados de preço — Use
get_price_quotepara obter uma URL de checkout do Stripe para arquivos em nível de tick (€1 por instrumento-dia). - Liste arquivos de amostra grátis — Use
list_sample_filespara baixar amostras gratuitas de dia inteiro antes de comprar. - Verifique a cobertura do arquivo — Use
get_coveragepara ver a disponibilidade em nível de dia para qualquer instrumento desde 2021‑02‑08.
Documentação
CryptoStruct MCP Server
Servidor MCP remoto de primeira parte para cryptostruct.com — dados históricos de criptomoedas e mercados de previsão (arquivos diários de nível de tick de 35 venues, incluindo Kalshi e Polymarket) além de estatísticas de mercado ao vivo, construído para traders, quantitativos e agentes de IA.
Este repositório documenta o servidor hospedado. Não há nada para instalar ou executar a partir daqui — o servidor é operado pela CryptoStruct.
- Endpoint:
https://cryptostruct.com/mcp(Streamable HTTP, sem estado, modo JSON) - Endpoint OAuth:
https://cryptostruct.com/mcp/auth(mesmas ferramentas; responde401+WWW-Authenticatepara acionar o fluxo OAuth padrão — Dynamic Client Registration + PKCE) - Cartão do servidor:
/.well-known/mcp/server-card.json - Documentação: https://cryptostruct.com/docs/mcp · Documentação do produto: https://docs.cryptostruct.com
Sem necessidade de chave de API — o catálogo, as estatísticas de mercado e o fluxo de compra como convidado funcionam sem chave. Entrar via OAuth (opcional) vincula sua conta CryptoStruct para histórico de pedidos, downloads de arquivos comprados e resgate automático de créditos.
Início rápido
Claude Code
claude mcp add --transport http cryptostruct https://cryptostruct.com/mcp
# or, to enable account sign-in via OAuth:
claude mcp add --transport http cryptostruct https://cryptostruct.com/mcp/auth
Cursor / configuração JSON genérica
{
"mcpServers": {
"cryptostruct": {
"url": "https://cryptostruct.com/mcp"
}
}
}
claude.ai — Configurações → Conectores → Adicionar conector personalizado → https://cryptostruct.com/mcp/auth
O que você pode fazer
- Catálogo e descoberta: pesquise ~500 mil instrumentos em 35 venues (spot, perpétuos, futuros, opções, mercados de previsão), com cobertura de arquivo diário desde 2021-02-08.
- Mercados de previsão: os contratos de eventos da Kalshi e da Polymarket são instrumentos de primeira classe — pesquisáveis no catálogo (
class=prediction), com cobertura, snapshots ao vivo e agregados minuto/diário como qualquer instrumento cripto. Os contratos são cotados em 0..1 (USD); o volume é normalizado em USD. - Estatísticas de mercado: snapshots ao vivo e agregados minuto/hora/diário — OHLC, VWAP, negociações, volume, spreads, profundidade do topo do livro; curvas de slippage / impacto de mercado.
- Compra de dados: arquivos de tick brutos — tanto instrumentos cripto quanto de mercados de previsão — custam €1 por instrumento-dia. O servidor fornece uma URL de checkout Stripe — o pagamento sempre ocorre no navegador do usuário, o servidor nunca toca em credenciais de pagamento. Amostras gratuitas de dia completo estão disponíveis sem qualquer compra.
- Ferramentas de conta (login OAuth): liste pedidos, obtenha URLs de download para arquivos comprados, verifique assinatura e saldo de créditos. O checkout aplica créditos Premium automaticamente.
Ferramentas
| Ferramenta | Descrição | Nível |
|---|---|---|
get_data_dictionary | Dicionário de dados e referência do produto (formato de arquivo, unidades, preços) | gratuito |
search_instruments | Pesquisar o catálogo de instrumentos | gratuito |
list_venues | Listar venues cobertos | gratuito |
get_instrument | Detalhes do instrumento | gratuito |
get_coverage | Cobertura de arquivo diário para um instrumento | gratuito |
list_sample_files | Amostras gratuitas de dia completo | gratuito |
get_price_quote | Cotação de preço para um conjunto de arquivos de dados | gratuito |
get_market_snapshot | Snapshot de mercado ao vivo (60 min + 24 h) | gratuito |
get_daily_stats | Agregados diários (30d–180d gratuitos; 365d/máx Premium) | gratuito |
get_hourly_stats | Agregados horários (7d–90d gratuitos; 180d Premium) | gratuito |
get_slippage | Curva de slippage / impacto de mercado (1h gratuita; 24h/7d Premium) | gratuito |
get_top_instruments | Principais instrumentos por volume de 24 h ao vivo | gratuito |
get_movers | Movimentos de 24 h (altas e quedas) | gratuito |
get_minutes_range | Séries minuto históricas para estudos de eventos | premium |
create_checkout | Criar um checkout Stripe para arquivos de dados (entrega de URL) | commerce |
get_checkout_status | Consultar uma sessão de checkout | commerce |
get_order_files | Listar os arquivos de um pedido pago com URLs de download | commerce |
request_file_restore | Restaurar um arquivo arquivado (cold-storage) | commerce |
list_my_orders | Meus pedidos | sign-in |
get_my_files | Meus arquivos comprados | sign-in |
get_my_subscription | Minha assinatura e saldo de créditos | sign-in |
Níveis: free/commerce funcionam sem chave. sign-in requer login OAuth verificado (qualquer conta). premium ferramentas/parâmetros exigem CryptoStruct Premium (€20/mês) — que também desbloqueia janelas de estatísticas mais longas (diário 365d/máx, horário 180d, slippage 24h/7d), limites de pesquisa maiores, um bloco de qualidade de dados em get_market_snapshot, e um orçamento de chamadas 5×. Chamadas além do seu nível retornam erros estáticos AUTH_REQUIRED / PREMIUM_REQUIRED com uma URL de upgrade — nunca uma falha dura.
Limites de taxa
Orçamento ponderado por chamador: 120 unidades/min sem chave (por IP) ou por usuário conectado, 600 unidades/min para Premium. Leituras baratas do catálogo custam 1 unidade, estatísticas com alto uso upstream 3–5, checkout 10. Em erros RATE_LIMITED, aguarde o número de segundos indicado.
Convenções
- Todos os tamanhos de arquivo são bytes compactados (zstd); valores de mercado estão em USD; preços de venda estão em EUR.
- Dados de granularidade minuto são retidos ~30 dias upstream; agregados horários/diários alcançam mais longe.
- Arquivos de tick são capturas JSON-lines de dia completo (snapshots e atualizações do orderbook, negociações, liquidações, funding, mark/index incl. gregas de opções). Referência de formato: Market Data Protocol.
Relacionados
- Agent Skill para analisar os arquivos de tick:
cryptostruct-market-data(zip) - Índice de descoberta de skills:
/.well-known/agent-skills/index.json - Catálogo de API (RFC 9727):
/.well-known/api-catalog llms.txt: https://cryptostruct.com/llms.txt
Suporte
Perguntas ou problemas: https://cryptostruct.com/contact