Get Trades
Trades
Trades History
Fetch historical trade data
GET
Get Trades
Query historical trade data with flexible filtering by market, token, wallet, and time range. All filters are optional - omit them to browse the global trade feed.
Returns one merged feed of all listed wallets’ trades, time-ordered, with standard cursor pagination — designed for tracking a list of followed wallets. Address order doesn’t matter and duplicates are ignored: the same list in any order returns identical results and pagination keys. Trades match on the maker side, same as the single-wallet filter, and the list combines with all other parameters.
Usable standalone or combined with each other and with any wallet/market/time filters. Invalid hash format returns HTTP 400.
V2 fields
Every trade row now carries Polymarket exchange version metadata:exchange_version-1(V1 CTF/NegRiskCTF) or2(V2). Defaults to1.builder- V2 builder attribution tag (bytes32 hex). Empty for V1 fills or V2 fills with no builder.metadata- V2 opaque metadata tag (bytes32 hex). Empty for V1 fills or V2 fills with no metadata.
builder query parameter to filter to fills attributed to a specific builder tag.
Multi-wallet filtering
Thewallet parameter accepts a single address or a comma-separated list of up to 50 addresses:
Point lookups by hash
Two optional parameters (each0x + 64 hex chars) support full-history point lookups, back to October 2022:
| Parameter | Returns |
|---|---|
tx_hash | all fills executed in that transaction |
order_hash | all fills of that order (an order can fill across multiple transactions) |
| Constraint | Value |
|---|---|
limit | 1–500 (default 100) |
wallet | up to 50 comma-separated addresses (>50 or any invalid address returns HTTP 400, identifying which one) |
Authorizations
Query Parameters
Filter by market slug
Filter by condition ID
Filter by token ID
Unix timestamp (seconds) for start
Unix timestamp (seconds) for end
Minimum trade amount in USD
Required range:
x >= 0Number of trades to return
Required range:
1 <= x <= 500Filter by wallet address(es) — single address or comma-separated list (max 50)
Filter by V2 builder attribution tag (bytes32 hex, 0x + 64 hex chars)
Filter by order hash (bytes32 hex, 0x + 64 hex chars)
Filter by transaction hash (bytes32 hex, 0x + 64 hex chars)
Sort order: asc or desc
Available options:
asc, desc Cursor for pagination
