• English
  • Русский
  • TürkçeSoon
  • Português (Brasil)Soon
  • EspañolSoon
  • Tiếng ViệtSoon
  • 한국어Soon
  • DeutschSoon
Sign in

← All APIs

Hyperliquid Whale Positions & Liquidation Map API

The largest open positions on Hyperliquid, how they change and where they would be liquidated — from real on-chain positions.

  • Hyperliquid perpetuals
  • free plan

What's inside

  • Largest positions of the 500 most active accounts
  • Opened, added, reduced, closed and flipped positions
  • Liquidation map built from real positions

Endpoints

GET/marketsHyperliquid perpetual marketsBASIC
GET/whalesLargest open positionsBASIC
GET/statusPlan and data freshnessBASIC
GET/whales/eventsChanges in large positionsULTRA
GET/liquidation-map/{coin}Liquidation levels from open positionsULTRA
GET/signalsOrder-flow signals on HyperliquidULTRA

On the right: the plan that opens each endpoint.

Example

curl --request GET \
  --url 'https://hookscreener.com/v1/p/hyperliquid/markets' \
  --header 'X-API-Key: YOUR_KEY'

Questions

Whose positions are tracked?
The 500 most active Hyperliquid accounts by monthly volume (account value ≥ $250k), list refreshed every 6 hours, positions every 5 minutes. The liquidation map says how many accounts it covers.
Is the liquidation map an estimate?
No. It sums the liquidation prices of real open positions of the tracked accounts. Positions of other accounts are not in it.
How fresh is the data on each plan?
BASIC: 15-minute delay; PRO: 60-second delay; ULTRA: 15-second delay; MEGA: real time.
How far back can I query?
BASIC: no history; PRO: 7 days of history; ULTRA: 30 days of history; MEGA: 30 days of history. History is a rolling window counted from now; one request covers at most 24 hours.

Data from Hyperliquid perpetuals. Derived events and aggregates only: no raw order books, no trade tape, no detection rules. History is a rolling window up to 30 days back. The licence covers use inside your own application, bot, dashboard or research. Redistributing the data as a feed, an API or a dataset, or re-hosting it as an MCP server, is not allowed. Informational purposes only. Not financial advice.