---
title: "Get L2 Book"
method: GET
path: "/api/v1/hyperliquid/l2-book"
tags: ["Hyperliquid"]
---

# Get L2 Book

`GET /api/v1/hyperliquid/l2-book`

## Request

- Base URL: `https://cryptodataapi.com`
- URL: `https://cryptodataapi.com/api/v1/hyperliquid/l2-book`
- Auth: API key in header `X-API-Key`

L2 order book snapshot.

``ts`` (ms) is Hyperliquid's own timestamp for the book snapshot (from the
``l2Book`` payload's ``time`` field) — null only if HL omitted it. The
collector dedupes identical requests for 3s, so two calls inside that
window return the same ``ts``.

## Query parameters

- `coin` string, nullable: HL coin name (default BTC)
- `symbol` string, nullable: Alias for `coin` (the rest of the API says `symbol`). Send one or the other.

## Response `200`

Successful Response

- HLL2BookResponse: Hyperliquid L2 order book.
  - `coin` string, required
  - `bids` object[]
  - `asks` object[]
  - `ts` integer, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/cryptodataapi/apis/crypto-data-api.md) · [All operations](https://skmtc.dev/cryptodataapi/apis/crypto-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cryptodataapi/apis/crypto-data-api/revisions/8628b754ca81?raw)