Prediction markets

You can trade prediction market contracts on Kalshi, taking positions on real-world events ranging from financial markets to sports outcomes.

Prediction markets use a pay-per-trade model. When you buy contracts, USDC is transferred from your wallet. When you sell, proceeds are sent directly back to your wallet as USDC.

How Kalshi markets work

Each Kalshi market resolves to either yes or no at a defined settlement date. Contracts are priced in cents, from 1 to 99, representing the market’s implied probability of the yes outcome (e.g., a price of 65 means the market assigns a 65% probability to yes). If you hold the winning side at settlement, each contract pays out $1.00. Markets are organized in a hierarchy:

Series — a topic area (e.g., Bitcoin price)
Events — a specific occurrence within a series
Markets — individual yes/no questions within an event

Browse categories

View all available market categories and their associated tags:

curl https://api.useknot.xyz/predictions/categories \
  -H "Authorization: Bearer <token>"

Sports filters

Get sports-specific filters including available competitions and scopes:

curl https://api.useknot.xyz/predictions/sports \
  -H "Authorization: Bearer <token>"

View markets

List prediction markets with optional filters:

curl "https://api.useknot.xyz/predictions/markets?status=open&limit=20&tradeable_only=true" \
  -H "Authorization: Bearer <token>"

Query parameters

string

Filter by market status: unopened, open, closed, or settled.

string

Filter markets by event ticker.

string

Filter markets by series ticker.

number

default:"50"

Maximum number of markets to return.

string

Pagination cursor returned from a previous response.

boolean

When true, only markets with active liquidity are returned.

Response

{
  "status": true,
  "data": {
    "markets": [
      {
        "ticker": "KXBTC-26MAR31-T100000",
        "eventTicker": "KXBTC",
        "title": "Bitcoin above $100,000?",
        "subtitle": "Will BTC be at or above $100,000 on March 31?",
        "status": "open",
        "yesBid": 65,
        "yesAsk": 67,
        "volume24h": 125000
      }
    ],
    "cursor": "next-page-cursor"
  }
}

object

Show properties

array

Show market object properties

string

Unique market identifier (e.g., KXBTC-26MAR31-T100000). Use this as the ticker parameter when buying or selling.

string

The event this market belongs to.

string

Short market title.

string

Detailed description of what the market resolves on.

string

Current market status: unopened, open, closed, or settled.

number

Best bid price for the yes side (in cents).

number

Best ask price for the yes side (in cents).

number

24-hour trading volume in number of contracts.

string

Pagination cursor to pass in the next request to retrieve the following page.

Get market details

Retrieve full details for a specific market by its ticker:

curl https://api.useknot.xyz/predictions/markets/KXBTC-26MAR31-T100000 \
  -H "Authorization: Bearer <token>"

Get market orderbook

View the current order book for a market:

curl "https://api.useknot.xyz/predictions/markets/KXBTC-26MAR31-T100000/orderbook?depth=10" \
  -H "Authorization: Bearer <token>"

View events

Events are groups of related markets. Browse open events:

curl "https://api.useknot.xyz/predictions/events?status=open&limit=20" \
  -H "Authorization: Bearer <token>"

Get event details

curl https://api.useknot.xyz/predictions/events/KXBTC \
  -H "Authorization: Bearer <token>"

View series

Browse series, optionally filtered by category:

curl "https://api.useknot.xyz/predictions/series?category=Crypto&limit=100" \
  -H "Authorization: Bearer <token>"

Get series details

curl https://api.useknot.xyz/predictions/series/KXBTC \
  -H "Authorization: Bearer <token>"

View milestones

Milestones represent scheduled real-world events such as games or matches:

curl "https://api.useknot.xyz/predictions/milestones?category=Sports&competition=Champions%20League&limit=50" \
  -H "Authorization: Bearer <token>"

Get milestone details

curl https://api.useknot.xyz/predictions/milestones/milestone-id \
  -H "Authorization: Bearer <token>"

Check balance

View your current prediction market balance:

curl https://api.useknot.xyz/predictions/balance \
  -H "Authorization: Bearer <token>"

