Blockchain

Block Height

GET https://api.glassnode.com/v1/metrics/blockchain/block_height

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
Query parameters
astringRequired

asset id - BTC, ETH

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 1h, 24h, 10m, 1w, 1month

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
get
GET /v1/metrics/blockchain/block_height HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
  {
    "t": 1726790400,
    "v": 862171
  }
]

Query Parameters

Name
Type
Description

a*

string

asset id - BTC, ETH

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval - 1h, 24h, 10m, 1w, 1month

f

string

format - csv, json

timestamp_format

string

timestamp format - unix or humanized (RFC 3339)

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

Block Interval (Mean)

GET https://api.glassnode.com/v1/metrics/blockchain/block_interval_mean

Query Parameters

Name
Type
Description

a*

string

asset id - BTC, ETH

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval - 1h, 24h, 10m, 1w, 1month

f

string

format - csv, json

timestamp_format

string

timestamp format - unix or humanized (RFC 3339)

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

Block Interval (Median)

GET https://api.glassnode.com/v1/metrics/blockchain/block_interval_median

Query Parameters

Name
Type
Description

a*

string

asset id - BTC, ETH

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval - 1h, 24h, 10m, 1w, 1month

f

string

format - csv, json

timestamp_format

string

timestamp format - unix or humanized (RFC 3339)

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

Block Size (Mean)

GET https://api.glassnode.com/v1/metrics/blockchain/block_size_mean

Block Size (Mean)

get

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

View in Studio

Authorizations
Query parameters
astringRequired

asset id - BTC, ETH

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 1h, 24h, 10m, 1w, 1month

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
get
GET /v1/metrics/blockchain/block_size_mean HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
  {
    "t": 1726790400,
    "v": 1661256.979310345
  }
]

Query Parameters

Name
Type
Description

a*

string

asset id - BTC, ETH

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval - 1h, 24h, 10m, 1w, 1month

f

string

format - csv, json

timestamp_format

string

timestamp format - unix or humanized (RFC 3339)

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

Block Size (Total)

GET https://api.glassnode.com/v1/metrics/blockchain/block_size_sum

Block Size (Total)

get

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

View in Studio

Authorizations
Query parameters
astringRequired

asset id - BTC, ETH

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 1h, 24h, 10m, 1w, 1month

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
get
GET /v1/metrics/blockchain/block_size_sum HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
  {
    "t": 1726790400,
    "v": 240882262
  }
]

Query Parameters

Name
Type
Description

a*

string

asset id - BTC, ETH

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval - 1h, 24h, 10m, 1w, 1month

f

string

format - csv, json

timestamp_format

string

timestamp format - unix or humanized (RFC 3339)

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

Blocks Mined

GET https://api.glassnode.com/v1/metrics/blockchain/block_count

Blocks Mined

get

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

View in Studio

Authorizations
Query parameters
astringRequired

asset id - BTC, ETH

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 1h, 24h, 10m, 1w, 1month

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
get
GET /v1/metrics/blockchain/block_count HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
  {
    "t": 1726790400,
    "v": 145
  }
]

Query Parameters

Name
Type
Description

a*

string

asset id - BTC, ETH

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval - 1h, 24h, 10m, 1w, 1month

f

string

format - csv, json

timestamp_format

string

timestamp format - unix or humanized (RFC 3339)

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

Percent UTXOs in Profit

GET https://api.glassnode.com/v1/metrics/blockchain/utxo_profit_relative

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
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
get
GET /v1/metrics/blockchain/utxo_profit_relative HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
  {
    "t": 1726790400,
    "v": 0.803661312846928
  }
]

Query Parameters

Name
Type
Description

a*

string

asset id - BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval - 1h, 24h

f

string

format - csv, json

timestamp_format

string

timestamp format - unix or humanized (RFC 3339)

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

UTXO Value Created (Mean)

GET https://api.glassnode.com/v1/metrics/blockchain/utxo_created_value_mean

UTXO Value Created (Mean)

get

The mean amount of coins in newly created UTXOs.

View in Studio

Authorizations
Query parameters
astringRequired

asset id - BTC

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 1h, 24h, 10m, 1w, 1month

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
get
GET /v1/metrics/blockchain/utxo_created_value_mean HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
  {
    "t": 1726790400,
    "v": 0.7248314081283942
  }
]

Query Parameters

Name
Type
Description

a*

string

asset id - BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval - 1h, 24h, 10m, 1w, 1month

f

string

format - csv, json

c

string

currency - native, usd

timestamp_format

string

timestamp format - unix or humanized (RFC 3339)

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

UTXO Value Created (Median)

GET https://api.glassnode.com/v1/metrics/blockchain/utxo_created_value_median

UTXO Value Created (Median)

get

The median amount of coins in newly created UTXOs.

View in Studio

Authorizations
Query parameters
astringRequired

asset id - BTC

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 1h, 24h, 10m, 1w, 1month

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
get
GET /v1/metrics/blockchain/utxo_created_value_median HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
  {
    "t": 1726790400,
    "v": 0.00032499
  }
]

