On-Chain Crypto Metrics API - Glassnode MVRV, SOPR, Flows

Export Bitcoin, Ethereum and altcoin on-chain metrics, exchange flows, valuation indicators, derivatives and ETF data from the Glassnode API into an Apify dataset with your own Glassnode API key.

This actor wraps the Glassnode REST API. It turns a list of metric paths and assets into clean, deduplicated, timestamped rows you can download as JSON, CSV or Excel, schedule daily or hourly, or feed into trading models, research notebooks, dashboards, spreadsheets and AI agents. Bring your own API key.

What it does

• On-chain metrics for any asset: active addresses, address balance bands, supply held by long-term and short-term holders, transfer volume, transaction counts, fees, hash rate and miner revenue, read as a time series for BTC, ETH, SOL, stablecoins and the other assets Glassnode covers.
• Valuation and cycle indicators: MVRV, MVRV Z-Score, SOPR, NUPL, realized price and cap, Puell Multiple, Reserve Risk, coin days destroyed, cost basis distributions and hundreds more.
• Exchange balances and flows: coins held on exchanges, inflows, outflows and net flows, per exchange (Binance, Coinbase, Bybit, OKX and others) or aggregated, in native units or USD.
• Derivatives and options: futures open interest, funding rates, liquidations, volume, options open interest, implied volatility and skew.
• ETF, treasury and macro data: US spot ETF balances and flows, corporate and government treasuries, and macro series.
• Bulk snapshots: one metric for many assets, or every asset with *, in a single request.
• Metric metadata and data lag: supported assets, resolutions, exchanges, networks, available history, descriptions, bulk and point-in-time variants, and how late new values arrive.
• Asset and reference lists: Glassnode asset IDs with contract addresses, CoinGecko, CoinMarketCap and CCData IDs and semantic tags; supported exchanges, networks, miners and tags; and your monthly credit usage.
• Pay only for results: empty answers are recorded as a free row that says why, never charged.

Input

Field	Used by	What it does
mode	all	metricSeries, bulkMetric, metricMetadata, dataLag, metricCatalog, assets, referenceList or apiUsage
metrics	series, bulk, metadata, data lag	Metric paths below /v1/metrics, such as market/mvrv, indicators/sopr or distribution/balance_exchanges
assets	series, bulk, metadata, data lag, catalogue	Glassnode asset IDs such as BTC, ETH or SOL; * for every asset in bulk mode
since, until	series, bulk	A date, a UTC date and time, or a unix time
lookbackDays	series, bulk	Days back from today when since is empty (default 30)
resolution	series, bulk, catalogue	24h, 1h, 10m, 1w or 1month, where the metric and your plan offer it
currency	series, bulk, catalogue	native or usd, for metrics that take a currency
exchanges, networks	series, bulk	Exchange or chain breakdowns, for metrics that take them
extraParameters	series, bulk, metadata	Documented drill-downs passed verbatim: miner, maturity, period, quote_symbol, from_exchange, to_exchange
assetFilter	assets, asset lists	A CEL filter such as asset.semantic_tags.exists(t, t=='stablecoin')
listType	reference list	Exchanges, networks, miners, metric tags, asset tags, categories or blockchains
maxResults	all	Row ceiling for the run; the newest points are kept
apiKey	all	Your Glassnode API key (secret). Or set the DATA_API_KEY environment secret

Every metric's own parameter list is checked against a snapshot of the Glassnode documentation (916 metrics). A currency, exchange or network the metric does not take is left off and named in the log, so a setting meant for another metric never silently empties your results. Metrics added after the snapshot are still sent, with the general parameters.

How to get an API key

API access comes with the Glassnode Professional plan (the full API) or the Advanced plan (the Light API: daily data, 14 days of history, 50 calls a day, no bulk endpoints). In Glassnode Studio, open the user menu, choose API, and generate a key at the bottom of the page. Paste it into the API key field.

Example output

{
    "mode": "metricSeries",
    "recordType": "datapoint",
    "identifier": "market/mvrv BTC",
    "found": true,
    "id": "market/mvrv|BTC|||1759968000",
    "metric": "market/mvrv",
    "metricName": "MVRV Ratio",
    "asset": "BTC",
    "date": "2025-10-09T00:00:00Z",
    "timestamp": 1759968000,
    "value": 2.31,
    "values": null,
    "resolution": "24h",
    "currency": null,
    "exchange": null,
    "network": null,
    "note": null
}

