/coins/{coin}/size-breakdown

GET https://data.vike.io/v1/hyperliquid/coins/{coin}/size-breakdown

Positioning for one coin split by the canonical ten position-size buckets — the same ladder, spellings and bounds as axis=tier on /coins/{coin}/cohort-metrics. Empty buckets come back zero-filled so the table shape is stable.

Truncated: the array holds all 10 tiers, largest first; the first 3 are shown.

cURL

# BTC notional, position count and long/short bias in each of the ten position-size buckets
curl -s "https://data.vike.io/v1/hyperliquid/coins/BTC/size-breakdown" \
  -H "X-API-KEY: $VIKE_API_KEY"

# the same split for ETH: whale-sized positions versus retail-sized ones
curl -s "https://data.vike.io/v1/hyperliquid/coins/ETH/size-breakdown" \
  -H "X-API-KEY: $VIKE_API_KEY"

# which size bucket carries the most notional close to liquidation
curl -s "https://data.vike.io/v1/hyperliquid/coins/BTC/size-breakdown" \
  -H "X-API-KEY: $VIKE_API_KEY" \
  | jq 'sort_by(.value_close_to_liquidation) | reverse | .[0] | {tier, position_count, value_close_to_liquidation}'

# bias per bucket: who is net long and who is net short, largest positions first
curl -s "https://data.vike.io/v1/hyperliquid/coins/BTC/size-breakdown" \
  -H "X-API-KEY: $VIKE_API_KEY" \
  | jq 'map({tier, bias})'

coinpathrequired

HL coin ticker

Example response

[
  {
    "tier": ">$2.5m",
    "min_size": 2500000.0,
    "max_size": null,
    "position_count": 177,
    "total_position_value": 2115975888.0,
    "total_position_value_long": 1033347966.0,
    "value_close_to_liquidation": 41070622.45,
    "bias": -0.02328946914
  },
  {
    "tier": "$1m-$2.5m",
    "min_size": 1000000.0,
    "max_size": 2500000.0,
    "position_count": 183,
    "total_position_value": 292004085.3,
    "total_position_value_long": 146257572.2,
    "value_close_to_liquidation": 17869289.39,
    "bias": 0.001750177871
  },
  {
    "tier": "$500k-$1m",
    "min_size": 500000.0,
    "max_size": 1000000.0,
    "position_count": 237,
    "total_position_value": 162494247.6,
    "total_position_value_long": 91367908.78,
    "value_close_to_liquidation": 10808042.57,
    "bias": 0.1245679168
  }
]

No query parameters.