Communitygithub.com

Kalshi API – Agent-Fähigkeit (Offizielle Skills)

Handeln und Abfragen der ersten CFTC-regulierten Vorhersagebörse. Binäre Ja/Nein-Kontrakte zu realen Ereignissen aus Politik, Wirtschaft, Sport und Wetter.

Was ist Kalshi API – Agent-Fähigkeit (Offizielle Skills)?

Diese Fähigkeit ermöglicht es KI-Agenten, mit der Kalshi-Börse zu interagieren, dem ersten von der CFTC regulierten Markt für binäre Vorhersagekontrakte. Sie unterstützt das Abrufen von Marktdaten (Serien, Ereignisse, Orderbücher, Kerzenchartdaten), Live-Daten und historischen Prognosen sowie das Erstellen, Ändern und Stornieren von Aufträgen. Die Authentifizierung erfolgt über ein RSA-PSS-Signaturschema (nicht das kalshi_python SDK). Ein entscheidendes Navigationsprinzip ist der serienbasierte Zugriff: Agenten müssen über die Hierarchie Serie → Ereignis → Markt navigieren, da die direkte Markets-Suche nach Schlüsselwörtern (z. B. „NHL“) nur irrelevante Multi-Game-Pakete zurückgibt. Die Fähigkeit ist plattformunabhängig und funktioniert mit jedem HTTP-Client in Verbindung mit Python-Code zur Signaturerzeugung; die vollständige API-Spezifikation ist unter docs.kalshi.com/openapi.yaml verfügbar.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Kalshi API

Handeln und Abfragen der ersten CFTC-regulierten Vorhersagebörse. Binäre Ja/Nein-Kontrakte zu realen Ereignissen, bepreist von 1–99 Cent.

Basis-URL: https://external-api.kalshi.com/trade-api/v2 Demo-URL: https://external-api.demo.kalshi.co/trade-api/v2

API-Schlüssel unter https://kalshi.com/account/api-keys anfordern (Tier Premier oder Market Maker erforderlich)

Wichtige Konzepte

Hierarchie: Serie > Ereignis > Markt

  • Serie – wiederkehrende Ereignisvorlagen (z. B. „Monatlicher Arbeitsmarktbericht“, „Wöchentliche Arbeitslosenanträge“)
  • Ereignisse – konkrete Instanzen innerhalb einer Serie (z. B. „Arbeitsmarktbericht Mai 2026“)
  • Märkte – einzelne binäre Ergebnisse innerhalb eines Ereignisses (z. B. „Liegen die neu geschaffenen Arbeitsplätze über 200.000?“)

Preisbildung binärer Kontrakte

  • Preise werden in Cent angegeben (1–99) und repräsentieren die implizite Wahrscheinlichkeit
  • Ein Ja-Kontrakt bei 65 Cent bedeutet, der Markt impliziert eine 65%ige Wahrscheinlichkeit
  • Ja-Gebot zu Preis X entspricht Nein-Verkaufsangebot zu (100 – X) – Orderbücher zeigen nur Ja- und Nein-Gebote
  • Abrechnung: zahlt 1,00 $ (100 Cent) bei Ja, 0 $ bei Nein
  • Alle Geldwerte (Guthaben, Preise, Abrechnungen) sind in Cent

Ticker-Format

  • Serie: KXBTC, KXJOBLESS, KXINX
  • Ereignis: KXBTC-25MAY30 (Serie + Datum)
  • Markt: KXBTC-25MAY30-T100000 (Ereignis + Schwelle/Ergebnis)

Sportspiel-Ticker folgen einem anderen Muster: {SERIE}-{JJMMTT}{TEAM1}{TEAM2}-{TEAM}

  • Beispiel: KXNHLGAME-25MAY12EDMORL-EDM (NHL, 12. Mai 2025, Edmonton vs. Orlando, Edmonton gewinnt)
  • Jedes Spieleereignis hat zwei sich gegenseitig ausschließende JA-Märkte – einen pro Team

KRITISCH: Serienbasierte Marktnavigation

NIEMALS /markets?keyword= für Sport, Wahlen oder andere serienbasierte Kategorien verwenden. Diese Suchmethode findet nur Multi-Game-Pakete, nicht die eigentlichen Spiele-Märkte. Die Suche nach „NHL“, „Fulham“, „Premier League“ usw. liefert null oder irrelevante Ergebnisse.

