Skip to main content
Returns fills attributed to a specific builder, enriched with builder profile metadata and market context. Use token, market, event, side, size, and time filters to narrow the trade feed.

​
Request

GET /v3/builders/{code}/trades

​
Path parameters

ParameterTypeDescription
codestringBuilder hex code (with or without 0x prefix)

​
Query parameters

ParameterTypeDefaultDescription
token_idstring—Filter trades involving this outcome token
condition_idstring—Filter by market condition ID (resolves to token IDs)
market_slugstring—Filter by market slug (resolves to token IDs)
event_slugstring—Filter by event slug (resolves to token IDs across the event)
sidestring—buy or sell, based on the maker order side
min_amountinteger—Minimum maker_amount_filled (raw 6-decimal)
categorystring—Filter by market category. Broad categories may return 400 asking for a narrower filter.
tag_slugstring—Filter by market tag slug. Broad tags may return 400 asking for a narrower filter.
afterinteger0Start of time range (Unix timestamp)
beforeinteger—End of time range
limitinteger100Max 300
offsetinteger0Pagination offset

​
Example

curl "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": 12,
  "has_more": true,
  "limit": 1,
  "offset": 0,
  "rows_returned": 1,
  "trades": [
    {
      "amount": 1.101,
      "amount_usd": 1.08999,
      "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": "BUY",
      "fee": 0.00032,
      "id": "0x0d57b8bd2cad026ccac902cee781becb358387c6fed98558802e0464434d4c9c_1060",
      "image": "https://polymarket-upload.s3.us-east-2.amazonaws.com/dota2-7ffacddb21.jpg",
      "maker": "0x952d11ebff81d6bd3185e608ed3515b94618ab8a",
      "maker_amount": 1.08999,
      "maker_asset_id": "0",
      "market": "Dota 2: Tundra Esports vs Xtreme Gaming - Game 1 Winner",
      "order_hash": "0x52d42aa621bd4c451151e97eb9b8a9ec4154f76da440ba31b73cebe918331ac2",
      "outcome": "Tundra Esports",
      "outcome_index": 0,
      "price": 0.99,
      "role": "maker",
      "side": 0,
      "size": 1.101,
      "slug": "dota2-tundra-xtreme-2026-05-22-game1",
      "taker": "0xe111180000d2663c0091e4f400237545b87b996b",
      "taker_amount": 1.101,
      "taker_asset_id": "21578184864194020862792310253337084708609281967112790860038966988826118995357",
      "timestamp": "1779448364",
      "token_id": "21578184864194020862792310253337084708609281967112790860038966988826118995357",
      "transaction_hash": "0x0d57b8bd2cad026ccac902cee781becb358387c6fed98558802e0464434d4c9c"
    }
  ]
}

​
Response fields

​
Response envelope

FieldTypeDescription
builderstringBuilder code requested in the path
builder_codestringSame builder code, included for profile-style naming consistency
builder_namestring | nullPublic builder profile name when available
builder_logostring | nullPublic builder profile image URL when available
builder_verifiedboolean | nullWhether the builder profile is verified, when available
tradesarrayTrade rows attributed to this builder
rows_returnedintegerNumber of trade rows returned
has_morebooleanWhether another page is available
offsetintegerPagination offset used
limitintegerPage size used
elapsed_msintegerServer-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.
FieldTypeDescription
builder_codestringBuilder code for this trade row
builder_namestring | nullPublic builder profile name when available
builder_logostring | nullPublic builder profile image URL when available
builder_verifiedboolean | nullWhether 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"
Builder categories are derived from the first market tag. Broad 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"
}
EndpointDescription
GET /v3/buildersBuilder leaderboard
GET /v3/builders/{code}Stats and profile metadata for this builder