Blockchain

Block Height

get

The block height, i.e. the total number of blocks ever created and included in the main blockchain.

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - BTC, ETH

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

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/blockchain/block_height

HTTPcURLJavaScriptPython

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

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

Block Interval (Mean)

get

The mean time (in seconds) between mined blocks.

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - BTC, ETH

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

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/blockchain/block_interval_mean

HTTPcURLJavaScriptPython

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

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

Block Interval (Median)

get

The median time (in seconds) between mined blocks.

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - BTC, ETH

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

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/blockchain/block_interval_median

HTTPcURLJavaScriptPython

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

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

Block Size (Mean)

get

The mean size of all blocks created within the time period (in bytes).

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - BTC, ETH

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

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/blockchain/block_size_mean

HTTPcURLJavaScriptPython

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

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

Block Size (Total)

get

The total size of all blocks created within the time period (in bytes).

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - BTC, ETH

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

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/blockchain/block_size_sum

HTTPcURLJavaScriptPython

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

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

Blocks Mined

get

The number of blocks created and included in the main blockchain in that time period.

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - BTC, ETH

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

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/blockchain/block_count

HTTPcURLJavaScriptPython

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

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

Percent UTXOs in Profit

get

The percentage of unspent transaction outputs whose price at creation time was lower than the current price. For more information see this article.

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - BTC

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

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/blockchain/utxo_profit_relative

HTTPcURLJavaScriptPython

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

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

UTXO Value Created (Mean)

get

The mean amount of coins in newly created UTXOs.

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - BTC

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

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/blockchain/utxo_created_value_mean

HTTPcURLJavaScriptPython

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

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

UTXO Value Created (Median)

get

The median amount of coins in newly created UTXOs.

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - BTC

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

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/blockchain/utxo_created_value_median

HTTPcURLJavaScriptPython

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

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

UTXO Value Created (Total)

get

The total amount of coins in newly created UTXOs.

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - BTC

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

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/blockchain/utxo_created_value_sum

HTTPcURLJavaScriptPython

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

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

UTXO Value Spent (Mean)

get

The mean amount of coins in spent transaction outputs.

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - BTC

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

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/blockchain/utxo_spent_value_mean

HTTPcURLJavaScriptPython

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

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

UTXO Value Spent (Median)

get

The median amount of coins in spent transaction outputs.

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - BTC

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

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/blockchain/utxo_spent_value_median

HTTPcURLJavaScriptPython

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

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

UTXO Value Spent (Total)

get

The total amount of coins in spent transaction outputs.

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - BTC

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

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/blockchain/utxo_spent_value_sum

HTTPcURLJavaScriptPython

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

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

UTXOs (Total)

get

The total number of UTXOs in the network.

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - BTC

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

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/blockchain/utxo_count

HTTPcURLJavaScriptPython

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

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

UTXOs Created

get

The number of created unspent transaction outputs.

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - BTC

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

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/blockchain/utxo_created_count

HTTPcURLJavaScriptPython

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

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

UTXOs in Loss

get

The number of unspent transaction outputs whose price at creation time was higher than the current price. For more information see this article.

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - BTC

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

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/blockchain/utxo_loss_count

HTTPcURLJavaScriptPython

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

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

UTXOs in Profit

get

The number of unspent transaction outputs whose price at creation time was lower than the current price. For more information see this article.

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - BTC

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

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/blockchain/utxo_profit_count

HTTPcURLJavaScriptPython

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

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

UTXOs Spent

get

The number of spent transaction outputs.

View in Studio

Authorizations

ApiKeyAuth

api_keystringRequired

Your Glassnode API key

Query parameters

astringRequired

asset id - BTC

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

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/blockchain/utxo_spent_count

HTTPcURLJavaScriptPython

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

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