Immer navigieren: Serie → Ereignis → Markt. Spiele-Märkte befinden sich unter der Serien-/Ereignis-Hierarchie und müssen über /events?series_ticker=KXXX erreicht werden. Außerdem kann /markets/{ticker} für Spiele-Märkte einen 404-Fehler zurückgeben – Geld-/Briefkurse erscheinen nur in der Ereignis-Antwort (/events/{event_ticker} mit with_nested_markets=true).

Dieses Muster gilt für alle serienbasierten Kategorien, nicht nur für Sport:

  • Sportspiele – NHL, NBA, NFL, MLB, EPL usw.
  • Politische Rennen – einzelne Kandidatenmärkte innerhalb von Multi-Kandidaten-Ereignissen
  • Unternehmensspezifische Märkte – Gewinne, CEO-Wechsel innerhalb einer Serie
  • Wiederkehrende Wirtschaftsdaten – Arbeitsmarktberichte, Arbeitslosenanträge, VPI usw.

Bekannte Sport-Serien-Ticker:

SportSerien-TickerBeispiel
NHLKXNHLGAMEKXNHLGAME-25MAY12EDMORL
NBAKXNBAGAMEKXNBAGAME-25MAY12BOSLAL
NFLKXNFLGAMEKXNFLGAME-25SEP07KCDET
MLBKXMLBGAMEKXMLBGAME-25MAY12NYYLAD
EPL (Premier League)KXEPLGAMEKXEPLGAME-25MAY12FULARS

Korrekter Workflow für Sport:

# 1. Offene Spiele für eine Sportart auflisten
curl -s "https://external-api.kalshi.com/trade-api/v2/events?series_ticker=KXNHLGAME&status=open&with_nested_markets=true"

# 2. Bestimmtes Spiel mit Live-Geld-/Briefkursen abrufen
curl -s "https://external-api.kalshi.com/trade-api/v2/events/KXNHLGAME-25MAY12EDMORL?with_nested_markets=true"

# FALSCH – das nicht tun:
# curl -s "https://external-api.kalshi.com/trade-api/v2/markets?keyword=NHL"  ← liefert Pakete, keine Spiele

So wird aufgerufen

Kalshi verwendet die RSA-Schlüsselpaar-Signatur-Authentifizierung. Drei Header sind bei authentifizierten Anfragen erforderlich:

HeaderWert
KALSHI-ACCESS-KEYAPI-Schlüssel-ID ($KALSHI_ACCESS_KEY)
KALSHI-ACCESS-SIGNATURERSA-PSS-Signatur von timestamp + method + path
KALSHI-ACCESS-TIMESTAMPUnix-Zeitstempel (ms)

Öffentliche GET-Endpunkte (Märkte, Ereignisse, Orderbücher) können ohne Authentifizierungs-Header aufgerufen werden.

# Öffentlicher Endpunkt – keine Authentifizierung erforderlich
curl -s "https://external-api.kalshi.com/trade-api/v2/markets?limit=10&status=open"

Für authentifizierte Endpunkte direktes RSA-PSS-Signieren verwenden (nicht das kalshi_python SDK – es funktioniert nicht):

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"]
    # Zuerst literale Escape-Sequenzen dekodieren (einige Eingabekanäle speichern '\n' als
    # zwei Zeichen Backslash+n anstelle eines echten Zeilenumbruchs).
    raw = (raw.replace('\\r\\n', '\n').replace('\\n', '\n')
              .replace('\\r', '\n').replace('\\t', ' '))
    # PEM-Marker entfernen, falls vorhanden, dann ALLE Leerzeichen entfernen und neu umbrechen.
    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()  # path darf KEINE Query-Strings enthalten
    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, ...} — Guthaben in Cent

