Contents

Smart-money convergence

Smart-money convergence: events when at least K (default 3) of the top all-time-PnL Hyperliquid wallets (without vaults, market makers by fill counts and turnover, and delta-neutral books) open or add the same side of a coin within the window (default 60 min), plus the current positioning of these wallets and the filter statistics.

GET/api/v1/smart-moneyEvery key

Description

Events are delayed for free keys (meta.delayMinutes).

Who can call it

Available with every key and keyless (X-Blockmetric-Access: public). Keys of Free accounts get free-tier data (real-time feeds, 30 days of history, heatmap over time for every coin over the last 24 hours, liquidation levels now for every coin, the same as the free web plan); Pro and Desk keys the data of their plan; API Dev / API Pro raise the limits.

No key: 24 h
Free: 30 days
Pro: 365 days
Desk: 1095 days
API Dev: 365 days
API Pro: 1095 days

History window per plan. Limits: Authentication & limits.

Parameters

Parameters of /smart-money
Parameter	Description
`coin`string	Only this coin (optional).
`limit`integer	Number of items, default 30, clamped to 1–200.1–200 · default 30

Response fields

Every success is { data, meta }; these are the fields of data. meta is the same on every endpoint.

Response fields of /smart-money
Field	Description
`events[]`array of objects	Events of this view (newest first) or their count.
`events[].id`integer	Stable id of the item; on paginated feeds the order key together with ts.
`events[].ts`string (ISO 8601)	Time of the event (ISO 8601 UTC).
`events[].coin`string · nullable	Coin name as on Hyperliquid (BTC, kPEPE, HIP-3 names like xyz:TSLA).
`events[].severity`integer	1 info, 2 notable, 3 major, 4 critical.
`events[].title`string	One-line factual title in our own words.
`events[].side`"long" \| "short" · nullable	Position side (for liquidations: the side of the liquidated position).
`events[].count`integer · nullable	Wallets that converged.
`events[].usd`number · nullable	Notional in USD.
`events[].wallets[]`array of objects	Number of distinct wallets.
`events[].wallets[].address`string	Hyperliquid address, lowercase.
`events[].wallets[].usd`number	Notional in USD.
`events[].wallets[].ts`string (ISO 8601)	Time of the event (ISO 8601 UTC).
`events[].wallets[].lists[]`array of "allTime" \| "month" \| "roi"	Smart-money lists the wallet was on at the time of the event (events from 2026-11-03 on).
`positioning[]`array of objects	Open tracked positions of the smart wallets.
`positioning[].coin`string	Coin name as on Hyperliquid (BTC, kPEPE, HIP-3 names like xyz:TSLA).
`positioning[].longUsd`number	Long notional in USD.
`positioning[].shortUsd`number	Short notional in USD.
`positioning[].longWallets`integer	Wallets on the long side.
`positioning[].shortWallets`integer	Wallets on the short side.
`positioning[].updatedAt`string (ISO 8601) · nullable	Newest poll of these positions.
`wallets`integer	Smart wallets after the filters.
`candidates`integer	Leaderboard wallets checked from the top of the lists (smart wallets plus excluded ones).
`excluded`object	Excluded wallets per reason.
`excluded.vault`integer	Hyperliquid vaults (including HLP).
`excluded.many_positions`integer	Deprecated: use manyPositions (same value).
`excluded.resting_orders`integer	Deprecated: use restingOrders (same value).
`excluded.high_fills`integer	Deprecated: use highFills (same value).
`excluded.turnover`integer	Wallets whose 30-day volume is a large multiple of the account value (market making / HFT).
`excluded.hedged`integer	Delta-neutral books (long and short notional nearly equal).
`excluded.manyPositions`integer	Wallets with many open positions (market makers, multi-asset algos).
`excluded.restingOrders`integer	Wallets with many resting limit orders (a quoted book).
`excluded.highFills`integer	Wallets with very many fills per hour (market making).
`excluded.notTrading`integer	All-time PnL above 20 × the all-time volume (token holdings, airdrops).
`delayMinutes`integer	Minutes the events are delayed for the caller’s plan (0 = real time).
`settings`object	Detector settings in force.
`settings.k`integer	Wallets needed for a convergence event.
`settings.windowMin`number	Window of a convergence in minutes.
`settings.minUsd`number	Minimum position change per wallet in USD.
`settings.top`integer	All-time PnL list size.
`settings.monthTop`integer	30-day PnL list size (0 = off).
`settings.monthMinAccountUsd`number	Lowest account value of the 30-day list (USD).
`settings.monthMinRoi`number	Lowest 30-day ROI as a fraction (0.05 = 5 %).
`settings.roiTop`integer	All-time ROI list size (0 = off).
`settings.roiMinAccountUsd`number	Lowest account value of the ROI list (USD).
`settings.roiMinPnlUsd`number	Lowest all-time PnL of the ROI list (USD).
`settings.maxWallets`integer	Most smart wallets in all.
`method`string	How the figures are computed, in plain words.
`lists`object	Wallets per list after the filters (a wallet on two lists counts on both).
`lists.allTime`object	-
`lists.allTime.wallets`integer	Number of distinct wallets.
`lists.allTime.floor`number · nullable	Ranking value of the last wallet on the list: all-time or 30-day PnL in USD, all-time ROI as a fraction.
`lists.month`object	-
`lists.month.wallets`integer	Number of distinct wallets.
`lists.month.floor`number · nullable	Ranking value of the last wallet on the list: all-time or 30-day PnL in USD, all-time ROI as a fraction.
`lists.roi`object	-
`lists.roi.wallets`integer	Number of distinct wallets.
`lists.roi.floor`number · nullable	Ranking value of the last wallet on the list: all-time or 30-day PnL in USD, all-time ROI as a fraction.
`leaderboardAt`string (ISO 8601) · nullable	Newest Hyperliquid leaderboard run the set is built from.

