Get order book

GET 
/{market}/book

Returns the list of up to 1000 bids and asks per request for the specified market, sorted by price.

info

This is a public endpoint. However, authenticating your request gives you a higher rate limit.

Rate limit weight points: 1

Request

Path Parameters

market stringrequired
The market for which to return the order book.
Example: BTC-EUR

Query Parameters

depth integer
Possible values: <= 1000
The number of bids and asks to return.
Default value: 1000

Responses

200

The request was successful.

Response Headers

bitvavo-ratelimit-remaining

The number of remaining weight points before it resets at bitvavo-ratelimit-resetat.

bitvavo-ratelimit-resetat

The time when bitvavo-ratelimit-remaining resets to bitvavo-ratelimit-limit.

bitvavo-ratelimit-limit

The number of available weight points in one minute.

application/json

Schema

Schema

marketstring
The market for which the order book is returned.
Example: BTC-EUR
nonceinteger
Unique identifier of the market data in the order book at a specific time. nonce is incremented by 1 every time the order book changes. For example, when an order is placed, updated, or deleted.
Example: 438524
bidsarray[]
The list of buy orders for the specified market and depth. Every bid contains:
• price: the offer for 1 unit of base currency in the amount of quote currency. For example, 34243 Euros.

• size: the amount of base currency in the offer. For example, 0.1 Bitcoin.
Example: [["4999.9","0.015"],["4999.8","0.015"],["4999.7","0.015"],["4999.6","0.015"]]
asksarray[]
The list of sell orders for the specified market and depth. Every bid contains:
• price: the offer for 1 unit of base currency in the amount of quote currency. For example, 34243 Euros.

• size: the amount of base currency in the offer. For example, 0.1 Bitcoin.
Example: [["5001.1","0.015"],["5001.2","0.015"],["5001.3","0.015"],["5001.4","0.015"]]
timestampinteger<unix-timestamp in nanoseconds>
A Unix timestamp when the snapshot was taken.
Example: 1542967486256

Example (body)

{
  "market": "BTC-EUR",
  "nonce": 438524,
  "bids": [
    [
      "4999.9",
      "0.015"
    ],
    [
      "4999.8",
      "0.015"
    ],
    [
      "4999.7",
      "0.015"
    ],
    [
      "4999.6",
      "0.015"
    ]
  ],
  "asks": [
    [
      "5001.1",
      "0.015"
    ],
    [
      "5001.2",
      "0.015"
    ],
    [
      "5001.3",
      "0.015"
    ],
    [
      "5001.4",
      "0.015"
    ]
  ],
  "timestamp": 1542967486256
}