Distribution

Bhutan Government Balance

get

Definition. The amount of BTC held in addresses controlled by Druk Holding and Investments (DHI), the investment arm of the Royal Government of Bhutan.\n

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:

cstringOptional

currency - native, usd

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:

Responses

200

Successful response

application/json

tinteger · int64Optional

Unix timestamp

Example: 1726790400

vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077

numberOptional

or

objectOptional

or

arrayOptional

400

Bad Request - Invalid parameters or unsupported asset

application/json

401

Unauthorized - Invalid or missing API key

application/json

429

Too Many Requests - Rate limit exceeded

application/json

get/v1/metrics/distribution/balance_bhutan_government

HTTPcURLJavaScriptPython

GET /v1/metrics/distribution/balance_bhutan_government?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Cash App Balance

get

The amount of BTC held in addresses controlled by Cash App. Note that this metric is based on address labels that we constantly keep updating. The values shown here provide an estimate and may not necessarily reflect the full balance.

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:

cstringOptional

currency - native, usd

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:

Responses

200

Successful response

application/json

tinteger · int64Optional

Unix timestamp

Example: 1726790400

vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077

numberOptional

or

objectOptional

or

arrayOptional

400

Bad Request - Invalid parameters or unsupported asset

application/json

401

Unauthorized - Invalid or missing API key

application/json

429

Too Many Requests - Rate limit exceeded

application/json

get/v1/metrics/distribution/balance_cashapp

HTTPcURLJavaScriptPython

GET /v1/metrics/distribution/balance_cashapp?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Donald Trump Balance

get

Definition. Donald Trump Balance is the amount of ETH held in addresses controlled by Donald Trump.\n

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:

cstringOptional

currency - native, usd

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:

Responses

200

Successful response

application/json

tinteger · int64Optional

Unix timestamp

Example: 1726790400

vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077

numberOptional

or

objectOptional

or

arrayOptional

400

Bad Request - Invalid parameters or unsupported asset

application/json

401

Unauthorized - Invalid or missing API key

application/json

429

Too Many Requests - Rate limit exceeded

application/json

get/v1/metrics/distribution/balance_donald_trump

HTTPcURLJavaScriptPython

GET /v1/metrics/distribution/balance_donald_trump?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

[
  {
    "t": 1726790400,
    "v": 822077
  }
]

El Salvador Government Balance

get

Definition. El Salvador Government Balance is the on-chain BTC balance attributed to the government of El Salvador, as reported by the National Bitcoin Office (ONBTC).\n\nNotes. For additional context, see the official government website.\n

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:

cstringOptional

currency - native, usd

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:

Responses

200

Successful response

application/json

tinteger · int64Optional

Unix timestamp

Example: 1726790400

vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077

numberOptional

or

objectOptional

or

arrayOptional

400

Bad Request - Invalid parameters or unsupported asset

application/json

401

Unauthorized - Invalid or missing API key

application/json

429

Too Many Requests - Rate limit exceeded

application/json

get/v1/metrics/distribution/balance_el_salvador

HTTPcURLJavaScriptPython

GET /v1/metrics/distribution/balance_el_salvador?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Estimated Bitwise Bitcoin ETF Balance (BITB)

get

Definition. The estimated balance held within Bitwise's spot ETFs — the Bitwise Bitcoin ETF (BITB) when queried for BTC and the Bitwise Ethereum ETF (ETHW) when queried for ETH.\n\nTechnical. The balance estimate is derived from the addresses published on the official Bitwise ETF websites (BITB, ETHW).\n\nNotes. For the most accurate and current balance information, consult the official Bitwise ETF website for the relevant ticker.\n

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:

cstringOptional

currency - native, usd

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:

Responses

200

Successful response

application/json

tinteger · int64Optional

Unix timestamp

Example: 1726790400

vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077

numberOptional

or

objectOptional

or

arrayOptional

400

Bad Request - Invalid parameters or unsupported asset

application/json

401

Unauthorized - Invalid or missing API key

application/json

429

Too Many Requests - Rate limit exceeded

application/json

get/v1/metrics/distribution/balance_bitwise

HTTPcURLJavaScriptPython

GET /v1/metrics/distribution/balance_bitwise?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Estimated BlackRock Bitcoin ETF Balance (IBIT)

get

Definition. IBIT Balance metric is designed to dynamically track the estimated Bitcoin balances associated with the BlackRock Bitcoin ETF (IBIT) through on-chain data and Glassnode's clustering heuristics.\n\nTechnical. Due to the inherent characteristics of on-chain analysis, this metric may not always precisely align with the officially reported numbers from the ETF issuer shown on the US Bitcoin Spot ETF Balances metric.\n\nNotes. For the most accurate balance information and a comprehensive understanding of IBIT's historical evolution, see the official BlackRock IBIT ETF website.\n

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:

cstringOptional

currency - native, usd

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:

Responses

200

Successful response

application/json

tinteger · int64Optional

Unix timestamp

Example: 1726790400

vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077

numberOptional

or

objectOptional

or

arrayOptional

400

Bad Request - Invalid parameters or unsupported asset

application/json

401

Unauthorized - Invalid or missing API key

application/json

429

Too Many Requests - Rate limit exceeded

application/json

get/v1/metrics/distribution/balance_blackrock

HTTPcURLJavaScriptPython

GET /v1/metrics/distribution/balance_blackrock?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Estimated Franklin Templeton Bitcoin ETF Balance (EZBC)

get

Definition. Estimated Franklin Templeton Bitcoin ETF Balance (EZBC) is the estimated BTC balance held within the Franklin Templeton Bitcoin ETF (EZBC), derived from on-chain analysis and Glassnode's clustering heuristics.\n\nTechnical. The balance is an estimate based on on-chain data and clustering methods and may not precisely match the actual EZBC balance.\n\nNotes. For the most accurate and current balance information and a comprehensive view of EZBC's historical evolution, see the official Franklin Templeton EZBC ETF website.\n

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:

cstringOptional

currency - native, usd

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:

Responses

200

Successful response

application/json

tinteger · int64Optional

Unix timestamp

Example: 1726790400

vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077

numberOptional

or

objectOptional

or

arrayOptional

400

Bad Request - Invalid parameters or unsupported asset

application/json

401

Unauthorized - Invalid or missing API key

