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

# L4 order book stop map

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

Where the stops are: every untriggered stop / take-profit order bucketed by distance from mid in 0.25% steps out to within_pct, with per bucket the count, size, reduce-only share, stop vs take-profit split and side split — plus totals below and above mid, the nearest trigger each side, and how many sit beyond the window. 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

- `within_pct` integer — Half-width of the bucketed window, in percent of mid. The stored map always covers ±10%; this slices it.

## 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/stops/: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)