Work directly with Glassnode engineers to solve integration and data challenges.
Request a quote from Glassnode Expert Services
Ctrlk
WebsiteStudioInsightsTwitter
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Blockchain

Block Height

get

Definition. The total number of blocks ever created and included in the main chain, i.e. the current block height.\n

View in Studio

Authorizations
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, 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
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
get/v1/metrics/blockchain/block_height
GET /v1/metrics/blockchain/block_height?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

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

Block Interval (Mean)

get

Definition. The mean time, in seconds, between mined blocks.\n

View in Studio

Authorizations
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, 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
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
get/v1/metrics/blockchain/block_interval_mean
GET /v1/metrics/blockchain/block_interval_mean?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

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

Block Interval (Median)

get

Definition. The median time, in seconds, between mined blocks.\n

View in Studio

Authorizations
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, 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
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
get/v1/metrics/blockchain/block_interval_median
GET /v1/metrics/blockchain/block_interval_median?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

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

Block Size (Mean)

get

Definition. The mean size, in bytes, of all blocks created within the time period.\n

View in Studio

Authorizations
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, 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
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
get/v1/metrics/blockchain/block_size_mean
GET /v1/metrics/blockchain/block_size_mean?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

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

Block Size (Total)

get

Definition. The total size, in bytes, of all blocks created within the time period.\n

View in Studio

Authorizations
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, 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
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
get/v1/metrics/blockchain/block_size_sum
GET /v1/metrics/blockchain/block_size_sum?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

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

Blocks Mined

get

Definition. The number of blocks created and included in the main blockchain in the given time period.\n

View in Studio

Authorizations
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, 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
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
get/v1/metrics/blockchain/block_count
GET /v1/metrics/blockchain/block_count?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

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

Percent UTXOs in Profit

get

Definition. The percentage of unspent transaction outputs (UTXOs) whose price at creation time was lower than the current price.\n\nInterpretation. Readings near 1 mean nearly every UTXO sits above its creation price, readings near 0 mean nearly every UTXO sits below it.\n\nNotes. For more information, see Dissecting Bitcoin's Unrealised On-Chain Profit and Loss.\n

View in Studio

Authorizations
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
get/v1/metrics/blockchain/utxo_profit_relative
GET /v1/metrics/blockchain/utxo_profit_relative?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

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

UTXO Value Created (Mean)

get

Definition. The mean amount of coins in newly created unspent transaction outputs (UTXOs).\n

View in Studio

Authorizations
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, 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
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
get/v1/metrics/blockchain/utxo_created_value_mean
GET /v1/metrics/blockchain/utxo_created_value_mean?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

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

UTXO Value Created (Median)

get

Definition. The median amount of coins in newly created UTXOs.\n

View in Studio

Authorizations
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, 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
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
get/v1/metrics/blockchain/utxo_created_value_median
GET /v1/metrics/blockchain/utxo_created_value_median?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

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

UTXO Value Created (Total)

get

Definition. The total amount of coins in newly created unspent transaction outputs (UTXOs).\n

View in Studio

Authorizations
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, 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
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
get/v1/metrics/blockchain/utxo_created_value_sum
GET /v1/metrics/blockchain/utxo_created_value_sum?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

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

UTXO Value Spent (Mean)

get

Definition. The mean amount of coins in spent transaction outputs.\n

View in Studio

Authorizations
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, 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
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
get/v1/metrics/blockchain/utxo_spent_value_mean
GET /v1/metrics/blockchain/utxo_spent_value_mean?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

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

UTXO Value Spent (Median)

get

Definition. The median amount of coins in spent transaction outputs.\n

View in Studio

Authorizations
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, 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
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
get/v1/metrics/blockchain/utxo_spent_value_median
GET /v1/metrics/blockchain/utxo_spent_value_median?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

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

UTXO Value Spent (Total)

get

Definition. The total amount of coins in spent transaction outputs.\n

View in Studio

Authorizations
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, 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
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
get/v1/metrics/blockchain/utxo_spent_value_sum
GET /v1/metrics/blockchain/utxo_spent_value_sum?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

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

UTXOs (Total)

get

Definition. The total number of unspent transaction outputs (UTXOs) in the network.\n

View in Studio

Authorizations
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, 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
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
get/v1/metrics/blockchain/utxo_count
GET /v1/metrics/blockchain/utxo_count?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

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

UTXOs Created

get

Definition. The number of unspent transaction outputs (UTXOs) created within the time period.\n

View in Studio

Authorizations
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, 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
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
get/v1/metrics/blockchain/utxo_created_count
GET /v1/metrics/blockchain/utxo_created_count?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

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

UTXOs in Loss

get

Definition. The number of unspent transaction outputs (UTXOs) whose price at creation time was higher than the current price.\n\nNotes. For more information, see Dissecting Bitcoin's Unrealised On-Chain Profit and Loss.\n

View in Studio

Authorizations
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
get/v1/metrics/blockchain/utxo_loss_count
GET /v1/metrics/blockchain/utxo_loss_count?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

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

UTXOs in Profit

get

Definition. The number of unspent transaction outputs (UTXOs) whose price at creation time was lower than the current price.\n\nNotes. For more information, see Dissecting Bitcoin's Unrealised On-Chain Profit and Loss.\n

View in Studio

Authorizations
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
get/v1/metrics/blockchain/utxo_profit_count
GET /v1/metrics/blockchain/utxo_profit_count?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

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

UTXOs Spent

get

Definition. The number of unspent transaction outputs (UTXOs) spent within the time period.\n

View in Studio

Authorizations
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, 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
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
get/v1/metrics/blockchain/utxo_spent_count
GET /v1/metrics/blockchain/utxo_spent_count?a=text HTTP/1.1
Host: api.glassnode.com
Accept: */*

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

Last updated