Query Parameters

Name
Type
Description

a*

string

asset id - BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval - 1h, 24h, 10m, 1w, 1month

f

string

format - csv, json

c

string

currency - native, usd

timestamp_format

string

timestamp format - unix or humanized (RFC 3339)

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

UTXO Value Created (Total)

GET https://api.glassnode.com/v1/metrics/blockchain/utxo_created_value_sum

UTXO Value Created (Total)

get

The total amount of coins in newly created UTXOs.

View in Studio

Authorizations
Query parameters
astringRequired

asset id - BTC

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 1h, 24h, 10m, 1w, 1month

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
get
GET /v1/metrics/blockchain/utxo_created_value_sum HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
  {
    "t": 1726790400,
    "v": 980010.47985418
  }
]

Query Parameters

Name
Type
Description

a*

string

asset id - BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval - 1h, 24h, 10m, 1w, 1month

f

string

format - csv, json

c

string

currency - native, usd

timestamp_format

string

timestamp format - unix or humanized (RFC 3339)

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

UTXO Value Spent (Mean)

GET https://api.glassnode.com/v1/metrics/blockchain/utxo_spent_value_mean

UTXO Value Spent (Mean)

get

The mean amount of coins in spent transaction outputs.

View in Studio

Authorizations
Query parameters
astringRequired

asset id - BTC

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 1h, 24h, 10m, 1w, 1month

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
get
GET /v1/metrics/blockchain/utxo_spent_value_mean HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
  {
    "t": 1726790400,
    "v": 0.8495012603919359
  }
]

Query Parameters

Name
Type
Description

a*

string

asset id - BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval - 1h, 24h, 10m, 1w, 1month

f

string

format - csv, json

c

string

currency - native, usd

timestamp_format

string

timestamp format - unix or humanized (RFC 3339)

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

UTXO Value Spent (Median)

GET https://api.glassnode.com/v1/metrics/blockchain/utxo_spent_value_median

UTXO Value Spent (Median)

get

The median amount of coins in spent transaction outputs.

View in Studio

Authorizations
Query parameters
astringRequired

asset id - BTC

sintegerOptional

since, unix timestamp

uintegerOptional

until, unix timestamp

istringOptional

frequency interval - 1h, 24h, 10m, 1w, 1month

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
get
GET /v1/metrics/blockchain/utxo_spent_value_median HTTP/1.1
Host: api.glassnode.com
Accept: */*
[
  {
    "t": 1726790400,
    "v": 0.0007047
  }
]

Query Parameters

Name
Type
Description

a*

string

asset id - BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval - 1h, 24h, 10m, 1w, 1month

f

string

format - csv, json

c

string

currency - native, usd

timestamp_format

string

timestamp format - unix or humanized (RFC 3339)

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

UTXO Value Spent (Total)

GET https://api.glassnode.com/v1/metrics/blockchain/utxo_spent_value_sum

Query Parameters

Name
Type
Description

a*

string

asset id - BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval - 1h, 24h, 10m, 1w, 1month

f

string

format - csv, json

c

string

currency - native, usd

timestamp_format

string

timestamp format - unix or humanized (RFC 3339)

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

UTXOs (Total)

GET https://api.glassnode.com/v1/metrics/blockchain/utxo_count

Query Parameters

Name
Type
Description

a*

string

asset id - BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval - 1h, 24h, 10m, 1w, 1month

f

string

format - csv, json

timestamp_format

string

timestamp format - unix or humanized (RFC 3339)

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

UTXOs Created

GET https://api.glassnode.com/v1/metrics/blockchain/utxo_created_count

Query Parameters

Name
Type
Description

a*

string

asset id - BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval - 1h, 24h, 10m, 1w, 1month

f

string

format - csv, json

timestamp_format

string

timestamp format - unix or humanized (RFC 3339)

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

UTXOs in Loss

GET https://api.glassnode.com/v1/metrics/blockchain/utxo_loss_count

Query Parameters

Name
Type
Description

a*

string

asset id - BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval - 1h, 24h

f

string

format - csv, json

timestamp_format

string

timestamp format - unix or humanized (RFC 3339)

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

UTXOs in Profit

GET https://api.glassnode.com/v1/metrics/blockchain/utxo_profit_count

Query Parameters

Name
Type
Description

a*

string

asset id - BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval - 1h, 24h

f

string

format - csv, json

timestamp_format

string

timestamp format - unix or humanized (RFC 3339)

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

UTXOs Spent

GET https://api.glassnode.com/v1/metrics/blockchain/utxo_spent_count

Query Parameters

Name
Type
Description

a*

string

asset id - BTC

s

integer

since, unix timestamp

u

integer

until, unix timestamp

i

string

frequency interval - 1h, 24h, 10m, 1w, 1month

f

string

format - csv, json

timestamp_format

string

timestamp format - unix or humanized (RFC 3339)

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

Last updated