---
title: "L4 order book whales"
method: GET
path: "/api/public/v1/market/book/whales/{coin}"
tags: ["Market"]
---

# L4 order book whales

`GET /api/public/v1/market/book/whales/{coin}`

Who is sitting on a book: the largest resting orders (wallet, side, price, size, distance from mid, tif, order type, rest duration) and the biggest wallets per side by total resting size. Wallet addresses join to the trader routes. Snapshot-derived, refreshed every 60s, latest-only.

## Path parameters

- `coin` string, required — Coin in the node's own spelling, case-sensitive. Not normalized. Spot pairs (names containing '/') are not addressable on this path.

## Query parameters

- `limit` integer — How many orders, and how many wallets per side, to return.

## Response `200`

OK

- object

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `422` — Unprocessable Entity
- `429` — Too Many Requests
- `500` — Internal Server Error
- `503` — Service Unavailable
- `504` — Gateway Timeout

## Changes

- **2026-09-23** `f2eba29805e5` — 9 info
  - added the non-success response with the status `403`
  - removed the non-success response with the status `401`
  - added the optional property `reason` to the response with the `400` status
  - added the optional property `reason` to the response with the `404` status
  - …5 more
- **2026-09-17** `d38edae62711` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/coinversa/apis/coinversa-api/changes/api/public/v1/market/book/whales/:coin/get.md)

---

[API](https://skmtc.dev/coinversa/apis/coinversa-api.md) · [All operations](https://skmtc.dev/coinversa/apis/coinversa-api/llms.txt) · [OpenAPI document](https://skmtc.dev/coinversa/apis/coinversa-api/revisions/f2eba29805e5?raw)