---
title: "/account/trades"
method: GET
path: "/api/v1/account/trades"
tags: ["Account Data"]
---

# /account/trades

`GET /api/v1/account/trades`

Retrieves the user's trade history.

## Query parameters

- `symbol` string
- `startTimeAtMillis` integer
- `endTimeAtMillis` integer
- `limit` integer
- `tradeType` 'ORDER' | 'LIQUIDATION' | 'DELEVERAGE' | 'UNSPECIFIED' — Type of trade.
- `page` integer

## Response `200`

Successful response with trade details.

- Trade[]
  - `id` string, required — Trade ID
  - `clientOrderId` string — Client order ID.
  - `symbol` string — Market address.
  - `orderHash` string — Order hash.
  - `orderType` 'LIMIT' | 'MARKET' | 'STOP_LIMIT' | 'STOP_MARKET' | 'LIQUIDATION' | 'STOP_LOSS_MARKET' | 'TAKE_PROFIT_MARKET' | 'STOP_LOSS_LIMIT' | 'TAKE_PROFIT_LIMIT' | 'BANKRUPTCY_LIQUIDATION' | 'UNSPECIFIED' — The type of order. (BANKRUPTCY_LIQUIDATION is deprecated)
  - `tradeType` 'ORDER' | 'LIQUIDATION' | 'DELEVERAGE' | 'UNSPECIFIED' — Type of trade.
  - `side` 'LONG' | 'SHORT' | 'UNSPECIFIED', required — Trade side based on the user order in this trade.
  - `isMaker` boolean — Indicates if the user was a maker to the trade.
  - `priceE9` string, required — Trade price (e9 format).
  - `quantityE9` string, required — Trade quantity (e9 format).
  - `quoteQuantityE9` string, required — Quote quantity (e9 format).
  - `realizedPnlE9` string — Realized profit and loss (e9 format).
  - `positionSide` 'LONG' | 'SHORT' | 'UNSPECIFIED' — The side of the position, either long or short
  - `tradingFeeE9` string — Trading fee (e9 format).
  - `tradingFeeAsset` string — Asset used for trading fee.
  - `gasFeeE9` string — Gas fee.
  - `gasFeeAsset` string — Asset used for gas fee.
  - `executedAtMillis` integer, required — Trade timestamp in milliseconds since Unix epoch.

## Other responses

- `400` — request missing required parameters
- `401` — unauthorized access
- `404` — account not found
- `500` — internal server error

---

[API](https://skmtc.net/bluefin/apis/bluefin-account-data-api.md) · [All operations](https://skmtc.net/bluefin/apis/bluefin-account-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bluefin/bluefin-account-data-api/versions/5fd638fb0785/schema)