Get Trades
Retrieve the account trade history within a time range, with pagination.
Endpoint
GET /v1/trades
Mainnet: GET https://api.orderly.org/v1/trades
Testnet: GET https://testnet-api.orderly.org/v1/trades
Rate limit: 10 requests per second. Returns the account's trade history for the requested range, limited to the latest 500 entries. This signed GET request has no body.
Authentication headers
- orderly-timestamp — signed-request timestamp in milliseconds.
- orderly-account-id — PangoPerps account ID.
- orderly-key — public API key.
- orderly-signature — request signature.
Query parameters
| Parameter | Type | Description |
|---|---|---|
| symbol | string | Restrict history to a market. |
| start_t | number | Start time, as a 13-digit millisecond timestamp. |
| end_t | number | End time, as a 13-digit millisecond timestamp. |
| page | number | Page to return; starts at 1. |
| size | number | Results per page; maximum 500. |
Example request
curl --request GET \
--url 'https://api.orderly.org/v1/trades?symbol=PERP_ETH_USDC&start_t=1702980000000&end_t=1702989200000&page=1&size=100' \
--header 'orderly-account-id: <account-id>' \
--header 'orderly-key: <public-api-key>' \
--header 'orderly-signature: <signature>' \
--header 'orderly-timestamp: <timestamp-in-ms>'Successful response
HTTP 200 returns metadata and rows for individual executions. A trade row can include the trade ID, market, fee and fee asset, side, order ID, execution price and quantity, execution time, maker flag, realized PnL, match ID, margin token/change/mode, and custom order-tag fee and fee-rate fields.
{
"success": true,
"data": {
"meta": {
"total": 1,
"records_per_page": 100,
"current_page": 1
},
"rows": [
{
"id": 123456789,
"symbol": "PERP_ETH_USDC",
"fee": 0.25,
"fee_asset": "USDC",
"side": "BUY",
"order_id": 987654321,
"executed_price": 3450.5,
"executed_quantity": 0.25,
"executed_timestamp": 1702989100000,
"is_maker": 1,
"realized_pnl": 0,
"match_id": 1234567890123456,
"margin_token": "USDC",
"margin_change_qty": 0,
"margin_mode": "CROSS",
"order_enum_fee": 0,
"order_enum_fee_rate": 0
}
]
},
"timestamp": 1702989203989
}