Trades
Trade tape
Returns a paginated list of trades that have occurred on the exchange. Default page size is 100, maximum is 5000.
The side field in the response indicates the taker side of the trade.
Example
GET /trades?market=BTC-USD-PERP&page_size=100
This endpoint supports cursor-based pagination for efficiently traversing large result sets.
get/trades
Query parameters
cursorstring
Returns the ‘next’ paginated page.
end_atinteger
End Time (unix time millisecond)
marketstring required
Market name
page_sizeinteger
Limit the number of responses in the page
start_atinteger
Start Time (unix time millisecond)
Response
OK
Example response
{
"next": "eyJmaWx0ZXIiMsIm1hcmtlciI6eyJtYXJrZXIiOiIxNjc1NjUwMDE3NDMxMTAxNjk5N=",
"prev": "eyJmaWx0ZXIiOnsiTGltaXQiOjkwfSwidGltZSI6MTY4MTY3OTgzNzk3MTMwOTk1MywibWFya2VyIjp7Im1zMjExMD==",
"results": [
{
"created_at": 1681497002041,
"id": "12345643",
"market": "BTC-USD-PERP",
"price": "30001.2",
"size": "0.01"
}
]
}