Mining

Difficulty

get

Definition. The current estimated number of hashes required to mine a block.\n\nTechnical. difficulty is often denoted as the relative difficulty with respect to the genesis block, which required approximately 2^32 hashes. For better comparison across blockchains, values here are denoted in raw hashes.\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, 1month, 1w, 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/mining/difficulty_latest

HTTPcURLJavaScriptPython

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

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

Hash Rate

get

Definition. The average estimated number of hashes per second produced by miners in the network.\n\nTechnical. Hash rate is not directly observable on-chain and is inferred from realised block intervals against current mining difficulty.\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, 1month, 1w, 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/mining/hash_rate_mean

HTTPcURLJavaScriptPython

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

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

Market Cap to Thermocap Ratio

get

Definition. Market Cap to Thermocap Ratio is the ratio of Market Cap to Thermocap, used to assess whether the asset's price is currently trading at a premium with respect to total security spend by miners.\n\nTechnical. The ratio is adjusted to account for the increasing circulating supply 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 - 1h, 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/mining/marketcap_thermocap_ratio

HTTPcURLJavaScriptPython

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

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

Miner Outflow Multiple

get

Definition. Miner Outflow Multiple identifies periods where the amount of flowing out of miner addresses is high relative to its historical average.\n\nTechnical. Computed as the ratio of miner outflow to its 365-day moving average, in USD.\n\nInterpretation. A reading near 1 reflects miner outflow in line with its trailing-year average. Readings well above 1 reflect accelerated distribution, below 1 suppressed 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:

minerstringOptional

miner name (see /v1/metrics/mining/miners_outflow_multiple/miners for a full list)

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/mining/miners_outflow_multiple

HTTPcURLJavaScriptPython

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

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

Miner Revenue (Block Rewards)

get

Definition. The total amount of newly minted coins paid to miners as the block subsidy.\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

minerstringOptional

miner name (see /v1/metrics/mining/volume_mined_sum/miners for a full list)

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/mining/volume_mined_sum

HTTPcURLJavaScriptPython

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

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

Miner Revenue (Fees)

get

Definition. The percentage of miner revenue derived from transaction fees, computed as fees divided by fees plus newly minted coins.\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:

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/mining/revenue_from_fees

HTTPcURLJavaScriptPython

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

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

Miner Revenue (Total)

get

Definition. The total miner revenue, equal to transaction fees plus the value of newly minted coins.\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

minerstringOptional

miner name (see /v1/metrics/mining/revenue_sum/miners for a full list)

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/mining/revenue_sum

HTTPcURLJavaScriptPython

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

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

Miner Unspent Supply

get

Definition. The total amount sitting in coinbase outputs that have never been moved since issuance.\n\nInterpretation. A rising series indicates miners are retaining newly issued coins in their original coinbase outputs, a falling series indicates those outputs are being spent.\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, 1month, 1w, 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/mining/miners_unspent_supply

HTTPcURLJavaScriptPython

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

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

Thermocap

get

Definition. Aggregate Security Spend, or Thermocap, is the cumulative USD value of all coins paid to miners since genesis, serving as a proxy for the mining resources spent to secure the network.\n\nTechnical. Computed as the aggregate of coinbase transactions multiplied by the spot price in USD at the time each block was mined.\n\nNotes. First proposed by Nic Carter.\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 - 1h, 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/mining/thermocap

HTTPcURLJavaScriptPython

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

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