> For the complete documentation index, see [llms.txt](https://docs.pangolin.exchange/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pangolin.exchange/pangoperps/trading-api/order-management/get-trade.md).

# 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

```bash
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.

```json
{
  "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
}
```
