Skip to main content
GET
/
gateway
/
v1
/
prediction-market
/
kalshi
/
trades
Kalshi Trades
curl --request GET \
  --url https://api.ask.surf/gateway/v1/prediction-market/kalshi/trades
{
  "data": [
    {
      "market_ticker": "<string>",
      "no_price": 123,
      "notional_volume_usd": 123,
      "taker_side": "<string>",
      "timestamp": 123,
      "trade_id": "<string>",
      "yes_price": 123
    }
  ],
  "meta": {
    "cached": true,
    "credits_used": 123,
    "limit": 123,
    "offset": 123,
    "total": 123
  },
  "$schema": "<string>"
}

Query Parameters

ticker
string
required

Market ticker identifier

Example:

"KXBTCD-26MAR31-B99999"

taker_side
enum<string>

Filter by taker side: yes or no

Available options:
yes,
no
Example:

"yes"

min_amount
integer<int64>

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

Required range: x >= 0
Example:

10000

from
string

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

Example:

"2024-01-01"

to
string

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

Example:

"2024-02-01"

sort_by
enum<string>
default:timestamp

Field to sort results by

Available options:
timestamp,
notional_volume_usd
Example:

"timestamp"

order
enum<string>
default:desc

Sort order

Available options:
asc,
desc
Example:

"desc"

limit
integer<int64>
default:50

Results per page

Required range: 1 <= x <= 500
Example:

50

offset
integer<int64>
default:0

Pagination offset

Required range: x >= 0
Example:

0

Response

OK

data
object[] | null
required
meta
object
required
$schema
string<uri>

A URL to the JSON Schema for this object.

Example:

"https://example.com/schemas/DataResponseKalshiTrade.json"