Prediction Market

Kalshi Trades

Returns individual trade records for a Kalshi market.

Filters: taker_side, min_contracts, and date range.

Sort: timestamp or num_contracts.

Data refresh: real-time

get/gateway/v1/prediction-market/kalshi/trades

Request

  • Base URL
    https://api.asksurf.ai
  • Auth
    HTTP bearer

Query parameters

tickerstring required

Market ticker identifier. Use GET /v1/prediction-market/kalshi/markets or GET /v1/search/prediction-market?platform=kalshi&q={keyword} to discover valid tickers.

Example:KXBTC2026250-27JAN01-250000
taker_side'yes' | 'no'

Filter by taker side: yes or no

min_amountinteger

Minimum notional volume in USD (each contract = $1)

fromstring

Start of time range. Accepts Unix seconds (1704067200) or date string (2024-01-01)

tostring

End of time range. Accepts Unix seconds (1706745600) or date string (2024-02-01)

sort_by'timestamp' | 'notional_volume_usd'

Field to sort results by

Example:timestamp
order'asc' | 'desc'

Sort order

Example:desc
limitinteger

Results per page

Example:50
offsetinteger

Pagination offset

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

Example response

{
  "$schema": "https://example.com/schemas/DataResponseKalshiTrade.json"
}

Changes

No recorded changes to this operation across all 12 revisions of this API.