---
title: "Get Trades"
method: GET
path: "/v2/polymarket/trades"
tags: ["polymarket"]
---

# Get Trades

`GET /v2/polymarket/trades`

Fetch historical trade data.

Returns trades from Polymarket with support for:
- Filtering by market_slug, condition_id, token_id, or wallet
- Multi-wallet filtering: wallet accepts a comma-separated list (max 50);
  results are the merged time-ordered feed across all listed wallets
- Point lookups by order_hash or tx_hash
- Time range filtering (start_time, end_time)
- Minimum trade amount filtering (min_total)
- Cursor-based pagination
- Global "all trades" mode (no filters) - returns trades across all markets

**All Trades Mode:**
When no market/wallet filter is provided, returns global trades newest-first.
- Only DESC order is supported (returns 400 if order=asc)
- First page defaults to last 24 hours for fast queries
- Pagination automatically extends the time range as you page back
- Provide start_time or end_time to query specific time ranges

## Query parameters

- `market_slug` string, nullable — Filter by market slug
- `condition_id` string, nullable — Filter by condition ID
- `token_id` string, nullable — Filter by token ID
- `start_time` integer, nullable — Unix timestamp (seconds) for start
- `end_time` integer, nullable — Unix timestamp (seconds) for end
- `min_total` number, nullable — Minimum trade amount in USD
- `limit` integer — Number of trades to return
- `wallet` string, nullable — Filter by wallet address(es) — single address or comma-separated list (max 50)
- `builder` string, nullable — Filter by V2 builder attribution tag (bytes32 hex, 0x + 64 hex chars)
- `order_hash` string, nullable — Filter by order hash (bytes32 hex, 0x + 64 hex chars)
- `tx_hash` string, nullable — Filter by transaction hash (bytes32 hex, 0x + 64 hex chars)
- `order` 'asc' | 'desc' — Sort order direction enum.
- `pagination_key` string, nullable — Cursor for pagination

## Response `200`

Successful Response

- TradesResponse — Trades endpoint response.
  - `trades` Trade[], required
    - `token_id` string, required
    - `side` 'BUY' | 'SELL', required — Order side enum.
    - `market_slug` string, required
    - `condition_id` string, required
    - `shares` integer, required — Shares (raw blockchain units)
    - `shares_normalized` number, required — Shares normalized (raw / 1000000)
    - `price` number, required — Trade price (0-1 range)
    - `amount_usd` number, required — Trade value in USD
    - `tx_hash` string, required
    - `title` string, required
    - `timestamp` integer, required — Unix timestamp in seconds
    - `order_hash` string, required — Order hash (same order can have multiple fills)
    - `user` string, required — Maker address
    - `taker` string, required — Taker address (counterparty)
    - `is_yes_side` boolean, required — True if trade is for YES token, False for NO token
    - `outcome_label` string — Human-readable outcome label (e.g., 'Yes', 'No', 'Trump', 'Harris')
    - `fee_usd` number — Trading fee in USD
    - `exchange_version` integer — Exchange contract version: 1 = V1 (CTF/NegRiskCTF), 2 = V2
    - `builder` string — V2 builder attribution tag (bytes32 hex). Empty for V1 fills or V2 fills with no builder.
    - `metadata` string — V2 opaque metadata tag (bytes32 hex). Empty for V1 fills or V2 fills with no metadata.
  - `pagination` CursorPagination, required — Cursor-based pagination for endpoints that don't support offset.
    - `limit` integer, required — Requested limit
    - `count` integer, required — Number of items in current response
    - `pagination_key` string, nullable — Base64-encoded cursor for next page
    - `has_more` boolean, required — Whether there are more items available

## Other responses

- `400` — Bad Request
- `422` — Validation Error
- `500` — Internal Server Error

---

[API](https://skmtc.net/predexon/apis/predexon-api.md) · [All operations](https://skmtc.net/predexon/apis/predexon-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/predexon/predexon-api/versions/80a306fbdb39/schema)