Skip to main content
GET
/
public
/
GroupedBook
Get Grouped Order Book
curl --request GET \
  --url https://api.kraken.com/0/public/GroupedBook
{
  "error": [],
  "result": {
    "pair": "BTC/USD",
    "grouping": 1000,
    "bids": [
      {
        "price": "90400.00000",
        "qty": "19.83057746"
      },
      {
        "price": "90300.00000",
        "qty": "45.35073006"
      },
      {
        "price": "90200.00000",
        "qty": "35.33199856"
      },
      {
        "price": "90100.00000",
        "qty": "32.40807838"
      },
      {
        "price": "90000.00000",
        "qty": "46.00445468"
      },
      {
        "price": "89900.00000",
        "qty": "22.71486458"
      },
      {
        "price": "89800.00000",
        "qty": "11.55482018"
      },
      {
        "price": "89700.00000",
        "qty": "13.77715743"
      },
      {
        "price": "89600.00000",
        "qty": "27.72185770"
      },
      {
        "price": "89500.00000",
        "qty": "14.09383330"
      }
    ],
    "asks": [
      {
        "price": "90500.00000",
        "qty": "38.96185061"
      },
      {
        "price": "90600.00000",
        "qty": "55.96402032"
      },
      {
        "price": "90700.00000",
        "qty": "34.64783055"
      },
      {
        "price": "90800.00000",
        "qty": "25.26797469"
      },
      {
        "price": "90900.00000",
        "qty": "20.48922196"
      },
      {
        "price": "91000.00000",
        "qty": "14.87773628"
      },
      {
        "price": "91100.00000",
        "qty": "18.99740224"
      },
      {
        "price": "91200.00000",
        "qty": "19.00592802"
      },
      {
        "price": "91300.00000",
        "qty": "4.05573682"
      },
      {
        "price": "91400.00000",
        "qty": "1.60667017"
      }
    ]
  }
}

Query Parameters

​
pair
string
required

Asset pair to get order book for

​
depth
enum<integer>
default:10

The number of price levels to return per side (bids/asks).

Available options:
10,
25,
100,
250,
1000
​
grouping
enum<integer> | null
default:1

Specifies how many tick levels should be within each price level. Bids and asks between grouped price levels are accumulated to the nearest passive level (asks rounded up, bids down).

Available options:
1,
5,
10,
25,
50,
100,
250,
500,
1000

Response

200 - application/json

Grouped order book data retrieved.

​
result
object
​
error
string[][]

Kraken API error