Kalshi Tools

Kalshi is a regulated prediction-market exchange. These tools let a workflow browse markets, events, orderbooks, trades, and candlestick data, and — with API credentials — read your balance and positions and create, amend, or cancel orders. Use them when you want an agent to research market prices or place and manage trades programmatically.

Overview

Public market-data operations (markets, events, orderbook, trades, candlesticks, series, exchange status) require no authentication. Portfolio and order operations require a Kalshi Key ID and an RSA private key (PEM), which the tool uses to generate KALSHI-ACCESS-KEY, KALSHI-ACCESS-TIMESTAMP, and KALSHI-ACCESS-SIGNATURE headers (RSA-PSS SHA-256 signature over timestamp + METHOD + path). The base URL is https://api.elections.kalshi.com/trade-api/v2.

Operations

Configuration

kalshi_get_markets

kalshi_get_market

kalshi_get_events

kalshi_get_event

kalshi_get_orderbook

kalshi_get_trades

kalshi_get_candlesticks

kalshi_get_series_by_ticker

kalshi_get_exchange_status

No parameters. Returns the current exchange and trading status.

kalshi_get_balance

kalshi_get_positions

kalshi_get_orders

kalshi_get_order

kalshi_get_fills

kalshi_create_order

kalshi_cancel_order

kalshi_amend_order

Outputs

kalshi_get_markets

• markets (json) — Array of market objects
• cursor (string) — Pagination cursor

kalshi_get_market

• market (json) — Market object

kalshi_get_events

• events (json) — Array of event objects
• cursor (string) — Pagination cursor

kalshi_get_event

• event (json) — Event object

kalshi_get_orderbook

• orderbook (json) — Orderbook with yes/no bids and asks

kalshi_get_trades

• trades (json) — Array of trade objects
• cursor (string) — Pagination cursor

kalshi_get_candlesticks

• candlesticks (json) — Array of OHLC candlestick data

kalshi_get_series_by_ticker

• series (json) — Series object

kalshi_get_exchange_status

• tradingActive (boolean) — Whether trading is active
• exchangeActive (boolean) — Whether the exchange is active

kalshi_get_balance

• balance (number) — Account balance in cents
• portfolioValue (number) — Portfolio value in cents

kalshi_get_positions

• positions (json) — Array of position objects
• cursor (string) — Pagination cursor

kalshi_get_orders

• orders (json) — Array of order objects
• cursor (string) — Pagination cursor

kalshi_get_order

• order (json) — Order object

kalshi_get_fills

• fills (json) — Array of fill objects
• cursor (string) — Pagination cursor

kalshi_create_order

• order (json) — Created order object

kalshi_cancel_order

• order (json) — The canceled order object
• reducedBy (number) — Number of contracts canceled

kalshi_amend_order

• order (json) — The amended order object

YAML Example

kalshi_1:
  type: kalshi
  name: "Kalshi"
  inputs:
    operation: "kalshi_get_markets"
    status: "open"
    seriesTicker: "KXBTC"
    limit: "50"
  connections:
    outgoing:
      - target: next-block-id

# Example: place an order (requires credentials)
kalshi_2:
  type: kalshi
  name: "Kalshi Create Order"
  inputs:
    operation: "kalshi_create_order"
    keyId: "{{KALSHI_KEY_ID}}"
    privateKey: "{{KALSHI_PRIVATE_KEY}}"
    ticker: "KXBTC-24DEC31"
    side: "yes"
    action: "buy"
    count: "10"
    type: "limit"
    yesPrice: "55"
  connections:
    outgoing:
      - target: next-block-id

Tips

• Public market-data operations (kalshi_get_markets, kalshi_get_market, kalshi_get_events, kalshi_get_event, kalshi_get_orderbook, kalshi_get_trades, kalshi_get_candlesticks, kalshi_get_series_by_ticker, kalshi_get_exchange_status) need no credentials — use them freely for research before any auth setup.
• For portfolio and order operations, supply your Key ID and RSA private key (PEM). Store the private key as an environment variable and reference it with {{KALSHI_PRIVATE_KEY}} rather than pasting it inline. The tool signs each request with RSA-PSS SHA-256; an invalid or improperly formatted key produces a signature mismatch / 401.
• Prices and balances are denominated in cents: yesPrice/noPrice are 1-99, and balance/portfolioValue outputs are integer cents (divide by 100 for dollars). For kalshi_get_candlesticks, startTs/endTs are Unix seconds while kalshi_get_fills uses minTs/maxTs in Unix milliseconds.
• List operations return a cursor; pass it back as the cursor param to page through large result sets.