Kalshi MCP

Servidor MCP auto-hospedado para negociação no mercado de previsão Kalshi via DFlow na Solana. 40 ferramentas para descoberta de mercado, gerenciamento de ordens, acompanhamento de posições e swaps Jupiter.

GitHub

Documentação

@quantish/kalshi-server

⚠️ Aviso: A Quantish está encerrando suas atividades. A plataforma Quantish (quantish.live) está sendo descontinuada. Este servidor MCP é auto-hospedado e continuará funcionando de forma independente, mas a equipe da Quantish não fará mais manutenção ou atualizações neste projeto. Se você está construindo no mercado de previsões e precisa de infraestrutura de dados em tempo real, confira polynode.dev.

Servidor MCP Kalshi auto-hospedado para negociação nos mercados da Kalshi via DFlow na Solana.

Visão Geral

Este pacote fornece um servidor MCP (Model Context Protocol) que permite que agentes de IA negociem nos mercados de previsão da Kalshi através do protocolo DFlow na Solana.

Recursos

Negociação Kalshi Completa - Compre/venda em qualquer mercado da Kalshi
Gerenciamento de Carteira Solana - Gere e gerencie carteiras Solana
Integração DFlow - Negocie via infraestrutura Solana da DFlow
Swaps Jupiter - Troque SOL/USDC via Jupiter Aggregator
Compatível com MCP - Funciona com Claude, Quantish Agent e qualquer cliente MCP
Auto-Hospedável - Execute no Railway, Fly.io ou qualquer hospedagem Node.js

Início Rápido

git clone https://github.com/joinQuantish/kalshi-mcp
cd kalshi-mcp
npm install

Variáveis de Ambiente

Variável	Obrigatória	Descrição
`DATABASE_URL`	Sim	String de conexão PostgreSQL
`ENCRYPTION_KEY`	Sim	String hexadecimal de 64 caracteres para criptografia da carteira
`DFLOW_API_KEY`	Não	Chave de API DFlow (opcional, para endpoints autenticados)
`JUPITER_API_KEY`	Não	Chave de API Jupiter de portal.jup.ag para ferramentas de swap
`SOLANA_RPC_URL`	Não	Endpoint RPC da Solana (padrão: mainnet)
`ADMIN_API_KEY`	Não	Chave de API de administrador para endpoints administrativos
`PORT`	Não	Porta do servidor (padrão: 3002)

Obtendo Chaves de API

Chave de API DFlow:

O acesso à DFlow pode exigir aprovação. Entre em contato com a equipe da DFlow em dflow.net para obter acesso à API.

Chave de API Jupiter:

Obtenha uma chave de API gratuita em portal.jup.ag (nível Basic, 1 RPS). Necessária para a funcionalidade de swap.

Usando os servidores públicos da Quantish? Os servidores públicos da Quantish não estão mais disponíveis, pois a plataforma está encerrando as atividades. Você deve auto-hospedar este servidor MCP para usá-lo. Siga as instruções de configuração acima para executar sua própria instância.

Gerar Chave de Criptografia

node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"

Configuração do Banco de Dados

Qualquer banco de dados PostgreSQL funciona. Opções:

Provedor	Notas
Railway	Adicione o serviço PostgreSQL, copie `DATABASE_URL` das variáveis
Supabase	Nível gratuito em supabase.com, copie a string de conexão em Configurações > Banco de Dados
Neon	Postgres sem servidor em neon.tech, nível gratuito disponível
Docker Local	`docker run -e POSTGRES_PASSWORD=pass -p 5432:5432 postgres`

Defina seu DATABASE_URL e execute:

# Generate Prisma client
npm run db:generate

# Create tables
npm run db:push

Ferramentas Disponíveis

Gerenciamento de Conta

kalshi_signup - Criar conta com carteira Solana
kalshi_request_api_key - Solicitar chave de API com código de acesso
kalshi_get_wallet_info - Obter endereço e tipo da carteira
kalshi_get_wallet_status - Status completo da carteira, incluindo saldos
kalshi_get_balances - Obter saldos de SOL e USDC
kalshi_get_deposit_address - Obter endereço para depósitos
kalshi_export_private_key - Exportar chave privada da carteira
kalshi_import_private_key - Importar carteira Solana existente

Descoberta de Mercados

kalshi_search_markets - Pesquisar mercados Kalshi por palavra-chave
kalshi_get_market - Obter detalhes do mercado por ticker
kalshi_get_event - Obter evento com todos os mercados aninhados
kalshi_get_events - Navegar por eventos com filtros
kalshi_get_live_data - Obter dados de preços em tempo real

Negociação

kalshi_get_quote - Obter cotação para negociação no mercado de previsão
kalshi_buy_yes - Comprar tokens de resultado YES
kalshi_buy_no - Comprar tokens de resultado NO
kalshi_sell_position - Vender tokens de resultado de volta para USDC
kalshi_get_positions - Visualizar posições atuais
kalshi_get_orders - Visualizar histórico de ordens

Swaps (SOL/USDC)

kalshi_get_swap_quote - Obter cotação de swap Jupiter
kalshi_execute_swap - Executar troca de tokens
kalshi_swap_sol_to_usdc - Trocar SOL por USDC
kalshi_swap_usdc_to_sol - Trocar USDC por SOL

Transferências

kalshi_send_sol - Enviar SOL para outra carteira
kalshi_send_usdc - Enviar USDC para outra carteira
kalshi_send_token - Enviar qualquer token SPL

Operações de Mercado

kalshi_check_market_initialization - Verificar se o mercado está tokenizado on-chain
kalshi_initialize_market - Inicializar mercado on-chain (paga taxa em SOL)
kalshi_check_redemption_status - Verificar se o mercado está liquidado
kalshi_get_market_by_mint - Consultar mercado pelo token mint

Resgate

kalshi_get_redeemable_positions - Encontrar posições prontas para reivindicação
kalshi_redeem_winnings - Resgatar posição vencedora específica
kalshi_redeem_all_positions - Resgatar todas as posições vencedoras de uma vez

Gerenciamento de Chaves de API

kalshi_list_api_keys - Listar suas chaves de API
kalshi_create_additional_api_key - Criar nova chave de API
kalshi_revoke_api_key - Revogar uma chave de API

Formato da API

O servidor expõe um endpoint JSON-RPC 2.0 em /mcp:

curl -X POST https://your-server.com/mcp \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
      "name": "kalshi_get_positions",
      "arguments": {}
    },
    "id": 1
  }'

Conectando ao Quantish Agent

Configure a CLI para usar seu servidor:

export KALSHI_MCP_URL=https://your-server.com/mcp
export KALSHI_API_KEY=your-api-key
quantish

Ou adicione ao ~/.quantish/config.json:

{
  "kalshiMcpUrl": "https://your-server.com/mcp",
  "kalshiApiKey": "your-api-key"
}

Desenvolvimento

# Install dependencies
npm install

# Generate Prisma client
npm run db:generate

# Run migrations
npm run db:push

# Start development server
npm run dev

Recursos

NPM: @quantish/kalshi-server
GitHub: joinQuantish/kalshi-mcp
Quantish Agent: @quantish/agent
Documentação DFlow: pond.dflow.net
Portal Jupiter: portal.jup.ag

Licença

Este projeto está licenciado sob a Licença Não Comercial PolyForm 1.0.0.

Gratuito para uso pessoal, pesquisa e fins não comerciais. O uso comercial requer permissão explícita da Quantish Inc. Entre em contato com hello@quantish.live para licenciamento comercial.

Desenvolvido por Quantish Inc.