Trades
Trade tape
Returns a paginated list of trades that have occurred on the exchange. Default page size is 100, maximum is 1000.
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
baseAssetstring
Base asset symbol; returns trades across all active options (OPTION and PERP_OPTION) for this base asset. Mutually exclusive with market.
cursorstring
Returns the ‘next’ paginated page.
end_atinteger
End Time (unix time millisecond)
marketstring
Market name. Mutually exclusive with base_asset.
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"
}
]
}