application/json

429

Too Many Requests - Rate limit exceeded

application/json

get/v1/metrics/distribution/balance_franklin_templeton

HTTPcURLJavaScriptPython

GET /v1/metrics/distribution/balance_franklin_templeton?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Estimated Grayscale Bitcoin ETF Balance (GBTC)

get

Definition. The estimated amount of BTC held within the Grayscale Bitcoin ETF (GBTC) under Coinbase Custody.\n\nTechnical. The balance is derived from a combination of on-chain analysis and Glassnode's clustering heuristics. Grayscale initially operated as a closed-end fund, allowing both cash and in-kind share creation, with an annual fee of 2 and enabling NAV arbitrage via both share creation and redemption (cash only, not in-kind).\n\nNotes. The presented balance is an estimate based on on-chain data and clustering methods, and may not precisely match the actual GBTC balance. For the most accurate and current balance information, and for a comprehensive understanding of GBTC's historical evolution, see the official Grayscale GBTC ETF website.\n

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:

cstringOptional

currency - native, usd

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:

Responses

200

Successful response

application/json

tinteger · int64Optional

Unix timestamp

Example: 1726790400

vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077

numberOptional

or

objectOptional

or

arrayOptional

400

Bad Request - Invalid parameters or unsupported asset

application/json

401

Unauthorized - Invalid or missing API key

application/json

429

Too Many Requests - Rate limit exceeded

application/json

get/v1/metrics/distribution/balance_grayscale_trust

HTTPcURLJavaScriptPython

GET /v1/metrics/distribution/balance_grayscale_trust?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Estimated VanEck Bitcoin ETF Balance (HODL)

get

Definition. Estimated VanEck Bitcoin ETF Balance (HODL) is the estimated BTC balance held within the VanEck Bitcoin ETF (HODL), derived from on-chain analysis and Glassnode's clustering heuristics.\n\nTechnical. The balance is an estimate based on on-chain data and clustering methods and may not precisely match the actual HODL balance.\n\nNotes. For the most accurate and current balance information and a comprehensive view of HODL's historical evolution, see the official VanEck HODL ETF website.\n

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:

cstringOptional

currency - native, usd

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:

Responses

200

Successful response

application/json

tinteger · int64Optional

Unix timestamp

Example: 1726790400

vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077

numberOptional

or

objectOptional

or

arrayOptional

400

Bad Request - Invalid parameters or unsupported asset

application/json

401

Unauthorized - Invalid or missing API key

application/json

429

Too Many Requests - Rate limit exceeded

application/json

get/v1/metrics/distribution/balance_vaneck

HTTPcURLJavaScriptPython

GET /v1/metrics/distribution/balance_vaneck?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Estimated WisdomTree Bitcoin ETF Balance (BTCW)

get

Definition. The estimated Bitcoin balance held within the WisdomTree Bitcoin ETF (BTCW).\n\nTechnical. The balance is derived from a combination of on-chain analysis and Glassnode's clustering heuristics, and may not precisely match the actual BTCW balance.\n\nNotes. For the most accurate and current balance information, and for a comprehensive understanding of BTCW's historical evolution, see the official WisdomTree BTCW ETF website.\n

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:

cstringOptional

currency - native, usd

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:

Responses

200

Successful response

application/json

tinteger · int64Optional

Unix timestamp

Example: 1726790400

vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077

numberOptional

or

objectOptional

or

arrayOptional

400

Bad Request - Invalid parameters or unsupported asset

application/json

401

Unauthorized - Invalid or missing API key

application/json

429

Too Many Requests - Rate limit exceeded

application/json

get/v1/metrics/distribution/balance_wisdomtree

HTTPcURLJavaScriptPython

GET /v1/metrics/distribution/balance_wisdomtree?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Exchange Aggregated Reliance Ratio

get

Definition. Exchange Aggregated Reliance Ratio is the USD-volume-weighted average of the per-asset Exchange Reliance Ratio across the principal assets traded on a given exchange.\n\nTechnical. Unlike asset-specific Reliance Ratios, this aggregated metric measures the overall dependency of an exchange's liquidity concentration, reflecting how centralized or diversified the platform's total asset flows are. Exchange metrics are based on Glassnode's continually updated set of labeled exchange addresses, together with statistical and data-science methods that are refined over time. The series is therefore mutable: its established history is stable, but recent data points may revise as labels update. For methodology and limitations, see our article on exchange metrics and Exchange Data Transparency Notice.\n\nInterpretation. Higher values indicate greater liquidity concentration and potential systemic risk, lower values suggest broader liquidity distribution across the exchange.\n\nNotes. Introduced by CryptoVizArt. For further details, see his introductory article.\n

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:

estringOptional

exchange name - aggregated, bibox, bigone, binance, bingx, bitcoin.de, bitfinex, bitflyer, bitget, bithumb, bitmex, bitpanda, bitstamp, bittrex, bybit, cobinhood, coinbase, coincheck, coinex, coinhako, coinspot, crypto.com, deribit, firi, ftx, gate.io, gemini, hashkey, hitbtc, huobi, indodax, korbit, kraken, kucoin, luno, mexc, nexo, okex, phemex, poloniex, robinhood, swissborg, upbit, uphold, zb.com

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:

Responses

200

Successful response

application/json

tinteger · int64Optional

Unix timestamp

Example: 1726790400

vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077

numberOptional

or

objectOptional

or

arrayOptional

400

Bad Request - Invalid parameters or unsupported asset

application/json

401

Unauthorized - Invalid or missing API key

application/json

429

Too Many Requests - Rate limit exceeded

application/json

get/v1/metrics/distribution/exchange_aggregated_reliance_ratio

HTTPcURLJavaScriptPython

GET /v1/metrics/distribution/exchange_aggregated_reliance_ratio?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Exchange Aggregated Reshuffling Ratio

get

