Sim

Kalshi

Access prediction markets and trade on Kalshi

Kalshi is a federally regulated exchange where users can trade directly on the outcomes of future events—prediction markets. Kalshi’s robust API and Sim integration enable agents and workflows to programmatically access all aspects of the platform, supporting everything from research and analytics to automated trading and monitoring.

With Kalshi’s integration in Sim, you can:

  • Market & Event Data: Search, filter, and retrieve real-time and historical data for markets and events; fetch granular details on market status, series, event groupings, and more.
  • Account & Balance Management: Access account balances, available funds, and monitor real-time open positions.
  • Order & Trade Management: Place new orders, cancel existing ones, view open orders, retrieve a live orderbook, and access complete trade histories.
  • Execution Analysis: Fetch recent trades, historical fills, and candlestick data for backtesting or market structure research.
  • Monitoring: Check exchange-wide or series-level status, receive real-time updates about market changes or trading halts, and automate responses.
  • Automation Ready: Build end-to-end automated agents and dashboards that consume, analyze, and trade on real-world event probabilities.

By using these unified tools and endpoints, you can seamlessly incorporate Kalshi’s prediction markets, live trading capabilities, and deep event data into your AI-powered applications, dashboards, and workflows—enabling sophisticated, automated decision-making tied to real-world outcomes.

Usage Instructions

Integrate Kalshi prediction markets into the workflow. Can get markets, market, events, event, balance, positions, orders, orderbook, trades, candlesticks, fills, series, exchange status, and place/cancel/amend trades.

Tools

kalshi_get_markets

Retrieve a list of prediction markets from Kalshi with optional filtering

Input

ParameterTypeRequiredDescription
statusstringNoFilter by status (unopened, open, closed, settled)
seriesTickerstringNoFilter by series ticker
eventTickerstringNoFilter by event ticker
limitstringNoNumber of results (1-1000, default: 100)
cursorstringNoPagination cursor for next page

Output

ParameterTypeDescription
marketsarrayArray of market objects
pagingobjectPagination cursor for fetching more results

kalshi_get_market

Retrieve details of a specific prediction market by ticker

Input

ParameterTypeRequiredDescription
tickerstringYesThe market ticker (e.g., "KXBTC-24DEC31")

Output

ParameterTypeDescription
marketobjectMarket object with details

kalshi_get_events

Retrieve a list of events from Kalshi with optional filtering

Input

ParameterTypeRequiredDescription
statusstringNoFilter by status (open, closed, settled)
seriesTickerstringNoFilter by series ticker
withNestedMarketsstringNoInclude nested markets in response (true/false)
limitstringNoNumber of results (1-200, default: 200)
cursorstringNoPagination cursor for next page

Output

ParameterTypeDescription
eventsarrayArray of event objects
pagingobjectPagination cursor for fetching more results

kalshi_get_event

Retrieve details of a specific event by ticker

Input

ParameterTypeRequiredDescription
eventTickerstringYesThe event ticker
withNestedMarketsstringNoInclude nested markets in response (true/false)

Output

ParameterTypeDescription
eventobjectEvent object with details

kalshi_get_balance

Retrieve your account balance and portfolio value from Kalshi

Input

ParameterTypeRequiredDescription
keyIdstringYesYour Kalshi API Key ID
privateKeystringYesYour RSA Private Key (PEM format)

Output

ParameterTypeDescription
balancenumberAccount balance in cents
portfolioValuenumberPortfolio value in cents
balanceDollarsnumberAccount balance in dollars
portfolioValueDollarsnumberPortfolio value in dollars

kalshi_get_positions

Retrieve your open positions from Kalshi

Input

ParameterTypeRequiredDescription
keyIdstringYesYour Kalshi API Key ID
privateKeystringYesYour RSA Private Key (PEM format)
tickerstringNoFilter by market ticker
eventTickerstringNoFilter by event ticker (max 10 comma-separated)
settlementStatusstringNoFilter by settlement status (all, unsettled, settled). Default: unsettled
limitstringNoNumber of results (1-1000, default: 100)
cursorstringNoPagination cursor for next page

Output

ParameterTypeDescription
positionsarrayArray of position objects
pagingobjectPagination cursor for fetching more results

kalshi_get_orders

Retrieve your orders from Kalshi with optional filtering

Input

ParameterTypeRequiredDescription
keyIdstringYesYour Kalshi API Key ID
privateKeystringYesYour RSA Private Key (PEM format)
tickerstringNoFilter by market ticker
eventTickerstringNoFilter by event ticker (max 10 comma-separated)
statusstringNoFilter by status (resting, canceled, executed)
limitstringNoNumber of results (1-200, default: 100)
cursorstringNoPagination cursor for next page

Output

ParameterTypeDescription
ordersarrayArray of order objects
pagingobjectPagination cursor for fetching more results

kalshi_get_order

Retrieve details of a specific order by ID from Kalshi

Input

ParameterTypeRequiredDescription
keyIdstringYesYour Kalshi API Key ID
privateKeystringYesYour RSA Private Key (PEM format)
orderIdstringYesThe order ID to retrieve

Output

ParameterTypeDescription
orderobjectOrder object with details

kalshi_get_orderbook

Retrieve the orderbook (yes and no bids) for a specific market

