Signals

Altcoin Cycle Signal

get

Definition. The Altcoin Cycle Signal measures whether the market favors bitcoin versus all altcoins. It is based on price data of the top 250 altcoins by market capitalization (excluding stablecoins) and is meant to be largely agnostic to which altcoins in particular an investor holds.\n\nTechnical. The metric is updated daily at 10:15 UTC, providing the previous day's data point at this time.\n\nInterpretation. During Bitcoin Season, bitcoin is likely to outperform the basket of all altcoins, during Altcoin Season this dynamic inverts.\n\nNotes. For more information on its interpretation and methodology, see this dashboard.\n

View in Studio

Authorizations

ApiKeyAuth

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 - 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

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/signals/altcoin_index

HTTPcURLJavaScriptPython

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

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

Bitcoin Risk Signal

get

Definition. Bitcoin Risk Signal gauges the risk of a major drawdown in the Bitcoin price.\n\nTechnical. Built from a set of proprietary indicators, including Bitcoin price data, on-chain data, and a selection of other trading metrics.\n\nNotes. For interpretation and methodology, see the signals dashboard, or explore Bitcoin Vector, a market regime framework.\n

View in Studio

Authorizations

ApiKeyAuth

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

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/signals/btc_risk_index

HTTPcURLJavaScriptPython

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

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

Bitcoin Sharpe Signal

get

Definition. Bitcoin Sharpe Signal is a machine-learning long-entry signal for BTC, trained on on-chain data with the design goal of minimizing downside risk while capturing rising trends and enhancing risk-adjusted returns.\n\nTechnical. The model output is a confidence score rendered as a color ramp, with green indicating the highest confidence and orange through red indicating reduced confidence. The signal is refreshed daily at 04:00 UTC, finalizing the previous day's timestamp. The standard version carries a one-day lag. Disclosed foundational inputs include Percent of Entities in Profit and Short Term Holder SOPR.\n\nInterpretation. Readings above 0.5 have historically been associated with improved risk-adjusted Bitcoin performance.\n\nNotes. For interpretation and methodology, see the signal dashboard. Enterprise clients interested in same-day data or the underlying methodology can contact the Institutional team.\n

View in Studio

Authorizations

ApiKeyAuth

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 - 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

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/signals/btc_sharpe_signal

HTTPcURLJavaScriptPython

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

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

Bitcoin Sharpe Signal - Indicator I

get

Definition. Bitcoin Sharpe Signal - Indicator I is derived directly from entities' profit, offering a nuanced view of entities profit momentum. It is used as one of the main features of the BSS model.\n

View in Studio

Authorizations

ApiKeyAuth

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 - 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

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/signals/btc_bss_indicator_1

HTTPcURLJavaScriptPython

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

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

Bitcoin Sharpe Signal - Indicator II

get

Definition. Bitcoin Sharpe Signal - Indicator II is a refined version of the MVRV ratio that employs statistical techniques to amplify its predictive power, highlighting periods of potential overvaluation or undervaluation. It is used as one of the main features of the BSS model.\n

View in Studio

Authorizations

ApiKeyAuth

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 - 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

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/signals/btc_bss_indicator_2

HTTPcURLJavaScriptPython

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

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

Bitcoin Sharpe Signal - Indicator III

get

Definition. Bitcoin Sharpe Signal - Indicator III draws from recent STH_SOPR data, offering insights into the market's short-term holder steadiness. It is used as one of the main features of the BSS model.\n

View in Studio

Authorizations

ApiKeyAuth

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 - 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

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/signals/btc_bss_indicator_3

HTTPcURLJavaScriptPython

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

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

Bitcoin Sharpe Signal - Indicator IV

get

Definition. Bitcoin Sharpe Signal - Indicator IV is a momentum reading on the percentage of circulating supply in profit, derived from a transformation applied to that base series.\n\nNotes. Used as one of the main features of the BSS model.\n

View in Studio

Authorizations

ApiKeyAuth

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 - 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

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/signals/btc_bss_indicator_4

HTTPcURLJavaScriptPython

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

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

