Recipe 17 of 65
Am I about to be liquidated? Hyperliquid wallet risk report
/positions?wallet= returns every open position with its liquidation price, mark price and liq_progress, and /wallets/{address} adds account value and exposure; together they show how far each position is from liquidation.
GET /v1/hyperliquid/positions answers it in one call with wallet set: the wallet's open positions as of the latest
snapshot, each with mark_price, liquidation_price, leverage_type and liq_progress, the share of the
entry-to-liquidation distance already used. GET /v1/hyperliquid/wallets/{address} adds the account side: account
value, unrealized PnL and how large the open book is against the equity. The full parameter lists are on
Positions and Wallet summary.
Quick answer
Pass the address as wallet.
# every open position of the wallet with its liquidation price
curl -H "X-API-Key: $VIKE_API_KEY" \
"https://data.vike.io/v1/hyperliquid/positions?wallet=0xfc667adba8d4837586078f4fdcdc29804337ca06&limit=5"Example response
Captured from the live API on 2026-10-24 at 17:16 UTC, trimmed to 3 of 5 rows. label_computed is cut to its first keys and the legacy asset
copy of symbol is left out.
The $19.6M BTC short would be liquidated at $274,567, more than three times the mark of $80,209, and liq_progress is
0 because it is in profit. The HYPE and NEAR longs show a liquidation_price of 0: no liquidation price was reported
for them. None of the three is close.
{
"positions": [
{
"wallet": "0xfc667adba8d4837586078f4fdcdc29804337ca06",
"symbol": "BTC",
"direction": "short",
"size_token": 244.26271,
"size_usd": 19592067.70639,
"entry_price": 81947.34275814347,
"mark_price": 80209.0,
"liquidation_price": 274567.3214235628,
"unrealized_pnl": 424612.3130129976,
"leverage": 0.0,
"leverage_type": "cross",
"margin_used": 19592067.70639,
"size_cohort": "4x whale",
"pnl_cohort": "3x smart",
"pnl_abs_cohort": "$1m+",
"liq_progress": 0.0,
"dex_name": "HL",
"snapshot_ts": "2026-10-24T17:12:00+00:00",
"pnl_cohort_as_of": null,
"pnl_cohort_basis": "current",
"opened_at": "2026-04-08T05:27:00+00:00"
},
{
"wallet": "0xfc667adba8d4837586078f4fdcdc29804337ca06",
"symbol": "HYPE",
"direction": "long",
"size_token": 7535.97,
"size_usd": 569191.8141000001,
"entry_price": 75.35654401755845,
"mark_price": 75.53,
"liquidation_price": 0.0,
"unrealized_pnl": 1307.159080000068,
"leverage": 5.0,
"leverage_type": "cross",
"margin_used": 113838.36282000001,
"size_cohort": "4x whale",
"pnl_cohort": "3x smart",
"pnl_abs_cohort": "$1m+",
"liq_progress": 0.0,
"dex_name": "HL",
"snapshot_ts": "2026-10-24T17:12:00+00:00",
"pnl_cohort_as_of": null,
"pnl_cohort_basis": "current",
"opened_at": "2026-04-29T16:58:00+00:00"
},
{
"wallet": "0xfc667adba8d4837586078f4fdcdc29804337ca06",
"symbol": "NEAR",
"direction": "long",
"size_token": 857137.9,
"size_usd": 3791120.9317,
"entry_price": 4.45238263796759,
"mark_price": 4.423,
"liquidation_price": 0.0,
"unrealized_pnl": -25184.972604000264,
"leverage": 10.0,
"leverage_type": "cross",
"margin_used": 379112.09317,
"size_cohort": "4x whale",
"pnl_cohort": "3x smart",
"pnl_abs_cohort": "$1m+",
"liq_progress": 0.0,
"dex_name": "HL",
"snapshot_ts": "2026-10-24T17:12:00+00:00",
"pnl_cohort_as_of": null,
"pnl_cohort_basis": "current",
"opened_at": "2026-10-12T22:48:00+00:00"
}
],
"nextCursor": "eyJhIjoiUEFYRyIsImQiOjEsIm0iOiJsYXRlc3QiLCJ0IjoiMjAyNi0xMC0yNCAxNzoxMjowMCIsInciOiIweGZjNjY3YWRiYThkNDgzNzU4NjA3OGY0ZmRjZGMyOTgwNDMzN2NhMDYifQ",
"label_computed": {
"grading": "realized",
"lookahead": false,
"resolution": "none — one label per wallet, today's"
}
}Variations
The account side. Equity, open book and exposure from the wallet summary.
# account value, unrealized PnL and exposure against equity
curl -s -H "X-API-Key: $VIKE_API_KEY" \
"https://data.vike.io/v1/hyperliquid/wallets/0xfc667adba8d4837586078f4fdcdc29804337ca06" \
| jq '{equity, open_positions}'Captured from the live API on 2026-10-24 at 17:16 UTC with window=7d, the output of that jq filter; these two
blocks do not depend on window.
{
"equity": {
"as_of": "2026-10-24T17:12:00+00:00",
"account_value": 48766377.678561,
"margin_used": 1977108.82216,
"cash_balance_usd": 67656948.627741,
"total_unrealized_pnl": 2121446.482,
"num_positions": 68
},
"open_positions": {
"count": 68,
"notional_usd": 101352029.132086,
"unrealized_pnl": 2121446.4822189976,
"margin_used": 50605822.522593156,
"perp_bias": -0.3835577207,
"equity_exposure": 0.6408813899,
"as_of": "2026-10-24T17:12:00+00:00",
"dexes": [
"HL",
"IO",
"MKTS",
"XYZ"
],
"opened_within": "all",
"oldest_opened_at": "2026-04-02T08:36:00+00:00",
"newest_opened_at": "2026-10-12T22:48:00+00:00",
"with_known_open_ts": 68
}
}68 open positions worth $101M on $48.8M of equity. equity_exposure 0.64 is the main-venue long plus short notional
over the account value, and perp_bias -0.38 says the book leans short.
Closest positions first, with a distance. Sort the wallet's positions by liq_progress and add the distance from mark to liquidation in percent.
# positions ranked by buffer used, with the distance to the liquidation price
curl -s -H "X-API-Key: $VIKE_API_KEY" \
"https://data.vike.io/v1/hyperliquid/positions?wallet=0xfc667adba8d4837586078f4fdcdc29804337ca06&limit=200" \
| jq '[.positions[] | select(.liquidation_price > 0) | {symbol, direction, size_usd, mark_price, liquidation_price, liq_progress, distance_pct: ((.mark_price - .liquidation_price) / .mark_price * 100 | fabs)}] | sort_by(-.liq_progress) | .[:10]'Before you rely on it
A 5-minute snapshot of a cross-margin account
Rows come from the latest position snapshot, about 5 minutes old at best, and a fast move can liquidate a position
between two snapshots. With leverage_type cross, the liquidation price depends on the whole account, so another
position's loss moves it. Positions on builder-deployed DEXes margin from separate accounts, and equity_exposure and
perp_bias count main-venue positions only. A leverage of 0 means none was reported, not an unleveraged position.
Ask your agent
Connected to the Vike MCP server (https://vike.io/mcp) in Claude, ChatGPT or Cursor, ask it in plain words.
The hl_wallet tool answers the account side with view: summary, and hl_market with view: positions and the wallet lists each position's liquidation price, at 1 credit a call each.
Is Hyperliquid wallet 0xfc667adba8d4837586078f4fdcdc29804337ca06 close to liquidation on any position?