Skip to main content
Glama
evan-thedev

kalshi

by evan-thedev

Kalshi Prediction Markets Plugin for Cursor

Плагин для маркетплейса Cursor, который подключается к API рынков предсказаний Kalshi и позволяет ИИ-агентам просматривать рынки и совершать сделки с одобрения пользователя.

Возможности

  • Чтение данных о рынках: просматривайте рынки, проверяйте цены и просматривайте книги заявок

  • Управление портфелем: проверяйте баланс и просматривайте позиции

  • Размещение заявок: размещайте и отменяйте заявки (только с явного одобрения пользователя)

  • Демо и продакшн: поддержка демо- и продакшн-среды

  • Безопасная аутентификация: аутентификация на основе подписей RSA-PSS

Related MCP server: Kalshi MCP Server

Установка

1. Создайте API-ключи

Перейдите на https://kalshi.com/account/profile и:

  1. Нажмите «Create New API Key»

  2. Сохраните свой Key ID (KALSHI_ACCESS_KEY)

  3. Загрузите и сохраните свой Private Key (KALSHI_PRIVATE_KEY) — получить его повторно уже не удастся!

Для тестирования вы также можете создать ключи в демо-среде по адресу https://demo.kalshi.com/account/profile.

2. Установите плагин

  1. Откройте Cursor

  2. Перейдите в Settings → Plugins → Marketplace

  3. Найдите «kalshi»

  4. Нажмите Install

Или склонируйте этот репозиторий и установите локально:

git clone https://github.com/evanparrott/kalshi

3. Настройте переменные

В 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"

Агент выполнит следующие действия:

  1. Покажет вам данные о рынке

  2. Отобразит текущую книгу заявок

  3. Запросит ваше явное подтверждение

  4. Только после этого разместит заявку

Меры безопасности

  • 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:

  1. Убедитесь, что выполнены все требования:

    • Публичный GitHub-репозиторий

    • Валидный .cursor-plugin/plugin.json

    • Валидный .cursor-plugin/mcp.json

    • Skill-файл по адресу skills/kalshi-trading/SKILL.md

    • Рабочий MCP-сервер

    • Отсутствие секретов в репозитории

  2. Подайте заявку по адресу: https://cursor.com/marketplace/publish

  3. Укажите:

    • 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.

Предупреждение

Это неофициальный плагин. Используйте его на свой страх и риск. Торговля на рынках предсказаний связана с финансовым риском. Всегда понимайте, чем вы торгуете, и никогда не торгуйте суммой, которую не можете позволить себе потерять.

Ссылки

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    Provides 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
    -
  • A
    license
    Not graded
    quality
    D
    maintenance
    Give Claude access to Kalshi prediction markets — browse live odds, analyze price history, and trade YES/NO contracts.
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    MCP 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
  • F
    license
    Not graded
    quality
    D
    maintenance
    Exposes Kalshi prediction market data as tools for Claude, enabling multi-agent research pipelines that analyze markets and produce confidence-rated trade signals.
    -