Communitygithub.com

Starchild-ai-agent/official-skills

Kalshi予測市場:政治、経済、スポーツ、天気などのバイナリーイベント契約を取引・閲覧します。

official-skills とは?

このスキルは、CFTC(米国先物取引委員会)規制下の予測市場取引所であるKalshi APIと対話するためのものです。現実世界のイベントに関するバイナリー(Yes/No)契約を、1~99セントの価格で取引できます。ユーザーは、市場の検索、イベントとシリーズのナビゲーション、注文の作成と管理、ポートフォリオの確認、そして特に政治やスポーツなどのシリーズベースのカテゴリを適切に階層構造(シリーズ→イベント→市場)で扱う方法を習得できます。このスキルは、Claude Code、Cursor、CodexなどのAIエージェント向けに設計されており、RSA鍵ペア認証を使用した安全なAPI呼び出しを行い、公開エンドポイントと認証済みエンドポイントの両方をサポートします。特にスポーツや選挙市場では、誤ったキーワード検索を避け、正しいAPIパスを通じて市場データを取得する方法を詳細に説明しています。

対応~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Starchild-ai-agent/official-skills/tree/HEAD/kalshi

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Kalshi API

CFTC規制下の最初の予測市場取引所と取引およびクエリを行います。現実世界のイベントに関するバイナリー(Yes/No)契約を、1~99セントの価格で提供します。

ベースURL: https://external-api.kalshi.com/trade-api/v2 デモURL: https://external-api.demo.kalshi.co/trade-api/v2

APIキーは https://kalshi.com/account/api-keys で取得できます(PremierまたはMarket Makerティアが必要です)

主要概念

階層構造: シリーズ > イベント > 市場

  • シリーズ — 定期的なイベントテンプレート(例:「毎月の雇用統計」、「週次の失業保険申請件数」)
  • イベント — シリーズ内の特定のインスタンス(例:「2026年5月の雇用統計」)
  • 市場 — イベント内の個別のバイナリー結果(例:「追加された雇用者数が20万人を超えるか?」)

バイナリー契約の価格設定

  • 価格はセント単位(1~99)で、暗黙の確率を示します
  • 65セントでのYes契約 = 市場が65%の確率を示唆
  • 価格XでのYes買い注文は、価格(100 - X)でのNo売り注文と同等 — オーダーブックはYes買い注文とNo買い注文のみを表示
  • 決済: Yesの場合は1.00ドル(100セント)支払われ、Noの場合は0ドル
  • すべての金額(残高、価格、決済額)はセント単位

ティッカー形式

  • シリーズ: KXBTC、KXJOBLESS、KXINX
  • イベント: KXBTC-25MAY30(シリーズ + 日付)
  • 市場: KXBTC-25MAY30-T100000(イベント + 閾値/結果)

スポーツゲームのティッカーは異なるパターンに従います: {SERIES}-{YYMONDD}{TEAM1}{TEAM2}-{TEAM}

  • 例: KXNHLGAME-25MAY12EDMORL-EDM(NHL、2025年5月12日、エドモントン vs オーランド、エドモントン勝利)
  • 各ゲームイベントには、相互に排他的な2つのYES市場があります — チームごとに1つ

重要: シリーズベースの市場ナビゲーション

スポーツ、選挙、またはシリーズベースのカテゴリには/markets?keyword=を使用しないでください。 これは実際のゲームレベルの市場ではなく、マルチゲームパーレイバンドルのみを表示します。「NHL」、「Fulham」、「Premier League」などの検索では、結果がゼロまたは無関係になります。

常に次のようにナビゲーションしてください: シリーズ → イベント → 市場。 ゲームレベルの市場はシリーズ/イベント階層の下にあり、/events?series_ticker=KXXXを介してアクセスする必要があります。また、/markets/{ticker}はゲーム市場に対して404を返す場合があります — 買い/売り価格は、イベントエンドポイントの応答(with_nested_markets=trueを指定した/events/{event_ticker})にのみ表示されます。

