Metadata

Assets

GET https://api.glassnode.com/v1/metadata/assets

Lists all assets and relevant metadata.

The base request returns the complete list of all known assets. With the query parameter, filter, the data can also be queried via Common Expression Language (CEL). See Assets Metadata Usage for usage examples and cel.dev for more details.

200 OK

{
    "data": [
        {
            "id": "USDT",
            "external_ids": {
                "ccdata": "7",
                "coinmarketcap": "825",
                "coingecko": "tether"
            },
            "symbol": "USDT",
            "name": "Tether",
            "asset_type": "TOKEN",
            "blockchains": [
                {
                    "blockchain": "SOL",
                    "address": "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB",
                    "decimals": 6,
                    "on_chain_support": true
                },
                {
                    "blockchain": "ETH",
                    "address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
                    "decimals": 6,
                    "on_chain_support": true
                },
                {
                    "blockchain": "TRX",
                    "address": "TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t",
                    "decimals": 6,
                    "on_chain_support": true
                },
                {
                    "blockchain": "TON",
                    "address": "0:b113a994b5024a16719f69139328eb759596c38a25f59028b146fecdc3621dfe",
                    "decimals": 6,
                    "on_chain_support": true
                },
                {
                    "blockchain": "ARB",
                    "address": "0xfd086bc7cd5c481dcc9c85ebe478a1c0b69fcbb9",
                    "decimals": 18,
                    "on_chain_support": true
                }
            ]
        },
        ...
    ]
}

400 Bad Request - Invalid Argument

rpc error: code = InvalidArgument desc = invalid filter: no such attribute(s): doesnotexist

Schema

Asset

Name	Type	Description
id	string	Glassnode ID -- a unique string-based identifier used to specify assets; typically matches with an asset's symbol
external_ids	External IDs	references to external IDs of third party entities such as CoinMarketCap, Coingecko or CCData
symbol	string	asset symbol -- used in Studio when referencing assets
name	string	asset name
asset_type	string	asset type -- one of: BLOCKCHAIN or TOKEN
blockchains	List[Blockchain]	list of all token contracts on blockchains supported by Glassnode-- see Supported Blockchains for a full list of supported blockchains

Blockchain

Name	Type	Description
blockchain	string	unique blockchain identifier
address	string	contract address for the asset on the given blockchain
decimals	integer	number of decimals places in the blockchain
on_chain_support	boolean	whether Glassnode offers on-chain metrics for the given blockchain

External IDs

Name	Type	Description
ccdata	string	CCData ID
coinmarketcap	string	CoinMarketCap ID
coingecko	string	CoinGecko ID

Query Parameters

Name	Type	Description
filter	string	CEL (Common Expression Language) compliant filter

Assets Metadata Usage

Examples

Filter asset by id

GET https://api.glassnode.com/v1/metadata/assets?filter=asset.id=='USDT'

Filter asset with CoinGecko id

GET https://api.glassnode.com/v1/metadata/assets?filter=asset.external_ids.coingecko=='tether'

Filter assets listed on ETH blockchain

GET https://api.glassnode.com/v1/metadata/assets?filter=asset.blockchains.exists(b,b.blockchain=='ETH')

Find all supported assets

GET https://api.glassnode.com/v1/metadata/assets?filter=asset.blockchains.exists(b,b.on_chain_support==true)

Metrics

GET https://api.glassnode.com/v1/metadata/metrics

Lists all available metric paths. This should be used as the base list which can then be used to retrieve metadata from the detail view Metric Metadata.

Note: the paths only include the metric portion of the path, and not the full path containing /v1/metrics.

200 OK

[
    "/addresses/accumulation_balance",
    "/addresses/accumulation_balance_pit",
    "/addresses/accumulation_count",
    "/addresses/accumulation_count_pit",
    "/addresses/active_count",
    "/addresses/count",
    ...
]

Metric

GET https://api.glassnode.com/v1/metadata/metric

Retrieves metadata describing the available parameters and potential drill-down options for a metric.

The base request, where only path is queried, returns the union of all possible parameters and their values.

If the response contains next_parameter, this indicates that query parameters are distinct across next_parameter values. If not present in the base response, all request parameters have the same supported set of values.

Once next_parameter is no longer present, no further narrowing of values is possible and the response represents the set of valid parameters and values for the query.