Buy contracts

Purchase contracts on a market. USDC is transferred from your wallet to fund the purchase:

curl -X POST https://api.useknot.xyz/predictions/buy \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "ticker": "KXBTC-26MAR31-T100000",
    "side": "yes",
    "count": 10
  }'

Request parameters

string

required

The market ticker to trade (e.g., KXBTC-26MAR31-T100000).

string

required

The contract side to buy: yes or no.

number

required

Number of contracts to purchase.

Response

{
  "status": true,
  "data": {
    "orderId": "order-uuid",
    "ticker": "KXBTC-26MAR31-T100000",
    "side": "yes",
    "count": 10,
    "pricePerContract": 65,
    "totalCostDollars": 6.50,
    "feeDollars": 0.17,
    "status": "filled"
  }
}

object

Hide properties

string

Unique identifier for the order.

string

The market ticker the order was placed on.

string

The side purchased: yes or no.

number

Number of contracts filled.

number

The average price paid per contract in cents.

number

Total cost of the order in USD.

number

Kalshi fee charged on the order in USD.

string

Order status: filled, partially_filled, or cancelled.

Sell contracts

Sell contracts you hold. Proceeds are sent directly to your wallet as USDC:

curl -X POST https://api.useknot.xyz/predictions/sell \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "ticker": "KXBTC-26MAR31-T100000",
    "side": "yes",
    "count": 5
  }'

Request parameters

string

required

The market ticker of the position to sell.

string

required

The side to sell: yes or no.

number

required

Number of contracts to sell.

View positions

List your current prediction market positions:

curl "https://api.useknot.xyz/predictions/positions?settled=false" \
  -H "Authorization: Bearer <token>"

Query parameters

boolean

Filter by settlement status. Pass false to see open positions or true to see settled ones.

View order history

Retrieve past orders, optionally filtered by market:

curl "https://api.useknot.xyz/predictions/orders?ticker=KXBTC-26MAR31-T100000&limit=50" \
  -H "Authorization: Bearer <token>"

Query parameters

string

Filter orders by market ticker.

number

default:"50"

Maximum number of orders to return.

Withdraw funds

Withdraw your prediction market balance back to your wallet as USDC:

curl -X POST https://api.useknot.xyz/predictions/withdraw \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"amountDollars": 50.00}'

number

required

Amount to withdraw in USD.

Contract settlement

At market close, Kalshi settles each contract based on the real-world outcome:

Winning contracts — each contract pays out $1.00
Losing contracts — expire worthless

Settled proceeds are automatically credited to your prediction market balance. Use the withdraw endpoint to move settled funds back to your wallet.

Policy constraints

Prediction markets must be enabled in your agent’s policy. Check allowPredictionMarkets in your policy settings if you receive a 403 error.

Getting Started

Core Features

Security & Policies

Advanced

How Kalshi markets work

Browse categories

Sports filters

View markets

Query parameters

Response

Get market details

Get market orderbook

View events

Get event details

View series

Get series details

View milestones

Get milestone details

Check balance

Buy contracts

Request parameters

Response

Sell contracts

Request parameters

View positions

Query parameters

View order history

Query parameters

Withdraw funds

Contract settlement

Policy constraints

​How Kalshi markets work

​Browse categories

​Sports filters

​View markets

​Query parameters

​Response

​Get market details

​Get market orderbook

​View events

​Get event details

​View series

​Get series details

​View milestones

​Get milestone details

​Check balance

​Buy contracts

​Request parameters

​Response

​Sell contracts

​Request parameters

​View positions

​Query parameters

​View order history

​Query parameters

​Withdraw funds

​Contract settlement

​Policy constraints

How Kalshi markets work

Browse categories

Sports filters

View markets

Query parameters

Response

Get market details

Get market orderbook

View events

Get event details

View series

Get series details

View milestones

Get milestone details

Check balance

Buy contracts

Request parameters

Response

Sell contracts

Request parameters

View positions

Query parameters

View order history

Query parameters

Withdraw funds

Contract settlement

Policy constraints