GET/builder/trades

Get builder trades

Retrieves trades attributed to a builder code.

Base URL: https://clob.polymarket.com
Auth: Public, no key
Rate limit: 9,000 req / 10s (900 per second)
Limit applies to: CLOB API general

Parameters

Name	In	Type	Required	Description
builder_code	query	string	yes	Builder code to fetch attributed trades for
id	query	string	no	Trade ID to filter by specific trade
market	query	string	no	Market (condition ID) to filter trades
asset_id	query	string	no	Asset ID (token ID) to filter trades
before	query	string	no	Filter trades before this Unix timestamp
after	query	string	no	Filter trades after this Unix timestamp
next_cursor	query	string	no	Cursor for pagination (base64 encoded offset)

Example

curl -X GET "https://clob.polymarket.com/builder/trades?builder_code=<builder_code>"

Response fields

Field	Type	Description
limit	integer	Maximum number of items per page
next_cursor	string	Cursor for next page (base64 encoded offset). "LTE=" indicates no more pages
count	integer	Number of items in current response
data	object[]	Array of builder trades

Responses

Status	Meaning
200	Successfully retrieved builder trades
400	Bad request - Invalid parameters
500	Internal server error

Errors this endpoint returns

Polymarket's API serves current state only, so it cannot show what a market's book looked like after it resolved. PolyTest records Up/Down markets while they run and keeps the snapshots. Try it free, or read the full rate limit reference.

From Polymarket's published OpenAPI spec and rate-limit tables, synced 2026-10-04.