Trades (Unified)

Unified, per-trade feed across Polymarket and Kalshi in one consistent schema. After the trade source switch (v11.0.0), Polymarket rows are finalized on-chain fills with 137_<block>_<log> IDs and block times. Market and token reads cover retained venue history from June 2023 for Polymarket and January 2023 for Kalshi (with platform=kalshi); global and wallet-only reads cover 35 days. Restart pagination after the switch: earlier pagination keys return 400.

GET/v2/trades

Plans All plansPlan rate limits apply

Parameters

platformstring

polymarket | kalshi. Optional - omit for both.

market_idstring

condition_id (Polymarket) or ticker (Kalshi). A Polymarket outcome token ID is also accepted and returns the same trades as token_id. Tokens without current market metadata use unresolved:<token>.

token_idstring

Outcome token ID (Polymarket only).

walletstring

Maker or taker wallet address. Polymarket-only data.

start_timeinteger

Unix seconds. Earlier ranges are clamped to _meta.data_available_from, or return 422 history_outside_hot_window when explicit coverage errors are enabled. Omit for the last 48 hours, or the full served range when filtering by market_id, token_id, or wallet.

end_timeinteger

Unix seconds. Default: now.

min_totalnumber

Minimum notional USD (>= 0).

limitinteger

1..500. Default: 100.

orderstring

asc | desc. Default: desc.

pagination_keystring

Cursor returned by a prior call. A key issued before the trade source switch returns 400 validation.invalid_cursor; repeat the request without it.

Response

tradesobject[]

Per-trade rows in requested order.

Show 13 fields

platformstring

polymarket | kalshi.

trade_idstring

Opaque, stable per-platform ID. After the trade source switch (v11.0.0), Polymarket IDs use scheme version 1: 137_<block>_<log>. Kalshi IDs do not change.

market_idstring

condition_id (Polymarket) or ticker (Kalshi). Tokens without current market metadata use unresolved:<token>.

token_idstring | null

Outcome token ID (Polymarket only).

sidestring | null

Kalshi outcome side (yes/no). Polymarket after the source switch: the maker participant's action (BUY/SELL).

taker_sidestring | null

yes | no | null. Null for Polymarket.

pricenumber

Execution price in [0, 1].

sharesnumber

Trade size in shares.

amount_usdnumber

Notional USD (price * shares).

maker_addrstring | null

Maker participant wallet, including a trader's own taker-order fills (Polymarket only; null for Kalshi).

taker_addrstring | null

Taker address recorded for the fill; the exchange contract for a trader's own taker-order fill (Polymarket only; null for Kalshi).

executed_atstring

ISO8601 UTC timestamp. Polymarket after the source switch: the block time of the fill, usually 0 to 2 seconds after the venue match time.

timestampinteger

Unix seconds.

paginationobject

Cursor-based keyset pagination state.

Show 4 fields

limitinteger

Echoed page size.

countinteger

Number of trades in this page.

pagination_keystring | null

Pass into the next call to get the following page. Null when has_more is false.

has_moreboolean

True if more rows exist beyond this page.

_metaobject

Data window and caveats.

Show 2 fields

data_available_fromstring

Current ISO8601 served floor. This moves with retention; read it from each live response before planning historical backfills.

warningstring

Plain-text coverage note and the Polymarket-only wallet-filter caveat.

Try it

Sample data

Platform

Market ID

Token ID

Wallet

Start (unix seconds)

End (unix seconds)

Min notional (USD)

Limit

Order

Pagination key

Sample mode returns a fixed recorded example; input changes apply to live requests. Switch it off to query live data with these parameters.