Metrics that return several values per timestamp (supply bands, cost basis distributions, exchange breakdowns) carry them in values as an object. Bulk rows also carry category and any other breakdown parameters.

FAQ

What is the Glassnode API?

The Glassnode API is the data API behind Glassnode Studio, the on-chain and crypto market analytics platform from Glassnode. It serves more than 900 metrics computed from the Bitcoin, Ethereum and other blockchains and from spot, futures and options markets, under paths such as /v1/metrics/market/mvrv, /v1/metrics/indicators/sopr and /v1/metrics/distribution/balance_exchanges, plus metadata endpoints under /v1/metadata. This actor calls those GET endpoints and nothing else.

Do I need my own API key?

Yes. This actor is bring your own key: you need a Glassnode plan with API access. Your key is stored as an Apify secret, sent only in the X-Api-Key header, and kept out of every log line and URL. Without a key the run stops immediately with a clear message and no charge.

How do I download Bitcoin MVRV or SOPR history?

Choose Metric time series, put market/mvrv or indicators/sopr in Metrics and BTC in Assets, and set Since to 2010-01-01 for the full history (or leave it empty for the last 30 days). Raise Maximum results to cover the number of days you want; each daily value is one row.

How do I get exchange inflows, outflows and balances per exchange?

Use metrics such as distribution/balance_exchanges, transactions/transfers_volume_to_exchanges_sum, transactions/transfers_volume_from_exchanges_sum or transactions/transfers_volume_exchanges_net, and list exchanges such as binance and coinbase in Exchanges. Each exchange is read separately and labelled in the exchange column; set Currency to usd for dollar values.

How do I compare one metric across many coins?

Choose Bulk metric, give one metric such as market/marketcap_usd and list the assets, or * for all. One bulk request spans at most 31 days at daily resolution (10 days at hourly, 93 days at weekly), so use it for recent snapshots and the time series mode for long history. Bulk endpoints need the Professional plan.

Which metrics can my key read?

Run the Metric catalogue mode. It lists every metric path your filters allow, with its name, resolutions, optional parameters and whether it is on the Light API, according to this actor's documentation snapshot. Metric metadata then shows the exact assets, exchanges, resolutions and history one metric supports.

What do I pay?

The actor charges per returned record: 0.005 USD per metric data point, 0.01 USD per metric metadata record, 0.005 USD per asset and 0.005 USD per reference record (catalogue path, lag statistic, list name or credit summary), with Apify platform usage included. Empty results are free. Glassnode also counts data credits on your plan: 1 per request for BTC and 2 for any other asset, and per asset in a bulk request.

What happens if my key is wrong or my plan does not cover a metric?

A missing or rejected key (401), spent credits (402) or a spent daily allowance ends the run cleanly with the provider's explanation as the status message. A metric, resolution or bulk endpoint outside your plan (403), or an asset a metric does not support (400), becomes a free row with the provider's words and the run moves on; if nothing at all comes back, the run ends with that explanation. The per-minute rate limit (429) is waited out using the provider's reset header and retried.

Keyword map

Glassnode API, on-chain data API, crypto on-chain metrics, Bitcoin on-chain analytics, Ethereum on-chain data, MVRV ratio, MVRV Z-Score, SOPR, NUPL, realized price, exchange flows, exchange balances, exchange netflow, active addresses, long-term holder supply, whale addresses, miner revenue, hash rate, futures open interest, funding rates, Bitcoin ETF flows, crypto market data API.

Terms and data use

You need your own Glassnode subscription with API access, and your use of the data is governed by your agreement with Glassnode. Its terms grant a personal, non-transferable licence: you may not distribute, sublicense or resell the content or your API key, the Advanced plan is for personal, non-commercial use, and commercial and redistribution rights come with the Professional plan or as a separate purchase. The terms also limit an account to one active IP address within 24 hours; Apify runs come from changing IP addresses, so check with Glassnode before scheduling runs alongside other use of the same key. Nothing here is investment advice. This actor is an independent tool and is not made or endorsed by Glassnode.