---
title: "Kalshi trades"
method: GET
path: "/kalshi/trades"
tags: ["Kalshi"]
---

# Kalshi trades

`GET /kalshi/trades`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/kalshi/trades`
- Auth: API key in header `x-api-key`

Lists recent Kalshi trades, up to `limit` rows (default 25, max 200), continued with `cursor`. Filter by market `ticker` and by created time with `min_ts` and `max_ts` (Unix seconds, at most 366 days apart). Each trade has its id, count, yes and no price, taker side and created time.

## Query parameters

- `limit` integer
- `cursor` string
- `ticker` string
- `min_ts` integer
- `max_ts` integer

## Headers

- `x-api-key` string, required

## Response `200`

OK

- KalshiTradesResponseDoc
  - `code` integer
  - `data` KalshiTradesResponse
    - `cursor` string: Cursor to pass in the next request to get the following page. Omitted when Kalshi returns none.
    - `fetched_at` string: Time the data was fetched, in UTC (RFC 3339).
    - `limit` integer: Number of trades requested per page.
    - `max_ts` integer: Latest trade creation time that was requested, in Unix seconds.
    - `min_ts` integer: Earliest trade creation time that was requested, in Unix seconds.
    - `source_url` string: URL the data was read from.
    - `ticker` string: Market ticker the trades were filtered by. Omitted when no ticker filter was used.
    - `trades` KalshiTradeRow[]: Recent trades on this page.
      - `count` number: Number of contracts traded.
      - `created_time` string: Time the trade was created, in UTC (RFC 3339).
      - `created_ts` integer: Time the trade was created, in Unix seconds.
      - `is_block_trade` boolean: Whether the trade was a block trade.
      - `no_price` number: Trade price of the No contract, in US dollars.
      - `taker_book_side` string: Order book side of the taker's order, such as `bid` or `ask`.
      - `taker_outcome_side` string: Outcome side of the taker's order, such as `yes` or `no`.
      - `taker_side` string: Side the taker traded, `yes` or `no`.
      - `ticker` string: Ticker of the market the trade happened in.
      - `trade_id` string: Kalshi identifier of the trade.
      - `yes_price` number: Trade price of the Yes contract, in US dollars.
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `429`: Too Many Requests
- `500`: Internal Server Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)