---
title: "Request a quote"
method: POST
path: "/trading/quote"
tags: ["Trading"]
---

# Request a quote

`POST /trading/quote`

Permissions required: **Execute trades**


Request a quote

#### Idempotent Requests

This endpoint supports [idempotent requests](#section/Idempotency) so that quote is not requested twice if an API call was interrupted and must be retried. To send an idempotent request, include the `idempotentId` field in the body of the POST request.

## Request body

- GetQuoteRequest
  - `accountId` string, nullable — Account ID for quote, must match the accountId on [accept quote](#operation/acceptQuote).
  - `currency` string, required — Currency of quantity.
  - `idempotentId` string, nullable — A client-provided unique ID for idempotent requests (optional). If provided a value, the same idempotentId must be also provided to [accept quote](#operation/acceptQuote).
  - `quantity` string, required — Quantity to quote for in units of currency.
  - `quantityRounding` boolean — Optional boolean to specify if quantity should round to Anchorage Digital supported increments. If false or not specified, the request can be rejected if quantity has more precision than our published size increments. The rounding is done as a truncation of the extra fractional digits.
  - `side` 'BUY' | 'SELL' | 'TWOWAY', required — Side of the quote request. "BUY", "SELL", or "TWOWAY".
  - `tradingPair` string, required — Trading pair being quoted.

## Response `201`

Successfully created request for quote

- GetQuoteResponse
  - `data` Quote, required
    - `bidAmount` Amount — 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
    - `bidPrice` string — Bid quote price
    - `offerAmount` Amount — 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
    - `offerPrice` string — Offer quote price
    - `quoteID` string, required — ID of this quote.
    - `quoteRequest` GetQuoteRequest, required
      - `accountId` string, nullable — Account ID for quote, must match the accountId on [accept quote](#operation/acceptQuote).
      - `currency` string, required — Currency of quantity.
      - `idempotentId` string, nullable — A client-provided unique ID for idempotent requests (optional). If provided a value, the same idempotentId must be also provided to [accept quote](#operation/acceptQuote).
      - `quantity` string, required — Quantity to quote for in units of currency.
      - `quantityRounding` boolean — Optional boolean to specify if quantity should round to Anchorage Digital supported increments. If false or not specified, the request can be rejected if quantity has more precision than our published size increments. The rounding is done as a truncation of the extra fractional digits.
      - `side` 'BUY' | 'SELL' | 'TWOWAY', required — Side of the quote request. "BUY", "SELL", or "TWOWAY".
      - `tradingPair` string, required — Trading pair being quoted.
    - `quoteStatus` 'OPEN' | 'REJECTED' | 'EXECUTED', required — A string describing the status of the given quote * `OPEN` - The quote request was accepted and the quote can be used to trade. * `REJECTED` - The quote was rejected and cannot be used to trade. * `EXECUTED` - The quote was traded successfully and can no longer be used to trade.
    - `timestamp` string, date-time, required — The time this quote was procured. An ISO-8601 UTC string of the form 2019-02-13T05:17:32.000000Z.
    - `validUntilTime` string, date-time, nullable — The expire time of the quote (optional). An ISO-8601 UTC string of the form 2019-02-13T05:17:32.000000Z.

## Other responses

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

---

[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)
