---
title: "List trades"
method: GET
path: "/trading/trades"
tags: ["Trading"]
---

# List trades

`GET /trading/trades`

Permissions required: **Execute trades** or **Read trade activity**

List all trades. With the permission **Read trade activity** all trades of the organization may be read. With the permission **Execute trades** only the trades created by this API key may be read.

Trades are sorted in a descending order by their timestamp, i.e. the most recent trade or the trade with a timestamp closest to `endDate` is listed first.

#### Filters

You may optionally supply the following filters:

- Specify a `tradingPair` to filter by the trading pair of the trade, for example `BTC-USD`.
- Specify one or multiple `status` to filter trades. Multiple statuses should be separated by commas.
- Specify a `side` to filter by the side of the trade.

## Query parameters

- `startDate` string, date
- `endDate` string, date
- `startDateTime` string, date-time
- `endDateTime` string, date-time
- `status` string[]
- `side` 'BUY' | 'SELL'
- `tradingPair` string
- `accountId` string
- `subaccountId` string
- `orderId` string
- `vaultId` string
- `tradeIds` string[]
- `limit` integer

## Response `200`

A list of Trades and their metadata

- TradesResponse
  - `data` TradeDetails[], required
    - `account` TradeAccount — The account into which this trade will be settled
      - `accountId` string — An ID uniquely identifying the trading account
      - `subaccountId` string — An ID uniquely identifying the subaccount where applicable
    - `currencyBought` string, required — The bought currency.
    - `currencySold` string, required — The sold currency.
    - `fee` string — Amount of the trade fee. It is filled asynchronously and might take up to 2 minutes to become available.
    - `feeCurrency` string — Currency of the trade fee.
    - `orderId` string — Unique order ID for this trade.
    - `price` string — Price in counter currency for **one unit** of the base currency. For example, in the trading pair BTC-USD, this is the price in USD for one unit of BTC. It includes Anchorage Digital trade fees and represents the exchange rate at which the trade was executed. It is filled asynchronously and might take up to 2 minutes to become available. Once filled, the value will remain unchanged through all the other tradeStatus (`EXECUTED`, `SETTLING`, `SETTLED`, and `CANCELED`)
    - `quantityBought` string, required — Quantity bought in units of currencyBought. It represents the quantity Anchorage Digital owes you. See "price" for details when this field is filled.
    - `quantityBoughtToSettle` string — Rounded bought quantity that will considered at settlement. Filled out only in the context of a settlement.
    - `quantitySold` string, required — Quantity sold in units of currencySold. It represents the quantity you owe Anchorage Digital. See "price" for details when this field is filled.
    - `quantitySoldToSettle` string — Rounded sold quantity that will considered at settlement. Filled out only in the context of a settlement.
    - `quoteID` string, required — Unique quote ID for this trade.
    - `side` 'BUY' | 'SELL', required — Side for the trade, either "BUY" or "SELL".
    - `timestamp` string, required — The system timestamp when this trade was received, i.e. when the quote was accepted, as an ISO-8601 UTC string of the form 2019-02-13T05:17:32.000000Z.
    - `tradeID` string, required — Unique ID for this trade.
    - `tradeStatus` 'PENDING' | 'REJECTED' | 'CANCELED' | 'EXECUTED' | 'SETTLING' | 'SETTLED' | 'PENDINGALLOCATION' | 'ALLOCATED', required — A string describing the status of the given trade * `PENDING` - The trade request has been placed and the trade is pending. * `EXECUTED` - This trade was executed and is waiting customer deposit. * `REJECTED` - This trade was rejected. * `CANCELED` - This trade was canceled by Anchorage Digital's trading team due to client legal/financial problems. * `SETTLING` - Anchorage Digital received the customer's deposit and the trade is in the process of settling. * `SETTLED` - Trade is settled and assets were sent to the customer. * `PENDINGALLOCATION` - Trade is executed and is awaiting client allocation. * `ALLOCATED` - Trade is fully allocated by the client.
    - `tradingPair` string, required — Pair of assets this trade is for.
    - `vault` object — The vault into which this trade will be settled
      - `vaultID` string — An ID uniquely identifying the vault
  - `page` Page, required — Pagination info
    - `next` string, nullable — URL to use to query for the next page or null if no additional results are available

## Other responses

- `400` — Bad Request
- `401` — Unauthenticated
- `403` — Forbidden
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.net/anchorage/apis/anchorage-digital-api-reference.md) · [All operations](https://skmtc.net/anchorage/apis/anchorage-digital-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/anchorage/anchorage-digital-api-reference/versions/166864b1ec6d/schema)