Glassnode Docs
WebsiteStudioInsightsTwitter
  • Welcome to Glassnode
    • Introduction
      • Studio
  • 📊Data
    • General Information
      • Timestamps and Resolutions
      • Data Availability
      • Data Finalization
    • Metric Catalog
    • Supported Blockchains
    • Supported Assets
      • Market Metrics Coverage
      • On-chain Metrics Coverage
    • Point-in-Time Metrics
  • 📖Guides & Tutorials
    • Getting Started
      • Use-Case Tutorials
        • Tutorial 1 - Navigating Market Tops and Bottoms
        • Tutorial 2 - Introduction to On-chain Activity
        • Tutorial 3 - Fundamentals of Proof-of-Work Mining
        • Tutorial 4 - Introduction to Supply Dynamics
      • Get started with Glassnode Metrics
      • Granular Cohorts for Key On-Chain Metrics
    • Metric Guides
      • Market Capitalization
      • Realized Capitalization
      • MVRV
        • LTH-MVRV
        • MVRV Ratio
        • MVRV-Z Score
        • STH-MVRV
      • SOPR
        • SOPR (Spent Output Profit Ratio)
        • aSOPR (Adjusted SOPR)
        • LTH-SOPR
        • STH-SOPR
      • Unrealized Profit/Loss
        • NUPL (Net Unrealized Profit/Loss)
        • Unrealized Profit
        • Unrealized Loss
        • LTH-NUPL
        • STH-NUPL
      • Realized Profit/Loss
        • Net Realized Profit/Loss
        • Realized Profit
        • Realized Loss
      • Coin Issuance
        • Puell Multiple
      • Stablecoin
        • SSR (Stablecoin Supply Ratio)
      • Coin Days Destroyed
        • CDD (Coin Days Destroyed)
        • Supply-Adjusted CDD
        • Binary CDD
        • CYD (Coin Years Destroyed)
        • Supply-Adjusted CYD
        • Reserve Risk
      • Liveliness
      • Dormancy
        • Average Coin Dormancy
        • Supply-Adjusted Dormancy
      • Lifespan
        • Spent Output Age Bands (SOAB)
        • Average Spent Output Lifespan (ASOL)
        • Median Spent Output Lifespan (MSOL)
      • NVT
        • NVT Ratio
        • NVT Signal
        • Velocity
      • Stock to Flow
        • Stock to Flow Ratio
        • Stock to Flow Deflection
      • Price Distribution
        • URPD (UTXO Realized Price Distribution)
        • SOPD (Spent Output Price Distribution)
      • Accumulation Trend Score
      • Long and Short-Term Holder Supply
        • Supply Held by Long and Short-Term Holders
      • Profit/Loss (Supply)
        • Percent Supply in Profit
        • Supply in Profit
        • Supply in Loss
      • Age Distribution
        • HODL Waves
        • Realized Cap HODL Waves
      • Profit/Loss (UTXO)
        • Percent UTXOs in Profit
        • UTXOs in Profit
        • UTXOs in Loss
    • On-Chain Concepts
      • Entity-Adjusted Metrics
      • On-chain Glossary
      • Understanding UTXOs - The Gold Coin Analogy
      • UTXO vs. Account-Based Chains
    • Workbench Guide
  • ⚙️API
    • Introduction
    • API Key
    • API Credits
    • Metadata
    • Bulk metrics (beta)
    • Endpoints
      • Addresses
      • Bridges
      • Blockchain
      • Breakdowns
      • DeFi
      • Derivatives
      • Distribution
      • Entities
      • ETH 2.0
      • Fees
      • Indicators
      • Institutions
      • Lightning
      • Market
      • Mempool
      • Mining
      • Point-In-Time
      • Protocols
      • Signals
      • Supply
      • Transactions
  • ℹ️Further Information
    • Changelog
      • 2025
      • 2024
      • 2023
      • 2022
      • 2021
      • 2020
    • Support FAQ
    • Affiliate FAQs
    • Exchange Data: Transparency Notice
Powered by GitBook
On this page
  • Block Height
  • Block Interval (Mean)
  • Block Interval (Median)
  • Block Size (Mean)
  • Block Size (Total)
  • Blocks Mined
  • Percent UTXOs in Profit
  • UTXO Value Created (Mean)
  • UTXO Value Created (Median)
  • UTXO Value Created (Total)
  • UTXO Value Spent (Mean)
  • UTXO Value Spent (Median)
  • UTXO Value Spent (Total)
  • UTXOs (Total)
  • UTXOs Created
  • UTXOs in Loss
  • UTXOs in Profit
  • UTXOs Spent
  1. API
  2. Endpoints

Blockchain

PreviousBridgesNextBreakdowns

Last updated 2 months ago

Block Height

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

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

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}]
unsupported asset

Block Interval (Mean)

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

The mean time (in seconds) between mined blocks.

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}]
unsupported asset

Block Interval (Median)

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

The median time (in seconds) between mined blocks.

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}]
unsupported asset

Block Size (Mean)

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

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

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}]
unsupported asset

Block Size (Total)

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

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

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}]
unsupported asset

Blocks Mined

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

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

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}]
unsupported asset

Percent UTXOs in Profit

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

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}]
unsupported asset

UTXO Value Created (Mean)

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

The mean amount of coins in newly created UTXOs.

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.7248314081284108}]
unsupported asset

UTXO Value Created (Median)

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

The median amount of coins in newly created UTXOs.

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}]
unsupported asset

UTXO Value Created (Total)

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

The total amount of coins in newly created UTXOs.

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}]
unsupported asset

UTXO Value Spent (Mean)

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

The mean amount of coins in spent transaction outputs.

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.8495012603919825}]
unsupported asset

UTXO Value Spent (Median)

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

The median amount of coins in spent transaction outputs.

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}]
unsupported asset

UTXO Value Spent (Total)

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

The total amount of coins in spent transaction outputs.

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}]
unsupported asset

UTXOs (Total)

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

The total number of UTXOs in the network.

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}]
unsupported asset

UTXOs Created

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

The number of created unspent transaction outputs.

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}]
unsupported asset

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}]
unsupported asset

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}]
unsupported asset

UTXOs Spent

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

The number of spent transaction outputs.

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}]
unsupported asset

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

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

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

⚙️
View in Studio
View in Studio
View in Studio
View in Studio
View in Studio
View in Studio
this article
View in Studio
View in Studio
View in Studio
View in Studio
View in Studio
View in Studio
View in Studio
View in Studio
View in Studio
this article
View in Studio
this article
View in Studio
View in Studio