Input

ParameterTypeRequiredDescription
tickerstringYesMarket ticker (e.g., KXBTC-24DEC31)

Output

ParameterTypeDescription
orderbookobjectOrderbook with yes/no bids and asks

kalshi_get_trades

Retrieve recent trades across all markets

Input

ParameterTypeRequiredDescription
limitstringNoNumber of results (1-1000, default: 100)
cursorstringNoPagination cursor for next page

Output

ParameterTypeDescription
tradesarrayArray of trade objects
pagingobjectPagination cursor for fetching more results

kalshi_get_candlesticks

Retrieve OHLC candlestick data for a specific market

Input

ParameterTypeRequiredDescription
seriesTickerstringYesSeries ticker
tickerstringYesMarket ticker (e.g., KXBTC-24DEC31)
startTsnumberYesStart timestamp (Unix seconds)
endTsnumberYesEnd timestamp (Unix seconds)
periodIntervalnumberYesPeriod interval: 1 (1min), 60 (1hour), or 1440 (1day)

Output

ParameterTypeDescription
candlesticksarrayArray of OHLC candlestick data

kalshi_get_fills

Retrieve your portfolio

Input

ParameterTypeRequiredDescription
keyIdstringYesYour Kalshi API Key ID
privateKeystringYesYour RSA Private Key (PEM format)
tickerstringNoFilter by market ticker
orderIdstringNoFilter by order ID
minTsnumberNoMinimum timestamp (Unix milliseconds)
maxTsnumberNoMaximum timestamp (Unix milliseconds)
limitstringNoNumber of results (1-1000, default: 100)
cursorstringNoPagination cursor for next page

Output

ParameterTypeDescription
fillsarrayArray of fill/trade objects
pagingobjectPagination cursor for fetching more results

kalshi_get_series_by_ticker

Retrieve details of a specific market series by ticker

Input

ParameterTypeRequiredDescription
seriesTickerstringYesSeries ticker

Output

ParameterTypeDescription
seriesobjectSeries object with details

kalshi_get_exchange_status

Retrieve the current status of the Kalshi exchange (trading and exchange activity)

Input

ParameterTypeRequiredDescription

Output

ParameterTypeDescription
statusobjectExchange status with trading_active and exchange_active flags

kalshi_create_order

Create a new order on a Kalshi prediction market

Input

ParameterTypeRequiredDescription
keyIdstringYesYour Kalshi API Key ID
privateKeystringYesYour RSA Private Key (PEM format)
tickerstringYesMarket ticker (e.g., KXBTC-24DEC31)
sidestringYesSide of the order: 'yes' or 'no'
actionstringYesAction type: 'buy' or 'sell'
countstringYesNumber of contracts (minimum 1)
typestringNoOrder type: 'limit' or 'market' (default: limit)
yesPricestringNoYes price in cents (1-99)
noPricestringNoNo price in cents (1-99)
yesPriceDollarsstringNoYes price in dollars (e.g., "0.56")
noPriceDollarsstringNoNo price in dollars (e.g., "0.56")
clientOrderIdstringNoCustom order identifier
expirationTsstringNoUnix timestamp for order expiration
timeInForcestringNoTime in force: 'fill_or_kill', 'good_till_canceled', 'immediate_or_cancel'
buyMaxCoststringNoMaximum cost in cents (auto-enables fill_or_kill)
postOnlystringNoSet to 'true' for maker-only orders
reduceOnlystringNoSet to 'true' for position reduction only
selfTradePreventionTypestringNoSelf-trade prevention: 'taker_at_cross' or 'maker'
orderGroupIdstringNoAssociated order group ID

Output

ParameterTypeDescription
orderobjectThe created order object

kalshi_cancel_order

Cancel an existing order on Kalshi

Input

ParameterTypeRequiredDescription
keyIdstringYesYour Kalshi API Key ID
privateKeystringYesYour RSA Private Key (PEM format)
orderIdstringYesThe order ID to cancel

Output

ParameterTypeDescription
orderobjectThe canceled order object
reducedBynumberNumber of contracts canceled

kalshi_amend_order

Modify the price or quantity of an existing order on Kalshi

Input

ParameterTypeRequiredDescription
keyIdstringYesYour Kalshi API Key ID
privateKeystringYesYour RSA Private Key (PEM format)
orderIdstringYesThe order ID to amend
tickerstringYesMarket ticker
sidestringYesSide of the order: 'yes' or 'no'
actionstringYesAction type: 'buy' or 'sell'
clientOrderIdstringYesThe original client-specified order ID
updatedClientOrderIdstringYesThe new client-specified order ID after amendment
countstringNoUpdated quantity for the order
yesPricestringNoUpdated yes price in cents (1-99)
noPricestringNoUpdated no price in cents (1-99)
yesPriceDollarsstringNoUpdated yes price in dollars (e.g., "0.56")
noPriceDollarsstringNoUpdated no price in dollars (e.g., "0.56")

Output

ParameterTypeDescription
orderobjectThe amended order object

Notes

  • Category: tools
  • Type: kalshi
On this page

On this page

Start building today
Trusted by over 60,000 builders.
Build Agentic workflows visually on a drag-and-drop canvas or with natural language.
Get started