---
title: "Get all balance-affecting executions."
method: GET
path: "/execution/tradeHistory"
tags: ["Execution"]
---

# Get all balance-affecting executions.

`GET /execution/tradeHistory`

## Query parameters

- `targetAccountId` number, double
- `targetAccountIds` string, JSON
- `symbol` string
- `filter` string, JSON
- `columns` string, JSON
- `count` integer
- `start` integer
- `reverse` boolean
- `startTime` string, date-time
- `endTime` string, date-time

## Response `200`

Request was successful

- Execution[]
  - `execID` string, guid
  - `orderID` string, guid
  - `clOrdID` string
  - `clOrdLinkID` string
  - `account` integer
  - `symbol` string, required
  - `side` string
  - `lastQty` integer
  - `lastPx` number, double
  - `lastLiquidityInd` string
  - `orderQty` integer
  - `price` number, double
  - `displayQty` integer
  - `stopPx` number, double
  - `pegOffsetValue` number, double
  - `pegPriceType` string
  - `currency` string
  - `settlCurrency` string
  - `execType` string
  - `ordType` string
  - `timeInForce` string
  - `execInst` string
  - `contingencyType` string
  - `ordStatus` string
  - `triggered` string
  - `workingIndicator` boolean
  - `ordRejReason` string
  - `leavesQty` integer
  - `cumQty` integer
  - `avgPx` number, double
  - `commission` number, double
  - `feeType` string
  - `tradePublishIndicator` string
  - `text` string
  - `trdMatchID` string, guid
  - `execCost` integer
  - `execComm` integer
  - `homeNotional` number, double
  - `foreignNotional` number, double
  - `transactTime` string, date-time
  - `timestamp` string, date-time, required

## Other responses

- `400` — Parameter Error
- `401` — Unauthorized
- `403` — Access Denied
- `404` — Not Found

## Changes

- **2023-11-29** `9aad85925d8d` — 2 info
  - added the new optional `query` request parameter `targetAccountId`
  - added the new optional `query` request parameter `targetAccountIds`
- **2019-12-18** `fd2de3a82a03` — 1 info
  - added the non-success response with the status `403`
- **2018-05-30** `0c1c991454e3` — 2 warning, 1 info
  - deleted the `query` request parameter `targetAccountId`
  - deleted the `query` request parameter `targetAccountIds`
  - removed the non-success response with the status `403`

[Change history](https://skmtc.dev/bitmex/apis/bitmex-api/changes/execution/tradeHistory/get.md)

---

[API](https://skmtc.dev/bitmex/apis/bitmex-api.md) · [All operations](https://skmtc.dev/bitmex/apis/bitmex-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bitmex/bitmex-api/revisions/04c6a16ffd27/schema)