{
  "_meta": {
    "data_available_from": "2026-05-19T00:00:00Z"
  },
  "pagination": {
    "count": 15,
    "has_more": true,
    "limit": 15,
    "pagination_key": "eyJleGVjdXRlZF9hdCI6IjIwMjYtMDUtMTlUMDY6MzQ6NTkrMDA6MDAiLCJzb3VyY2UiOiJwb2x5bWFya2V0IiwidHJhZGVfaWQiOiIweGZiNzVhY2Q1NThkMWViMzMxNTc2MDRlNjVkMzEyN2JkNDY4ZWIzOGVjMzg3OTE0Nzg2ZjU5NGM0NTQwZDY1NTc6MDFkMmE4ZThjZDIwMTk0YSJ9"
  },
  "trades": [
    {
      "amount_usd": 0.05,
      "executed_at": "2026-05-19T06:34:59+00:00",
      "maker_addr": null,
      "market_id": "0xb106ac0c16ae525428956c037cac86230b89bcc5e36ac9e6bd1f77a49a482b69",
      "platform": "polymarket",
      "price": 0.01,
      "shares": 5,
      "side": "no",
      "taker_addr": "0xd21644873b3518a4e5d1a85fc710a2dbc270eead",
      "taker_side": null,
      "timestamp": 1779172499,
      "token_id": "40210368263420407470377837379165750303835340600429616363440284004791150015802",
      "trade_id": "0xfb75acd558d1eb33157604e65d3127bd468eb38ec387914786f594c4540d6557:dad9331949aa42fb"
    },
    {
      "amount_usd": 0.05,
      "executed_at": "2026-05-19T06:34:59+00:00",
      "maker_addr": null,
      "market_id": "0xb106ac0c16ae525428956c037cac86230b89bcc5e36ac9e6bd1f77a49a482b69",
      "platform": "polymarket",
      "price": 0.01,
      "shares": 5,
      "side": "no",
      "taker_addr": "0x78a6d8b69d58ceac0095c0dcf0acaac91ea282dd",
      "taker_side": null,
      "timestamp": 1779172499,
      "token_id": "40210368263420407470377837379165750303835340600429616363440284004791150015802",
      "trade_id": "0xfb75acd558d1eb33157604e65d3127bd468eb38ec387914786f594c4540d6557:d8fa36776cf9f107"
    },
    {
      "amount_usd": 0.5,
      "executed_at": "2026-05-19T06:34:59+00:00",
      "maker_addr": null,
      "market_id": "0xb106ac0c16ae525428956c037cac86230b89bcc5e36ac9e6bd1f77a49a482b69",
      "platform": "polymarket",
      "price": 0.01,
      "shares": 50,
      "side": "no",
      "taker_addr": "0x9df697cd8e3d1e9c0d353a4090591c06b80af87c",
      "taker_side": null,
      "timestamp": 1779172499,
      "token_id": "40210368263420407470377837379165750303835340600429616363440284004791150015802",
      "trade_id": "0xfb75acd558d1eb33157604e65d3127bd468eb38ec387914786f594c4540d6557:c356d614ef46b4cd"
    },
    {
      "amount_usd": 0.3,
      "executed_at": "2026-05-19T06:34:59+00:00",
      "maker_addr": null,
      "market_id": "0xb106ac0c16ae525428956c037cac86230b89bcc5e36ac9e6bd1f77a49a482b69",
      "platform": "polymarket",
      "price": 0.01,
      "shares": 30,
      "side": "no",
      "taker_addr": "0x46b353667fd7d846af3bbeda6584b0e5b883d3de",
      "taker_side": null,
      "timestamp": 1779172499,
      "token_id": "40210368263420407470377837379165750303835340600429616363440284004791150015802",
      "trade_id": "0xfb75acd558d1eb33157604e65d3127bd468eb38ec387914786f594c4540d6557:b9169527ffbf4fb5"
    },
    {
      "amount_usd": 0.05,
      "executed_at": "2026-05-19T06:34:59+00:00",
      "maker_addr": null,
      "market_id": "0xb106ac0c16ae525428956c037cac86230b89bcc5e36ac9e6bd1f77a49a482b69",
      "platform": "polymarket",
      "price": 0.01,
      "shares": 5,
      "side": "no",
      "taker_addr": "0xee64eefb98bd4d65557b52b95480ee76884602b9",
      "taker_side": null,
      "timestamp": 1779172499,
      "token_id": "40210368263420407470377837379165750303835340600429616363440284004791150015802",
      "trade_id": "0xfb75acd558d1eb33157604e65d3127bd468eb38ec387914786f594c4540d6557:8fde00370b18d626"
    },
    {
      "amount_usd": 0.05,
      "executed_at": "2026-05-19T06:34:59+00:00",
      "maker_addr": null,
      "market_id": "0xb106ac0c16ae525428956c037cac86230b89bcc5e36ac9e6bd1f77a49a482b69",
      "platform": "polymarket",
      "price": 0.01,
      "shares": 5,
      "side": "no",
      "taker_addr": "0xff7b3b8275addd153f2749cf6b03079b8c8bf059",
      "taker_side": null,
      "timestamp": 1779172499,
      "token_id": "40210368263420407470377837379165750303835340600429616363440284004791150015802",
      "trade_id": "0xfb75acd558d1eb33157604e65d3127bd468eb38ec387914786f594c4540d6557:72a3b363cfd49eba"
    },
    {
      "amount_usd": 0.2,
      "executed_at": "2026-05-19T06:34:59+00:00",
      "maker_addr": null,
      "market_id": "0xb106ac0c16ae525428956c037cac86230b89bcc5e36ac9e6bd1f77a49a482b69",
      "platform": "polymarket",
      "price": 0.01,
      "shares": 20,
      "side": "no",
      "taker_addr": "0x1ed098fda89bfa00fe77a52905c818fe9e473802",
      "taker_side": null,
      "timestamp": 1779172499,
      "token_id": "40210368263420407470377837379165750303835340600429616363440284004791150015802",
      "trade_id": "0xfb75acd558d1eb33157604e65d3127bd468eb38ec387914786f594c4540d6557:5bf68a20499b0232"
    },
    {
      "amount_usd": 0.1,
      "executed_at": "2026-05-19T06:34:59+00:00",
      "maker_addr": null,
      "market_id": "0xb106ac0c16ae525428956c037cac86230b89bcc5e36ac9e6bd1f77a49a482b69",
      "platform": "polymarket",
      "price": 0.01,
      "shares": 10,
      "side": "no",
      "taker_addr": "0xb8249f2e7f322889ef83d7a7cc3174624f92dd4d",
      "taker_side": null,
      "timestamp": 1779172499,
      "token_id": "40210368263420407470377837379165750303835340600429616363440284004791150015802",
      "trade_id": "0xfb75acd558d1eb33157604e65d3127bd468eb38ec387914786f594c4540d6557:5aac02a797bb7c53"
    },
    {
      "amount_usd": 0.05,
      "executed_at": "2026-05-19T06:34:59+00:00",
      "maker_addr": null,
      "market_id": "0xb106ac0c16ae525428956c037cac86230b89bcc5e36ac9e6bd1f77a49a482b69",
      "platform": "polymarket",
      "price": 0.01,
      "shares": 5,
      "side": "no",
      "taker_addr": "0xf70af3961690530af8d1e7711a5e8799232f903d",
      "taker_side": null,
      "timestamp": 1779172499,
      "token_id": "40210368263420407470377837379165750303835340600429616363440284004791150015802",
      "trade_id": "0xfb75acd558d1eb33157604e65d3127bd468eb38ec387914786f594c4540d6557:4d4bb9e97b674cdd"
    },
    {
      "amount_usd": 0.869,
      "executed_at": "2026-05-19T06:34:59+00:00",
      "maker_addr": null,
      "market_id": "0xb106ac0c16ae525428956c037cac86230b89bcc5e36ac9e6bd1f77a49a482b69",
      "platform": "polymarket",
      "price": 0.01,
      "shares": 86.9,
      "side": "no",
      "taker_addr": "0xd9a040eb26611022e5f02226dc29ac263e9fdbca",
      "taker_side": null,
      "timestamp": 1779172499,
      "token_id": "40210368263420407470377837379165750303835340600429616363440284004791150015802",
      "trade_id": "0xfb75acd558d1eb33157604e65d3127bd468eb38ec387914786f594c4540d6557:358afa3f55c01ce2"
    },
    {
      "amount_usd": 499.95,
      "executed_at": "2026-05-19T06:34:59+00:00",
      "maker_addr": null,
      "market_id": "0xb106ac0c16ae525428956c037cac86230b89bcc5e36ac9e6bd1f77a49a482b69",
      "platform": "polymarket",
      "price": 0.99,
      "shares": 505,
      "side": "yes",
      "taker_addr": "0x28b976aa1ca37a46bb5be373bac7677d3dda531f",
      "taker_side": null,
      "timestamp": 1779172499,
      "token_id": "10952632889671908197139242210701452110152101378847589349477467271204155366598",
      "trade_id": "0xfb75acd558d1eb33157604e65d3127bd468eb38ec387914786f594c4540d6557:3532955ccfb3fe46"
    },
    {
      "amount_usd": 0.05,
      "executed_at": "2026-05-19T06:34:59+00:00",
      "maker_addr": null,
      "market_id": "0xb106ac0c16ae525428956c037cac86230b89bcc5e36ac9e6bd1f77a49a482b69",
      "platform": "polymarket",
      "price": 0.01,
      "shares": 5,
      "side": "no",
      "taker_addr": "0x548da1d7d80ed8462f0252c29a0ed98f3f0a3b6d",
      "taker_side": null,
      "timestamp": 1779172499,
      "token_id": "40210368263420407470377837379165750303835340600429616363440284004791150015802",
      "trade_id": "0xfb75acd558d1eb33157604e65d3127bd468eb38ec387914786f594c4540d6557:211a3197c4d2ae72"
    },
    {
      "amount_usd": 0.6,
      "executed_at": "2026-05-19T06:34:59+00:00",
      "maker_addr": null,
      "market_id": "0xb106ac0c16ae525428956c037cac86230b89bcc5e36ac9e6bd1f77a49a482b69",
      "platform": "polymarket",
      "price": 0.01,
      "shares": 60,
      "side": "no",
      "taker_addr": "0x213908774da29f39c1b625b806bcd2c0fb8b7e15",
      "taker_side": null,
      "timestamp": 1779172499,
      "token_id": "40210368263420407470377837379165750303835340600429616363440284004791150015802",
      "trade_id": "0xfb75acd558d1eb33157604e65d3127bd468eb38ec387914786f594c4540d6557:1f7ef9ead9a70c2f"
    },
    {
      "amount_usd": 0.05,
      "executed_at": "2026-05-19T06:34:59+00:00",
      "maker_addr": null,
      "market_id": "0xb106ac0c16ae525428956c037cac86230b89bcc5e36ac9e6bd1f77a49a482b69",
      "platform": "polymarket",
      "price": 0.01,
      "shares": 5,
      "side": "no",
      "taker_addr": "0x25ef5322584b9b95faa027f4a47c3659fa1cc91b",
      "taker_side": null,
      "timestamp": 1779172499,
      "token_id": "40210368263420407470377837379165750303835340600429616363440284004791150015802",
      "trade_id": "0xfb75acd558d1eb33157604e65d3127bd468eb38ec387914786f594c4540d6557:0a2cce28ec55762b"
    },
    {
      "amount_usd": 0.0514,
      "executed_at": "2026-05-19T06:34:59+00:00",
      "maker_addr": null,
      "market_id": "0xb106ac0c16ae525428956c037cac86230b89bcc5e36ac9e6bd1f77a49a482b69",
      "platform": "polymarket",
      "price": 0.01,
      "shares": 5.14,
      "side": "no",
      "taker_addr": "0x8432c8463bec7e1eef30a2d4a738e283ebcb62ab",
      "taker_side": null,
      "timestamp": 1779172499,
      "token_id": "40210368263420407470377837379165750303835340600429616363440284004791150015802",
      "trade_id": "0xfb75acd558d1eb33157604e65d3127bd468eb38ec387914786f594c4540d6557:01d2a8e8cd20194a"
    }
  ]
}