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など
既知のスポーツシリーズティッカー:
| スポーツ | シリーズティッカー | 例 |
|---|---|---|
| NHL | KXNHLGAME | KXNHLGAME-25MAY12EDMORL |
| NBA | KXNBAGAME | KXNBAGAME-25MAY12BOSLAL |
| NFL | KXNFLGAME | KXNFLGAME-25SEP07KCDET |
| MLB | KXMLBGAME | KXMLBGAME-25MAY12NYYLAD |
| EPL (プレミアリーグ) | KXEPLGAME | KXEPLGAME-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-KEY | APIキーID($KALSHI_ACCESS_KEY) |
KALSHI-ACCESS-SIGNATURE | timestamp + method + pathのRSA-PSS署名 |
KALSHI-ACCESS-TIMESTAMP | Unixタイムスタンプ(ミリ秒) |
公開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 | /events | limit (1-200), cursor, status, series_ticker, with_nested_markets | イベント一覧(多変量を除く) |
| GET | /events/{event_ticker} | event_ticker, with_nested_markets | 特定のイベントを取得 |
| GET | /events/{event_ticker}/metadata | event_ticker | イベントメタデータのみ |
| GET | /events/multivariate | limit, cursor, series_ticker, collection_ticker, with_nested_markets | 多変量(コンボ)イベント一覧 |
市場
| メソッド | エンドポイント | 主要パラメータ | 説明 |
|---|---|---|---|
| GET | /markets | limit, cursor, status, ticker, event_ticker, series_ticker, min_close_ts, max_close_ts | 市場の一覧/フィルタリング |
| GET | /markets/{ticker} | ticker | 特定の市場詳細を取得 |
| GET | /markets/{ticker}/orderbook | ticker, depth | 現在のオーダーブック(Yes買い注文 + No買い注文) |
| GET | /markets/orderbooks | tickers (配列、最大100) | バッチオーダーブック |
| GET | /markets/trades | ticker, limit, cursor, min_ts, max_ts | 市場全体の取引 |
ローソク足
| メソッド | エンドポイント | 主要パラメータ | 説明 |
|---|---|---|---|
| GET | /series/{series_ticker}/markets/{ticker}/candlesticks | series_ticker, ticker, start_ts, end_ts, period_interval | 市場レベルのローソク足 |
| GET | /series/{series_ticker}/events/{ticker}/candlesticks | series_ticker, ticker, start_ts, end_ts, period_interval | 集計イベントレベルのローソク足 |
| GET | /markets/candlesticks | market_tickers, start_ts, end_ts, period_interval | バッチローソク足 |
period_intervalの値: 1 (1分), 60 (1時間), 1440 (1日)
予測とライブデータ
| メソッド | エンドポイント | 主要パラメータ | 説明 |
|---|---|---|---|
| GET | /series/{series_ticker}/events/{ticker}/forecast_percentile_history | percentiles (0-10000), start_ts, end_ts, period_interval | 過去の予測パーセンタイル |
| GET | /live_data/milestone/{milestone_id} | milestone_id, include_player_stats | ライブマイルストーンデータ |
| GET | /live_data/batch | milestone_ids (配列、最大100), include_player_stats | バッチライブデータ |
| GET | /live_data/game-stats/{milestone_id} | milestone_id | プレイバイプレイ統計(フットボール、バスケットボール、サッカー、ホッケー、野球) |
シリーズ
| メソッド | エンドポイント | 主要パラメータ | 説明 |
|---|---|---|---|
| GET | /series/{series_ticker} | series_ticker, include_volume | シリーズテンプレートを取得 |
| GET | /series | category, tags, include_volume, min_updated_ts | すべてのシリーズを一覧表示 |
取引所情報
| メソッド | エンドポイント | 主要パラメータ | 説明 |
|---|---|---|---|
| GET | /exchange/status | — | 現在の取引所ステータス |
| GET | /exchange/schedule | — | 営業時間 |
| GET | /exchange/announcements | — | プラットフォームのお知らせ |
| GET | /exchange/user_data_timestamp | — | データ同期タイムスタンプ |
| GET | /series/fee_changes | series_ticker, show_historical | 手数料変更履歴 |
検索と発見
| メソッド | エンドポイント | 主要パラメータ | 説明 |
|---|---|---|---|
| GET | /search/tags_by_categories | — | シリーズカテゴリ別に整理されたタグ |
| GET | /search/filters_by_sport | — | スポーツ別に整理されたフィルター |
注文(認証済み)
| メソッド | エンドポイント | 主要パラメータ | 説明 |
|---|---|---|---|
| GET | /portfolio/orders | ticker, event_ticker, status, limit, cursor, subaccount | ユーザーの注文を一覧表示 |
| GET | /portfolio/orders/{order_id} | order_id | 特定の注文を取得 |
| POST | /portfolio/orders | Body: ticker, action, side, type, count, yes_price/no_price | 注文を作成 |
| DELETE | /portfolio/orders/{order_id} | order_id, subaccount | 注文をキャンセル |
| POST | /portfolio/orders/{order_id}/amend | order_id, Body: 新しい count/price | 注文を修正 |
| POST | /portfolio/orders/{order_id}/decrease | order_id, Body: 削減量 | 注文数を減らす |
| POST | /portfolio/orders/batched | Body: 注文の配列 | バッチ作成(最大サイズはティアに応じて変動) |
| DELETE | /portfolio/orders/batched | Body: 注文IDの配列 | バッチキャンセル |
| GET | /portfolio/orders/queue_positions | market_tickers, event_ticker, subaccount | すべてのレスト注文のキュー位置 |
| GET | /portfolio/orders/{order_id}/queue_position | order_id | 特定の注文のキュー位置 |
注文 V2 — イベント市場注文(認証済み、固定小数点)
| メソッド | エンドポイント | 主要パラメータ | 説明 |
|---|---|---|---|
| POST | /portfolio/events/orders | Body: イベントティッカー、市場サイド、価格(固定小数点)、カウント | V2注文を作成 |
| POST | /portfolio/events/orders/batched | Body: V2注文の配列 | バッチV2作成 |
| DELETE | /portfolio/events/orders/{order_id} | order_id, subaccount | V2注文をキャンセル |
| DELETE | /portfolio/events/orders/batched | Body: 注文IDの配列 | バッチV2キャンセル |
| POST | /portfolio/events/orders/{order_id}/amend | order_id, Body: 新しいカウント/価格 | V2注文を修正 |
| POST | /portfolio/events/orders/{order_id}/decrease | order_id, Body: 新しい残りカウント | V2注文を減らす |
注文グループ(認証済み)
| メソッド | エンドポイント | 主要パラメータ | 説明 |
|---|---|---|---|
| GET | /portfolio/order_groups | subaccount | すべての注文グループを一覧表示 |
| POST | /portfolio/order_groups/create | Body: 契約制限 | 注文グループを作成 |
| GET | /portfolio/order_groups/{id} | id, subaccount | 特定のグループを取得 |
| DELETE | /portfolio/order_groups/{id} | id, subaccount | グループを削除し、すべての注文をキャンセル |
| PUT | /portfolio/order_groups/{id}/limit | id, Body: 新しい制限 | 契約制限を更新 |
| PUT | /portfolio/order_groups/{id}/trigger | id, subaccount | グループをトリガー(すべての注文をキャンセル) |
| PUT | /portfolio/order_groups/{id}/reset | id, subaccount | マッチした契約カウンターをリセット |
ポートフォリオ(認証済み)
| メソッド | エンドポイント | 主要パラメータ | 説明 |
|---|---|---|---|
| GET | /portfolio/balance | subaccount | 残高とポートフォリオ価値(セント単位) |
| GET | /portfolio/positions | cursor, limit, count_filter, ticker, event_ticker, subaccount | ユーザーのポジション |
| GET | /portfolio/fills | ticker, order_id, min_ts, max_ts, limit, cursor, subaccount | すべての取引約定 |
| GET | /portfolio/settlements | limit, cursor, ticker, event_ticker, min_ts, max_ts, subaccount | 決済履歴 |
| GET | /portfolio/deposits | limit, cursor | 入金履歴 |
| GET | /portfolio/withdrawals | limit, cursor | 出金履歴 |
| GET | /portfolio/summary/total_resting_order_value | — | 総レスト注文額 |