Smart-money (top-PnL cohort) positions on a coin

List the biggest open positions on one coin held by the 3x smart cohort (top 1% of wallets by realized PnL) with /v1/hyperliquid/positions?axis=pnl&cohort=3x_smart&sort=size.

GET /v1/hyperliquid/positions answers it in one call: filtered with axis=pnl&cohort=3x_smart and sorted with sort=size, it returns the largest current positions on one coin held by the top 1% of wallets by realized PnL. Each row carries the side, notional, entry, leverage, liquidation price, both cohort labels and the wallet's account_value. The full parameter list is on Positions.

Quick answer

sort=size needs a symbol.

cURL

# the five biggest BTC positions of 3x smart wallets right now
curl -H "X-API-Key: $VIKE_API_KEY" \
  "https://data.vike.io/v1/hyperliquid/positions?symbol=BTC&axis=pnl&cohort=3x_smart&sort=size&limit=5"

Example response

Captured from the live API on 2026-10-24 at 17:15 UTC, trimmed to 2 rows of 5; label_computed is left out. Four of the five biggest smart-money BTC positions were shorts; the largest is a $212M short at 5x against a $143M account, down $10.4M. size_usd, unrealized_pnl and account_value are USD; account_value is the wallet's native perp account. pnl_cohort_basis: current means the label is today's, which is the right one for a position open now.

Example response

{
  "positions": [
    {
      "wallet": "0x5b5d51203a0f9079f8aeb098a6523a13f298c060",
      "symbol": "BTC",
      "direction": "short",
      "size_token": 2637.9539,
      "size_usd": 211722443.80939,
      "entry_price": 76327.4353021245,
      "mark_price": 80260.1,
      "liquidation_price": 145332.3757904606,
      "unrealized_pnl": -10374188.177153,
      "leverage": 5.0,
      "leverage_type": "cross",
      "margin_used": 42344488.761878,
      "size_cohort": "4x whale",
      "pnl_cohort": "3x smart",
      "pnl_abs_cohort": "$1m+",
      "liq_progress": 0.05699105991606848,
      "dex_name": "HL",
      "snapshot_ts": "2026-10-24T17:07:00+00:00",
      "pnl_cohort_as_of": null,
      "pnl_cohort_basis": "current",
      "opened_at": "2026-07-16T10:29:00+00:00",
      "account_value": 142888148.427184
    },
    {
      "wallet": "0x15a4f009bb324a3fb9e36137136b201e3fe0dfdb",
      "symbol": "BTC",
      "direction": "long",
      "size_token": 1000.0,
      "size_usd": 80260100.0,
      "entry_price": 62353.654881179995,
      "mark_price": 80260.1,
      "liquidation_price": 57865.6982587716,
      "unrealized_pnl": 17906445.11882001,
      "leverage": 40.0,
      "leverage_type": "cross",
      "margin_used": 2006502.5,
      "size_cohort": "3x whale",
      "pnl_cohort": "3x smart",
      "pnl_abs_cohort": "$1m+",
      "liq_progress": 0.0,
      "dex_name": "HL",
      "snapshot_ts": "2026-10-24T17:07:00+00:00",
      "pnl_cohort_as_of": null,
      "pnl_cohort_basis": "current",
      "opened_at": "2026-07-06T11:24:00+00:00",
      "account_value": 8616650.730071
    }
  ],
  "nextCursor": null
}

Variations

The cohort's totals instead of its wallets. The newest settled hour of BTC's realized-PnL matrix: long and short notional and bias for every rung, smart ones first.

cURL — totals

# BTC positioning per pnl cohort, newest hour
curl -H "X-API-Key: $VIKE_API_KEY" \
  "https://data.vike.io/v1/hl-cohorts/symbols/BTC/cohort-metrics?axis=pnl&hours=1"

Every 3x smart position, not only the biggest. Without sort=size the rows come in wallet order and page with nextCursor, up to 5000 a page.

cURL — all of them

# all current 3x smart BTC positions, first page
curl -H "X-API-Key: $VIKE_API_KEY" \
  "https://data.vike.io/v1/hyperliquid/positions?symbol=BTC&axis=pnl&cohort=3x_smart&limit=5000"

The next rung down. 2x smart is the top 1% to 5%.

cURL — 2x smart

# the ten biggest HYPE positions of 2x smart wallets
curl -H "X-API-Key: $VIKE_API_KEY" \
  "https://data.vike.io/v1/hyperliquid/positions?symbol=HYPE&axis=pnl&cohort=2x_smart&sort=size&limit=10"

Before you rely on it

Rows come in wallet order unless you sort by size

Without sort=size, limit=10 is the first ten wallets in address order, never the ten biggest. sort=size needs symbol, takes at most 500 rows and has no cursor. account_value leaves out a builder DEX's separate account and is null, not 0, when it is unknown. The current label is today's grading: for positions at a past time, pass start and the rows carry the label of their own hour.

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_market tool answers (view positions), at 1 credit a call.

Ask your agent

What are the biggest BTC positions held by 3x smart wallets on Hyperliquid right now, with their account value?

Smart-money (top-PnL cohort) positions on a coin

Quick answer

Example response

Variations

Before you rely on it

Ask your agent

Related