Trade tape

GET

https://api.testnet.paradex.trade/v1/trades

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

1 GET /trades?market=BTC-USD-PERP&page_size=100

This endpoint supports cursor-based pagination for efficiently traversing large result sets.

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 ```http GET /trades?market=BTC-USD-PERP&page_size=100 ``` This endpoint supports cursor-based pagination for efficiently traversing large result sets.

Query parameters

cursorstringOptional

Returns the ‘next’ paginated page.

end_atintegerOptional

End Time (unix time millisecond)

marketstringRequired

Market name

page_sizeintegerOptional1-1000Defaults to 100

Limit the number of responses in the page

start_atintegerOptional

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)

resultslist of objects

Array of paginated results

Errors

400

Bad Request Error

1	{
2	"next": "eyJmaWx0ZXIiMsIm1hcmtlciI6eyJtYXJrZXIiOiIxNjc1NjUwMDE3NDMxMTAxNjk5N=",
3	"prev": "eyJmaWx0ZXIiOnsiTGltaXQiOjkwfSwidGltZSI6MTY4MTY3OTgzNzk3MTMwOTk1MywibWFya2VyIjp7Im1zMjExMD==",
4	"results": [
5	{
6	"created_at": 1681497002041,
7	"id": "12345643",
8	"market": "BTC-USD-PERP",
9	"price": "30001.2",
10	"side": "BUY",
11	"size": "0.01",
12	"trade_type": "FILL"
13	}
14	]
15	}

$	curl -X GET https://api.testnet.paradex.trade/v1/trades?market=BTC-USD-PERP \
>	-H 'Accept: application/json'