Bitcoin Sharpe Signal Short

get

Definition. Bitcoin Sharpe Signal Short is a machine-learning short-entry signal for BTC, trained on on-chain data to anticipate periods of market turmoil and identify opportunities to short Bitcoin with reduced downside risk.\n\nTechnical. The model output is a confidence score rendered as a color ramp, with red indicating the highest confidence in a coming market sell-off and yellow through green indicating reduced confidence.\n\nInterpretation. Readings above 0.5 have historically been associated with imminent market downturns.\n

View in Studio

Authorizations

ApiKeyAuth

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

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/signals/btc_bss_short

HTTPcURLJavaScriptPython

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

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

BSS Goldilocks Short Signal

get

Definition. BSS Goldilocks Short Signal is the signal decision extracted from the Goldilocks Zone, marking a prime area to be short on Bitcoin according to the Bitcoin Sharpe Signal Short.\n

View in Studio

Authorizations

ApiKeyAuth

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

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/signals/btc_bss_goldilocks_short

HTTPcURLJavaScriptPython

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

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

BSS Goldilocks Signal

get

Definition. The BSS Goldilocks Signal is derived from the heuristics of the ML model used to construct the Bitcoin Sharpe Signal. It activates when the conditions of the Goldilocks zone are met, identifying prime opportunities to enhance the risk-adjusted return on Bitcoin.\n\nTechnical. Conditions of the Goldilocks zone: BSS Indicator I is between 52 and 65, and BSS Indicator III is below 4%.\n

View in Studio

Authorizations

ApiKeyAuth

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 - 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

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/signals/btc_bss_goldilocks

HTTPcURLJavaScriptPython

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

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

Ecosystem Momentum Signal

get

Definition. The L1 Momentum Signal evaluates the propensity of a Layer 1 ecosystem to move into an exponential trend, either positive or negative. It can be used to gauge the likelihood of a short-term exponential price momentum continuing and intensifying.\n\nTechnical. Based on a proprietary statistical method that identifies whether the underlying distribution of an asset's returns has departed from its usual structure. Data at 1-hour resolution is updated every 6 hours due to a data-source limitation for this metric.\n\nNotes. For more information, see the signals dashboard.\n

View in Studio

Authorizations

ApiKeyAuth

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

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/signals/ecosystem_momentum_index

HTTPcURLJavaScriptPython

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

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

Intraday Bitcoin Sharpe Signal

get

Definition. The Glassnode Intraday Bitcoin Sharpe Signal extends the BSS by exposing within-day positioning of the Bitcoin Sharpe signal, improving response capabilities for Pro ML package subscribers against market movements.\n\nTechnical. The signal uses a machine-learning approach with on-chain data to minimize downside risks and capture rising trends in Bitcoin. Model confidence is color-coded: green for the highest confidence, orange to red for reduced confidence.\n\nInterpretation. A surge beyond the 0.5 mark has historically been associated with improved risk-adjusted performance in Bitcoin.\n

View in Studio

Authorizations

ApiKeyAuth

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

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/signals/btc_bss_v2

HTTPcURLJavaScriptPython

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

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

Marketcap returns vs BTC

get

Definition. Marketcap Grouping Returns vs BTC tracks the relative price performance of market-capitalization size-based clusters versus Bitcoin. Groupings are defined as Large Cap (>1B USD), Mid Cap (1B-100M USD), and Small Cap (100M-50M USD).\n\nNotes. For interpretation and methodology, see the signals dashboard.\n

View in Studio

Authorizations

ApiKeyAuth

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

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/signals/mcap_returns_vs_btc

HTTPcURLJavaScriptPython

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

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

Token returns vs BTC

get

Definition. Native Token Returns vs BTC tracks the relative price performance of large L1 native tokens versus Bitcoin.\n\nNotes. For interpretation and methodology, see the signals dashboard.\n

View in Studio

Authorizations

ApiKeyAuth

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

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/signals/l1_native_tokens_returns_vs_btc

HTTPcURLJavaScriptPython

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

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