Fallstricke beim Signieren:

  • PSS, nicht PKCS1v15 – PKCS1v15-Padding gibt 401 zurück. Muss PSS mit SHA256 verwenden.
  • Query-Strings vor dem Signieren entfernen – Die Signatur wird nur über den reinen Pfad berechnet (z. B. /trade-api/v2/portfolio/balance), nicht über /trade-api/v2/portfolio/balance?param=value. Das Einfügen des Query-Strings führt zu 401.
  • Schlüssel-Umgebungsvariablen-Format – KALSHI_PRIVATE_KEY akzeptiert: rohen base64-Text, vollständiges PEM mit echten Zeilenumbrüchen oder vollständiges PEM mit zu Leerzeichen zusammengefassten Zeilenumbrüchen (häufig beim Einfügen über Webformulare). Der Helfer normalisiert alle Formate automatisch. Für die robusteste Speicherung als doppelt angeführtes mehrzeiliges PEM mit \n-Escapes in .env speichern, damit python-dotenv es in eine echte PEM-Zeichenkette umwandelt.

API-Spezifikation

Vollständige OpenAPI-Spezifikation: https://docs.kalshi.com/openapi.yaml

Intent-Routing

Benutzerabsicht dem richtigen Endpunkt zuordnen. Alle Pfade sind relativ zur Basis-URL.

Ereignisse

MethodeEndpunktPrimäre ParameterBeschreibung
GET/eventslimit (1-200), cursor, status, series_ticker, with_nested_marketsEreignisse auflisten (ohne multivariate)
GET/events/{event_ticker}event_ticker, with_nested_marketsBestimmtes Ereignis abrufen
GET/events/{event_ticker}/metadataevent_tickerNur Ereignis-Metadaten
GET/events/multivariatelimit, cursor, series_ticker, collection_ticker, with_nested_marketsMultivariate (Kombi-)Ereignisse auflisten

Märkte

MethodeEndpunktPrimäre ParameterBeschreibung
GET/marketslimit, cursor, status, ticker, event_ticker, series_ticker, min_close_ts, max_close_tsMärkte auflisten/filtern
GET/markets/{ticker}tickerBestimmte Marktdetails abrufen
GET/markets/{ticker}/orderbookticker, depthAktuelles Orderbuch (Ja-Gebote + Nein-Gebote)
GET/markets/orderbookstickers (Array, max. 100)Batch-Orderbücher
GET/markets/tradesticker, limit, cursor, min_ts, max_tsTrades über Märkte hinweg

Kerzencharts

MethodeEndpunktPrimäre ParameterBeschreibung
GET/series/{series_ticker}/markets/{ticker}/candlesticksseries_ticker, ticker, start_ts, end_ts, period_intervalMarkt-Level-Kerzen
GET/series/{series_ticker}/events/{ticker}/candlesticksseries_ticker, ticker, start_ts, end_ts, period_intervalAggregierte Ereignis-Level-Kerzen
GET/markets/candlesticksmarket_tickers, start_ts, end_ts, period_intervalBatch-Kerzencharts

period_interval Werte: 1 (1 Min), 60 (1 Std), 1440 (1 Tag)

Prognose & Live-Daten

MethodeEndpunktPrimäre ParameterBeschreibung
GET/series/{series_ticker}/events/{ticker}/forecast_percentile_historypercentiles (0-10000), start_ts, end_ts, period_intervalHistorische Prognose-Perzentile
GET/live_data/milestone/{milestone_id}milestone_id, include_player_statsLive-Meilensteindaten
GET/live_data/batchmilestone_ids (Array, max. 100), include_player_statsBatch-Live-Daten
GET/live_data/game-stats/{milestone_id}milestone_idSpiel-für-Spiel-Statistiken (Football, Basketball, Fußball, Hockey, Baseball)

Serien

MethodeEndpunktPrimäre ParameterBeschreibung
GET/series/{series_ticker}series_ticker, include_volumeSerienvorlage abrufen
GET/seriescategory, tags, include_volume, min_updated_tsAlle Serien auflisten

Börseninformationen

MethodeEndpunktPrimäre ParameterBeschreibung
GET/exchange/status—Aktueller Börsenstatus
GET/exchange/schedule—Betriebszeiten
GET/exchange/announcements—Plattform-Ankündigungen
GET/exchange/user_data_timestamp—Daten-Synchronisationszeitstempel
GET/series/fee_changesseries_ticker, show_historicalGebührenänderungshistorie

Suche & Entdeckung

MethodeEndpunktPrimäre ParameterBeschreibung
GET/search/tags_by_categories—Tags, geordnet nach Serienkategorien
GET/search/filters_by_sport—Filter, geordnet nach Sportart

Aufträge (Authentifiziert)

