Skip to main content
GET
/
trading
/
marketdata
Get market data snapshot
curl --request GET \
  --url https://api.anchorage-staging.com/v2/trading/marketdata \
  --header 'Api-Access-Key: <api-key>'
{
  "data": [
    {
      "timestamp": "2025-05-08T16:17:01.863332Z",
      "symbol": "BTC-USD",
      "spread": "0.001",
      "sizeBuckets": [
        "1",
        "5",
        "10"
      ],
      "bids": [
        {
          "price": "101022.85",
          "size": "1.00000000"
        },
        {
          "price": "101003.14",
          "size": "5.00000000"
        },
        {
          "price": "100998.21",
          "size": "10.00000000"
        }
      ],
      "offers": [
        {
          "price": "101253.98",
          "size": "1.00000000"
        },
        {
          "price": "101253.98",
          "size": "5.00000000"
        },
        {
          "price": "101253.98",
          "size": "10.00000000"
        }
      ],
      "amountBuckets": []
    }
  ]
}

Authorizations

Api-Access-Key
string
header
required

An API key associated with a security role

Query Parameters

symbol
string
required

The trading pair symbol (e.g., BTC-USD, ETH-USD)

accountId
string

The account ID (either accountId or subaccountId must be provided)

subaccountId
string

The subaccount ID (either accountId or subaccountId must be provided)

sizeBuckets
string[]

Comma-separated list of size buckets for market depth (e.g., 0.1,0.5,1.0)

amountBuckets
string[]

Comma-separated list of amount buckets for market depth (e.g., 1000,5000,10000). Amount buckets represent USD values. Note: When using amount buckets, the price levels in the response may show size as aggregated notional value rather than asset quantity.

depth
integer<int64>

Number of price levels to return for bids and offers. Must be greater than zero. The API will return up to the requested depth, limited by available liquidity in the order book. Defaults to 5 if none of depth, sizeBuckets, or amountBuckets are specified.

priceIncrement
string

Price increment for market data aggregation (decimal string for precision)

Response

Successfully retrieved market data snapshot

data
MarketDataSnapshot · object[]
required

Array of market data snapshots