Global Trades

Returns all Polymarket fills across all wallets, enriched with market metadata. Supports time range filtering, dollar-size filtering, and scoping by token, market, or event.

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
`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 all of the event’s markets)
`event_id`	integer	—	Filter by numeric event ID (same scope as `event_slug`)
`order_hash`	string	—	Return only fills for one exact order hash (`0x` + 64 hex characters)
`builder`	string	—	Filter by builder code (hex)
`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`
`side`	string	—	Maker order side: `buy`, `sell`, `0`, or `1`
`sort_by`	string	—	`order_hash` groups fills from the same order visually
`group_by`	string	—	`order_hash` aggregates the returned fills per order
`order`	string	`desc`	`asc` or `desc`
`limit`	integer	100	Max 300
`offset`	integer	0	Pagination offset

Event filters cover events currently in Polymarket’s catalog. A very large event can return 400 asking for a narrower filter (condition_id or market_slug). All supplied filters are intersected. order_hash is an exact, indexed filter applied before pagination. Hex characters are case-insensitive; malformed or empty hashes return 400, while a valid hash with no fills returns an empty 200 page.

Example

Every fill for one order:

curl -H "x-api-key: pn_live_YOUR_KEY" \
  "https://api.polynode.dev/v3/trades?order_hash=0x9ed363e9c05368fba5c717b8bee355d60a579f599cb7c007d90974203896a95c"

See Trades by Order Hash for global, wallet, token, slug, pagination, and grouping recipes. $100+ trades, newest first:

curl -H "x-api-key: pn_live_YOUR_KEY" "https://api.polynode.dev/v3/trades?min_amount_usd=100&limit=1"

{
  "trades": [
    {
      "id": "0x5e5cf2c73b8d7a8d09f6397c3c32aa285b7102ab957f43a22afaf0e2a1c3476e_0x3ef6f61107628696009ccf3d343c29177a3244f5d1e92f1fd540e75f04a9f48c_1102",
      "maker": "0xe9076a87c5ed90ef16e6fe6529c943baeca0cff6",
      "taker": "0xe2222d279d744050d28e00520010520000310f59",
      "maker_asset_id": "14635675870982897917581198649476127837975251193150495566552970565909631535281",
      "taker_asset_id": "0",
      "maker_amount": 2028.24,
      "taker_amount": 585.671225,
      "amount_usd": 585.671225,
      "fee": 20.82768,
      "price": 0.2888,
      "size": 2028.24,
      "timestamp": "1783824661",
      "transaction_hash": "0x5e5cf2c73b8d7a8d09f6397c3c32aa285b7102ab957f43a22afaf0e2a1c3476e",
      "order_hash": "0x3ef6f61107628696009ccf3d343c29177a3244f5d1e92f1fd540e75f04a9f48c",
      "builder": "0x2c6624a23b16a2a69acd14c87b7fc03906870c851fa0a7b7f9d7be0fbbedea8a",
      "side": 1,
      "role": "maker",
      "direction": "SELL",
      "market": "Will Argentina win on 2026-07-11?",
      "slug": "fifwc-arg-che-2026-07-11-arg",
      "outcome": "Yes",
      "outcome_index": 0,
      "image": "https://polymarket-upload.s3.us-east-2.amazonaws.com/soccer ball-bba4025f77.png",
      "condition_id": "0x95f726bbb693b945f94473908298b2389989550b08a7bfd90f97ce7ba62cb719",
      "event_slug": "fifwc-arg-che-2026-07-11",
      "event_id": 679992
    }
  ],
  "rows_returned": 1,
  "has_more": true,
  "offset": 0,
  "limit": 1,
  "elapsed_ms": 10
}

Event-scoped: every trade across all markets of one event:

curl -H "x-api-key: pn_live_YOUR_KEY" "https://api.polynode.dev/v3/trades?event_slug=fifwc-arg-che-2026-07-11&limit=100"

Response fields

Each trade contains the same fields as Wallet Trades, including market enrichment (market, slug, outcome, image, condition_id, event_slug, event_id), computed price and size in USD, order_hash, and direction. event_slug/event_id identify the Polymarket event the market belongs to; they are null for old markets that no longer exist in Polymarket’s catalog. 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.

Overview

V3 Data API

Wallet P&L

Wallet Activity

Credits

Identity

Fees

Combos

Rewards

Markets & Search

Orderbook

Leaderboard & Tags

Builders

Polymarket Profiles

Global

Tokens

Perps

Perps Market Data

Perps Wallets

Perps Analytics

Perps On-Chain

Perps Streaming

Crypto

Sports

BYOL

Backtesting

Market Card

System

Search & Context

Onchain V2 (legacy)

Request

Query parameters

Example

Response fields

​Request

​Query parameters

​Example

​Response fields

Request

Query parameters

Example

Response fields