API Setup

Welcome to the Glassnode API documentation.

Welcome to the Glassnode API, which powers all our tools, including Glassnode Studio, the CLI, the MCP Server and the Excel add-in. The Glassnode API is available to Professional subscribers, with full access to the metrics, history, and resolutions included in your plan. Advanced subscribers have access to the more limited Light API. Please be aware that making API requests consumes data credits associated with your subscription tier.

Before making your first request, it is highly recommended that you familiarize yourself with how our data is structured and processed. Understanding these core concepts is crucial for accurate analysis:

• Timestamps & Resolutions: Understand how we treat timestamps across different timeframes and metric resolutions.

• Data Availability: Learn exactly when new data points arrive and are ready to be fetched.

• Data Finalization: Read about how we handle data mutations, reprocessing, and finalization over time.

• Metadata: Retrieve metadata for metrics (parameters, time ranges, descriptions, …) and assets (smart contract addresses, external vendor identifiers, …).

• Bulk Endpoints: Batch multiple queries into a single request.

---

Light API

The Light API is the API available to Advanced subscribers. It's a more limited entry point built for automated and agentic workflows. Compared to the full Professional API, it:

• is limited to 14 days of history,

• is restricted to daily (1d) resolution,

• is capped at 50 calls per day, and

• does not support bulk endpoints.

---

Make Your First API Request

Generate your API key

You can generate an API key by clicking on the user icon in the top right corner of Glassnode Studio. In the dropdown, you'll find the API option. Scroll to the bottom to find the Generate API Key section.

Follow the instructions on the API Key page to generate your credentials and make your first request.

Usage

Specify the api_key query parameter or X-Api-Key header with your API key with all endpoints.

Example using cURL

export API_KEY=YOUR-KEY

# using query parameter
curl "https://api.glassnode.com/v1/metrics/indicators/sopr?a=btc&api_key=$API_KEY"

# using request header
curl -H "X-Api-Key:${API_KEY}" "https://api.glassnode.com/v1/metrics/indicators/sopr?a=btc"

Example using Python

import json
import requests
import pandas as pd

# insert your API key here
API_KEY = ''

# make API request
res = requests.get('https://api.glassnode.com/v1/metrics/indicators/sopr',
    params={'a': 'BTC', 'api_key': API_KEY})

# convert to pandas dataframe
df = pd.read_json(res.text, convert_dates=['t'])

Pro-Tip: The Glassnode CLI

While the API is perfect for programmatic integrations, for ad hoc research, we highly recommend using the Glassnode CLI. The CLI makes it incredibly easy to download metric files directly to your local disk. Because of its command-line nature, it also fits perfectly into agentic workflows, allowing AI agents and automated scripts to fetch exactly what they need with minimal overhead.