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

# List settlements

`GET /trading/settlements`

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

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

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

#### Filters

You may optionally supply the following filters:

- Specify a one or multiple `status` to filter settlements. Multiple statuses should be separated by commas.

## Query parameters

- `startDate` string, date
- `endDate` string, date
- `status` string[]
- `vaultID` string
- `limit` integer
- `excludePositions` boolean
- `excludeSettlementInstructions` boolean
- `accountId` string

## Response `200`

A list of Settlements and their metadata

- SettlementsResponse
  - `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
  - `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)