Skip to content

Get Orderbook​

GET
/v1/perps/orderbook/{pair}

Return the top 5 levels of bids and asks for the pair. Each level is a three-element array
[price, quantity, orderCount]; the best price is first on each side. Depth is fixed at 5
levels per side. updatedAt is the book time in epoch milliseconds.

Authorizations​

apiKey

Your API key

Type
API Key (header: X-VALR-API-KEY)
+
apiSignature

HMAC SHA512 signature of the request (see Authentication section)

Type
API Key (header: X-VALR-SIGNATURE)
+
apiTimestamp

Request timestamp in milliseconds

Type
API Key (header: X-VALR-TIMESTAMP)

Parameters​

Path Parameters

pair*

The pair symbol, e.g. BTCUSDC.

Type
string
Required

Responses​

Orderbook retrieved successfully

application/json

Playground​

Authorization
Variables
Key
Value

Samples​