Get Polymarket Trade History

Retrieve historical trades for a Polymarket market. Each trade includes execution details.

What you get:

• Trade price and size
• Token ID (identifies YES/NO outcome)
• outcome: The outcome label for this token (e.g., “Yes”, “No”, or a named outcome like “EDward Gaming”)
• Side (buy/sell)
• Timestamp

Important: This endpoint requires the condition_id (hex string starting with 0x), NOT the standard poly_id.

Use cases:

• Analyze trading volume
• Track price movements
• Calculate VWAP
• Build candlestick charts

GET /api/v1/poly/{poly_id}/tradehistory

200

[
  {
    "exchange": "<string>",
    "token_id": "<string>",
    "market_id": "<string>",
    "outcome": "<string>",
    "price": 123,
    "size": 123,
    "side": "<string>",
    "last_update": "2023-11-07T05:31:56Z"
  }
]

Authorizations

X-API-Key · string · header · required

Your API key (get one from the test-key endpoint above)

Path Parameters

poly_id · string · required

Polymarket condition ID (hex string). This is different from the standard poly_id - it's the long identifier starting with '0x' that uniquely identifies a market condition.

Query Parameters

limit · integer · default: 10

Maximum number of trades to return (default: 10 in docs, no max limit)

Response

200 - application/json

Trade history

exchange · string

token_id · string

Token identifier for this trade

market_id · string

outcome · string

Outcome label for this token (e.g., Yes, No, or a named outcome)

price · number

size · number

side · string

last_update · string<date-time>