MethodeEndpunktPrimäre ParameterBeschreibung
GET/portfolio/ordersticker, event_ticker, status, limit, cursor, subaccountBenutzeraufträge auflisten
GET/portfolio/orders/{order_id}order_idBestimmten Auftrag abrufen
POST/portfolio/ordersBody: ticker, action, side, type, count, yes_price/no_priceAuftrag erstellen
DELETE/portfolio/orders/{order_id}order_id, subaccountAuftrag stornieren
POST/portfolio/orders/{order_id}/amendorder_id, Body: neue count/priceAuftrag ändern
POST/portfolio/orders/{order_id}/decreaseorder_id, Body: ReduzierungsbetragAuftragsmenge verringern
POST/portfolio/orders/batchedBody: Array von AufträgenBatch-Erstellung (maximale Größe skaliert mit Tier)
DELETE/portfolio/orders/batchedBody: Array von Auftrags-IDsBatch-Stornierung
GET/portfolio/orders/queue_positionsmarket_tickers, event_ticker, subaccountAlle ruhenden Auftragswarteschlangenpositionen
GET/portfolio/orders/{order_id}/queue_positionorder_idBestimmte Auftragswarteschlangenposition

Aufträge V2 — Ereignis-Markt-Aufträge (Authentifiziert, Festkomma)

MethodeEndpunktPrimäre ParameterBeschreibung
POST/portfolio/events/ordersBody: Ereignis-Ticker, Marktseite, Preis (Festkomma), AnzahlV2-Auftrag erstellen
POST/portfolio/events/orders/batchedBody: Array von V2-AufträgenBatch-Erstellung V2
DELETE/portfolio/events/orders/{order_id}order_id, subaccountV2-Auftrag stornieren
DELETE/portfolio/events/orders/batchedBody: Array von Auftrags-IDsBatch-Stornierung V2
POST/portfolio/events/orders/{order_id}/amendorder_id, Body: neue Anzahl/PreisV2-Auftrag ändern
POST/portfolio/events/orders/{order_id}/decreaseorder_id, Body: neue verbleibende AnzahlV2-Auftrag verringern

Auftragsgruppen (Authentifiziert)

MethodeEndpunktPrimäre ParameterBeschreibung
GET/portfolio/order_groupssubaccountAlle Auftragsgruppen auflisten
POST/portfolio/order_groups/createBody: VertragslimitAuftragsgruppe erstellen
GET/portfolio/order_groups/{id}id, subaccountBestimmte Gruppe abrufen
DELETE/portfolio/order_groups/{id}id, subaccountGruppe löschen und alle Aufträge stornieren
PUT/portfolio/order_groups/{id}/limitid, Body: neues LimitVertragslimit aktualisieren
PUT/portfolio/order_groups/{id}/triggerid, subaccountGruppe auslösen (alle Aufträge stornieren)
PUT/portfolio/order_groups/{id}/resetid, subaccountZähler für abgeglichene Verträge zurücksetzen

Portfolio (Authentifiziert)

MethodeEndpunktPrimäre ParameterBeschreibung
GET/portfolio/balancesubaccountGuthaben & Portfoliowert (in Cent)
GET/portfolio/positionscursor, limit, count_filter, ticker, event_ticker, subaccountBenutzerpositionen
GET/portfolio/fillsticker, order_id, min_ts, max_ts, limit, cursor, subaccountAlle Trade-Ausführungen
GET/portfolio/settlementslimit, cursor, ticker, event_ticker, min_ts, max_ts, subaccountAbrechnungshistorie
GET/portfolio/depositslimit, cursorEinzahlungshistorie
GET/portfolio/withdrawalslimit, cursorAuszahlungshistorie
GET/portfolio/summary/total_resting_order_value—Gesamtwert ruhender Aufträge

Unterkonten (Authentifiziert)

MethodeEndpunktPrimäre ParameterBeschreibung
GET/portfolio/subaccounts—Unterkonten abrufen

Batch-Marktdaten (Authentifiziert)

MethodeEndpunktPrimäre ParameterBeschreibung
GET/portfolio/markets/tradescursor, min_ts, max_ts, limitBatch-Trade-Daten
GET/portfolio/markets/snapshotscursor, limitBatch-Markt-Snapshots
GET/portfolio/markets/snapshots/{ticker}tickerMarkt-Snapshot-Details

Individual skills in this repo

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

Verwandte Skills