Definition. Exchange Aggregated Reshuffling Ratio is a USD-volume-weighted average of the per-asset Reshuffling Ratios across the major assets traded on a given exchange. It measures overall internal liquidity movements relative to the exchange's combined balances, representing platform-wide asset reallocation rather than asset-specific flows.\n\nTechnical. Exchange metrics are based on Glassnode's continually updated set of labeled exchange addresses, together with statistical and data-science methods that are refined over time. The series is therefore mutable: its established history is stable, but recent data points may revise as labels update. For methodology and limitations, see our article on exchange metrics and Exchange Data Transparency Notice.\n\nInterpretation. Higher readings indicate more intensive, and potentially stressed, internal reallocation of assets. Lower readings point to comparatively stable internal flows across the exchange.\n\nNotes. Introduced by CryptoVizArt. For more information, see the introductory article.\n

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:

estringOptional

exchange name - aggregated, bibox, bigone, binance, bingx, bitcoin.de, bitfinex, bitflyer, bitget, bithumb, bitmex, bitpanda, bitstamp, bittrex, bybit, cobinhood, coinbase, coincheck, coinex, coinhako, coinspot, crypto.com, deribit, firi, ftx, gate.io, gemini, hashkey, hitbtc, huobi, indodax, korbit, kraken, kucoin, luno, mexc, nexo, okex, phemex, poloniex, robinhood, swissborg, upbit, uphold, zb.com

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:

Responses

200

Successful response

application/json

tinteger · int64Optional

Unix timestamp

Example: 1726790400

vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077

numberOptional

or

objectOptional

or

arrayOptional

400

Bad Request - Invalid parameters or unsupported asset

application/json

401

Unauthorized - Invalid or missing API key

application/json

429

Too Many Requests - Rate limit exceeded

application/json

get/v1/metrics/distribution/exchange_aggregated_reshuffling_ratio

HTTPcURLJavaScriptPython

GET /v1/metrics/distribution/exchange_aggregated_reshuffling_ratio?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Exchange Balance (Percent)

get

Definition. The percentage of supply held on exchange addresses.\n\nTechnical. Exchange metrics are based on Glassnode's continually updated set of labeled exchange addresses, together with statistical and data-science methods that are refined over time. The series is therefore mutable: its established history is stable, but recent data points may revise as labels update. For methodology and limitations, see our article on exchange metrics and Exchange Data Transparency Notice.\n

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:

estringOptional

exchange name - aggregated, bibox, bigone, binance, bingx, bitcoin.de, bitfinex, bitflyer, bitget, bithumb, bitmex, bitpanda, bitstamp, bittrex, bybit, cobinhood, coinbase, coincheck, coinex, coinhako, coinspot, crypto.com, deribit, firi, ftx, gate.io, gemini, hashkey, hitbtc, huobi, indodax, korbit, kraken, kucoin, luno, mexc, nexo, okex, phemex, poloniex, robinhood, swissborg, upbit, uphold, zb.com

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:

Responses

200

Successful response

application/json

tinteger · int64Optional

Unix timestamp

Example: 1726790400

vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077

numberOptional

or

objectOptional

or

arrayOptional

400

Bad Request - Invalid parameters or unsupported asset

application/json

401

Unauthorized - Invalid or missing API key

application/json

429

Too Many Requests - Rate limit exceeded

application/json

get/v1/metrics/distribution/balance_exchanges_relative

HTTPcURLJavaScriptPython

GET /v1/metrics/distribution/balance_exchanges_relative?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Exchange Balance (Stacked)

get

Definition. The total amount of coins held on exchange addresses. Coins are broken out by individual exchange so each venue's share is read separately.\n\nTechnical. Exchange metrics are based on Glassnode's continually updated set of labeled exchange addresses, together with statistical and data-science methods that are refined over time. The series is therefore mutable: its established history is stable, but recent data points may revise as labels update. For methodology and limitations, see our article on exchange metrics and Exchange Data Transparency Notice.\n

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - (see metadata (metadata/metric) page for more details)

networkstringOptional

network values - aggregated, arb, base, eth, opt. Defaults to eth when omitted.

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:

cstringOptional

currency - native, usd

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:

Responses

200

Successful response

application/json

tinteger · int64Optional

Unix timestamp

Example: 1726790400

vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077

numberOptional

or

objectOptional

or

arrayOptional

400

Bad Request - Invalid parameters or unsupported asset

application/json

401

Unauthorized - Invalid or missing API key

application/json

429

Too Many Requests - Rate limit exceeded

application/json

get/v1/metrics/distribution/balance_exchanges_all

HTTPcURLJavaScriptPython

GET /v1/metrics/distribution/balance_exchanges_all?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Exchange Balance (Total)

get

Definition. The total amount of coins held on exchange addresses.\n\nTechnical. Exchange metrics are based on Glassnode's continually updated set of labeled exchange addresses, together with statistical and data-science methods that are refined over time. The series is therefore mutable: its established history is stable, but recent data points may revise as labels update. For methodology and limitations, see our article on exchange metrics and Exchange Data Transparency Notice.\n

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - (see metadata (metadata/metric) page for more details)

networkstringOptional

network values - aggregated, arb, base, eth, opt. Defaults to eth when omitted.

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:

cstringOptional

currency - native, usd

estringOptional

exchange name - aggregated, bibox, bigone, binance, bingx, bitcoin.de, bitfinex, bitflyer, bitget, bithumb, bitmex, bitpanda, bitstamp, bittrex, bybit, cobinhood, coinbase, coincheck, coinex, coinhako, coinspot, crypto.com, deribit, firi, ftx, gate.io, gemini, hashkey, hitbtc, huobi, indodax, korbit, kraken, kucoin, luno, mexc, nexo, okex, phemex, poloniex, robinhood, swissborg, upbit, uphold, zb.com

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:

Responses

200

Successful response

application/json

tinteger · int64Optional

Unix timestamp

Example: 1726790400

vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077

numberOptional

or

objectOptional

or

arrayOptional

400

Bad Request - Invalid parameters or unsupported asset

application/json

401

Unauthorized - Invalid or missing API key

application/json

429

Too Many Requests - Rate limit exceeded

application/json

get/v1/metrics/distribution/balance_exchanges

HTTPcURLJavaScriptPython

GET /v1/metrics/distribution/balance_exchanges?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Exchange Net Position Change

get

Definition. The 30-day change in the supply held in exchange wallets.\n\nTechnical. Exchange metrics are based on Glassnode's continually updated set of labeled exchange addresses, together with statistical and data-science methods that are refined over time. The series is therefore mutable: its established history is stable, but recent data points may revise as labels update. For methodology and limitations, see our article on exchange metrics and Exchange Data Transparency Notice.\n\nInterpretation. Negative prints reflect a 30-day window of net outflows from exchange-tagged addresses, positive prints reflect a 30-day window of net inflows.\n

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - (see metadata (metadata/metric) page for more details)

