Kalshi MCP

Servidor MCP autoalojado para operar en el mercado de predicciones de Kalshi a través de DFlow en Solana. 40 herramientas para descubrimiento de mercados, gestión de órdenes, seguimiento de posiciones y swaps de Jupiter.

GitHub

Documentación

@quantish/kalshi-server

⚠️ Aviso: Quantish está cerrando. La plataforma Quantish (quantish.live) está cesando operaciones. Este servidor MCP es autoalojado y seguirá funcionando de forma independiente, pero el equipo de Quantish ya no mantendrá ni actualizará este proyecto. Si estás construyendo en el espacio de mercados de predicción y necesitas infraestructura de datos en tiempo real, consulta polynode.dev.

Servidor MCP de Kalshi autoalojado para operar en los mercados de Kalshi a través de DFlow en Solana.

Descripción general

Este paquete proporciona un servidor MCP (Protocolo de Contexto de Modelos) que permite a los agentes de IA operar en los mercados de predicción de Kalshi a través del protocolo DFlow en Solana.

Características

Operaciones completas en Kalshi - Compra/venta en cualquier mercado de Kalshi
Gestión de billeteras Solana - Genera y gestiona billeteras Solana
Integración con DFlow - Opera a través de la infraestructura Solana de DFlow
Intercambios Jupiter - Intercambia SOL/USDC mediante Jupiter Aggregator
Compatible con MCP - Funciona con Claude, Quantish Agent y cualquier cliente MCP
Autoalojable - Ejecútalo en Railway, Fly.io o cualquier host Node.js

Inicio rápido

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

Variables de entorno

Variable	Requerida	Descripción
`DATABASE_URL`	Sí	Cadena de conexión de PostgreSQL
`ENCRYPTION_KEY`	Sí	Cadena hexadecimal de 64 caracteres para el cifrado de billeteras
`DFLOW_API_KEY`	No	Clave API de DFlow (opcional, para endpoints autenticados)
`JUPITER_API_KEY`	No	Clave API de Jupiter de portal.jup.ag para herramientas de intercambio
`SOLANA_RPC_URL`	No	Endpoint RPC de Solana (por defecto usa mainnet)
`ADMIN_API_KEY`	No	Clave API de administrador para endpoints administrativos
`PORT`	No	Puerto del servidor (por defecto 3002)

Obtención de claves API

Clave API de DFlow:

El acceso a DFlow puede requerir aprobación. Contacta al equipo de DFlow en dflow.net para obtener acceso a la API.

Clave API de Jupiter:

Obtén una clave API gratuita en portal.jup.ag (nivel Básico, 1 RPS). Requerida para la funcionalidad de intercambio.

¿Usas los servidores públicos de Quantish? Los servidores públicos de Quantish ya no están disponibles porque la plataforma está cerrando. Debes autoalojar este servidor MCP para usarlo. Sigue las instrucciones de configuración anteriores para ejecutar tu propia instancia.

Generar clave de cifrado

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

Configuración de la base de datos

Cualquier base de datos PostgreSQL funciona. Opciones:

Proveedor	Notas
Railway	Agrega un servicio PostgreSQL, copia `DATABASE_URL` desde las variables
Supabase	Nivel gratuito en supabase.com, copia la cadena de conexión desde Configuración > Base de datos
Neon	Postgres sin servidor en neon.tech, nivel gratuito disponible
Docker local	`docker run -e POSTGRES_PASSWORD=pass -p 5432:5432 postgres`

Configura tu DATABASE_URL y luego ejecuta:

# Generate Prisma client
npm run db:generate

# Create tables
npm run db:push

Herramientas disponibles

Gestión de cuentas

kalshi_signup - Crea una cuenta con billetera Solana
kalshi_request_api_key - Solicita una clave API con código de acceso
kalshi_get_wallet_info - Obtén la dirección y el tipo de billetera
kalshi_get_wallet_status - Estado completo de la billetera, incluidos los saldos
kalshi_get_balances - Obtén los saldos de SOL y USDC
kalshi_get_deposit_address - Obtén la dirección para depósitos
kalshi_export_private_key - Exporta la clave privada de la billetera
kalshi_import_private_key - Importa una billetera Solana existente

Descubrimiento de mercados

kalshi_search_markets - Busca mercados de Kalshi por palabra clave
kalshi_get_market - Obtén detalles del mercado por ticker
kalshi_get_event - Obtén el evento con todos los mercados anidados
kalshi_get_events - Explora eventos con filtros
kalshi_get_live_data - Obtén datos de precios en vivo

Operaciones

kalshi_get_quote - Obtén cotización para operaciones en mercados de predicción
kalshi_buy_yes - Compra tokens de resultado SÍ
kalshi_buy_no - Compra tokens de resultado NO
kalshi_sell_position - Vende tokens de resultado de vuelta a USDC
kalshi_get_positions - Consulta posiciones actuales
kalshi_get_orders - Consulta historial de órdenes

Intercambios (SOL/USDC)

kalshi_get_swap_quote - Obtén cotización de intercambio de Jupiter
kalshi_execute_swap - Ejecuta intercambio de tokens
kalshi_swap_sol_to_usdc - Intercambia SOL a USDC
kalshi_swap_usdc_to_sol - Intercambia USDC a SOL

Transferencias

kalshi_send_sol - Envía SOL a otra billetera
kalshi_send_usdc - Envía USDC a otra billetera
kalshi_send_token - Envía cualquier token SPL

Operaciones de mercado

kalshi_check_market_initialization - Verifica si el mercado está tokenizado en cadena
kalshi_initialize_market - Inicializa el mercado en cadena (paga tarifa en SOL)
kalshi_check_redemption_status - Verifica si el mercado está liquidado
kalshi_get_market_by_mint - Busca mercado por token mint

Canje

kalshi_get_redeemable_positions - Encuentra posiciones listas para reclamar
kalshi_redeem_winnings - Canjea una posición ganadora específica
kalshi_redeem_all_positions - Canjea todas las posiciones ganadoras a la vez

Gestión de claves API

kalshi_list_api_keys - Lista tus claves API
kalshi_create_additional_api_key - Crea una nueva clave API
kalshi_revoke_api_key - Revoca una clave API

Formato de API

El servidor expone un endpoint JSON-RPC 2.0 en /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
  }'

Conexión con Quantish Agent

Configura la CLI para usar tu servidor:

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

O agrégalo a ~/.quantish/config.json:

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

Desarrollo

# 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
Documentación de DFlow: pond.dflow.net
Portal de Jupiter: portal.jup.ag

Licencia

Este proyecto está licenciado bajo la Licencia No Comercial PolyForm 1.0.0.

Gratuito para uso personal, investigación y fines no comerciales. El uso comercial requiere permiso explícito de Quantish Inc. Contacta a hello@quantish.live para licencias comerciales.

Creado por Quantish Inc.