---
title: "Get settlement by ID"
method: GET
path: "/trading/settlements/{settlementId}"
tags: ["Trading"]
---

# Get settlement by ID

`GET /trading/settlements/{settlementId}`

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

Get settlement details by ID.

## Path parameters

- `settlementId` string, required

## Query parameters

- `excludeTrades` boolean
- `excludePositions` boolean
- `excludeSettlementInstructions` boolean

## Response `200`

Metadata about a specific settlement

- SettlementResponse
  - `data` SettlementDetails, required
    - `account` object — The account into which this trade will be settled
      - `accountId` string — An ID uniquely identifying the trading account
    - `createdAt` string, required — The system timestamp when this settlement was created, as an ISO-8601 UTC string of the form 2019-02-13T05:17:32.000000Z.
    - `instructionsCrypto` SettlementInstructionsCrypto[], nullable — Set of settlement instructions in crypto currencies.
      - `address` string, required — Settlement address.
      - `assetTypeID` string, required — Asset type identifier.
    - `positions` TradingPosition[], nullable — A list of positions for that Settlement
      - `positionAmount` Amount, required — An amount of a crypto-asset represented by quantity, assetType, current unit price and current USD value. Fee amounts will be estimates if a transaction is not final. NOTE: price and USD value information is recent but does not reflect real-time data.
        - `assetType` string, required — A string representing a type of crypto-asset, which usually corresponds to the crypto asset's ticker symbol. Use `/asset-types` to list all of the supported asset types for your organization.
        - `currentPrice` string — A recent assessment of the intra-day USD value of 1 unit of this asset type. This value is provided for convenience for such use cases as estimating point-in-time portfolio balances. This value does not represent authoritative pricing information used by Anchorage Digital for any purpose. The price is fetched as of the present, and may be omitted in certain contexts where more structured pricing information is provided (e.g. quotes and trades).
        - `currentUSDValue` string — The result of `quantity * currentPrice`, rounded to the nearest cent. A unitless number implicitly denominated in dollars. See `currentPrice` for methodology and disclaimers.
        - `quantity` string, required — The numeric value of this amount, excluding units
    - `settlementID` string, required — Unique ID for this settlement.
    - `settlementStatus` 'PENDING' | 'SETTLING' | 'SETTLED' | 'CANCELED' | 'EXECUTED', required — A string describing the status of the given settlement * `PENDING` - This settlement has been created. * `SETTLING` - This settlement is in progress. * `SETTLED` - This settlement has been fully settled, this is a terminal state. * `CANCELED` - This settlement has been canceled, this is a terminal state. * `EXECUTED` - This settlement has been created. This is a deprecated status which will be moved to `PENDING` in the future. Please expect either `EXECUTED` or `PENDING` to have a smooth transition.
    - `settlementType` 'TRADE' | 'ADVISORY_FEE' | 'CUSTODY_FEE' | 'MANAGEMENT_FEE' | 'MODEL_FEE' — A string describing the type of a given settlement * `TRADE` - This settlement is associated with trades. * `ADVISORY_FEE` - This settlement is associated with advisory fees. * `CUSTODY_FEE` - This settlement is associated with custody fees. * `MANAGEMENT_FEE` - This settlement is associated with management fees. * `MODEL_FEE` - This settlement is associated with model fees.
    - `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/versions/166864b1ec6d/schema)