---
title: "Get trade by ID"
method: GET
path: "/trading/trades/{tradeId}"
tags: ["Trading"]
---

# Get trade by ID

`GET /trading/trades/{tradeId}`

Permissions required: **Read trade activity** or **Execute trades** (if trade created by this API key)

Get trade by ID.

## Path parameters

- `tradeId` string, required

## Response `200`

Metadata about a specific trade

- TradeResponse
  - `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

## Other responses

- `400` — Bad Request
- `401` — Unauthenticated
- `403` — Forbidden
- `404` — Not Found
- `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/revisions/166864b1ec6d/schema)