Errors

400invalid_param Invalid parameter
401unauthorized Missing or invalid API key
403plan_required Plan does not include this
403scope_required Key not scoped for this API
403ip_not_allowed Address not on the IP allowlist of the key
403origin_not_allowed Key used from a browser origin it does not allow
403source_restricted Exchange data not redistributed
403https_required https required
429rate_limited Per-minute limit reachedretry
429daily_limit_exceeded Daily limit reachedretry
429stream_limit Too many open streamsretry
500internal_error Internal errorretry

Methodology

Smart money (how it is computed and its limits)

Request

curl -s -H "X-Blockmetric-Access: public" \
  "https://api.blockmetric.io/v1/smart-money?limit=10"

Example response

HTTP 200Real data

{
  "data": {
    "events": [],
    "positioning": [
      {
        "coin": "BTC",
        "longUsd": 147457920.25,
        "shortUsd": 112147433.25,
        "longWallets": 8,
        "shortWallets": 12,
        "updatedAt": "2026-10-27T13:11:20.471Z"
      },
      {
        "coin": "HYPE",
        "longUsd": 196677230.4,
        "shortUsd": 56889464.66,
        "longWallets": 9,
        "shortWallets": 14,
        "updatedAt": "2026-10-27T13:11:30.881Z"
      }
    ],
    "wallets": 418,
    "candidates": 500,
    "excluded": {
      "many_positions": 26,
      "vault": 5,
      "turnover": 25,
      "high_fills": 14,
      "resting_orders": 7,
      "hedged": 5,
      "manyPositions": 26,
      "restingOrders": 7,
      "highFills": 14
    },
    "delayMinutes": 0,
    "settings": {
      "k": 3,
      "windowMin": 60,
      "minUsd": 100000,
      "top": 500
    },
    "method": "Smart money = the 500 wallets with the highest all-time PnL on the Hyperliquid leaderboard, without vaults, market makers (20+ open positions, 50+ resting limit orders, 200+ fills in an hour on our trade stream, or 30-day volume ≥ 50 × account value) and delta-neutral books. A convergence event fires when ≥ 3 of them open or add the same side of a coin within 60 min (≥ $100K each) and at most half as many add the other side."
  },
  "meta": {
    "updatedAt": null,
    "source": "hyperliquid",
    "sources": [
      "hyperliquid"
    ],
    "plan": "api_dev",
    "delayMinutes": 0,
    "commercial": false,
    "license": {
      "id": "internal",
      "display": false,
      "attributionRequired": false,
      "attribution": null,
      "redistribution": false,
      "mauCap": null,
      "terms": "https://blockmetric.io/terms#api-license"
    },
    "attribution": {
      "text": "Data by Blockmetric · Source: Blockmetric Research",
      "url": "https://blockmetric.io/"
    },
    "access": {
      "historyDays": 365,
      "historyFrom": "2025-10-27T13:14:00.000Z"
    }
  }
}

More options: open in the explorer · SDK method smartMoney() / smart_money()

Code snippets in these docs are licensed under MIT-0: copy them into your own code without attribution. The SDKs, CLI and MCP server will be, once published, Apache-2.0; the name Blockmetric is not licensed (forks must be renamed). Data from the API is governed by the API terms; third-party exchange data by the exchange’s terms.