networkstringOptional

network values - aggregated, arb, base, eth, opt. Defaults to eth when omitted.

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:

cstringOptional

currency - native, usd

estringOptional

exchange name - aggregated, bibox, bigone, binance, bingx, bitcoin.de, bitfinex, bitflyer, bitget, bithumb, bitmex, bitpanda, bitstamp, bittrex, bybit, cobinhood, coinbase, coincheck, coinex, coinhako, coinspot, crypto.com, deribit, firi, ftx, gate.io, gemini, hashkey, hitbtc, huobi, indodax, korbit, kraken, kucoin, luno, mexc, nexo, okex, phemex, poloniex, robinhood, swissborg, upbit, uphold, zb.com

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:

Responses

200

Successful response

application/json

tinteger · int64Optional

Unix timestamp

Example: 1726790400

vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077

numberOptional

or

objectOptional

or

arrayOptional

400

Bad Request - Invalid parameters or unsupported asset

application/json

401

Unauthorized - Invalid or missing API key

application/json

429

Too Many Requests - Rate limit exceeded

application/json

get/v1/metrics/distribution/exchange_net_position_change

HTTPcURLJavaScriptPython

GET /v1/metrics/distribution/exchange_net_position_change?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Exchange Reliance Ratio

get

Definition. Exchange Reliance Ratio measures the net token flow (inflows minus outflows) at an exchange relative to that exchange's total balance, capturing how dependent a token's liquidity is on the specific platform.\n\nTechnical. The ratio is bounded between -1 and +1, with the sign carrying the direction of net cross-exchange flow. Exchange metrics are based on Glassnode's continually updated set of labeled exchange addresses, together with statistical and data-science methods that are refined over time. The series is therefore mutable: its established history is stable, but recent data points may revise as labels update. For methodology and limitations, see our article on exchange metrics and Exchange Data Transparency Notice.\n\nInterpretation. Elevated values indicate liquidity concentration within a single exchange and amplified systemic risk if disruptions occur, while extremely low values may signal insufficient liquidity if the condition persists.\n\nNotes. Introduced by CryptoVizArt. For further details, see his introductory article.\n

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:

estringOptional

exchange name - aggregated, bibox, bigone, binance, bingx, bitcoin.de, bitfinex, bitflyer, bitget, bithumb, bitmex, bitpanda, bitstamp, bittrex, bybit, cobinhood, coinbase, coincheck, coinex, coinhako, coinspot, crypto.com, deribit, firi, ftx, gate.io, gemini, hashkey, hitbtc, huobi, indodax, korbit, kraken, kucoin, luno, mexc, nexo, okex, phemex, poloniex, robinhood, swissborg, upbit, uphold, zb.com

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:

Responses

200

Successful response

application/json

tinteger · int64Optional

Unix timestamp

Example: 1726790400

vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077

numberOptional

or

objectOptional

or

arrayOptional

400

Bad Request - Invalid parameters or unsupported asset

application/json

401

Unauthorized - Invalid or missing API key

application/json

429

Too Many Requests - Rate limit exceeded

application/json

get/v1/metrics/distribution/exchange_reliance_ratio

HTTPcURLJavaScriptPython

GET /v1/metrics/distribution/exchange_reliance_ratio?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Exchange Reshuffling Ratio

get

Definition. Exchange Reshuffling Ratio quantifies the volume of internal (in-house) token transfers at an exchange relative to that exchange's total balance, averaged over a short rolling window.\n\nTechnical. Readings are capped to the 0-to-1 range. Exchange metrics are based on Glassnode's continually updated set of labeled exchange addresses, together with statistical and data-science methods that are refined over time. The series is therefore mutable: its established history is stable, but recent data points may revise as labels update. For methodology and limitations, see our article on exchange metrics and Exchange Data Transparency Notice.\n\nInterpretation. A higher ratio suggests the exchange is actively reallocating its liquidity internally, behavior that, if persistent, may warrant further investigation into the exchange's liquidity management practices. A lower ratio indicates more stable internal flows and a healthier operational state.\n\nNotes. Introduced by CryptoVizArt. For further details, see his introductory article.\n

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:

estringOptional

exchange name - aggregated, bibox, bigone, binance, bingx, bitcoin.de, bitfinex, bitflyer, bitget, bithumb, bitmex, bitpanda, bitstamp, bittrex, bybit, cobinhood, coinbase, coincheck, coinex, coinhako, coinspot, crypto.com, deribit, firi, ftx, gate.io, gemini, hashkey, hitbtc, huobi, indodax, korbit, kraken, kucoin, luno, mexc, nexo, okex, phemex, poloniex, robinhood, swissborg, upbit, uphold, zb.com

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:

Responses

200

Successful response

application/json

tinteger · int64Optional

Unix timestamp

Example: 1726790400

vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077

numberOptional

or

objectOptional

or

arrayOptional

400

Bad Request - Invalid parameters or unsupported asset

application/json

401

Unauthorized - Invalid or missing API key

application/json

429

Too Many Requests - Rate limit exceeded

application/json

get/v1/metrics/distribution/exchange_reshuffling_ratio

HTTPcURLJavaScriptPython

GET /v1/metrics/distribution/exchange_reshuffling_ratio?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Exchange Whales Outflow

get

Definition. Exchange Whales Outflow tracks the rolling volume of withdrawals from an exchange to large non-exchange entities, normalized by the exchange's balance.\n\nTechnical. Whale entities are non-exchange, non-miner clusters holding at least 1k coins. Exchange metrics are based on Glassnode's continually updated set of labeled exchange addresses, together with statistical and data-science methods that are refined over time. The series is therefore mutable: its established history is stable, but recent data points may revise as labels update. For methodology and limitations, see our article on exchange metrics and Exchange Data Transparency Notice.\n\nInterpretation. Higher values reflect increased whale-driven outflows, which may indicate active large-client withdrawal behavior. Concentrated single-exchange activity can result from internal wallet management under typical circumstances, but in extreme cases may signal declining client confidence or even a potential security breach.\n\nNotes. Introduced by CryptoVizArt. For further details, see his introductory article.\n

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:

