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 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

ParameterTypeDefaultDescription
afterinteger—Start of time range (Unix timestamp)
beforeinteger—End of time range
limitinteger100Max 1000
offsetinteger0Pagination offset

​
Example (by token ID)

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

{
  "token_id": "75783394880030392863380883800697645018418815910449662777195626260206142035810",
  "trades": [
    {
      "id": "0xc6708a8b57ab936d8bd50be18b0bb55b64d27b5224b7c48ce487fef16fa0de0a_1077",
      "maker": "0x3248e74f1dafd9acb332fd6a511fe7e4600baad4",
      "taker": "0xf8f3c0269b1bff87dba772666864737b168f12a9",
      "maker_asset_id": "0",
      "taker_asset_id": "75783394880030392863380883800697645018418815910449662777195626260206142035810",
      "maker_amount": 31.130816,
      "taker_amount": 61.040815,
      "fee": 0.0,
      "price": 0.51,
      "size": 61.040815,
      "timestamp": "1778674995",
      "transaction_hash": "0xc6708a8b57ab936d8bd50be18b0bb55b64d27b5224b7c48ce487fef16fa0de0a",
      "order_hash": "0xf91a35be0abe447ed8c7d5e4c7511db22e0707136f3850b6708487bf2e6d834c",
      "builder": "0x0000000000000000000000000000000000000000000000000000000000000000",
      "side": 0,
      "role": "maker",
      "direction": "BUY",
      "market": "Dota 2: Aurora vs Team Liquid (BO3) - DreamLeague Group A",
      "slug": "dota2-aur1-liquid-2026-05-13",
      "outcome": "Aurora",
      "outcome_index": 0,
      "image": "https://polymarket-upload.s3.us-east-2.amazonaws.com/dota2-7ffacddb21.jpg",
      "condition_id": "0x4f05dbc6273b89aed46bb79a961c1d8771c01925d92d439e9a81fa6241900661"
    }
  ],
  "rows_returned": 1,
  "has_more": true,
  "elapsed_ms": 30
}

​
Example (by slug)

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

​
Response fields

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