Perps - Token Liquidation Map

get

https://public-api.birdeye.so/perps/v1/token/liquidation_map

Recent Requests

Log in to see full request history

Time	Status	User Agent
Retrieving recent requests…

Loading…

Returns price buckets around the current market with estimated liquidation exposure for longs and shorts.
Each row is a bucket bounded by low_price and high_price.
cum_* fields accumulate liquidation exposure from the current price toward that bucket, while non-cumulative fields describe only that bucket.
Data availability begins on May 25, 2026 at 15:00 UTC.

Use Cases 💡

Visualize liquidation clusters above and below the current price.
Build squeeze maps that show where cascading liquidations may accelerate moves.
Add liquidation heatmaps to perp market pages and trader workstations.
Stress-test market scenarios using cumulative long and short liquidation exposure.

How to Use 🛠️

Set x-perp and pass the market symbol in token.
Plot low_price to high_price as buckets on a price axis.
Use long_liq_value and short_liq_value for local bucket intensity.
Use cum_long_liq_value and cum_short_liq_value for path-dependent liquidation buildup.

Best Practices ✅

Separate local bucket exposure from cumulative exposure in your charts and alerts.
Overlay the liquidation map with current price, recent volatility, and open interest for context.
Recompute views frequently around fast-moving markets because liquidation surfaces can shift quickly.

Limitations ⚠️

Hyperliquid only.

Responses

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json