Global Trades

Browse the full Polymarket trade history with market enrichment, computed prices, and order hashes.

Returns all Polymarket fills across all wallets, enriched with market metadata. Supports time range filtering, minimum amount, and token filtering.

Request

GET /v3/trades

Query parameters

Parameter	Type	Default	Description
after	integer	—	Start of time range (Unix timestamp)
before	integer	—	End of time range (Unix timestamp)
token_id	string	—	Filter by outcome token
builder	string	—	Filter by builder code (hex)
min_amount	integer	—	Minimum maker_amount_filled (raw 6-decimal)
order	string	desc	asc or desc
limit	integer	100	Max 1000
offset	integer	0	Pagination offset

Example

curl https://api.polynode.dev/v3/trades?limit=1

{
  "trades": [
    {
      "id": "0xd4064c6d77afc87390ae9c371bb87d7f4687ac8f2cb1e600ad695928397c1dce_1483",
      "maker": "0x84cfffc3f16dcc353094de30d4a45226eccd2f63",
      "taker": "0xe2222d279d744050d28e00520010520000310f59",
      "maker_asset_id": "0",
      "taker_asset_id": "9593514921851392841100196009218771406639098519115981476479629056691973100726",
      "maker_amount": 49.301,
      "taker_amount": 70.43,
      "fee": 0.4437,
      "price": 0.7,
      "size": 70.43,
      "timestamp": "1778674687",
      "transaction_hash": "0xd4064c6d77afc87390ae9c371bb87d7f4687ac8f2cb1e600ad695928397c1dce",
      "order_hash": "0xad6a2b6ebf9537d72374fe77a41a7fc285906827a1adddda28948d37c09a6640",
      "builder": "0x0000000000000000000000000000000000000000000000000000000000000000",
      "side": 0,
      "role": "maker",
      "direction": "BUY",
      "market": "Will Racing Club de Lens win on 2026-05-13?",
      "slug": "fl1-rcl-psg-2026-05-13-rcl",
      "outcome": "No",
      "outcome_index": 1,
      "image": "https://polymarket-upload.s3.us-east-2.amazonaws.com/league-fl1.png",
      "condition_id": "0x8e4ef7519b5dc20cebc4c19a07abae587e4abf889e415169ec6b1477d796e1b5"
    }
  ],
  "rows_returned": 1,
  "has_more": true,
  "offset": 0,
  "limit": 1,
  "elapsed_ms": 2
}

Response fields

Each trade contains the same fields as Wallet Trades, including market enrichment (market, slug, outcome, image, condition_id), computed price and size in USD, order_hash, and direction.

On global trades (no wallet context), role is always "maker" and direction reflects the maker’s action. Use the Wallet Trades endpoint for wallet-specific perspective.