estringOptional

exchange name - aggregated, binance, bitcoin.de, bitfinex, bitflyer, bitget, bithumb, bitmex, bitstamp, bittrex, bybit, coinbase, coincheck, coinex, coinspot, crypto.com, deribit, firi, ftx, gate.io, gemini, hashkey, hitbtc, huobi, indodax, korbit, kraken, kucoin, luno, mexc, okex, phemex, poloniex, robinhood, swissborg, upbit, uphold

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:

Responses

200

Successful response

application/json

tinteger · int64Optional

Unix timestamp

Example: 1726790400

vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077

numberOptional

or

objectOptional

or

arrayOptional

400

Bad Request - Invalid parameters or unsupported asset

application/json

401

Unauthorized - Invalid or missing API key

application/json

429

Too Many Requests - Rate limit exceeded

application/json

get/v1/metrics/distribution/exchange_whales_outflow

HTTPcURLJavaScriptPython

GET /v1/metrics/distribution/exchange_whales_outflow?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

[
  {
    "t": 1726790400,
    "v": 822077
  }
]

German Government Balance

get

Definition. German Government Balance is the amount of BTC held in addresses controlled by German authorities, including seized funds such as those from Movie2k that were seized by the German BKA.\n\nTechnical. The set of addresses contributing to the total balance is continuously updated.\n

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:

cstringOptional

currency - native, usd

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:

Responses

200

Successful response

application/json

tinteger · int64Optional

Unix timestamp

Example: 1726790400

vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077

numberOptional

or

objectOptional

or

arrayOptional

400

Bad Request - Invalid parameters or unsupported asset

application/json

401

Unauthorized - Invalid or missing API key

application/json

429

Too Many Requests - Rate limit exceeded

application/json

get/v1/metrics/distribution/balance_german_government

HTTPcURLJavaScriptPython

GET /v1/metrics/distribution/balance_german_government?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Gini Coefficient

get

Definition. Gini Coefficient is the classical inequality statistic applied to the distribution of coins over addresses.\n\nTechnical. Exchange addresses, smart-contract addresses, and other special asset-specific addresses (e.g. team-fund addresses) are excluded from the computation.\n\nInterpretation. Values run from 0 (perfectly even distribution across all addresses) to 1 (one address holding the entire included supply).\n

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:

Responses

200

Successful response

application/json

tinteger · int64Optional

Unix timestamp

Example: 1726790400

vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077

numberOptional

or

objectOptional

or

arrayOptional

400

Bad Request - Invalid parameters or unsupported asset

application/json

401

Unauthorized - Invalid or missing API key

application/json

429

Too Many Requests - Rate limit exceeded

application/json

get/v1/metrics/distribution/gini

HTTPcURLJavaScriptPython

GET /v1/metrics/distribution/gini?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Herfindahl Index

get

Definition. Herfindahl Index, originally a measure of competition, is adapted here as a metric for decentralization. It is defined as the sum of squared address shares of current supply across the network.\n\nTechnical. Exchange addresses, smart-contract addresses, and other special asset-specific addresses (e.g. team-fund addresses) are excluded.\n\nInterpretation. A large score indicates high concentration of supply, a small score indicates more evenly distributed funds across addresses.\n

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:

Responses

200

Successful response

application/json

tinteger · int64Optional

Unix timestamp

Example: 1726790400

vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077

numberOptional

or

objectOptional

or

arrayOptional

400

Bad Request - Invalid parameters or unsupported asset

application/json

401

Unauthorized - Invalid or missing API key

application/json

429

Too Many Requests - Rate limit exceeded

application/json

get/v1/metrics/distribution/herfindahl

HTTPcURLJavaScriptPython

GET /v1/metrics/distribution/herfindahl?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Luna Foundation Guard Balance

get

Definition. Luna Foundation Guard Balance is the amount of BTC held in addresses of the Luna Foundation Guard (LFG), which controlled the bitcoin reserve supporting the TerraUSD (UST) stablecoin.\n

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:

cstringOptional

currency - native, usd

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:

Responses

200

Successful response

application/json

tinteger · int64Optional

Unix timestamp

Example: 1726790400

vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077

numberOptional

or

objectOptional

or

arrayOptional

400

Bad Request - Invalid parameters or unsupported asset

application/json

401

Unauthorized - Invalid or missing API key

application/json

429

Too Many Requests - Rate limit exceeded

application/json

get/v1/metrics/distribution/balance_luna_foundation_guard

HTTPcURLJavaScriptPython

GET /v1/metrics/distribution/balance_luna_foundation_guard?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Miner Balance

get

Definition. The total supply held in miner addresses.\n

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:

cstringOptional

currency - native, usd

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:

Responses

200

Successful response

application/json

tinteger · int64Optional

Unix timestamp

Example: 1726790400

vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077

numberOptional

or

objectOptional

or

arrayOptional

400

Bad Request - Invalid parameters or unsupported asset

application/json

401

Unauthorized - Invalid or missing API key

application/json

429

Too Many Requests - Rate limit exceeded

application/json

get/v1/metrics/distribution/balance_miners_sum

HTTPcURLJavaScriptPython

GET /v1/metrics/distribution/balance_miners_sum?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Miner Balance (Stacked)

get

Definition. The total supply held in miner addresses. Supply is broken out by individual mining pool so each entity's share is read separately.\n

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:

cstringOptional

currency - native, usd

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:

Responses

200

Successful response

application/json

tinteger · int64Optional

Unix timestamp

Example: 1726790400

vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077

numberOptional

or

objectOptional

or

arrayOptional

400

Bad Request - Invalid parameters or unsupported asset

application/json

401

Unauthorized - Invalid or missing API key

application/json

429

Too Many Requests - Rate limit exceeded

application/json

get/v1/metrics/distribution/balance_miners_all

HTTPcURLJavaScriptPython

GET /v1/metrics/distribution/balance_miners_all?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Miner Net Position Change

get

Definition. The 30-day change of the supply held in miner addresses.\n\nInterpretation. Positive prints indicate the miner cohort is a net sink over the trailing month (accumulation), negative prints indicate it is a net source (distribution).\n

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:

cstringOptional

currency - native, usd

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:

Responses

