Sign in

v1

latestOpenAPI 3.0.02026-08-04134348905.1 KB
Trading

Get market data snapshot

Permissions required: Execute trades or Read trade activity

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

get/trading/marketdata

Query parameters

symbolstring required

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

accountIdstring

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

subaccountIdstring

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

sizeBucketsstring[]

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

amountBucketsstring[]

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.

depthinteger

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.

priceIncrementstring

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

Response

Successfully retrieved market data snapshot

Example response

{
  "data": [
    {
      "amountBuckets": [
        "1000",
        "5000",
        "10000"
      ],
      "bids": [
        {
          "amount": "100.00000000",
          "price": "101022.85",
          "size": "1.00000000"
        }
      ],
      "offers": [
        {
          "amount": "100.00000000",
          "price": "101022.85",
          "size": "1.00000000"
        }
      ],
      "sizeBuckets": [
        "1",
        "5",
        "10"
      ],
      "spread": "0.001",
      "status": "Online",
      "symbol": "BTC-USD",
      "timestamp": "2025-05-08T16:17:01.863332Z"
    }
  ]
}