このパターンは、スポーツだけでなくすべてのシリーズベースのカテゴリに適用されます:

  • スポーツゲーム — NHL、NBA、NFL、MLB、EPLなど
  • 政治レース — 複数候補イベント内の個別候補市場
  • 企業固有の市場 — シリーズ内の収益、CEO交代
  • 定期的な経済データ — 雇用統計、失業保険申請件数、CPIなど

既知のスポーツシリーズティッカー:

スポーツシリーズティッカー例
NHLKXNHLGAMEKXNHLGAME-25MAY12EDMORL
NBAKXNBAGAMEKXNBAGAME-25MAY12BOSLAL
NFLKXNFLGAMEKXNFLGAME-25SEP07KCDET
MLBKXMLBGAMEKXMLBGAME-25MAY12NYYLAD
EPL (プレミアリーグ)KXEPLGAMEKXEPLGAME-25MAY12FULARS

スポーツの正しいワークフロー:

# 1. スポーツの開催中のゲームを一覧表示
curl -s "https://external-api.kalshi.com/trade-api/v2/events?series_ticker=KXNHLGAME&status=open&with_nested_markets=true"

# 2. 特定のゲームをリアルタイムの買い/売り価格とともに取得
curl -s "https://external-api.kalshi.com/trade-api/v2/events/KXNHLGAME-25MAY12EDMORL?with_nested_markets=true"

# 誤り — これは行わないでください:
# curl -s "https://external-api.kalshi.com/trade-api/v2/markets?keyword=NHL"  ← パーレイを返し、ゲームは返さない

呼び出し方法

KalshiはRSA鍵ペア署名認証を使用します。認証済みリクエストには3つのヘッダーが必要です:

ヘッダー値
KALSHI-ACCESS-KEYAPIキーID($KALSHI_ACCESS_KEY)
KALSHI-ACCESS-SIGNATUREtimestamp + method + pathのRSA-PSS署名
KALSHI-ACCESS-TIMESTAMPUnixタイムスタンプ(ミリ秒)

公開GETエンドポイント(市場、イベント、オーダーブック)は認証ヘッダーなしで呼び出すことができます。

# 公開エンドポイント — 認証不要
curl -s "https://external-api.kalshi.com/trade-api/v2/markets?limit=10&status=open"

認証済みエンドポイントには、直接RSA-PSS署名を使用します(kalshi_python SDKは使用しないでください — 機能しません):

import os, time, base64, requests
from cryptography.hazmat.primitives import hashes, serialization
from cryptography.hazmat.primitives.asymmetric import padding
from cryptography.hazmat.backends import default_backend
from dotenv import load_dotenv
load_dotenv('/data/workspace/.env')

BASE_URL = "https://api.elections.kalshi.com"

def kalshi_headers(method: str, path: str) -> dict:
    import re
    raw = os.environ["KALSHI_PRIVATE_KEY"]
    # 最初にリテラルエスケープシーケンスをデコード(一部の入力チャネルでは'\n'が
    # 実際の改行ではなく2文字のバックスラッシュ+nとして保存される)。
    raw = (raw.replace('\\r\\n', '\n').replace('\\n', '\n')
              .replace('\\r', '\n').replace('\\t', ' '))
    # PEMマーカーが存在する場合は削除し、すべての空白を削除して再ラップする。
    body = re.sub(r'-----BEGIN[^-]+-----', '', raw)
    body = re.sub(r'-----END[^-]+-----', '', body)
    body = re.sub(r'\s+', '', body)
    wrapped = '\n'.join(body[i:i+64] for i in range(0, len(body), 64))
    pem = f"-----BEGIN RSA PRIVATE KEY-----\n{wrapped}\n-----END RSA PRIVATE KEY-----\n"
    private_key = serialization.load_pem_private_key(pem.encode(), password=None, backend=default_backend())
    ts = str(int(time.time() * 1000))
    msg = (ts + method + path).encode()  # パスにクエリ文字列を含めてはいけない
    sig = private_key.sign(msg, padding.PSS(mgf=padding.MGF1(hashes.SHA256()), salt_length=padding.PSS.DIGEST_LENGTH), hashes.SHA256())
    return {
        "KALSHI-ACCESS-KEY": os.environ["KALSHI_ACCESS_KEY"].strip(),
        "KALSHI-ACCESS-TIMESTAMP": ts,
        "KALSHI-ACCESS-SIGNATURE": base64.b64encode(sig).decode(),
        "Content-Type": "application/json"
    }

