Skip to main content
GET
/
v1
/
trades
Get trades
curl --request GET \
  --url https://api.orderly.org/v1/trades \
  --header 'orderly-account-id: <orderly-account-id>' \
  --header 'orderly-key: <orderly-key>' \
  --header 'orderly-signature: <orderly-signature>' \
  --header 'orderly-timestamp: <orderly-timestamp>'
{
  "success": true,
  "data": {
    "meta": {
      "total": 9,
      "records_per_page": 25,
      "current_page": 1
    },
    "rows": [
      {
        "id": 2,
        "symbol": "PERP_BTC_USDC",
        "fee": 0.0001,
        "fee_asset": "USDC",
        "side": "BUY",
        "order_id": 1,
        "executed_price": 123,
        "executed_quantity": 0.05,
        "executed_timestamp": 1567382401000,
        "is_maker": 1,
        "realized_pnl": 0,
        "match_id": 1773456866666462000,
        "margin_token": "USDC",
        "margin_change_qty": 0,
        "margin_mode": "CROSS"
      }
    ]
  },
  "timestamp": 1702989203989
}

Headers

​
orderly-timestamp
string
required

Timestamp of the signed request in milliseconds.

​
orderly-account-id
string
required

Account ID of the authenticated account.

​
orderly-key
string
required

Public orderly key used to sign the request.

​
orderly-signature
string
required

Signature of the request payload generated with the orderly key.

Query Parameters

​
symbol
string
​
start_t
number

start time range that wish to query, noted the time stamp is 13-digits timestamp.

​
end_t
number

end time range that wish to query, noted the time stamp is 13-digits timestamp.

​
page
number

the page you wish to query. start from 1

​
size
number

the page size you wish to query. (max: 500)

Response

200 - application/json

OK

​
success
boolean
required

Indicates whether the request was successful.

Example:

true

​
data
object
required
​
timestamp
integer

Server timestamp in milliseconds.

Example:

1702989203989