v1

latestOpenAPI 3.0.32026-07-267278168.1 KB

Market Data

Get Trades

Returns a paginated list of public trades for a market.

get/v1/perps/trades

Query parameters

marketstring required

Example:AAPL-USD.P

Trading market to query

limitinteger

Example:100

Maximum number of results to return

cursorstring

Example:NQ5WWO3THN3Q====

Pagination cursor

Response

Paginated list of trades, most recent first

successboolean required

Whether the request was successful

errorstring

Error message, present only on failure

error_codestring

Semantic error code. See each endpoint's error responses for the specific codes it can return.

deprecatedstring

Deprecation notice, if applicable

Example response

{
  "success": true,
  "result": [
    {
      "market": "AAPL-USD.P",
      "price": "1.55",
      "size": "5.403",
      "cost": "8.37465",
      "aggressor_side": "buy",
      "time": "2022-06-16T12:35:11.123456Z",
      "id": "70a37d8f972f2494837f9dba8364cbb4"
    }
  ],
  "pageInfo": {
    "prevCursor": "O4ZTGM3RGM2DG===",
    "nextCursor": "NQ5WWO3THN3Q===="
  }
}