---
title: "Live order book depth and slippage"
method: GET
path: "/api/v1/book"
tags: ["Order book"]
---

# Live order book depth and slippage

`GET /api/v1/book`

## Request

- Base URL: `https://marginpad.io`
- URL: `https://marginpad.io/api/v1/book`
- Auth: none declared

The resting order book for one coin, reconstructed in real time from the websockets of Bybit, OKX, Bitget and Hyperliquid (snapshot plus incremental updates, every update checked against the venue's own sequence number). Per venue: best bid/ask, spread in bps, how many levels we hold and how far from mid they reach, depthUsd = resting dollars within 1/2/5/10/25 bps of mid, and slipBps = the measured cost of a market order of $10k/$50k/$250k walking that book. Plus consolidatedDepthUsd across all venues. Freshness (ageMs) is measured from OUR receive time, never the venue clock. Depth is quoted at bp DISTANCES, not as "liquidity within 2%" - a major-coin book only reaches about 0.03-0.24% from mid, so a wider band would be mostly empty. A venue whose book cannot be proven correct is omitted, and a symbol with no provable book returns 404 rather than a plausible wrong number. Passthrough from the collector: raw object, NOT the { ok, data, ts } envelope.

## Query parameters

- `symbol` string, required
- `levels` string

## Response `200`

Raw collector object (no envelope)

## Other responses

- `404`: No provable book for that symbol

---

[API](https://skmtc.dev/marginpad/apis/marginpad-free-crypto-api.md) · [All operations](https://skmtc.dev/marginpad/apis/marginpad-free-crypto-api/llms.txt) · [OpenAPI document](https://skmtc.dev/marginpad/apis/marginpad-free-crypto-api/revisions/27d21fcd0bf0?raw)