Market Trades

Returns fills involving a specific outcome token, enriched with market metadata, computed prices, and order hashes. Can look up by token ID or market slug.

By token ID

GET /v3/markets/{token_id}/trades

By market slug

GET /v3/markets/slug/{slug}/trades

Resolves the slug to all token IDs for that market and returns trades across all outcomes.

Query parameters

Parameter	Type	Default	Description
`after`	integer	—	Start of time range (Unix timestamp)
`before`	integer	—	End of time range
`order_hash`	string	—	Return only fills for one exact order hash (`0x` + 64 hex characters)
`min_amount_usd`	number	—	Minimum trade size in dollars, matching the `amount_usd` response field. Decimals allowed, e.g. `99.5`
`order`	string	`desc`	`asc` or `desc`
`sort_by`	string	—	`order_hash` groups fills from the same order visually
`group_by`	string	—	`order_hash` aggregates the returned fills per order
`limit`	integer	100	Max 300
`offset`	integer	0	Pagination offset

Both the token-ID and market-slug forms accept order_hash and min_amount_usd. Filters are intersected and applied before pagination. For example, ?order_hash=0x...&min_amount_usd=100 returns only $100+ fills from that order in the selected token or market. A valid hash with no scoped fills returns an empty 200 page; an empty or malformed hash returns 400.

Example (by token ID)

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

{
  "elapsed_ms": 1,
  "has_more": true,
  "limit": 1,
  "offset": 0,
  "rows_returned": 1,
  "token_id": "75783394880030392863380883800697645018418815910449662777195626260206142035810",
  "trades": [
    {
      "amount": 5000.0,
      "amount_usd": 5.0,
      "asset": "75783394880030392863380883800697645018418815910449662777195626260206142035810",
      "builder": "0x0000000000000000000000000000000000000000000000000000000000000000",
      "condition_id": "0x4f05dbc6273b89aed46bb79a961c1d8771c01925d92d439e9a81fa6241900661",
      "direction": "BUY",
      "event_id": 475423,
      "event_slug": "dota2-aur1-liquid-2026-05-13",
      "fee": 0.14985,
      "id": "0x01d8b23249b1327d103d033ae9c4cff7303ff87a2cf1bcca7d53bbfb98aec6ed_0xfdc90661e12491b7b4244496eaec409d45a4df55d734244e297eb761bec220b9_1378",
      "image": "https://polymarket-upload.s3.us-east-2.amazonaws.com/dota2-7ffacddb21.jpg",
      "maker": "0xcf19ba47a99eee6be9925211c4f0c6cfd1c344b5",
      "maker_amount": 5.0,
      "maker_asset_id": "0",
      "market": "Dota 2: Aurora vs Team Liquid (BO3) - DreamLeague Group A",
      "order_hash": "0xfdc90661e12491b7b4244496eaec409d45a4df55d734244e297eb761bec220b9",
      "outcome": "Aurora",
      "outcome_index": 0,
      "price": 0.001,
      "role": "maker",
      "side": 0,
      "size": 5000.0,
      "slug": "dota2-aur1-liquid-2026-05-13",
      "taker": "0xe111180000d2663c0091e4f400237545b87b996b",
      "taker_amount": 5000.0,
      "taker_asset_id": "75783394880030392863380883800697645018418815910449662777195626260206142035810",
      "timestamp": "1778692047",
      "token_id": "75783394880030392863380883800697645018418815910449662777195626260206142035810",
      "transaction_hash": "0x01d8b23249b1327d103d033ae9c4cff7303ff87a2cf1bcca7d53bbfb98aec6ed"
    }
  ]
}

Example (by slug)

curl https://api.polynode.dev/v3/markets/slug/dota2-aur1-liquid-2026-05-13/trades?limit=5

Filter a market by order hash

curl -H "x-api-key: pn_live_YOUR_KEY" \
  "https://api.polynode.dev/v3/markets/slug/nba-det-cle-2026-05-15/trades?order_hash=0x9ed363e9c05368fba5c717b8bee355d60a579f599cb7c007d90974203896a95c"

Response fields

Each trade contains the same fields as Wallet Trades, including all market enrichment fields.

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)

By token ID

By market slug

Query parameters

Example (by token ID)

Example (by slug)

Filter a market by order hash

Response fields

​By token ID

​By market slug

​Query parameters

​Example (by token ID)

​Example (by slug)

​Filter a market by order hash

​Response fields

By token ID

By market slug

Query parameters

Example (by token ID)

Example (by slug)

Filter a market by order hash

Response fields