path = "/trade-api/v2/portfolio/balance"
resp = requests.get(BASE_URL + path, headers=kalshi_headers("GET", path))
print(resp.json())  # {"balance": 5000, ...} — 残高はセント単位

署名の注意点:

  • PSS、PKCS1v15ではない — PKCS1v15パディングは401を返します。SHA256でPSSを使用する必要があります。
  • 署名前にクエリ文字列を削除する — 署名はベアパス(例: /trade-api/v2/portfolio/balance)でのみ計算され、/trade-api/v2/portfolio/balance?param=valueでは計算されません。クエリ文字列を含めると401になります。
  • キー環境変数の形式 — KALSHI_PRIVATE_KEYは次のいずれかを受け入れます: raw base64本文、実際の改行を含む完全なPEM、または空白に圧縮された改行を含む完全なPEM(Webフォームに貼り付ける際によく見られます)。ヘルパー関数はすべての形式を自動的に正規化します。最も堅牢な保存方法としては、.env内で\nエスケープを使用した二重引用符で囲まれた複数行PEMとして保存し、python-dotenvがそれを実際のPEM文字列に復元するようにします。

API仕様

完全なOpenAPI仕様: https://docs.kalshi.com/openapi.yaml

意図ルーティング

ユーザーの意図を正しいエンドポイントにマッピングします。すべてのパスはベースURLからの相対パスです。

イベント

メソッドエンドポイント主要パラメータ説明
GET/eventslimit (1-200), cursor, status, series_ticker, with_nested_marketsイベント一覧(多変量を除く)
GET/events/{event_ticker}event_ticker, with_nested_markets特定のイベントを取得
GET/events/{event_ticker}/metadataevent_tickerイベントメタデータのみ
GET/events/multivariatelimit, cursor, series_ticker, collection_ticker, with_nested_markets多変量(コンボ)イベント一覧

市場

メソッドエンドポイント主要パラメータ説明
GET/marketslimit, cursor, status, ticker, event_ticker, series_ticker, min_close_ts, max_close_ts市場の一覧/フィルタリング
GET/markets/{ticker}ticker特定の市場詳細を取得
GET/markets/{ticker}/orderbookticker, depth現在のオーダーブック(Yes買い注文 + No買い注文)
GET/markets/orderbookstickers (配列、最大100)バッチオーダーブック
GET/markets/tradesticker, limit, cursor, min_ts, max_ts市場全体の取引

ローソク足

メソッドエンドポイント主要パラメータ説明
GET/series/{series_ticker}/markets/{ticker}/candlesticksseries_ticker, ticker, start_ts, end_ts, period_interval市場レベルのローソク足
GET/series/{series_ticker}/events/{ticker}/candlesticksseries_ticker, ticker, start_ts, end_ts, period_interval集計イベントレベルのローソク足
GET/markets/candlesticksmarket_tickers, start_ts, end_ts, period_intervalバッチローソク足

period_intervalの値: 1 (1分), 60 (1時間), 1440 (1日)

予測とライブデータ

メソッドエンドポイント主要パラメータ説明
GET/series/{series_ticker}/events/{ticker}/forecast_percentile_historypercentiles (0-10000), start_ts, end_ts, period_interval過去の予測パーセンタイル
GET/live_data/milestone/{milestone_id}milestone_id, include_player_statsライブマイルストーンデータ
GET/live_data/batchmilestone_ids (配列、最大100), include_player_statsバッチライブデータ
GET/live_data/game-stats/{milestone_id}milestone_idプレイバイプレイ統計(フットボール、バスケットボール、サッカー、ホッケー、野球)

シリーズ

メソッドエンドポイント主要パラメータ説明
GET/series/{series_ticker}series_ticker, include_volumeシリーズテンプレートを取得
GET/seriescategory, tags, include_volume, min_updated_tsすべてのシリーズを一覧表示