200

Successful response

application/json

tinteger · int64Optional

Unix timestamp

Example: 1726790400

vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077

numberOptional

or

objectOptional

or

arrayOptional

400

Bad Request - Invalid parameters or unsupported asset

application/json

401

Unauthorized - Invalid or missing API key

application/json

429

Too Many Requests - Rate limit exceeded

application/json

get/v1/metrics/distribution/balance_miners_change

HTTPcURLJavaScriptPython

GET /v1/metrics/distribution/balance_miners_change?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Mt. Gox Balance

get

Definition. Mt. Gox Trustee Balance is the amount of BTC held in addresses controlled by Nobuaki Kobayashi, the trustee overseeing the Mt. Gox civil rehabilitation proceedings.\n

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:

cstringOptional

currency - native, usd

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:

Responses

200

Successful response

application/json

tinteger · int64Optional

Unix timestamp

Example: 1726790400

vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077

numberOptional

or

objectOptional

or

arrayOptional

400

Bad Request - Invalid parameters or unsupported asset

application/json

401

Unauthorized - Invalid or missing API key

application/json

429

Too Many Requests - Rate limit exceeded

application/json

get/v1/metrics/distribution/balance_mtgox_trustee

HTTPcURLJavaScriptPython

GET /v1/metrics/distribution/balance_mtgox_trustee?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Mt. Gox Outflows

get

Definition. The movements of BTC out of the balances held by Nobuaki Kobayashi, the trustee supervising the civil rehabilitation proceedings of Mt. Gox. The series itemises BTC transactions flowing from Mt. Gox to individual exchanges or other recognized entities, tracking the redistribution of these assets over time.\n

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:

Responses

200

Successful response

application/json

tinteger · int64Optional

Unix timestamp

Example: 1726790400

vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077

numberOptional

or

objectOptional

or

arrayOptional

400

Bad Request - Invalid parameters or unsupported asset

application/json

401

Unauthorized - Invalid or missing API key

application/json

429

Too Many Requests - Rate limit exceeded

application/json

get/v1/metrics/distribution/outflows_mtgox_trustee

HTTPcURLJavaScriptPython

GET /v1/metrics/distribution/outflows_mtgox_trustee?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

[
  {
    "t": 1726790400,
    "v": 822077
  }
]

OTC Desks Holdings

get

Definition. Balance of Known OTC Desks is the cumulative balance of stored in addresses associated with Over-The-Counter (OTC) desks, covering three identified desks and therefore representing a sample of the broader OTC market rather than its entirety.\n\nTechnical. OTC metrics are based on Glassnode's continually updated set of labeled OTC-desk addresses, together with statistical and data-science methods that are refined over time. The series is therefore mutable: its established history is stable, but recent data points may revise as labels update.\n

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:

cstringOptional

currency - native, usd

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:

Responses

200

Successful response

application/json

tinteger · int64Optional

Unix timestamp

Example: 1726790400

vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077

numberOptional

or

objectOptional

or

arrayOptional

400

Bad Request - Invalid parameters or unsupported asset

application/json

401

Unauthorized - Invalid or missing API key

application/json

429

Too Many Requests - Rate limit exceeded

application/json

get/v1/metrics/distribution/balance_otc_desks

HTTPcURLJavaScriptPython

GET /v1/metrics/distribution/balance_otc_desks?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

[
  {
    "t": 1726790400,
    "v": 822077
  }
]

PayPal Balance

get

Definition. The amount of BTC held in addresses controlled by PayPal Holdings, Inc.\n\nTechnical. Based on address labels that are continuously updated. The values shown here provide an estimate and may not necessarily reflect the full balance.\n

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:

cstringOptional

currency - native, usd

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:

Responses

200

Successful response

application/json

tinteger · int64Optional

Unix timestamp

Example: 1726790400

vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077

numberOptional

or

objectOptional

or

arrayOptional

400

Bad Request - Invalid parameters or unsupported asset

application/json

401

Unauthorized - Invalid or missing API key

application/json

429

Too Many Requests - Rate limit exceeded

application/json

get/v1/metrics/distribution/balance_paypal

HTTPcURLJavaScriptPython

GET /v1/metrics/distribution/balance_paypal?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Proof of Reserves

get

Definition. The total balance on the self-reported exchange addresses that constitute an exchange's on-chain reserves as officially disclosed.\n\nTechnical. Only our supported blockchains are incorporated. Proof-of-reserve data differs from Glassnode's exchange balance metrics, which monitor a broader set of clustering-derived exchange addresses, the disclosed set tracked here is a strict subset of that wider coverage.\n\nNotes. For more information, see the article on proof-of-reserve metrics.\n

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - (see metadata (metadata/metric) page for more details)

networkstringOptional

network values - aggregated, arb, base, eth, opt. Defaults to eth when omitted.

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:

cstringOptional

currency - native, usd

estringRequired

exchange name - binance, bingx, BITB, bitfinex, bitget, bitmart, bitmex, bitstamp, bybit, checksig.com, coinex, crypto.com, deribit, gate.io, gemini, huobi, korbit, kucoin, lbank, mexc, okex, phemex, swissborg

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:

Responses

200

Successful response

application/json

tinteger · int64Optional

Unix timestamp

Example: 1726790400

vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077

numberOptional

or

objectOptional

or

arrayOptional

400

Bad Request - Invalid parameters or unsupported asset

application/json

401

Unauthorized - Invalid or missing API key

application/json

429

Too Many Requests - Rate limit exceeded

application/json

get/v1/metrics/distribution/proof_of_reserves

HTTPcURLJavaScriptPython

GET /v1/metrics/distribution/proof_of_reserves?a=text&e=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Proof of Reserves (All assets)

get

Definition. The total balance (in USD) of the largest holdings on self-reported exchange addresses, as officially disclosed by the exchanges. At most the top 10 assets by balance are shown, with all others combined into an 'Other' category.\n\nTechnical. Only our supported blockchains are incorporated, so 'Other' should be treated as a lower bound on additional exchange holdings. Proof-of-reserves data differs from the broader exchange balance metrics, which strictly monitor only officially communicated exchange addresses, a subset of all addresses included in the more comprehensive exchange metrics.\n\nNotes. For more information, see the article on proof-of-reserve metrics.\n

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:

