kalshi
Kalshi Prediction Markets Plugin for Cursor
Плагин для маркетплейса Cursor, который подключается к API рынков предсказаний Kalshi и позволяет ИИ-агентам просматривать рынки и совершать сделки с одобрения пользователя.
Возможности
Чтение данных о рынках: просматривайте рынки, проверяйте цены и просматривайте книги заявок
Управление портфелем: проверяйте баланс и просматривайте позиции
Размещение заявок: размещайте и отменяйте заявки (только с явного одобрения пользователя)
Демо и продакшн: поддержка демо- и продакшн-среды
Безопасная аутентификация: аутентификация на основе подписей RSA-PSS
Related MCP server: Kalshi MCP Server
Установка
1. Создайте API-ключи
Перейдите на https://kalshi.com/account/profile и:
Нажмите «Create New API Key»
Сохраните свой Key ID (KALSHI_ACCESS_KEY)
Загрузите и сохраните свой Private Key (KALSHI_PRIVATE_KEY) — получить его повторно уже не удастся!
Для тестирования вы также можете создать ключи в демо-среде по адресу https://demo.kalshi.com/account/profile.
2. Установите плагин
Откройте Cursor
Перейдите в Settings → Plugins → Marketplace
Найдите «kalshi»
Нажмите Install
Или склонируйте этот репозиторий и установите локально:
git clone https://github.com/evanparrott/kalshi3. Настройте переменные
В Cursor перейдите в Settings → Plugins → «kalshi» и задайте:
KALSHI_ACCESS_KEY: ваш Key ID от Kalshi
KALSHI_PRIVATE_KEY: ваш RSA-приватный ключ (полное содержимое PEM-файла)
KALSHI_BASE_URL (необязательно):
Продакшн:
https://external-api.kalshi.com(по умолчанию)Демо:
https://external-api.demo.kalshi.co
Доступные инструменты
Инструменты только для чтения (безопасные)
kalshi_get_balance— проверка баланса и стоимости портфеляkalshi_list_markets— просмотр доступных рынков предсказанийkalshi_get_market— получение информации о конкретном рынкеkalshi_get_orderbook— просмотр текущей книги заявок с ценамиkalshi_get_positions— просмотр ваших текущих позицийkalshi_list_orders— просмотр ваших текущих заявок
Инструменты записи (требуют одобрения пользователя)
kalshi_create_order— размещение новой заявкиkalshi_cancel_order— отмена существующей заявки
Примеры использования
Просмотр рынков
"What prediction markets are available on Kalshi?"Проверка баланса
"What's my Kalshi account balance?"Получение информации о рынке
"Show me details about the market HIGHNY-24JAN01-T60"Размещение заявки (требуется подтверждение)
"Buy 10 YES contracts on HIGHNY-24JAN01-T60 at 56 cents"Агент выполнит следующие действия:
Покажет вам данные о рынке
Отобразит текущую книгу заявок
Запросит ваше явное подтверждение
Только после этого разместит заявку
Меры безопасности
Skill-файл: в плагин включён skill-файл, который агенты должны прочитать перед началом торговли
Обязательное явное одобрение: заявки никогда не размещаются без подтверждения пользователя
Без угадывания цен: агенты должны использовать реальные цены из книги заявок
Понятные подтверждения: все параметры сделки подтверждаются перед исполнением
Демо-режим: безопасное тестирование на виртуальные деньги в демо-среде
Демо и продакшн
Демо-среда
Базовый URL:
https://external-api.demo.kalshi.coИспользует виртуальные деньги для тестирования
Отдельный аккаунт и отдельные API-ключи
Отлично подходит для тестирования плагина
Продакшн-среда
Базовый URL:
https://external-api.kalshi.comИспользует реальные деньги
Используется по умолчанию, если не задан KALSHI_BASE_URL
Всегда сначала тестируйте в демо-режиме!
Разработка
Предварительные требования
Node.js 18 или выше
npm
Локальная разработка
# Clone the repository
git clone https://github.com/evanparrott/kalshi
cd kalshi
# Install dependencies
npm install
# Set environment variables
export KALSHI_ACCESS_KEY="your-key-id"
export KALSHI_PRIVATE_KEY="$(cat path/to/your/private-key.pem)"
export KALSHI_BASE_URL="https://external-api.demo.kalshi.co"
# Run the server
npm startТестирование
MCP-сервер работает через stdio. Вы можете протестировать его с помощью MCP Inspector или интегрировать напрямую в Cursor.
Публикация в Cursor Marketplace
Этот плагин предназначен для публикации в Cursor Marketplace:
Убедитесь, что выполнены все требования:
Публичный GitHub-репозиторий
Валидный
.cursor-plugin/plugin.jsonВалидный
.cursor-plugin/mcp.jsonSkill-файл по адресу
skills/kalshi-trading/SKILL.mdРабочий MCP-сервер
Отсутствие секретов в репозитории
Подайте заявку по адресу: https://cursor.com/marketplace/publish
Укажите:
URL репозитория
Описание плагина
Примеры использования
Особые примечания по установке
Справочник API
Полная документация по API Kalshi:
Меры безопасности
Никогда не коммитьте свои API-ключи и приватные ключи в систему контроля версий
Храните приватные ключи в надежном месте
Используйте демо-среду для тестирования
Приватные ключи невозможно восстановить — сохраняйте их сразу после генерации
Плагин использует подписи RSA-PSS SHA256 для аутентификации
Устранение неисправностей
«Не удалось разобрать KALSHI_PRIVATE_KEY»
Убедитесь, что ваш приватный ключ находится в формате PEM и содержит полный ключ с заголовками:
-----BEGIN PRIVATE KEY-----
...
-----END PRIVATE KEY-----Ошибки «Unauthorized»
Проверьте правильность значения KALSHI_ACCESS_KEY
Убедитесь, что KALSHI_PRIVATE_KEY соответствует ключу для вашего KALSHI_ACCESS_KEY
Проверьте, что вы используете правильный базовый URL (демо или продакшн)
Ошибка «Рынок не найден»
Проверьте правильность тикера
Проверьте статус рынка с помощью
kalshi_get_marketРынок может быть закрыт или по нему уже произведён расчёт
Лицензия
Лицензия MIT — подробности в файле LICENSE.
Автор
Evan Parrott
Вклад в разработку
Приветствуются любые вклады! Отправляйте Pull Request.
Предупреждение
Это неофициальный плагин. Используйте его на свой страх и риск. Торговля на рынках предсказаний связана с финансовым риском. Всегда понимайте, чем вы торгуете, и никогда не торгуйте суммой, которую не можете позволить себе потерять.
Ссылки
This server cannot be deployed
Maintenance
Related MCP Connectors
Calibrated world model for AI agents. 40 tools: world state, markets, trading. Kalshi + Polymarket.
Kalshi MCP — US-regulated prediction-market data (no auth on public reads).
Hosted MCP for Kalshi prediction markets: search, odds, order books, settlement rules, and trading.
- Trade ItOAuthapp.tradeit
Connect brokerage accounts to AI assistants: holdings, orders, asset lookup, and approved trading.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides access to Kalshi prediction market data with 23 tools for querying events, markets, trades, forecasts, candlesticks, and live data from the CFTC-regulated exchange for trading on real-world events.7-
- AlicenseNot gradedqualityDmaintenanceGive Claude access to Kalshi prediction markets — browse live odds, analyze price history, and trade YES/NO contracts.MIT
- AlicenseNot gradedqualityCmaintenanceMCP server that exposes Kalshi prediction markets as tools for AI agents, enabling conversational trading with safety features like demo mode, preview-before-place, and hard caps.MIT
- FlicenseNot gradedqualityDmaintenanceExposes Kalshi prediction market data as tools for Claude, enabling multi-agent research pipelines that analyze markets and produce confidence-rated trade signals.-