For the complete documentation index, see llms.txt. This page is also available as Markdown.

Lightning

Lightning Network Base Fee (Median)

get

Definition. The median base fee in the Lightning Network in Satoshi, derived from the channel graph.\n\nTechnical. Base fees are paid for each payment routed through a channel. Payments between two peers that share a direct channel connection incur no fee.\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

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/lightning/base_fee_median

Lightning Network Capacity

get

Definition. The total amount locked in the Lightning Network.\n\nTechnical. The Bitcoin Lightning Network is a Layer 2 payment protocol built on top of the Bitcoin blockchain, designed to provide faster, cheaper, and more scalable transactions than traditional on-chain Bitcoin transactions. Only public channels announced to the routing graph are counted, so BTC held in private channels is excluded.\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

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/lightning/network_capacity_sum

Lightning Network Channel Size (Mean)

get

Definition. The mean BTC size of public Lightning Network channels.\n\nTechnical. The Lightning Network works by creating payment channels between two parties, where multiple transactions can be made without the need for each individual transaction to be recorded on the Bitcoin blockchain. These transactions are instead recorded off-chain, which makes them faster and cheaper.\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

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/lightning/channel_size_mean

Lightning Network Channel Size (Median)

get

Definition. The median size of public Lightning Network channels.\n\nTechnical. The Lightning Network creates bilateral payment channels between two parties, allowing multiple transactions to settle off-chain without each individual transaction being recorded on the Bitcoin blockchain, which makes them faster and cheaper.\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

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/lightning/channel_size_median

Lightning Network Fee Rate (Median)

get

Definition. The median fee rate in the Lightning Network, derived from the channel graph and expressed in units of sat / BTC. A value of 1000 indicates that a fee of 1000 Satoshi is required to transfer 1 BTC.\n\nTechnical. On top of a base fee, payment fees are proportional to the transferred amount.\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

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/lightning/fee_rate_median

Lightning Network Gini Capacity Distribution

get

Definition. Lightning Network Gini Coefficient (Capacity Distribution) is a statistical measure of how Bitcoin capacity is distributed across nodes on the Lightning Network, used to monitor the degree of centralization and the potential risks associated with highly concentrated capacity.\n\nTechnical. The coefficient is computed by comparing the actual distribution of Bitcoin capacity across nodes to a hypothetical uniform distribution. It ranges from 0 to 1, with 0 representing perfect equality and 1 representing maximum inequality.\n\nInterpretation. A higher Gini coefficient indicates a more unequal distribution of Bitcoin capacity across nodes, while a lower coefficient indicates a more even distribution.\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

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/lightning/gini_capacity_distribution

Lightning Network Gini Channel Distribution

get

Definition. Lightning Network Gini Coefficient (Channel Distribution) is a statistical measure of how channel counts are distributed across nodes on the Lightning Network, used to monitor the degree of centralization and the potential risks associated with highly concentrated node influence.\n\nTechnical. The coefficient is computed by comparing the actual distribution of channels across nodes to a hypothetical uniform distribution. It ranges from 0 to 1, with 0 representing perfect equality and 1 representing maximum inequality.\n\nInterpretation. A higher Gini coefficient indicates a more unequal distribution of channel counts across nodes, while a lower coefficient indicates a more even distribution.\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

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/lightning/gini_channel_distribution

Lightning Network Node Connectivity

get

Definition. The number of nodes in the Lightning Network connected via IP, TOR, or both.\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

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/lightning/node_connectivity

Lightning Network Number of Channels

get

Definition. The number of public Lightning Network channels. The Lightning Network works by creating payment channels between two parties, where multiple transactions can be made without each individual transaction being recorded on the Bitcoin blockchain. These transactions are instead recorded off-chain, which makes them faster and cheaper.\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

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/lightning/channels_count

Lightning Network Number of Nodes

get

Definition. The number of Lightning Network nodes.\n\nTechnical. Only nodes gossiping on the public routing graph are counted.\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

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/lightning/nodes_count

Last updated