Get Trade
Retrieve the full execution details for one trade ID.
Endpoint
GET /v1/trade/{trade_id}
Mainnet: GET https://api.orderly.org/v1/trade/{trade_id}
Testnet: GET https://testnet-api.orderly.org/v1/trade/{trade_id}
Rate limit: 10 requests per second. Returns one trade record. 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.
Path parameter
| Parameter | Type | Required | Description |
|---|---|---|---|
| trade_id | number | Yes | ID of the trade to retrieve. |
Example request
curl --request GET \
--url 'https://api.orderly.org/v1/trade/123456789' \
--header 'orderly-account-id: <account-id>' \
--header 'orderly-key: <public-api-key>' \
--header 'orderly-signature: <signature>' \
--header 'orderly-timestamp: <timestamp-in-ms>'Successful response
The 200 response includes a single trade object under data. Fields describe the trade ID, market, fee, side, associated order, execution price/size/time, maker status, realized PnL, match ID, margin values, and custom order-tag fee details.
{
"success": true,
"data": {
"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
}