Kalshi Market Data

Kalshi

Search public Kalshi events and contracts with current prices, volume and lifecycle details.

Current price
$0.0013/result
Availability
Ready to run
Last accepted verification

What this API does

Read-only public prediction-market research. This route does not connect an account, place orders or provide financial advice.

Agents select this operation with tool ID kalshi.market-data, then inspect its current executable contract before a run.

Public input and output shape

Input

inputobject · required

Provider-specific public source, URL or search criteria.

maxItemsinteger · optional

Maximum number of records to return.

minimum: 1 · maximum: 100

Output

active_market_countnumber

Returned active market count value.

categorystring

Returned category value.

contractsarray

Returned contracts value.

event_subtitlestring

Returned event subtitle value.

event_tickerstring

Returned event ticker value.

event_titlestring

Returned event title value.

lifecyclestring

Returned lifecycle value.

querystring

Search terms used to find relevant records.

recent_volumenumber

Returned recent volume value.

retrieved_atstring

Returned retrieved at value.

series_tickerstring

Returned series ticker value.

series_titlestring

Returned series title value.

sourcestring

Returned source value.

source_updated_atnull

Returned source updated at value.

source_urlstring

Returned source url value.

total_market_countnumber

Returned total market count value.

Example request and output

This reviewed worked example is shared with inspect. Inspect also returns the current executable schema and price estimate before a paid run.

Request

{
  "tool_id": "kalshi.market-data",
  "input": {
    "input": {
      "queries": [
        "bitcoin"
      ],
      "maxResults": 2
    },
    "maxItems": 2
  }
}

Output

{
  "query": "bitcoin",
  "source": "kalshi",
  "category": "Crypto",
  "contracts": [
    {
      "title": null,
      "ticker": "KXBTC15M-26AUG200815-15",
      "volume": 1403565,
      "yes_ask": "0.0600",
      "yes_bid": "0.0600",
      "no_label": null,
      "opens_at": "2026-08-20T12:00:00Z",
      "closes_at": "2026-08-20T12:15:00Z",
      "yes_label": "Target Price: $71,859.88",
      "last_price": "0.0630",
      "resolution": null,
      "price_delta": 6,
      "previous_price": "0.0000",
      "expected_resolution_at": "2026-08-20T12:20:00Z"
    }
  ],
  "lifecycle": "active",
  "source_url": "https://api.elections.kalshi.com/v1/search/series",
  "event_title": "BTC 15 min · $71,859.88 target",
  "event_ticker": "KXBTC15M-26AUG200815",
  "retrieved_at": "2026-08-20T12:09:12.000Z",
  "series_title": "Bitcoin price up down",
  "total_volume": 701782,
  "recent_volume": 41436,
  "series_ticker": "KXBTC15M",
  "event_subtitle": "Aug 20 - 8:00AM EDT to 8:15AM EDT",
  "source_updated_at": null,
  "total_market_count": 1,
  "active_market_count": 1
}
Teaching errors and limitations

No listing-specific teaching errors are published. Inspect the tool before running to receive the current schema and error guidance.

Updated
21 August 2026

Use Kalshi Market Data with Scrollport

Scrollport identifies and validates the best-in-class API tools and provides them on a pay-as-you-go basis so you don't need to maintain a separate provider account, subscription or credits.

Give your agent the setup prompt to receive $1 in trial credit and start using the tools right away.