---
title: "Liquidity Heatmap"
method: GET
path: "/v1/viz/liquidity_heatmap"
tags: ["viz", "viz"]
---

# Liquidity Heatmap

`GET /v1/viz/liquidity_heatmap`

## Request

- Base URL: `https://app.mrtrades.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.mrtrades.com/v1/viz/liquidity_heatmap`
- Auth: none declared

Shallow book size × price × time (ClickHouse when configured, else PG fallback).

## Query parameters

- `symbol` string, required
- `venue` string, nullable
- `range` '1h' | '4h' | '12h' | '1d' | '3d' | '7d' | '30d' | '90d' | 'max'
- `tf` '1m' | '5m' | '15m' | '30m' | '1h' | '4h'
- `depth_levels` integer

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

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