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

Polymarket

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

Example

Request: GET /api/v1/poly/0x00000977017fa72fb6b1908ae694000d3b51f442c2552656b10bdbbfd16ff707/tradehistory?limit=10
Header: X-API-Key: YOUR_API_KEY

GET

api

poly

{poly_id}

tradehistory

[
  {
    "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>

Get Polymarket Orderbook Get Polymarket Price History