Sign in

v1

latestOpenAPI 3.1.02026-07-2657157254.1 KB
polymarket

Get 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
get/v2/polymarket/trades

Query parameters

market_slugstring nullable

Filter by market slug

Filter by market slug

condition_idstring nullable

Filter by condition ID

Filter by condition ID

token_idstring nullable

Filter by token ID

Filter by token ID

start_timeinteger nullable

Unix timestamp (seconds) for start

Unix timestamp (seconds) for start

end_timeinteger nullable

Unix timestamp (seconds) for end

Unix timestamp (seconds) for end

min_totalnumber nullable

Minimum trade amount in USD

Minimum trade amount in USD

limitinteger

Number of trades to return

Number of trades to return

walletstring nullable

Filter by wallet address(es) — single address or comma-separated list (max 50)

Filter by wallet address(es) — single address or comma-separated list (max 50)

builderstring nullable

Filter by V2 builder attribution tag (bytes32 hex, 0x + 64 hex chars)

Filter by V2 builder attribution tag (bytes32 hex, 0x + 64 hex chars)

order_hashstring nullable

Filter by order hash (bytes32 hex, 0x + 64 hex chars)

Filter by order hash (bytes32 hex, 0x + 64 hex chars)

tx_hashstring nullable

Filter by transaction hash (bytes32 hex, 0x + 64 hex chars)

Filter by transaction hash (bytes32 hex, 0x + 64 hex chars)

order'asc' | 'desc'

Sort order direction enum.

Sort order: asc or desc

pagination_keystring nullable

Cursor for pagination

Cursor for pagination

Response

Successful Response