取引所情報

メソッドエンドポイント主要パラメータ説明
GET/exchange/status—現在の取引所ステータス
GET/exchange/schedule—営業時間
GET/exchange/announcements—プラットフォームのお知らせ
GET/exchange/user_data_timestamp—データ同期タイムスタンプ
GET/series/fee_changesseries_ticker, show_historical手数料変更履歴

検索と発見

メソッドエンドポイント主要パラメータ説明
GET/search/tags_by_categories—シリーズカテゴリ別に整理されたタグ
GET/search/filters_by_sport—スポーツ別に整理されたフィルター

注文(認証済み)

メソッドエンドポイント主要パラメータ説明
GET/portfolio/ordersticker, event_ticker, status, limit, cursor, subaccountユーザーの注文を一覧表示
GET/portfolio/orders/{order_id}order_id特定の注文を取得
POST/portfolio/ordersBody: ticker, action, side, type, count, yes_price/no_price注文を作成
DELETE/portfolio/orders/{order_id}order_id, subaccount注文をキャンセル
POST/portfolio/orders/{order_id}/amendorder_id, Body: 新しい count/price注文を修正
POST/portfolio/orders/{order_id}/decreaseorder_id, Body: 削減量注文数を減らす
POST/portfolio/orders/batchedBody: 注文の配列バッチ作成(最大サイズはティアに応じて変動)
DELETE/portfolio/orders/batchedBody: 注文IDの配列バッチキャンセル
GET/portfolio/orders/queue_positionsmarket_tickers, event_ticker, subaccountすべてのレスト注文のキュー位置
GET/portfolio/orders/{order_id}/queue_positionorder_id特定の注文のキュー位置

注文 V2 — イベント市場注文(認証済み、固定小数点)

メソッドエンドポイント主要パラメータ説明
POST/portfolio/events/ordersBody: イベントティッカー、市場サイド、価格(固定小数点)、カウントV2注文を作成
POST/portfolio/events/orders/batchedBody: V2注文の配列バッチV2作成
DELETE/portfolio/events/orders/{order_id}order_id, subaccountV2注文をキャンセル
DELETE/portfolio/events/orders/batchedBody: 注文IDの配列バッチV2キャンセル
POST/portfolio/events/orders/{order_id}/amendorder_id, Body: 新しいカウント/価格V2注文を修正
POST/portfolio/events/orders/{order_id}/decreaseorder_id, Body: 新しい残りカウントV2注文を減らす

注文グループ(認証済み)

メソッドエンドポイント主要パラメータ説明
GET/portfolio/order_groupssubaccountすべての注文グループを一覧表示
POST/portfolio/order_groups/createBody: 契約制限注文グループを作成
GET/portfolio/order_groups/{id}id, subaccount特定のグループを取得
DELETE/portfolio/order_groups/{id}id, subaccountグループを削除し、すべての注文をキャンセル
PUT/portfolio/order_groups/{id}/limitid, Body: 新しい制限契約制限を更新
PUT/portfolio/order_groups/{id}/triggerid, subaccountグループをトリガー(すべての注文をキャンセル)
PUT/portfolio/order_groups/{id}/resetid, subaccountマッチした契約カウンターをリセット

ポートフォリオ(認証済み)

メソッドエンドポイント主要パラメータ説明
GET/portfolio/balancesubaccount残高とポートフォリオ価値(セント単位)
GET/portfolio/positionscursor, limit, count_filter, ticker, event_ticker, subaccountユーザーのポジション
GET/portfolio/fillsticker, order_id, min_ts, max_ts, limit, cursor, subaccountすべての取引約定
GET/portfolio/settlementslimit, cursor, ticker, event_ticker, min_ts, max_ts, subaccount決済履歴
GET/portfolio/depositslimit, cursor入金履歴
GET/portfolio/withdrawalslimit, cursor出金履歴
GET/portfolio/summary/total_resting_order_value—総レスト注文額

Individual skills in this repo

This repo contains 5 individual skills — each has its own dedicated page.

関連スキル