Request a quote

curl --request POST \
  --url https://api.anchorage-staging.com/v2/trading/quote \
  --header 'Api-Access-Key: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "currency": "USD",
  "quantity": "100",
  "side": "BUY",
  "tradingPair": "BTC-USD",
  "accountId": "aaa44c42-5ad3-4108-b376-f78cd32f0543",
  "idempotentId": "01944c42-5ad3-4108-b376-f78cd6ff0393",
  "quantityRounding": true
}
'

import requests

url = "https://api.anchorage-staging.com/v2/trading/quote"

payload = {
    "currency": "USD",
    "quantity": "100",
    "side": "BUY",
    "tradingPair": "BTC-USD",
    "accountId": "aaa44c42-5ad3-4108-b376-f78cd32f0543",
    "idempotentId": "01944c42-5ad3-4108-b376-f78cd6ff0393",
    "quantityRounding": True
}
headers = {
    "Api-Access-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Api-Access-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    currency: 'USD',
    quantity: '100',
    side: 'BUY',
    tradingPair: 'BTC-USD',
    accountId: 'aaa44c42-5ad3-4108-b376-f78cd32f0543',
    idempotentId: '01944c42-5ad3-4108-b376-f78cd6ff0393',
    quantityRounding: true
  })
};

fetch('https://api.anchorage-staging.com/v2/trading/quote', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": {
    "offerAmount": {
      "assetType": "USD",
      "quantity": "11733.73"
    },
    "offerPrice": "11733.73",
    "quoteID": "06f71d1e-e7e8-11ea-adc1-0242ac120002",
    "quoteRequest": {
      "currency": "BTC",
      "quantity": "1",
      "side": "BUY",
      "tradingPair": "BTC-USD"
    },
    "quoteStatus": "OPEN",
    "timestamp": "2020-08-31T16:57:07.265Z",
    "validUntilTime": "2020-08-31T16:57:10.265Z"
  }
}

{
  "errorType": "InternalError",
  "message": "Missing required field 'amount'."
}

{
  "errorType": "InternalError",
  "message": "Missing required field 'amount'."
}

{
  "errorType": "InternalError",
  "message": "Missing required field 'amount'."
}

{
  "errorType": "InternalError",
  "message": "Missing required field 'amount'."
}

{
  "errorType": "InternalError",
  "message": "Missing required field 'amount'."
}

{
  "errorType": "InternalError",
  "message": "Missing required field 'amount'."
}

POST

trading

quote

Request a quote

curl --request POST \
  --url https://api.anchorage-staging.com/v2/trading/quote \
  --header 'Api-Access-Key: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "currency": "USD",
  "quantity": "100",
  "side": "BUY",
  "tradingPair": "BTC-USD",
  "accountId": "aaa44c42-5ad3-4108-b376-f78cd32f0543",
  "idempotentId": "01944c42-5ad3-4108-b376-f78cd6ff0393",
  "quantityRounding": true
}
'

import requests

url = "https://api.anchorage-staging.com/v2/trading/quote"

payload = {
    "currency": "USD",
    "quantity": "100",
    "side": "BUY",
    "tradingPair": "BTC-USD",
    "accountId": "aaa44c42-5ad3-4108-b376-f78cd32f0543",
    "idempotentId": "01944c42-5ad3-4108-b376-f78cd6ff0393",
    "quantityRounding": True
}
headers = {
    "Api-Access-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Api-Access-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    currency: 'USD',
    quantity: '100',
    side: 'BUY',
    tradingPair: 'BTC-USD',
    accountId: 'aaa44c42-5ad3-4108-b376-f78cd32f0543',
    idempotentId: '01944c42-5ad3-4108-b376-f78cd6ff0393',
    quantityRounding: true
  })
};

fetch('https://api.anchorage-staging.com/v2/trading/quote', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": {
    "offerAmount": {
      "assetType": "USD",
      "quantity": "11733.73"
    },
    "offerPrice": "11733.73",
    "quoteID": "06f71d1e-e7e8-11ea-adc1-0242ac120002",
    "quoteRequest": {
      "currency": "BTC",
      "quantity": "1",
      "side": "BUY",
      "tradingPair": "BTC-USD"
    },
    "quoteStatus": "OPEN",
    "timestamp": "2020-08-31T16:57:07.265Z",
    "validUntilTime": "2020-08-31T16:57:10.265Z"
  }
}

{
  "errorType": "InternalError",
  "message": "Missing required field 'amount'."
}

{
  "errorType": "InternalError",
  "message": "Missing required field 'amount'."
}

{
  "errorType": "InternalError",
  "message": "Missing required field 'amount'."
}

{
  "errorType": "InternalError",
  "message": "Missing required field 'amount'."
}

{
  "errorType": "InternalError",
  "message": "Missing required field 'amount'."
}

{
  "errorType": "InternalError",
  "message": "Missing required field 'amount'."
}

Authorizations

Api-Access-Key

string

header

required

An API key associated with a security role

Body

application/json

Request for quote examples

BUY quote requests:

I want to buy the amount of BTC equivalent to 100 USD (I buy BTC and sell USD)

{
  "tradingPair": "BTC-USD",
  "side": "BUY",
  "quantity": "100",
  "currency": "USD"
}

I want to buy 1 BTC (I buy BTC and sell USD)

{
  "tradingPair": "BTC-USD",
  "side": "BUY",
  "quantity": "1",
  "currency": "BTC"
}

I want to buy the amount of ETH equivalent to 1 BTC (I buy ETH and sell BTC)

{
  "tradingPair": "ETH-BTC",
  "side": "BUY",
  "quantity": "1",
  "currency": "BTC"
}

SELL quote requests:

I want to sell the amount of BTC equivalent to 100 USD (I sell BTC and buy USD)

{
  "tradingPair": "BTC-USD",
  "side": "SELL",
  "quantity": "100",
  "currency": "USD"
}

I want to sell 1 BTC (I sell BTC and buy USD)

{
  "tradingPair": "BTC-USD",
  "side": "SELL",
  "quantity": "1",
  "currency": "BTC"
}

I want to sell 1 ETH (I sell ETH and buy BTC)

{
  "tradingPair": "ETH-BTC",
  "side": "SELL",
  "quantity": "1",
  "currency": "ETH"
}

TWOWAY quote requests:

I want two-way quotes to buy 1 ETH and sell BTC or to sell 1 ETH and buy BTC

{
  "tradingPair": "ETH-BTC",
  "side": "TWOWAY",
  "quantity": "1",
  "currency": "ETH"
}

currency

string

required

Currency of quantity.

Example:

"USD"

quantity

string

required

Quantity to quote for in units of currency.

Example:

"100"

side

enum<string>

required

Side of the quote request. "BUY", "SELL", or "TWOWAY".

Available options:

BUY,

SELL,

TWOWAY

Example:

"BUY"

tradingPair

string

required

Trading pair being quoted.

Example:

"BTC-USD"

accountId

string | null

Account ID for quote, must match the accountId on accept quote.

Example:

"aaa44c42-5ad3-4108-b376-f78cd32f0543"

idempotentId

string | null

A client-provided unique ID for idempotent requests (optional). If provided a value, the same idempotentId must be also provided to accept quote.

Maximum string length: 128

Example:

"01944c42-5ad3-4108-b376-f78cd6ff0393"

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.

Response

Successfully created request for quote

data

Quote · object

required

Show child attributes

Getting started

Anchorage custody

Move money

Atlas

Wealth Management & ETF

Trading

Webhooks

Request a quote

Idempotent Requests

Authorizations

Body

Response