# Blockmetric > Crypto market data, measured block by block. Real-time crypto market intelligence: liquidation heatmap and levels from real Hyperliquid on-chain positions, liquidations across Hyperliquid, Lighter, Binance and Bybit, whale positions with public labels, funding, open interest, long/short ratios and a risk radar (big liquidations, cascades, exploits, depegs). Read-only JSON API, Bearer key auth. Data from public sources, not investment advice. Base URL: https://api.blockmetric.io/v1 · Auth: `Authorization: Bearer bm_live_…` (keys on https://blockmetric.io/account/api) or, without a key, `X-Blockmetric-Access: public` (free tier, 24 h of history, 10 requests/min per IP) · Envelope: `{ data, meta }`, errors `{ error: { code, message, doc_url, request_id } }` · Times ISO 8601 UTC, money USD, funding and distances as fractions (0.01 = 1 %) · Pagination: `limit` + `cursor` = `meta.nextCursor` · ETag / If-None-Match supported. Limits per account: Free 10/min 1000/day; Pro 20/min 5000/day; Desk 30/min 10000/day; API Dev 60/min 50000/day; API Pro 300/min 500000/day (commercial). 429 responses carry Retry-After. ## Pages - [Liquidation heatmap](https://blockmetric.io/heatmap): Live crypto liquidation heatmap from the real liquidation prices of Hyperliquid positions: see where longs and shorts get liquidated. Free, every coin. - [Crypto futures screener](https://blockmetric.io/markets): Screen every crypto perpetual in one live table: price change, open interest, funding, long/short, 24h liquidations, RSI and volatility. Sort any column. - [Crypto liquidations · 24h](https://blockmetric.io/liquidations): Crypto liquidated in the last 24 hours, 7 or 30 days: the live total, longs vs shorts, every exchange and coin, an hourly chart and the largest orders. - [Largest crypto liquidations](https://blockmetric.io/liquidations/largest): The biggest single crypto liquidations of today (UTC) and the past 7 days: coin, side, size, price and exchange, as the exchanges publish them. - [Funding rates](https://blockmetric.io/funding): Live crypto funding rates on every exchange we track, annualised: current and predicted funding, the spread between venues and the widest funding gaps. - [Long/short ratio](https://blockmetric.io/long-short): Who is long and who is short, per coin: the Hyperliquid long/short ratio from real open positions in USD, exchange ratios as published, with history. - [Crypto exchange data](https://blockmetric.io/exchanges): Compare crypto derivatives exchanges side by side: 24h liquidations, open interest and funding per exchange, live from their public market data. - [Crypto market sentiment](https://blockmetric.io/sentiment): Blockmetric Sentiment is our own 0 to 100 index of crypto market mood, built live from momentum, volatility, funding, open interest and liquidations. - [Coin data](https://blockmetric.io/coins): Pick a coin and see its live liquidation levels, 24h liquidations, funding, open interest, long/short ratio and largest whale positions on one page. - [Whale tracker](https://blockmetric.io/whales): Follow Hyperliquid whales live: the largest positions with entry, liquidation price and stops, plus big on-chain transfers, exchange flows and DEX trades. - [Hyperliquid trader leaderboard](https://blockmetric.io/traders): The top Hyperliquid traders ranked by PnL and ROI from 1 day to all-time, from the official leaderboard, with their win rate, holding time and drawdown. - [Hyperliquid vaults](https://blockmetric.io/traders/vaults): Every Hyperliquid vault ranked by TVL, APR and PnL over 7 days, 30 days and all-time, with its leader, followers, commission and age. - [Crypto market map](https://blockmetric.io/markets/map): The whole crypto market at a glance: a live treemap of every perpetual we track, sized by open interest or 24h volume, coloured by the 24h price change. - [Correlation to Bitcoin](https://blockmetric.io/markets/correlation): How closely large crypto markets move with Bitcoin: correlation and beta over 30 days, 90 days and a year of daily returns from our stored candles. - [Crypto news wire](https://blockmetric.io/news): What just happened in crypto derivatives, live: liquidation cascades, whale moves, hacks and new Hyperliquid listings, each linked to its evidence. - [Security news](https://blockmetric.io/security/news): Live crypto security news: hacks, exploits, stablecoin depegs, oracle deviations and moves of sanctioned or hacker wallets, each with its evidence. - [Crypto hacks & exploits](https://blockmetric.io/security/incidents): Every verified crypto hack and exploit in one list: date, reported loss, chain, attack type and primary sources, newest first, in our own words. - [Listed wallets](https://blockmetric.io/security/wallets): Crypto wallets listed by the OFAC SDN list, FBI announcements and official post-mortems, with the source of each listing and their on-chain moves. - [Crypto liquidation reports](https://blockmetric.io/reports): A crypto liquidation report every Monday, plus daily and quarterly ones: the biggest liquidations, cluster hits, whale moves, funding and open interest. - [Crypto alerts](https://blockmetric.io/alerts): Crypto alerts to Telegram, e-mail or webhook for price, RSI, funding, open interest, liquidation levels, whales and hacks. 5 rules free. - [Liquidation Guard](https://blockmetric.io/guard): Paste a wallet address: see how close each Hyperliquid position is to liquidation, what liquidates first, and get an alert before you get close. - [Liquidation price calculator](https://blockmetric.io/tools/liquidation-calculator): Calculate the liquidation price of a perpetual position, isolated or cross margin, with the venue's published margin tiers. Runs in your browser. - [Position size calculator](https://blockmetric.io/tools/position-size-calculator): Position size from account size, risk per trade and stop, with the margin tier, margin and liquidation price at your leverage. Runs in your browser. - [Do liquidation clusters act as magnets?](https://blockmetric.io/scoreboard): Do liquidation clusters pull the price? A public record of whether price reached big Hyperliquid clusters within 4, 24 and 72 hours, every case listed. - [Historical data](https://blockmetric.io/historical-data): Which crypto history we store and since when (heatmaps, funding, open interest, long/short, candles), and three ways to get it: CSV, API or archive files. - [Data & methodology](https://blockmetric.io/methodology): Where our data comes from and under which terms, how it is collected and computed, how fresh it is, its known gaps and how corrections work. - [Learn crypto derivatives](https://blockmetric.io/learn): Guides that explain the data and the tools, every crypto derivatives term in one sentence and every metric with its exact method and limits. - [Research from our data](https://blockmetric.io/blog): What our data shows on liquidations, funding, open interest, leverage, Hyperliquid whales and crypto hacks, every number dated and sourced. - [Pricing](https://blockmetric.io/pricing): Free: every coin's heatmap (24h), wallet stats, 5 alert rules. Pro $29/mo with a 7-day free trial, Desk $79/mo. Yearly: 20% off. - [API pricing](https://blockmetric.io/pricing/api): Free API key with 10 requests a minute. API Dev $49/mo for internal use, API Pro $249/mo with display rights and a live stream. Yearly: 10% off. - Coin hubs, e.g. [BTC](https://blockmetric.io/coins/BTC): one page per coin with tabs for the liquidation heatmap (https://blockmetric.io/coins/BTC/heatmap, https://blockmetric.io/coins/ETH/heatmap, https://blockmetric.io/coins/HYPE/heatmap), order flow, positioning (open interest, funding, long/short), whales and daily history - Exchange pages, e.g. [Hyperliquid](https://blockmetric.io/exchanges/hyperliquid): liquidations, open interest and funding per venue; the Hyperliquid page adds the protocol section (https://blockmetric.io/exchanges/hyperliquid#protocol: Assistance Fund buybacks and holdings, HYPE supply, the HLP vault) Citing: name the source as "Blockmetric" with a link to the page; every number on a page shows its time ("Updated … UTC") and its data sources. Data from public sources, not investment advice. ## Learn guides - [Archive node vs full node: what historical state means](https://blockmetric.io/learn/archive-vs-full-node): The difference between an archive node and a full node, which RPC calls need historical state, how log ranges work, and what HyperEVM supports. (example data frozen at publication) - [Auto-deleveraging (ADL) explained: who gets closed and why](https://blockmetric.io/learn/auto-deleveraging-adl): What auto-deleveraging is, when Hyperliquid uses it after book and backstop liquidations fail, how it ranks profitable positions and what that means. (example data frozen at publication) - [Crypto bridge hacks: why bridges get drained](https://blockmetric.io/learn/crypto-bridge-hacks): Why cross-chain bridges are hacked so often: forged messages, captured validators, stolen keys and central control, with verified cases and sources. (example data frozen at publication) - [Crypto liquidation data API: history, totals and levels](https://blockmetric.io/learn/liquidation-data-api): How to pull crypto liquidation history, hourly totals and liquidation levels from the Blockmetric API, with the endpoints, parameters and limits. (example data frozen at publication) - [Do liquidation clusters attract price?](https://blockmetric.io/learn/liquidation-clusters-price-magnets): Why liquidation clusters are called price magnets, why that is not a law, why bands fade before price arrives, and how a hit rate measures it. (example data frozen at publication) - [Exchange inflows and outflows: how to read on-chain flows](https://blockmetric.io/learn/exchange-inflows-and-outflows): What exchange inflows and outflows measure, how a transfer is matched to an exchange wallet, what net flow means and what it cannot tell you. (example data frozen at publication) - [Funding rate vs basis: how they differ and connect](https://blockmetric.io/learn/funding-rate-vs-basis): Funding rate vs basis: what each one measures, how a perpetual's premium feeds its funding, how dated futures basis differs, and how to read both together. (example data frozen at publication) - [How crypto hacks happen: the main attack types](https://blockmetric.io/learn/how-crypto-exploits-happen): How crypto hacks and exploits happen: contract bugs, price oracles, governance, stolen keys, supply-chain attacks and manipulation, with verified cases. (example data frozen at publication) - [How crypto liquidations work, step by step](https://blockmetric.io/learn/how-crypto-liquidations-work): What triggers a liquidation on a perpetual future, how the exchange closes the position, what partial and backstop liquidations are, and what is lost. (example data frozen at publication) - [How funding rates are calculated, step by step](https://blockmetric.io/learn/how-funding-rates-are-calculated): How a perpetual funding rate is calculated: the premium from impact prices, the interest part, the clamp, the cap and the hourly payment, with an example. (example data frozen at publication) - [How Hyperliquid works: HyperCore, HyperEVM and HyperBFT](https://blockmetric.io/learn/hyperliquid-explained): Hyperliquid explained: the HyperBFT chain, HyperCore order books and clearinghouse, the HyperEVM, oracle and mark prices, and why every position is public. (example data frozen at publication) - [How leverage works in crypto futures](https://blockmetric.io/learn/crypto-leverage-explained): How leverage works in crypto perpetual futures: margin and notional, why one move liquidates a 20x position but not a 5x one, and what it leaves alone. (example data frozen at publication) - [How to read CVD (cumulative volume delta)](https://blockmetric.io/learn/how-to-read-cvd): How to read CVD: what cumulative volume delta adds up, how to compare it with price, why perp and spot CVD differ, and where trade-stream data stops. (example data frozen at publication) - [How to track a Hyperliquid wallet: positions and alerts](https://blockmetric.io/learn/how-to-track-a-hyperliquid-wallet): Track any Hyperliquid wallet step by step: find the address, read its positions and liquidation prices, follow its moves and get alerts, without keys. (example data frozen at publication) - [Hyperliquid fees and the Assistance Fund explained](https://blockmetric.io/learn/hyperliquid-fees-and-assistance-fund): How Hyperliquid trading fees work (volume tiers, maker rebates, staking discounts, HIP-3) and how the Assistance Fund turns fees into HYPE that is burned. (example data frozen at publication) - [Hyperliquid HIP-3: builder-deployed perpetuals explained](https://blockmetric.io/learn/hyperliquid-hip-3-builder-perps): How Hyperliquid HIP-3 lets builders deploy their own perp markets: stake, auctions, fees, oracles, settlement, slashing, margin and onchain backstop. (example data frozen at publication) - [Hyperliquid HLP and vaults: how they work](https://blockmetric.io/learn/hyperliquid-hlp-and-vaults): What the Hyperliquid HLP vault does, how the liquidator vault takes over positions, and how user vaults share profits, lock deposits and treat withdrawals. (example data frozen at publication) - [Isolated vs cross margin: how they differ](https://blockmetric.io/learn/isolated-vs-cross-margin): Isolated vs cross margin on perpetual futures: what backs each position, how the liquidation price and the possible loss differ, with a worked example. (example data frozen at publication) - [Liquidation cascades: how forced orders chain together](https://blockmetric.io/learn/liquidation-cascades): What a liquidation cascade is, why forced orders push in the direction of the move, what slows a cascade down, and how to see one in liquidation data. (example data frozen at publication) - [Liquidation price formula, with worked examples](https://blockmetric.io/learn/liquidation-price-formula): The liquidation price formula for perpetual futures, its inputs in isolated and cross margin, and worked long, short and cross examples you can recompute. (example data frozen at publication) - [Maintenance margin and margin tiers explained](https://blockmetric.io/learn/maintenance-margin-and-margin-tiers): What maintenance margin is, how Hyperliquid sets it from maximum leverage, how margin tiers and the deduction work for large positions, with examples. (example data frozen at publication) - [Mark price vs oracle price: which price does what](https://blockmetric.io/learn/mark-price-vs-oracle-price): Mark, oracle, index and last price compared: how Hyperliquid builds each one and which one drives funding, liquidations, trigger orders and PnL. (example data frozen at publication) - [Negative funding rate: what it means and what it doesn't](https://blockmetric.io/learn/negative-funding-rate-meaning): What a negative funding rate means: shorts pay longs. Why the baseline is positive, how extreme rates arise, and what funding does not say about the price. (example data frozen at publication) - [Perp DEX vs CEX liquidations: what each venue shows](https://blockmetric.io/learn/perp-dex-vs-cex-liquidations): How liquidations differ on an on-chain perp DEX like Hyperliquid and on centralised exchanges, what each publishes, and why exchange totals undercount. (example data frozen at publication) - [Perpetual futures vs dated futures: the differences](https://blockmetric.io/learn/perpetual-vs-dated-futures): Perpetual futures vs dated futures: expiry versus funding, how each stays close to spot, how they settle, and what the difference means for market data. (example data frozen at publication) - [Short squeeze vs long squeeze in crypto: how they unfold](https://blockmetric.io/learn/long-squeeze-vs-short-squeeze): How short squeezes and long squeezes work in crypto derivatives: the role of liquidations, stop orders and funding, and how each squeeze shows in the data. (example data frozen at publication) - [Stablecoin mints and burns: what supply changes show](https://blockmetric.io/learn/stablecoin-mints-and-burns): How USDC, USDT and DAI mints and burns appear on-chain, how to tell them from bridge moves and plain transfers, and what a supply change does not mean. (example data frozen at publication) - [What is an RPC node? JSON-RPC explained for builders](https://blockmetric.io/learn/what-is-an-rpc-node): What an RPC node is, how JSON-RPC requests over HTTPS and WebSocket work, which read methods apps use most, and why most apps use an RPC provider. (example data frozen at publication) - [What is Robinhood Chain? The Arbitrum layer 2 for tokenized stocks](https://blockmetric.io/learn/what-is-robinhood-chain): Robinhood Chain explained: an Arbitrum-based Ethereum layer 2 for tokenized stocks and ETFs. Chain ID, gas, public RPC terms, bridges, USDG and Lighter. (example data frozen at publication) - [How to read a liquidation heatmap](https://blockmetric.io/learn/how-to-read-a-liquidation-heatmap): What the bands of a liquidation heatmap mean, how long and short clusters differ, how price meets them and where the data stops, with a BTC example. (example data frozen 2026-10-27 19:55 UTC) - [Funding rates explained, and how funding arbitrage works](https://blockmetric.io/learn/funding-rates-and-funding-arbitrage): Why perpetual futures pay funding, how hourly and 8-hour funding compare, how to annualise a rate, and how funding arbitrage works, with its costs. (example data frozen 2026-10-27 18:57 UTC) - [Open interest and long/short: what they tell you, what they don't](https://blockmetric.io/learn/open-interest-and-long-short-ratio): What open interest and the long/short ratio measure, why the ratio by wallets and by USD can disagree, and what neither says about direction, with BTC. (example data frozen 2026-10-27 18:57 UTC) ## Blog - [48 hours of crypto liquidations: which side, which venue, which coins](https://blockmetric.io/blog/crypto-liquidations-48-hours-long-vs-short): Crypto liquidations in the 48 hours to 28 October 2026: longs vs shorts, the split by venue and the coins with the most liquidated, from our streams. (Markets, 2026-10-28; numbers frozen 2026-10-28 18:25 UTC) - [Altcoin long/short ratios: when wallets and dollars disagree](https://blockmetric.io/blog/altcoin-long-short-ratios-wallets-vs-usd): Long/short ratios of XRP, DOGE, SUI, LINK and AVAX on Hyperliquid on 28 October 2026, counted by wallets and by dollars, and why the two can disagree. (Markets, 2026-10-28; numbers frozen 2026-10-28 18:25 UTC) - [Crypto hacks in 2025: the year in our verified database](https://blockmetric.io/blog/crypto-hacks-2025-year-review): The crypto hacks and exploits of 2025 in our verified database: how many, the largest stated losses, attack types, chains and how the year ended. (Security, 2026-10-28; numbers frozen 2026-10-26 15:28 UTC) - [HYPE liquidation levels and positioning: a 72-hour snapshot](https://blockmetric.io/blog/hype-liquidation-levels-72-hours): HYPE liquidation levels over the 72 hours to 28 October 2026, the largest tracked positions, long/short by wallets and dollars, and funding. (Hyperliquid, 2026-10-28; numbers frozen 2026-10-28 18:25 UTC) - [Where ETH positions would be liquidated: a 24-hour snapshot](https://blockmetric.io/blog/eth-liquidation-levels-24-hours): Where tracked ETH positions on Hyperliquid would have been liquidated on 28 October 2026: the largest long and short clusters and the whales behind them. (Markets, 2026-10-28; numbers frozen 2026-10-28 18:25 UTC) - [Hyperliquid whales: what our position tracking shows](https://blockmetric.io/blog/hyperliquid-whales-position-tracking): The largest tracked Hyperliquid positions, the leverage behind them, how close big positions sit to liquidation, and how to watch a wallet with Guard. (Hyperliquid, 2026-10-27T19:10:00Z; numbers frozen 2026-10-27 18:58 UTC) - [Crypto hacks in 2026 so far: what 77 verified incidents show](https://blockmetric.io/blog/crypto-hacks-2026-so-far): The largest crypto hacks and exploits of 2026 so far, the attack types and chains behind them, and what they have in common, from our verified database. (Security, 2026-10-27T18:50:00Z; numbers frozen 2026-10-26 15:28 UTC) ## Recipes Step-by-step builds with complete code in cURL, JavaScript and Python (MIT-0): [all recipes](https://blockmetric.io/developers/recipes). - [Liquidation alert bot for Telegram](https://blockmetric.io/developers/recipes/liquidation-alert-bot): Every big liquidation in your chat seconds after it happens. Cheapest plan: Free. - [Cascade and cluster alerts with webhooks](https://blockmetric.io/developers/recipes/webhook-cascade-alerts): Liquidation cascades pushed to your server, plus a warning before price hits a big cluster. Cheapest plan: API Dev. - [Funding arbitrage scanner across venues](https://blockmetric.io/developers/recipes/funding-arbitrage-scanner): A table of the widest funding spreads between venues, now and for the next funding. Cheapest plan: Free. - [Whale position tracker](https://blockmetric.io/developers/recipes/whale-tracker): One line every time a large wallet opens, adds, cuts, flips or closes a position. Cheapest plan: Free. - [Wallet liquidation-risk monitor](https://blockmetric.io/developers/recipes/wallet-risk-monitor): A warning when a watched position comes within 10 % or 3 % of its liquidation price. Cheapest plan: Free. - [Backtest liquidation clusters with heatmap history](https://blockmetric.io/developers/recipes/heatmap-backtest): Hit rates: how often price reached the big liquidation cluster near it within 24 hours. Cheapest plan: Free. - [Research notebook in Python](https://blockmetric.io/developers/recipes/python-research-notebook): A reproducible study: what happened after the hours with the largest liquidations. Cheapest plan: Free. - [Market data in your app](https://blockmetric.io/developers/recipes/market-data-in-your-app): Funding, open interest and liquidations on your own site, cached and credited. Cheapest plan: No key. - [Multi-chain dApp backend with Blockmetric RPC](https://blockmetric.io/developers/recipes/multichain-dapp-backend): Balances, blocks and token transfers on eight chains with one token. Cheapest plan: RPC Free. - [AI agent with live market data](https://blockmetric.io/developers/recipes/ai-agent-mcp): An assistant that answers with live liquidations, clusters, funding and whale moves, and cites them. Cheapest plan: No key. ## Docs - [Full API reference as Markdown](https://blockmetric.io/docs/api.md): every endpoint with parameters, response fields, a curl example and a real example response (the best single file for an agent) - [API reference](https://blockmetric.io/docs/api): the same as web pages, with a live "Try it" console - [Quickstart](https://blockmetric.io/developers#quickstart): Your first request in 60 seconds. No key needed for the first one. - [Recipes](https://blockmetric.io/developers/recipes): Step-by-step builds with complete code: alert bots, scanners, backtests, agents. - [Authentication & limits](https://blockmetric.io/docs/api/authentication): Keys, headers, rate limits and the daily quota of your plan. - [Pagination & caching](https://blockmetric.io/docs/api/pagination): Cursors, time windows, ETag and polling without waste. - [Conventions & glossary](https://blockmetric.io/docs/api/conventions): Units, names, the response envelope, sources and licence. - [Errors](https://blockmetric.io/developers/errors): Every error code with causes and fixes. - [Webhooks](https://blockmetric.io/docs/api/webhooks): Signed radar events pushed to your server, with verification code. - [Live stream (SSE)](https://blockmetric.io/docs/api/stream): Server-Sent Events with resume, in cURL, JavaScript and Python. - [AI agents & LLMs](https://blockmetric.io/docs/api/agents): llms.txt, the full reference as Markdown and tool definitions. - [Changelog & versioning](https://blockmetric.io/developers/changelog): What changed, and what we promise not to break. - [OpenAPI 3.1](https://api.blockmetric.io/v1/openapi.json): machine-readable spec (also [YAML](https://api.blockmetric.io/v1/openapi.yaml)) - [Status](https://api.blockmetric.io/v1/status): public JSON, data freshness per source ## Endpoints: Markets - [GET /markets](https://blockmetric.io/docs/api/markets) (venue, fields, format): Market state of a venue. Latest market state of one venue: mark, oracle, funding (hourly and annualised), open interest, 24h volume, premium, max leverage. - [GET /funding](https://blockmetric.io/docs/api/funding) (coin, limit, fields, format): Cross-venue funding board. Cross-venue funding board: one row per coin with funding of every venue, APR spread between venues and the largest absolute APR of the venues shown. - [GET /coins](https://blockmetric.io/docs/api/coins) (fields, format): Hyperliquid coins. Hyperliquid coins with market data, largest open interest first, with the number of tracked positions and whether a liquidation map exists. - [GET /long-short](https://blockmetric.io/docs/api/long-short) (coin, limit, fields, format): Long/short positioning. Long/short positioning per coin: Hyperliquid from the tracked positions (USD and wallet counts per side, ratio = longUsd / shortUsd) and the public account ratios of the enabled exchanges (Binance: all accounts, top accounts, top positions; Bybit; OKX) from the last 60 minutes. - [GET /candles/{coin}](https://blockmetric.io/docs/api/candles-coin) (coin*, tf, from, to, limit, fields, format): Price candles (OHLC). Price candles (OHLC) of a Hyperliquid coin, oldest first. - [GET /screener](https://blockmetric.io/docs/api/screener) (coin, sort, dir, minOiUsd, limit, fields, format): Screener (every coin). Screener: one row per Hyperliquid coin with price change 1h / 24h (Hyperliquid mark), open interest of the enabled venues and its change 1h / 24h, current and predicted Hyperliquid funding (annualised), tracked Hyperliquid long/short and Binance top-trader ratio, liquidations of the last 24 h, the nearest big liquidation cluster (signed distance, USD, side), RSI(14) of 1h and 4h candles and 24 h realised volatility (annualised; computed for the 80 largest coins by open interest, else null). - [GET /funding/predicted](https://blockmetric.io/docs/api/funding-predicted) (coin, limit, fields, format): Predicted next funding. Predicted next funding per coin for Hyperliquid, Binance and Bybit (from Hyperliquid predictedFundings, refreshed every 5 minutes): hourly rate, annualised rate, funding interval and next funding time per venue. - [GET /funding/spreads](https://blockmetric.io/docs/api/funding-spreads) (coin, basis, minOiUsd, limit, fields, format): Cross-venue funding spreads. Cross-venue funding spread per coin: the venue with the highest and the lowest annualised funding (current rates or predicted next rates), the spread per year and per day and the smaller open interest of the two legs. - [GET /sentiment](https://blockmetric.io/docs/api/sentiment) (days): Blockmetric Sentiment index. Blockmetric Sentiment: our own 0–100 market sentiment index (0 extreme fear, 100 extreme greed) from data we collect: BTC price momentum and volatility, funding of BTC and ETH perpetuals on Binance and Bybit, BTC open interest change, the Binance long/short account ratio, the liquidation imbalance and the positioning of tracked Hyperliquid whales. ## Endpoints: Liquidations - [GET /liquidations](https://blockmetric.io/docs/api/liquidations) (coin, venue, side, minUsd, sinceMinutes, from, to, after, limit, cursor, fields, format): Liquidations feed. Market-wide liquidations (Hyperliquid liquidations of tracked wallets confirmed by their liquidation fills, with time, price and size of the fills; Lighter trades the exchange flags as liquidations; CEX force orders as reported, where licensed), newest first. - [GET /liquidations/summary](https://blockmetric.io/docs/api/liquidations-summary) (coin, hours): Liquidation totals. Liquidation totals of the last hours (default 24): long/short USD and count, per venue, the 50 coins with the most USD, the largest single liquidation and an hourly series. - [GET /liqmap/{coin}](https://blockmetric.io/docs/api/liqmap-coin) (coin*): Liquidation map (current). Liquidation map of one coin from the tracked Hyperliquid positions: USD that would be liquidated per price bucket (longs below the mark, shorts above), plus totals. - [GET /heatmap/{coin}](https://blockmetric.io/docs/api/heatmap-coin) (coin*, tf, hours, end, columns, clusters, venue, stepMinutes, layer): Liquidation heatmap over time. Liquidation heatmap over time from the tracked Hyperliquid positions (venue=lighter | lighter_rh: tracked Lighter / Lighter RH accounts with the liquidation price Lighter reports; venue=dydx | gmx: every open dYdX v4 / GMX v2 position read from the chain, with the liquidation price we compute from the chain state; venue=all: every enabled real layer added per column): one column per interval tf (times, UTC aligned), one row per price bucket (prices, ascending); cells[t][p] is the USD that would be liquidated in that bucket at that time (longCells / shortCells split by side), plus the mark per column. - [GET /heatmap/{coin}/open-interest](https://blockmetric.io/docs/api/heatmap-coin-open-interest) (coin*, hours, end, venue, bandPct): Open interest added per price band. Where open interest was added and removed on the exchanges (Binance, Bybit; OKX while enabled), per price band: the "open interest added at this price" layer of the heatmap. - [GET /heatmap/{coin}/wallets](https://blockmetric.io/docs/api/heatmap-coin-wallets) (coin*, lo, hi, price, clusters, side, minUsd, limit): Wallets with their liquidation price in a band. Tracked Hyperliquid wallets whose position in this coin has its liquidation price in a band right now: size, side, leverage, liquidation price and its signed distance from the mark (liqDistance, fraction), with a link to the wallet page (url). - [GET /scoreboard](https://blockmetric.io/docs/api/scoreboard) (coin, limit): Cluster hit rates (scoreboard). The cluster scoreboard: how often big liquidation clusters of the tracked Hyperliquid positions were reached by the price within 4, 24 and 72 hours, per coin (first row ALL = every coin), with the number of scored clusters, the median time to the touch and the median distance. ## Endpoints: Whales - [GET /positions/top](https://blockmetric.io/docs/api/positions-top) (coin, side, minUsd, limit, cursor, venue, fields, format): Largest positions. Largest tracked Hyperliquid positions (venue=lighter: tracked Lighter accounts) with entry, leverage, liquidation price and the signed distance from the mark to the liquidation price (liqDistance, fraction). - [GET /whales](https://blockmetric.io/docs/api/whales) (sort, coin, labelled, limit, venue, fields, format): Whale leaderboard. Whale leaderboard of tracked Hyperliquid wallets with public labels (label + labelSource URL; otherwise the self-chosen leaderboard name), open notional, PnL, largest position with liquidation distance and the number of fill-confirmed liquidations. - [GET /whales/feed](https://blockmetric.io/docs/api/whales-feed) (coin, minUsd, since, limit, cursor, fields, format): Whale position changes. Whale position changes (open, close, increase, decrease, flip, liquidated), newest first. - [GET /wallets/{address}](https://blockmetric.io/docs/api/wallets-address) (address*, limit): Wallet detail. One tracked Hyperliquid wallet: stored account data, current positions (largest first), latest position events (increase / decrease kept 90 days, the other kinds 400 days) and totals. - [GET /whales/stops](https://blockmetric.io/docs/api/whales-stops) (coin): Whale stop / TP map. Stop / take-profit map of the largest tracked Hyperliquid wallets (default the 150 largest by open notional, open orders read every ~40 min): with coin, the trigger orders per price bucket (sell stops below / buy stops above the price, TPs separately), a heatmap overlay (overlay: price, label, side, usd) and coverage; without coin, a per-coin table with the largest stop cluster below and above the price. - [GET /traders](https://blockmetric.io/docs/api/traders) (sort, search, style, minAccountValue, limit, cursor, fields, format): Trader leaderboard. Trader leaderboard from the official Hyperliquid leaderboard (PnL, ROI and volume of day / week / month / all-time; PnL is the change of the account with its sub-accounts and spot balances, so deposits and withdrawals do not count) plus what we observed: win rate and holding time from our position polls, max drawdown and Sharpe from Hyperliquid portfolio history (top traders), style tags and cohorts. - [GET /cohorts](https://blockmetric.io/docs/api/cohorts) (coin, dim, cohort, limit): Cohort positioning. Positioning of tracked Hyperliquid wallets by cohort: size (shrimp < $10K, fish, dolphin, shark, whale ≥ $10M account value) and all-time PnL (top ≥ +$1M, profitable, flat, losing, rekt ≤ −$1M): long / short notional, wallets and long share now, its change over 15m / 1h / 4h / 24h / 3d / 7d (from 5-min snapshots, capped at the plan history), recent position changes with cohorts and the net flow of the last hour. - [GET /smart-money](https://blockmetric.io/docs/api/smart-money) (coin, limit): 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 /movements](https://blockmetric.io/docs/api/movements) (type, chain, asset, minUsd, labelled, address, since, limit, cursor, fields, format): Whale movements (on-chain + Hyperliquid). Whale movements, newest first, in one feed: large on-chain transfers (Ethereum, Arbitrum, Base from $1M, stablecoins from $5M; Bitcoin from $1M, change excluded), exchange in- and outflows (exchanges’ own proof-of-reserves addresses), stablecoin mints / burns, bridge transfers, large swaps on the biggest Uniswap v3 / Aerodrome pools (from $500K) and Hyperliquid whale position changes and large Hyperliquid trades (from $1M). - [GET /exchange-flows](https://blockmetric.io/docs/api/exchange-flows) (hours, exchange, asset): Exchange on-chain flows. On-chain exchange flows: inflow, outflow and net (in − out) per exchange and asset over a window, from every scanned transfer into or out of the exchange’s own proof-of-reserves addresses (all sizes on Ethereum, Arbitrum and Base; large transactions on Bitcoin). ## Endpoints: Order flow - [GET /orderbook/{coin}](https://blockmetric.io/docs/api/orderbook-coin) (coin*, venue, hours): Order book liquidity and walls. Order book liquidity of one coin: resting USD per price bucket for every covered venue (Hyperliquid l2Book in a fine layer ≈ ±2 % and a coarse layer ≈ ±10–25 %, Binance / Bybit local books within ±5 %), depth within 1 / 2 / 5 % and the bid/ask imbalance, plus walls (large resting liquidity relative to the buckets around it) that are active or ended in the last hour. - [GET /flow/{coin}](https://blockmetric.io/docs/api/flow-coin) (coin*, venue, hours, stepMinutes): Taker flow (CVD) and volume profile. Taker flow of one coin: buy / sell volume of the aggressor per bar, delta and cumulative volume delta (CVD), summed over the perpetual venues, per venue (Binance spot separately where collected), by print size (under $10k, $10k–100k, $100k–1M, $1M and more; a print = the fills of one taker order) and for tracked Hyperliquid whales (USD they bought minus sold, either side of the trade), plus the volume profile (taker volume by price, point of control, 70 % value area) of the window. - [GET /tape](https://blockmetric.io/docs/api/tape) (coin, venue, side, minUsd, sinceMinutes, from, to, after, limit, cursor, fields, format): Large-trade tape. Large-trade tape: taker prints at or above the tape threshold ($250k for BTC / ETH, $50k otherwise; one print = the fills of one taker order at one timestamp), newest first in order of arrival (id; an exchange print can arrive after a later Hyperliquid one), with the Hyperliquid taker address (public on-chain state) and whether it is a tracked whale. ## Endpoints: Radar - [GET /radar/events](https://blockmetric.io/docs/api/radar-events) (kinds, minSeverity, coin, since, limit, cursor, fields, format): Risk radar events. Risk radar events (whale moves, big liquidations, cascades, funding extremes, OI spikes, hacks, depegs, TVL drops, CEX outflows), newest first. - [GET /security/incidents](https://blockmetric.io/docs/api/security-incidents) (origin, type, chain, minSeverity, limit, cursor, fields, format): Security incidents. Security view, newest first: detector events (Hyperliquid manipulation patterns, possible ADL, oracle / mark deviations, HLP vault drawdowns, market-wide liquidation surges, stablecoin depegs from Chainlink feeds read on-chain, outflows from bridge and lending contracts listed in the protocols’ own docs) and curated incidents (our own factual summary, amount with its primary source, status, post-mortem and transaction links). - [GET /security/wallets](https://blockmetric.io/docs/api/security-wallets) (category, network, source, q, movedDays, limit, cursor, fields, format): Listed wallets (OFAC, FBI, post-mortems). Listed wallets: addresses that an official source lists, with the source’s own category, wording, date and a link to the listing. - [GET /security/wallets/{address}](https://blockmetric.io/docs/api/security-wallets-address) (address*, limit): Listed wallet detail. One listed wallet: every active listing of the address (category, source, wording, date, link), its last known balances on the scanned EVM chains (native ETH and the curated tokens, at our own prices) and its tracked movements, newest first (every token on Ethereum, Arbitrum and Base, native ETH on Ethereum, Bitcoin; within the plan history). ## Endpoints: Meta - [GET /stats](https://blockmetric.io/docs/api/stats): Coverage and freshness. Coverage and freshness: tracked wallets and positions, markets per venue, event counts, liquidation-map size and the last run of every collector job. - [GET /me](https://blockmetric.io/docs/api/me): The calling key: plan, limits, usage. The caller: the key (masked, never the secret: name, scopes, expiry, IP allowlist, browser origins), the plan and its limits, the account’s usage of the current minute and UTC day, overage, the history window and the venues the licence gate withholds. ## Realtime - [GET /stream](https://blockmetric.io/docs/api/stream) (API Pro): Server-Sent Events of radar events, resume with Last-Event-ID. - [Webhooks](https://blockmetric.io/docs/api/webhooks) (API Dev, API Pro): signed POSTs (Blockmetric-Signature: t=,v1=) with the same envelope. ## Blockmetric RPC Multi-chain JSON-RPC over HTTPS and WebSocket: Ethereum, Base, Arbitrum One, OP Mainnet, Polygon PoS, BNB Smart Chain, Avalanche C-Chain, HyperEVM, HyperCore (info API) and testnets Sepolia, Base Sepolia, Arbitrum Sepolia. URL https://rpc.blockmetric.io// with an endpoint token (bmr_…; the token may be in the path, API keys never), or https://rpc.blockmetric.io/ with "Authorization: Bearer ". 1 credit = 1 request on every chain, weights 1 standard, 2 heavy, 5 trace/debug. Read-only during the beta. Chains, regions and plans open when enough teams ask for them; the waitlist on the product page takes exactly the combination you need. - [Blockmetric RPC](https://blockmetric.io/rpc): what it is, how it differs from the market-data API, chains, regions, the waitlist - [RPC pricing](https://blockmetric.io/pricing/rpc): Global plans (every open chain and region, pay per use, peak requests per second within the credits), dedicated throughput per chain and region (a sustained rate, from $199 a month), dedicated nodes (price on request, per chain and region), each with its comparison - [Supported chains](https://blockmetric.io/rpc/chains): every network with chain id, transports and links to its endpoint page and docs - [Request a chain or feature](https://blockmetric.io/rpc#request): not available yet, on the waitlist (we build what enough teams ask for): 60 chains (Abstract, Arbitrum Nova, Blast, Boba Network, Celo, Fraxtal, Hemi, Ink, Lens, Linea, Mantle, MegaETH, Metis, Mode, Robinhood Chain, Scroll, Soneium, Unichain, World Chain, X Layer, ZKsync Era, Zora, 0G, ApeChain, Arc, Berachain, Flare, Flow EVM, Gnosis Chain, Kaia, Monad, opBNB, Plasma, Ronin, Rootstock, Sei, Sonic, Tempo, ZetaChain, Aptos, Bitcoin, Bitcoin Cash, Celestia, Cosmos Hub, Dogecoin, Hedera, Injective, Litecoin, NEAR, Osmosis, Polkadot, Solana, Stacks, Starknet, Stellar, Sui, TON, TRON, XRP Ledger, Zcash) and 40 features (Token API, NFT API, Transfers API, Token prices API, Portfolio API, Transaction simulation, Gas fee estimates, Block by timestamp, Ethereum Beacon API, SQL over chain data, Subgraph hosting, Address activity webhooks, Custom webhooks, Streams, Streams to storage, Historical backfills, Pending transaction stream, gRPC streaming, ERC-4337 bundler, Gas sponsorship (paymaster), Smart wallets, MEV protection, JWT authentication, Method allow-list per token, Rate limits per method, Team members and roles, Single sign-on, Audit log, Admin API, Terraform provider, Metrics export (Prometheus), SOC 2 and ISO 27001 reports, Pay with crypto, Pay per request (x402), MCP server for AI agents, IPFS pinning and gateway, Key-value store, More testnets, Testnet faucet, Rollup as a service) - [Ethereum RPC Endpoint: HTTPS and WebSocket](https://blockmetric.io/rpc/eth): endpoint format, shared plans and dedicated Ethereum throughput, regions - [Base RPC Endpoint: HTTPS and WebSocket](https://blockmetric.io/rpc/base): endpoint format, shared plans and dedicated Base throughput, regions - [Arbitrum One RPC Endpoint: HTTPS and WebSocket](https://blockmetric.io/rpc/arbitrum): endpoint format, shared plans and dedicated Arbitrum One throughput, regions - [OP Mainnet RPC Endpoint: HTTPS and WebSocket](https://blockmetric.io/rpc/optimism): endpoint format, shared plans and dedicated OP Mainnet throughput, regions - [Polygon PoS RPC Endpoint: HTTPS and WebSocket](https://blockmetric.io/rpc/polygon): endpoint format, shared plans and dedicated Polygon PoS throughput, regions - [BNB Smart Chain RPC Endpoint](https://blockmetric.io/rpc/bsc): endpoint format, shared plans and dedicated BNB Smart Chain throughput, regions - [Avalanche C-Chain RPC Endpoint](https://blockmetric.io/rpc/avalanche): endpoint format, shared plans and dedicated Avalanche C-Chain throughput, regions - [HyperEVM RPC Endpoint: HTTPS and WebSocket](https://blockmetric.io/rpc/hyperevm): endpoint format, shared plans and dedicated HyperEVM throughput, regions - [HyperCore Info API Endpoint](https://blockmetric.io/rpc/hypercore): endpoint format, shared plans and dedicated HyperCore (info API) throughput, regions - [Sepolia RPC Endpoint: HTTPS and WebSocket](https://blockmetric.io/rpc/sepolia): endpoint format, shared plans, regions - [Base Sepolia RPC Endpoint: HTTPS and WebSocket](https://blockmetric.io/rpc/base-sepolia): endpoint format, shared plans, regions - [Arbitrum Sepolia RPC Endpoint](https://blockmetric.io/rpc/arbitrum-sepolia): endpoint format, shared plans, regions - [RPC docs: Overview](https://blockmetric.io/docs/rpc): Quickstart: your token, the first request and every chain. - [RPC docs: WebSockets](https://blockmetric.io/docs/rpc/websockets): JSON-RPC over WebSocket, eth_subscribe for new heads and logs, reconnects. - [RPC docs: Limits and errors](https://blockmetric.io/docs/rpc/limits): Rate limits per plan, credits and weights, response headers and every error code. - [RPC docs: Best practices](https://blockmetric.io/docs/rpc/best-practices): Batching, retries, log ranges, token safety and caching. - [Ethereum](https://blockmetric.io/docs/rpc/eth): chain id 1 (0x1), methods, limits and examples - [Base](https://blockmetric.io/docs/rpc/base): chain id 8453 (0x2105), methods, limits and examples - [Arbitrum One](https://blockmetric.io/docs/rpc/arbitrum): chain id 42161 (0xa4b1), methods, limits and examples - [OP Mainnet](https://blockmetric.io/docs/rpc/optimism): chain id 10 (0xa), methods, limits and examples - [Polygon PoS](https://blockmetric.io/docs/rpc/polygon): chain id 137 (0x89), methods, limits and examples - [BNB Smart Chain](https://blockmetric.io/docs/rpc/bsc): chain id 56 (0x38), methods, limits and examples - [Avalanche C-Chain](https://blockmetric.io/docs/rpc/avalanche): chain id 43114 (0xa86a), methods, limits and examples - [HyperEVM](https://blockmetric.io/docs/rpc/hyperevm): chain id 999 (0x3e7), methods, limits and examples - [HyperCore (info API)](https://blockmetric.io/docs/rpc/hypercore): HyperCore info API (Hyperliquid read types) - [Sepolia](https://blockmetric.io/docs/rpc/sepolia): chain id 11155111 (0xaa36a7), methods, limits and examples - [Base Sepolia](https://blockmetric.io/docs/rpc/base-sepolia): chain id 84532 (0x14a34), methods, limits and examples - [Arbitrum Sepolia](https://blockmetric.io/docs/rpc/arbitrum-sepolia): chain id 421614 (0x66eee), methods, limits and examples ## Optional - [AI agents](https://blockmetric.io/docs/api/agents): tool definitions for LLM agents over the REST API (the MCP server package is being prepared for release) - [Agent skill (SKILL.md)](https://blockmetric.io/llms-skill.md): how to fetch and present the data; works without a key via the public access header - Without a key: header `X-Blockmetric-Access: public` gives free-tier data with 24 h of history, 10 requests/min and 300/day per IP. A free personal key raises the request limits and the history to 30 days; paid plans add more history - [Widgets](https://blockmetric.io/widgets) (iframe / embed.js); CSV / JSON files from the website are part of Pro (signed in), scripts use the API - [Postman collection](https://blockmetric.io/developers/downloads/blockmetric.postman_collection.json) · [.http file](https://blockmetric.io/developers/downloads/blockmetric.http)