Skip to main content
GET
/
api
/
v1
/
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>