Kalshi Prediction Markets Plugin for Cursor

Kalshiの予測市場APIに接続するCursorマーケットプレイス向けプラグインです。AIエージェントが市場の閲覧や、ユーザーの承認を得た取引の発注を行えるようにします。

機能

• 市場データの閲覧: 市場のブラウズ、価格の確認、オーダーブックの表示

• ポートフォリオ管理: 残高の確認とポジションの表示

• 注文の発注: 注文の発注とキャンセル（ユーザーの明示的な承認がある場合のみ）

• デモ・本番対応: デモ環境と本番環境の両方に対応

• 安全な認証: 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. 設定 → プラグイン → マーケットプレイス に移動します

3. "kalshi" を検索します

4. インストールをクリックします

または、このリポジトリをクローンしてローカルにインストールします：

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

3. 変数の設定

Cursorで、設定 → プラグイン → kalshi を開き、以下を設定します：

• KALSHI_ACCESS_KEY: KalshiのAPIキーID

• 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. 確認が取れた場合にのみ注文を発注します

セキュリティ機能

• スキルファイル: プラグインには、エージェントが取引前に必ず読む必要があるスキルファイルが含まれています

• 明示的な承認必須: ユーザーの確認なしに注文が発注されることはありません

• 価格推測の禁止: エージェントは実際のオーダーブック価格を使用する必要があります

• 明確な確認: すべての取引パラメータは実行前に確認されます

• デモモード: デモ環境で疑似残高と失敗気にすることなくテストできます

デモ環境と本番環境

デモ環境

• Base URL: https://external-api.demo.kalshi.co

• テスト用の疑似資金（フェイクマネー）を使用します

• 別のアカウントとAPIキーを使用します

• プラグインのテストに最適です

本番環境

• Base 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マーケットプレイスへの公開

このプラグインはCursorマーケットプレイスへ公開することを前提としています：

1. すべての要件を満たしていることを確認します：

   • 公開GitHubリポジトリ

   • 有効な .cursor-plugin/plugin.json

   • 有効な .cursor-plugin/mcp.json

   • skills/kalshi-trading/SKILL.md にあるスキルファイル

   • 正常に動作するMCPサーバー

   • リポジトリ内にシークレット（秘密情報）がないこと

2. https://cursor.com/marketplace/publish から提出します。

3. 以下を提供します：

   • リポジトリURL

   • プラグインの説明

   • 使用例

   • 特別なインストール手順（ある場合）

APIリファレンス

Kalshi APIの完全なドキュメントは以下を参照してください：

• 公式APIドキュメント

• はじめに

• APIリファレンス

セキュリティ上の注意

• APIキーや秘密鍵をバージョン管理にコミットしないでください

• 秘密鍵は安全に保管してください

• テストにはデモ環境を使用してください

• 秘密鍵は再取得できません。生成したらすぐに保存してください

• プラグインは認証にRSA-PSS SHA256署名を使用します

トラブルシューティング

"Failed to parse KALSHI_PRIVATE_KEY" エラー

秘密鍵がPEM形式であり、ヘッダーを含む完全なキーであることを確認してください：

-----BEGIN PRIVATE KEY-----
...
-----END PRIVATE KEY-----

"Unauthorized" エラー

• KALSHI_ACCESS_KEY が正しいことを確認してください

• KALSHI_PRIVATE_KEY が KALSHI_ACCESS_KEY に対応するキーであることを確認してください

• 正しいベースURL（デモか本番か）を使用していることを確認してください

"Market not found" エラー

• ティッカーシンボルが正しいことを確認してください

• kalshi_get_market で市場のステータスを確認してください

• 市場は終了または決済されている可能性があります

ライセンス

MIT ライセンス - 詳細は LICENSE ファイルを参照してください。

作者

Evan Parrott

コントリビューション

コントリビューション歓迎します！お気軽にプルクエストを送信してください。

免責事項

これは非公式のプラグインです。ご自身の責任で使用してください。予測市場での取引は経済的リスクを伴います。取引内容を常に理解し、失っても構わない金額を超えて取引しないでください。

リンク

• Kalshi Website

• Kalshi API ドキュメント

• Cursor Marketplace

• 問題を報告する