estringRequired

exchange name - binance, bingx, BITB, bitfinex, bitget, bitmart, bitmex, bitstamp, bybit, checksig.com, coinex, crypto.com, deribit, gate.io, gemini, huobi, korbit, kucoin, lbank, mexc, okex, phemex, swissborg

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:

Responses

200

Successful response

application/json

tinteger · int64Optional

Unix timestamp

Example: 1726790400

vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077

numberOptional

or

objectOptional

or

arrayOptional

400

Bad Request - Invalid parameters or unsupported asset

application/json

401

Unauthorized - Invalid or missing API key

application/json

429

Too Many Requests - Rate limit exceeded

application/json

get/v1/metrics/distribution/proof_of_reserves_all

HTTPcURLJavaScriptPython

GET /v1/metrics/distribution/proof_of_reserves_all?a=text&e=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Proof of Reserves (Current)

get

Definition. The latest balance on each exchange's self-reported reserve addresses, alongside the corresponding 24-hour change. At most the top 10 assets by balance are shown explicitly, with the remainder combined into an 'Other' category.\n\nTechnical. Only our supported blockchains are incorporated, so 'Other' should be treated as a lower bound on additional exchange holdings. Proof-of-reserve data differs from Glassnode's exchange balance metrics, which monitor a broader set of clustering-derived exchange addresses, the disclosed set tracked here is a strict subset of that wider coverage.\n\nNotes. For more information, see the article on proof-of-reserve metrics.\n

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - (see metadata (metadata/metric) page for more details)

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:

cstringOptional

currency - native, usd

estringRequired

exchange name - binance, bingx, BITB, bitfinex, bitget, bitmart, bitmex, bitstamp, bybit, checksig.com, coinex, crypto.com, deribit, gate.io, gemini, huobi, korbit, kucoin, lbank, mexc, okex, phemex, swissborg

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:

Responses

200

Successful response

application/json

tinteger · int64Optional

Unix timestamp

Example: 1726790400

vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077

numberOptional

or

objectOptional

or

arrayOptional

400

Bad Request - Invalid parameters or unsupported asset

application/json

401

Unauthorized - Invalid or missing API key

application/json

429

Too Many Requests - Rate limit exceeded

application/json

get/v1/metrics/distribution/proof_of_reserves_all_latest

HTTPcURLJavaScriptPython

GET /v1/metrics/distribution/proof_of_reserves_all_latest?a=text&e=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Reliance Ratio Breakdown

get

The Exchange Reliance Ratio Breakdown returns the Reliance Ratio for every supported exchange in a single response, enabling cross-exchange comparison at a glance. Each entry maps an exchange name to its net token flow (inflows minus outflows) relative to that exchange’s total balance. Elevated values across multiple exchanges may signal liquidity concentration risk, while outliers can highlight venues whose token liquidity is unusually dependent on a small set of flows.\n\nThis metric was introduced by CryptoVizArt. For further details, please refer to his introductory article.

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - (see metadata (metadata/metric) page for more details)

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:

Responses

200

Successful response

application/json

tinteger · int64Optional

Unix timestamp

Example: 1726790400

vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077

numberOptional

or

objectOptional

or

arrayOptional

400

Bad Request - Invalid parameters or unsupported asset

application/json

401

Unauthorized - Invalid or missing API key

application/json

429

Too Many Requests - Rate limit exceeded

application/json

get/v1/metrics/distribution/exchange_reliance_ratio_breakdown

HTTPcURLJavaScriptPython

GET /v1/metrics/distribution/exchange_reliance_ratio_breakdown?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Reshuffling Ratio Breakdown

get

The Exchange Reshuffling Ratio Breakdown returns the Reshuffling Ratio for every supported exchange in a single response, enabling cross-exchange comparison at a glance. Each entry maps an exchange name to its current ratio of internal (in-house) token transfer volume relative to its total balance, averaged over a short rolling window. Higher values across multiple exchanges may indicate sector-wide liquidity stress, while outliers can highlight venues actively reallocating assets internally and worth deeper investigation.\n\nThis metric was introduced by CryptoVizArt. For further details, please refer to his introductory article.

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - (see metadata (metadata/metric) page for more details)

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:

Responses

200

Successful response

application/json

tinteger · int64Optional

Unix timestamp

Example: 1726790400

vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077

numberOptional

or

objectOptional

or

arrayOptional

400

Bad Request - Invalid parameters or unsupported asset

application/json

401

Unauthorized - Invalid or missing API key

application/json

429

Too Many Requests - Rate limit exceeded

application/json

get/v1/metrics/distribution/exchange_reshuffling_ratio_breakdown

HTTPcURLJavaScriptPython

GET /v1/metrics/distribution/exchange_reshuffling_ratio_breakdown?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Revolut Balance

get

The amount of BTC held in addresses controlled by Revolut Group Holdings Ltd. Note that this metric is based on address labels that we constantly keep updating. The values shown here provide an estimate and may not necessarily reflect the full balance.

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:

cstringOptional

currency - native, usd

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:

Responses

200

Successful response

application/json

tinteger · int64Optional

Unix timestamp

Example: 1726790400

vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077

numberOptional

or

objectOptional

or

arrayOptional

400

Bad Request - Invalid parameters or unsupported asset

application/json

401

Unauthorized - Invalid or missing API key

application/json

429

Too Many Requests - Rate limit exceeded

application/json

get/v1/metrics/distribution/balance_revolut

HTTPcURLJavaScriptPython

GET /v1/metrics/distribution/balance_revolut?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Robinhood Balance

get

The amount of BTC held in addresses controlled by Robinhood Markets, Inc. Note that this metric is based on address labels that we constantly keep updating. The values shown here provide an estimate and may not necessarily reflect the full balance.

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:

cstringOptional

currency - native, usd

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:

Responses

200

Successful response

application/json

tinteger · int64Optional

Unix timestamp

Example: 1726790400

vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077

numberOptional

or

objectOptional

or

arrayOptional

400

Bad Request - Invalid parameters or unsupported asset

application/json

401

Unauthorized - Invalid or missing API key

application/json

429

Too Many Requests - Rate limit exceeded

application/json

get/v1/metrics/distribution/balance_robinhood

HTTPcURLJavaScriptPython

