---
title: "List Trades"
method: GET
path: "/accounts/{account_id}/trades"
tags: ["Trades"]
---

# List Trades

`GET /accounts/{account_id}/trades`

## Path parameters

- `account_id` string, required

## Query parameters

- `cursor` string
- `limit` integer
- `instrument` string — An ISIN (International Securities Identification Number) according to ISO 6166. Use this filter to restrict the returned list to trades for a specific instrument.
- `order` string — An order identifier. Use this to filter the results to the trades related to a specific order.
- `securities_account` string — A securities account identifier. Use this to filter the results to the trades related to a specific securities account.

## Headers

- `LMG-Data-Privacy-Access-Principal` string, required
- `LMG-Data-Privacy-Access-Justification` string, required

## Response `200`

Successful Response

- PageTradeResponse
  - `data` TradeResponse[], required — The elements of the response.
    - `id` string, required — A string representing the unique identifier of this transaction.
    - `side` 'buy' | 'sell', required — A category to represent the side of a customer's order: <ul> <li><code>buy</code>: Buy shares of an instrument and pay with cash. <li><code>sell</code>: Sell shares of an instrument and receive cash. </ul>
    - `instrument` string, required — An ISIN (International Securities Identification Number) according to ISO 6166. This value uniquely identifies the instrument that was traded.
    - `quantity` string, number, required — The quantity of shares traded.
    - `price` string, number, required — The execution price of the trade (indicated per one share).
    - `amount` string, number, required — The monetary value of the trade.
    - `taxes` TaxResponseField[]
      - `type` string, required — A string identifying the type of tax that was withheld for a trade: <ul> <li><code>capital_gains</code> <li><code>church_tax</code> <li><code>solidarity_surcharge</code> </ul> <strong>NOTE:</strong> This list can be extended in the future. Prepare your code to accept other values, too.
      - `amount` string, required — The monetary amount representing this tax.
      - `direction` 'debit' | 'credit', required — A category representing the direction of a payment or transaction flow: <ul> <li><code>credit</code> <li><code>debit</code> </ul>
    - `fee` string, number, required — The fee that was be charged by lemon.markets on your behalf.
    - `currency` string, required — An ISO 4217 three-letter currency code. Its value represents the currency for the amount listed here. The only currently available currency is `"EUR"`.
    - `order` string, required — An identifier referencing the order triggering the trade.
    - `execution_venue` string, required — An ISO-10383 four-letter code. Its value represents the market on which the trade took place. May be `null` for small trades that did not cause a trade on a public market.
    - `securities_account` string, required — A securities account identifier. This field represents the securities account associated with a trade.
    - `executed_at` string, date-time, required — The venue execution timestamp: the point in time at which the trade was executed on the trading venue
  - `pagination` Pagination, required — Information about accessing elements beyond the ones that were returned.
    - `next_cursor` string — When fetching long lists of elements, you can use our pagination feature to fetch batches of data. If a response contains the property `pagination.next_cursor`, you can pass its value via the query item `cursor` to generate the request for the next batch of data.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `422` — Unprocessable Entity
- `5XX` — Server Error

---

[API](https://skmtc.net/lemon/apis/lemon-markets-brokerage-api.md) · [All operations](https://skmtc.net/lemon/apis/lemon-markets-brokerage-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lemon/lemon-markets-brokerage-api/revisions/3c8cfd3a96c9/schema)