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

nextstring

The pointer to fetch next set of records (null if there are no records left)

prevstring

The pointer to fetch previous set of records (null if there are no records left)

Example response

{
  "next": "eyJmaWx0ZXIiMsIm1hcmtlciI6eyJtYXJrZXIiOiIxNjc1NjUwMDE3NDMxMTAxNjk5N=",
  "prev": "eyJmaWx0ZXIiOnsiTGltaXQiOjkwfSwidGltZSI6MTY4MTY3OTgzNzk3MTMwOTk1MywibWFya2VyIjp7Im1zMjExMD==",
  "results": [
    {
      "created_at": 1681497002041,
      "id": "12345643",
      "market": "BTC-USD-PERP",
      "price": "30001.2",
      "size": "0.01"
    }
  ]
}

Changes

Changed in 1 of the 50 revisions of this API.2

Dec 24, 2025e0dd7ef9404f2See the full diff
- ○
  added the media type application/json for the response with the status 200
  response-media-type-added
- ○
  added the media type application/json for the response with the status 400
  response-media-type-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history