GET /v1/metrics/distribution/balance_robinhood?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Supply in Smart Contracts

get

Definition. The percentage of total token supply held in smart contracts.\n

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:

Responses

200

Successful response

application/json

tinteger · int64Optional

Unix timestamp

Example: 1726790400

vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077

numberOptional

or

objectOptional

or

arrayOptional

400

Bad Request - Invalid parameters or unsupported asset

application/json

401

Unauthorized - Invalid or missing API key

application/json

429

Too Many Requests - Rate limit exceeded

application/json

get/v1/metrics/distribution/supply_contracts

HTTPcURLJavaScriptPython

GET /v1/metrics/distribution/supply_contracts?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Supply of Top 1% Addresses

get

Definition. The percentage of supply held by the top 1% of addresses by balance.\n\nTechnical. Exchange addresses, smart contract addresses, and other special asset-specific addresses (e.g. team fund addresses) are excluded.\n

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:

Responses

200

Successful response

application/json

tinteger · int64Optional

Unix timestamp

Example: 1726790400

vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077

numberOptional

or

objectOptional

or

arrayOptional

400

Bad Request - Invalid parameters or unsupported asset

application/json

401

Unauthorized - Invalid or missing API key

application/json

429

Too Many Requests - Rate limit exceeded

application/json

get/v1/metrics/distribution/balance_1pct_holders

HTTPcURLJavaScriptPython

GET /v1/metrics/distribution/balance_1pct_holders?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Tesla Balance

get

Definition. Tesla Balance is the amount of BTC held in addresses controlled by Tesla, Inc.\n\nTechnical. The metric is based on address labels that are continuously updated. The values shown provide an estimate and may not reflect the full balance.\n

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:

cstringOptional

currency - native, usd

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:

Responses

200

Successful response

application/json

tinteger · int64Optional

Unix timestamp

Example: 1726790400

vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077

numberOptional

or

objectOptional

or

arrayOptional

400

Bad Request - Invalid parameters or unsupported asset

application/json

401

Unauthorized - Invalid or missing API key

application/json

429

Too Many Requests - Rate limit exceeded

application/json

get/v1/metrics/distribution/balance_tesla

HTTPcURLJavaScriptPython

GET /v1/metrics/distribution/balance_tesla?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

[
  {
    "t": 1726790400,
    "v": 822077
  }
]

Tether Treasury Balance

get

Definition. Tether Treasury Balance is the amount of BTC held in addresses controlled by Tether.\n

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:

cstringOptional

currency - native, usd

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:

Responses

200

Successful response

application/json

tinteger · int64Optional

Unix timestamp

Example: 1726790400

vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077

numberOptional

or

objectOptional

or

arrayOptional

400

Bad Request - Invalid parameters or unsupported asset

application/json

401

Unauthorized - Invalid or missing API key

application/json

429

Too Many Requests - Rate limit exceeded

application/json

get/v1/metrics/distribution/balance_tether_treasury

HTTPcURLJavaScriptPython

GET /v1/metrics/distribution/balance_tether_treasury?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

[
  {
    "t": 1726790400,
    "v": 822077
  }
]

UK Government Balance

get

Definition. UK Government Balance is the amount of BTC held in addresses controlled by UK authorities.\n\nTechnical. The metric is based on address labels that are continuously updated. The values shown provide an estimate and may not reflect the full balance.\n

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:

cstringOptional

currency - native, usd

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:

Responses

200

Successful response

application/json

tinteger · int64Optional

Unix timestamp

Example: 1726790400

vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077

numberOptional

or

objectOptional

or

arrayOptional

400

Bad Request - Invalid parameters or unsupported asset

application/json

401

Unauthorized - Invalid or missing API key

application/json

429

Too Many Requests - Rate limit exceeded

application/json

get/v1/metrics/distribution/balance_uk_government

HTTPcURLJavaScriptPython

GET /v1/metrics/distribution/balance_uk_government?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

[
  {
    "t": 1726790400,
    "v": 822077
  }
]

US Government Balance

get

Definition. US Government Balance is the amount of BTC held in addresses controlled by US authorities, including seized funds such as those from the 2016 Bitfinex Hack and the 2012 Silk Road Hack.\n\nTechnical. The set of addresses contributing to the total balance is continuously updated.\n

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:

cstringOptional

currency - native, usd

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:

Responses

200

Successful response

application/json

tinteger · int64Optional

Unix timestamp

Example: 1726790400

vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077

numberOptional

or

objectOptional

or

arrayOptional

400

Bad Request - Invalid parameters or unsupported asset

application/json

401

Unauthorized - Invalid or missing API key

application/json

429

Too Many Requests - Rate limit exceeded

application/json

get/v1/metrics/distribution/balance_us_government

HTTPcURLJavaScriptPython

GET /v1/metrics/distribution/balance_us_government?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

[
  {
    "t": 1726790400,
    "v": 822077
  }
]

WBTC Balance

get

Definition. Wrapped BTC (WBTC) Balance is the amount of BTC held by BitGo as backing for Wrapped Bitcoin (WBTC), the first ERC20 token backed 1:1 with Bitcoin and designed to represent Bitcoin on the Ethereum blockchain.\n\nTechnical. BitGo is the custodian responsible for minting new WBTC ERC20 tokens and guaranteeing that newly minted tokens are backed by actual BTC.\n

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - (see metadata (metadata/metric) page for more details)

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 10m, 1h, 24h

fstring · enumOptional

format - csv, json

Default: jsonPossible values:

cstringOptional

currency - native, usd

timestamp_formatstring · enumOptional

timestamp format - unix or humanized (RFC 3339)

Default: unixPossible values:

Responses

200

Successful response

application/json

tinteger · int64Optional

Unix timestamp

Example: 1726790400

vone ofOptional

Metric value (can be number, object, or array depending on the metric)

Example: 822077

numberOptional

or

objectOptional

or

arrayOptional

400

Bad Request - Invalid parameters or unsupported asset

application/json

401

Unauthorized - Invalid or missing API key

application/json

429

Too Many Requests - Rate limit exceeded

application/json

get/v1/metrics/distribution/balance_wbtc

HTTPcURLJavaScriptPython

GET /v1/metrics/distribution/balance_wbtc?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

[
  {
    "t": 1726790400,
    "v": 822077
  }
]