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

• Начало работы

• Справочник API

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

• Никогда не коммитьте свои 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.

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

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

Ссылки

• Веб-сайт Kalshi

• Документация Kalshi API

• Cursor Marketplace

• Сообщить о проблемах