---
title: "Get market data snapshot"
method: GET
path: "/trading/marketdata"
tags: ["Trading"]
---

# Get market data snapshot

`GET /trading/marketdata`

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

Get real-time market data snapshot for a trading symbol from the liquidity provider.

## Query parameters

- `symbol` string, required
- `accountId` string
- `subaccountId` string
- `sizeBuckets` string[]
- `amountBuckets` string[]
- `depth` integer
- `priceIncrement` string

## Response `200`

Successfully retrieved market data snapshot

- MarketDataResponse
  - `data` MarketDataSnapshot[], required — Array of market data snapshots
    - `amountBuckets` string[] — Amount buckets used for market depth aggregation. Returns the USD amount values that were requested in the query. Empty array if amount buckets were not requested.
    - `bids` PriceLevel[], required — Array of bid price levels
      - `amount` string — Amount (in counter currency) available at this price level as a decimal string. Returned when amountBuckets parameter is used.
      - `price` string, required — Price level as a decimal string
      - `size` string — Size available at this price level as a decimal string. Returned when sizeBuckets parameter is used.
    - `offers` PriceLevel[], required — Array of offer price levels
      - `amount` string — Amount (in counter currency) available at this price level as a decimal string. Returned when amountBuckets parameter is used.
      - `price` string, required — Price level as a decimal string
      - `size` string — Size available at this price level as a decimal string. Returned when sizeBuckets parameter is used.
    - `sizeBuckets` string[] — Size buckets used for market depth aggregation. Returns the BTC size values that were requested in the query. Empty array if size buckets were not requested.
    - `spread` string — Current spread as a decimal string
    - `status` string — Market status
    - `symbol` string, required — Trading pair symbol
    - `timestamp` string, date-time, required — UTC timestamp of the market data snapshot. [RFC 3339](https://datatracker.ietf.org/doc/html/rfc3339#section-5.6) 'date-time'.

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