Request
GET /v3/builders/{code}/trades
Path parameters
| Parameter | Type | Description |
|---|---|---|
code | string | Builder hex code (with or without 0x prefix) |
Query parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
token_id | string | — | Filter trades involving this outcome token |
condition_id | string | — | Filter by market condition ID (resolves to token IDs) |
market_slug | string | — | Filter by market slug (resolves to token IDs) |
event_slug | string | — | Filter by event slug (resolves to token IDs across the event) |
event_id | integer | — | Filter by numeric event ID (same scope as event_slug) |
side | string | — | buy or sell, based on the maker order side |
min_amount_usd | number | — | Minimum trade size in dollars, matching the amount_usd response field. Decimals allowed, e.g. 99.5 |
min_amount | integer | — | Minimum maker_amount_filled (raw 6-decimal). Prefer min_amount_usd |
category | string | — | Filter by market category. Broad categories may return 400 asking for a narrower filter. |
tag_slug | string | — | Filter by market tag slug. Broad tags may return 400 asking for a narrower filter. |
after | integer | 0 | Start of time range (Unix timestamp) |
before | integer | — | End of time range |
limit | integer | 100 | Max 300 |
offset | integer | 0 | Pagination offset |
Example
curl -H "x-api-key: pn_live_YOUR_KEY" "https://api.polynode.dev/v3/builders/0x4898df15ec6590495dc6c0fedf951ade3e64001d47f9caf44a64e86fc11959df/trades?market_slug=dota2-tundra-xtreme-2026-05-22-game1&limit=1"
{
"builder": "0x4898df15ec6590495dc6c0fedf951ade3e64001d47f9caf44a64e86fc11959df",
"builder_code": "0x4898df15ec6590495dc6c0fedf951ade3e64001d47f9caf44a64e86fc11959df",
"builder_logo": "https://polymarket-upload.s3.us-east-2.amazonaws.com/profile-image-4043800-ced7ecde-0754-46a1-8a16-bb6c338fbf39.png",
"builder_name": "PolyCop",
"builder_verified": true,
"elapsed_ms": 134,
"has_more": true,
"limit": 1,
"offset": 0,
"rows_returned": 1,
"trades": [
{
"amount": 34.62,
"amount_usd": 34.58538,
"asset": "21578184864194020862792310253337084708609281967112790860038966988826118995357",
"builder": "0x4898df15ec6590495dc6c0fedf951ade3e64001d47f9caf44a64e86fc11959df",
"builder_code": "0x4898df15ec6590495dc6c0fedf951ade3e64001d47f9caf44a64e86fc11959df",
"builder_logo": "https://polymarket-upload.s3.us-east-2.amazonaws.com/profile-image-4043800-ced7ecde-0754-46a1-8a16-bb6c338fbf39.png",
"builder_name": "PolyCop",
"builder_verified": true,
"condition_id": "0x97269cbb95bd572b3dde34cdd619be278c8f13ba5e43e2e6c2d8639411128a86",
"direction": "SELL",
"event_id": 507638,
"event_slug": "dota2-tundra-xtreme-2026-05-22",
"fee": 0.00103,
"id": "0x5177eefeb47113ec68797a30997eadc7bc7f1e748358ea240ca4c391f29c06d6_0x95a8da83ec734acb0324ee2af0c05551a85b55ef824e0c898ed0ab613d9eab69_1025",
"image": "https://polymarket-upload.s3.us-east-2.amazonaws.com/dota2-7ffacddb21.jpg",
"maker": "0x952d11ebff81d6bd3185e608ed3515b94618ab8a",
"maker_amount": 34.62,
"maker_asset_id": "21578184864194020862792310253337084708609281967112790860038966988826118995357",
"market": "Dota 2: Tundra Esports vs Xtreme Gaming - Game 1 Winner",
"order_hash": "0x95a8da83ec734acb0324ee2af0c05551a85b55ef824e0c898ed0ab613d9eab69",
"outcome": "Tundra Esports",
"outcome_index": 0,
"price": 0.999,
"role": "maker",
"side": 1,
"size": 34.62,
"slug": "dota2-tundra-xtreme-2026-05-22-game1",
"taker": "0xe111180000d2663c0091e4f400237545b87b996b",
"taker_amount": 34.58538,
"taker_asset_id": "0",
"timestamp": "1779449911",
"token_id": "21578184864194020862792310253337084708609281967112790860038966988826118995357",
"transaction_hash": "0x5177eefeb47113ec68797a30997eadc7bc7f1e748358ea240ca4c391f29c06d6"
}
]
}
Response fields
Response envelope
| Field | Type | Description |
|---|---|---|
builder | string | Builder code requested in the path |
builder_code | string | Same builder code, included for profile-style naming consistency |
builder_name | string | null | Public builder profile name when available |
builder_logo | string | null | Public builder profile image URL when available |
builder_verified | boolean | null | Whether the builder profile is verified, when available |
trades | array | Trade rows attributed to this builder |
rows_returned | integer | Number of trade rows returned |
has_more | boolean | Whether another page is available |
offset | integer | Pagination offset used |
limit | integer | Page size used |
elapsed_ms | integer | Server-side query time in milliseconds |
Trade data
Each trade contains the same enriched fields as Wallet Trades, including market context, computed price/size, order hash, and direction. Builder metadata is also repeated on each row for clients that stream or store trade rows independently.| Field | Type | Description |
|---|---|---|
builder_code | string | Builder code for this trade row |
builder_name | string | null | Public builder profile name when available |
builder_logo | string | null | Public builder profile image URL when available |
builder_verified | boolean | null | Whether the builder profile is verified, when available |
Filter examples
Trades for a specific token
curl "https://api.polynode.dev/v3/builders/0x4898df15.../trades?token_id=21578184864194020862792310253337084708609281967112790860038966988826118995357&limit=10"
Trades for a specific market
curl "https://api.polynode.dev/v3/builders/0x4898df15.../trades?market_slug=dota2-tundra-xtreme-2026-05-22-game1&limit=10"
Maker-side buys or sells
curl "https://api.polynode.dev/v3/builders/0x4898df15.../trades?side=buy&limit=10"
curl "https://api.polynode.dev/v3/builders/0x4898df15.../trades?side=sell&limit=10"
Combine tag/category with a narrow market filter
curl "https://api.polynode.dev/v3/builders/0x4898df15.../trades?market_slug=dota2-tundra-xtreme-2026-05-22-game1&tag_slug=sports&limit=10"
curl "https://api.polynode.dev/v3/builders/0x4898df15.../trades?market_slug=dota2-tundra-xtreme-2026-05-22-game1&category=Sports&limit=10"
category and tag_slug filters can be too large to run directly; add market_slug, condition_id, or token_id to use the indexed intersection path.
{
"error": "tag_slug filter too broad for builder trades; add market_slug, condition_id, token_id, or time bounds"
}
Related endpoints
| Endpoint | Description |
|---|---|
GET /v3/builders | Builder leaderboard |
GET /v3/builders/{code} | Stats and profile metadata for this builder |