Cascade
Markets

Get Order Book

Retrieve the order book for a market

GET
/book/{symbol}

Path Parameters

symbolstring

Identifies the market for which book data is desired

Query Parameters

depth?integer

Maximum depth of aggregated book to return. For example, if depth is set to 50, one could receive up to 100 results; 50 bids and 50 offers.

Range1 <= value <= 5000
tickSize?number

Price grouping tick size. Must be base_tick_size * multiplier. Valid multipliers: 1x, 2x, 5x, 10x, 100x, 1000x. Examples: if base_tick=0.01, 0.02, 0.05, 0.10, 1.00, 10.00

Formatfloat

Response Body

application/json

text/plain

text/plain

curl -X GET "https://matcher.cascade.xyz/book/SOLUSD?depth=4&tickSize=0.01"
{
  "asks": [
    {
      "price": "150.372",
      "quantity": "0.45"
    },
    {
      "price": "150.373",
      "quantity": "0.333334"
    },
    {
      "price": "150.378",
      "quantity": "1.39"
    },
    {
      "price": "150.382",
      "quantity": "2.6"
    }
  ],
  "bids": [
    {
      "price": "150.371",
      "quantity": "0.58"
    },
    {
      "price": "150.37",
      "quantity": "0.25"
    },
    {
      "price": "150.362",
      "quantity": "1.004"
    },
    {
      "price": "150.361",
      "quantity": "0.7511"
    }
  ],
  "sequence_number": 12345,
  "time": 1752798506
}
"Depth must be between 1 and 5000"
"Symbol not found"