Skip to main content

Documentation Index

Fetch the complete documentation index at: https://polynode.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

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

ParameterTypeDefaultDescription
afterinteger—Start of time range (Unix timestamp)
beforeinteger—End of time range (Unix timestamp)
token_idstring—Filter by outcome token
builderstring—Filter by builder code (hex)
min_amountinteger—Minimum maker_amount_filled (raw 6-decimal)
orderstringdescasc or desc
limitinteger100Max 1000
offsetinteger0Pagination 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.