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. Settings → Plugins → Marketplace로 이동합니다.

3. "kalshi"를 검색합니다.

4. Install(설치)을 클릭합니다.

또는 이 저장소를 클론하여 로컬에 설치할 수도 있습니다:

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

3. 변수 구성

Cursor에서 Settings → Plugins → kalshi로 이동하여 다음을 설정합니다:

• KALSHI_ACCESS_KEY: Kalshi에서 발급한 API Key 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. 승인 후에만 주문을 체결합니다.

안전 기능

• 스킬 파일: 플러그인에는 에이전트가 거래 전에 반드시 읽어야 하는 스킬 파일이 포함되어 있습니다.

• 명시적 승인 필수: 사용자 확인 없이는 주문이 체결되지 않습니다.

• 가격 임의 지정 금지: 에이전트는 실제 호가창(오더북) 가격을 사용해야 합니다.

• 명확한 확인: 모든 거래 매개변수는 실행 전에 확인됩니다.

• 데모 모드: 데모 환경에서 가상 화폐로 안전하게 테스트할 수 있습니다.

데모 vs 프로덕션

데모 환경

• 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

Publisher to Cursor Marketplace

이 플러그인은 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 Reference

보안 참고 사항

• API 키나 프라이빗 키를 버전 관리(Git)에 커밋하지 마세요.

• 프라이빗 키는 안전한 위치에 보관하세요.

• 테스트 시 데모 환경을 사용하세요.

• 프라이빗 키는 복구할 수 없으므로, 생성 즉시 안전하게 저장하세요.

• 플러그인은 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으로 시장 상태를 확인합니다.

• 시장이 마감되었거나 정산되었을 수 있습니다.

License (라이선스)

MIT License — 자세한 내용은 LICENSE 파일을 참조하세요.

저자

Evan Parrott

기여

기여를 환영합니다! 언제든 자유롭게 Pull Request를 제출해 주세요.

고지 사항

이 플러그인은 비공식 플러그인입니다. 사용에 따른 책임은 본인에게 있습니다. 예측 시장 거래는 금전적 위험을 수반합니다. 거래하는 내용을 항상 충분히 이해하고, 감당할 수 있는 손실을 초과하는 거래를 하지 마십시오.

링크

• Kalshi 웹사이트

• Kalshi API 문서

• Cursor Marketplace

• 이슈 보고