Skip to main content

Glassnode API client for python

Project description

Glassnode Python API

Glassnode API client for python.


This is a non-official python client for the Glassnode API. I am in no way affiliated, associated, authorized, endorsed by, or in any way officially connected with Glassnode, or any of its subsidiaries or its affiliates. The name Glassnode as well as related names, marks, emblems and images are registered trademarks of their respective owners.


This is a very simple and intuitive library for accessing the Glassnode API.

Quick Start

To start using the library, first install the package.

pip install glassnode

Then, just instanciate the GlassnodeClient providing your API key and start making requests. Here's a code sample that demonstrates how to get the full history of BTC addresses count.

from glassnode import GlassnodeClient

api_key = ""
client = GlassnodeClient(api_key)
data = client.get("addresses", "count", {"a": "BTC"})

How to make requests

In order to request any metric, just call the get method on the GlassnodeClient instance passing the following parameters:

  • domain: the metric's domain.
  • metric: the metric name.
  • params: the dict of the query parameters to pass along to the request.

The difference between domain and metric is actually very simple. Glassnode has designed it's API in a very modular and intuitive way, grouping metrics by domain. All metrics endpoints follow this pattern:{domain}/{metric}. For a complete list of domains, metrics and params, see their official API docs (

Here's another example. This time we'll use the client to get both the STH and LTH NUPL for the market cycle from the 2016 halving to the 2020 halving, with a 24h resolution.

from  glassnode  import  GlassnodeClient

api_key = ""

client = GlassnodeClient(api_key)
since = 1589148000 # July 9 2016
until = 1468015200 # May 11 2020
resolution = "24h"
params = {"a": "BTC", "s": since, "u": until, "i": resolution}

sth_nupl = client.get("indicators", "nupl_less_155", params)
lth_nupl = client.get("indicators", "nupl_more_155", params)

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

glassnode-0.0.2.tar.gz (4.4 kB view hashes)

Uploaded source

Built Distribution

glassnode-0.0.2-py3-none-any.whl (5.6 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page