See Metric Metadata Usage for a complete example.

Schema

Name	Type	Description	Presence
path	string	metric path	always
parameters	Dict[string, List[string]]	list of all allowed parameters and their values	always
next_parameter	string	should the metric possess a hierarchy by which the valid parameters change, this key-value pair denotes the next available parameter which can be queried	only present in the response when a drill-down is available
queried	Dict[string, string]	the query which was processed by the server; extraneous values will not be queried	always
modified	int	the last unix timestamp that the metadata was updated in UTC
refs	Dict[string, string]	links to the metric in studio and its documentation

Query Parameters

Name	Type	Description
path*	string	metric path: /addresses/count
a	string	asset id: BTC

200 OK

{
  "path": "/distribution/balance_exchanges",
  "tier": 2,
  "parameters": {
    "a": [
      "1INCH",
      "AAVE",
      "ABT",
      ...
    ],
    "e": [
      "aggregated",
      "bibox",
      "bigone",
      "binance",
      ...
    ],
    "f": [
      "csv",
      "json"
    ],
    "i": [
      "10m",
      "1h",
      "24h"
    ]
  },
  "queried": {
    "path": "/distribution/balance_exchanges"
  },
  "next_parameter": "a",
  "refs": {
    "docs": "https://docs.glassnode.com/basic-api/endpoints/distribution#distribution.balanceexchanges",
    "studio": "https://studio.glassnode.com/charts/distribution.BalanceExchanges"
  },
  "modified": 1730993909
}

400 Bad Request - Required Parameter Not Set

required parameter not set: path

400 Bad Request - Invalid Query

invalid query parameter: invalid value a=invalid_asset value must be one of [BTC ETH]

404 Not Found

metadata not found: path=/distribution/does_not_exist

Metric Metadata Usage

Request metadata for metric:

GET https://api.glassnode.com/v1/metadata/metric?path=/distribution/balance_exchanges

{
  "path": "/distribution/balance_exchanges",
  "tier": 2,
  "parameters": {
    "a": [
      "1INCH",
      "AAVE",
      "ABT",
      ...
    ],
    "e": [
      "aggregated",
      "bibox",
      "bigone",
      "binance",
      ...
    ],
    "f": [
      "csv",
      "json"
    ],
    "i": [
      "10m",
      "1h",
      "24h"
    ]
  },
  "queried": {
    "path": "/distribution/balance_exchanges"
  },
  "next_parameter": "a",
  "refs": {
    "docs": "https://docs.glassnode.com/basic-api/endpoints/distribution#distribution.balanceexchanges",
    "studio": "https://studio.glassnode.com/charts/distribution.BalanceExchanges"
  },
  "modified": 1730993909
}

Add the value of next_parameter to the query with a value from the response to refine the query further. Continue this process until next_parameter is no longer present in the response.

GET https://api.glassnode.com/v1/metadata/metric?path=/distribution/balance_exchanges&a=BTC

{
  "path": "/distribution/balance_exchanges",
  "tier": 2,
  "parameters": {
    "c": [
      "native",
      "usd"
    ],
    "e": [
      "aggregated",
      "binance",
      "bitfinex",
      "bitget",
      "bithumb",
      "bitmex",
      "bitstamp",
      "bittrex",
      "bybit",
      "coinbase",
      "coincheck",
      "coinex",
      "crypto.com",
      "deribit",
      "ftx",
      "gate.io",
      "gemini",
      "hitbtc",
      "huobi",
      "korbit",
      "kraken",
      "kucoin",
      "luno",
      "okex",
      "poloniex",
      "swissborg"
    ],
    "f": [
      "csv",
      "json"
    ],
    "i": [
      "10m",
      "1h",
      "24h"
    ]
  },
  "queried": {
    "a": "BTC",
    "path": "/distribution/balance_exchanges"
  },
  "refs": {
    "docs": "https://docs.glassnode.com/basic-api/endpoints/distribution#distribution.balanceexchanges",
    "studio": "https://studio.glassnode.com/charts/distribution.BalanceExchanges"
  },
  "modified": 1733829848
}

The result displays the set of valid parameters and their values given the query:

{
  "a": "BTC",
  "path": "/distribution/balance_exchanges"
}