---
title: "Trade History"
method: GET
path: "/iserver/account/trades"
tags: ["tradingOrders"]
---

# Trade History

`GET /iserver/account/trades`

Retrieve a list of trades, up to a maximum of 7 days prior.

## Query parameters

- `days` integer

## Response `200`

trades

- TradesResponseItems[] — Array of objects representing executions.
  - `execution_id` string — IB-assigned execution identifier.
  - `symbol` string — Symbol of the instrument involved in the execution.
  - `supports_tax_opt` '0' | '1' — Indicates whether the order is supported by IB's Tax Optimization tool.
  - `side` 'B' | 'S' — Side of the execution.
  - `order_description` string — Human-readable description of the outcome of the execution.
  - `trade_time` string — UTC date and time of the execution in format YYYYMMDD-hh:mm:ss.
  - `trade_time_r` integer — Unix timestamp of the execution time in milliseconds.
  - `size` number, double — The size of the execution in units of the instrument.
  - `price` string — The price at which the execution occurred.
  - `order_ref` string — The client-provided customer order identifier. Specified via cOID during order submission in the Web API.
  - `submitter` string — The IB username that originated the order ticket against which the execution occurred.
  - `exchange` string — The exchange or other venue on which the execution occurred.
  - `commission` string — Commissions incurred by the execution. May also include
  - `net_amount` number, double — net_amount
  - `account` string — The IB account ID of the account that received the execution.
  - `accountCode` string — The IB account ID of the account that received the execution.
  - `account_allocation_name` string — The IB account ID of the account that received the execution.
  - `company_name` string — Name of business associated with instrument, or otherwise description of instrument.
  - `contract_description_1` string — Human-readable description of the order's instrument.
  - `sec_type` 'STK' | 'OPT' | 'FUT' | 'FOP' | 'CASH' | 'CRYPTO' | 'BOND' | 'WAR' | 'FUND' — IB asset class identifier.
  - `listing_exchange` string — The primary exchange on which the instrument is listed.
  - `conid` string — Contract ID of the order's instrument.
  - `conidEx` string — Contract ID and routing destination in format 123456@EXCHANGE.
  - `clearing_id` string — Identifier of the firm clearing the trade. Value is "IB" if account is cleared by Interactive Brokers.
  - `clearing_name` string — Name of the firm clearing the trade. Value is "IB" if account is cleared by Interactive Brokers.
  - `liquidation_trade` '0' | '1' — Indicates whether the trade is the result of a liquidiation by IB.
  - `is_event_trading` '0' | '1' — Indicates whether the order ticket is an Event Trading order.
  - `order_id` integer — Order ID

## Other responses

- `401` — Missing, invalid, or unparseable Authorization token.
- `500` — internal server error, returned when incoming request cannot be processed. It can sometimes include subset of bad requests. For example, wrong accountId passed and it can only be detected later in handling request. Error contains reason of the problem.
- `503` — service is unavailable. For example if request takes more than 10s due to some internal service unavailability, request aborted and this status returned

---

[API](https://skmtc.net/interactivebrokers/apis/api-reference.md) · [All operations](https://skmtc.net/interactivebrokers/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/interactivebrokers/api-reference/revisions/67f9f562c2c6/schema)