Glassnode Docs
WebsiteStudioInsightsTwitter
  • Welcome to Glassnode
    • Introduction
      • Studio
  • 📊Data
    • General Information
      • Timestamps and Resolutions
      • Data Availability
      • Data Finalization
    • Metric Catalog
    • Supported Blockchains
    • Supported Assets
      • Market Metrics Coverage
      • On-chain Metrics Coverage
    • Point-in-Time Metrics
  • 📖Guides & Tutorials
    • Getting Started
      • Use-Case Tutorials
        • Tutorial 1 - Navigating Market Tops and Bottoms
        • Tutorial 2 - Introduction to On-chain Activity
        • Tutorial 3 - Fundamentals of Proof-of-Work Mining
        • Tutorial 4 - Introduction to Supply Dynamics
      • Get started with Glassnode Metrics
      • Granular Cohorts for Key On-Chain Metrics
    • Metric Guides
      • Market Capitalization
      • Realized Capitalization
      • MVRV
        • LTH-MVRV
        • MVRV Ratio
        • MVRV-Z Score
        • STH-MVRV
      • SOPR
        • SOPR (Spent Output Profit Ratio)
        • aSOPR (Adjusted SOPR)
        • LTH-SOPR
        • STH-SOPR
      • Unrealized Profit/Loss
        • NUPL (Net Unrealized Profit/Loss)
        • Unrealized Profit
        • Unrealized Loss
        • LTH-NUPL
        • STH-NUPL
      • Realized Profit/Loss
        • Net Realized Profit/Loss
        • Realized Profit
        • Realized Loss
      • Coin Issuance
        • Puell Multiple
      • Stablecoin
        • SSR (Stablecoin Supply Ratio)
      • Coin Days Destroyed
        • CDD (Coin Days Destroyed)
        • Supply-Adjusted CDD
        • Binary CDD
        • CYD (Coin Years Destroyed)
        • Supply-Adjusted CYD
        • Reserve Risk
      • Liveliness
      • Dormancy
        • Average Coin Dormancy
        • Supply-Adjusted Dormancy
      • Lifespan
        • Spent Output Age Bands (SOAB)
        • Average Spent Output Lifespan (ASOL)
        • Median Spent Output Lifespan (MSOL)
      • NVT
        • NVT Ratio
        • NVT Signal
        • Velocity
      • Stock to Flow
        • Stock to Flow Ratio
        • Stock to Flow Deflection
      • Price Distribution
        • URPD (UTXO Realized Price Distribution)
        • SOPD (Spent Output Price Distribution)
      • Accumulation Trend Score
      • Long and Short-Term Holder Supply
        • Supply Held by Long and Short-Term Holders
      • Profit/Loss (Supply)
        • Percent Supply in Profit
        • Supply in Profit
        • Supply in Loss
      • Age Distribution
        • HODL Waves
        • Realized Cap HODL Waves
      • Profit/Loss (UTXO)
        • Percent UTXOs in Profit
        • UTXOs in Profit
        • UTXOs in Loss
    • On-Chain Concepts
      • Entity-Adjusted Metrics
      • On-chain Glossary
      • Understanding UTXOs - The Gold Coin Analogy
      • UTXO vs. Account-Based Chains
    • Workbench Guide
  • ⚙️API
    • Introduction
    • API Key
    • API Credits
    • Metadata
    • Bulk metrics (beta)
    • Endpoints
      • Addresses
      • Bridges
      • Blockchain
      • Breakdowns
      • DeFi
      • Derivatives
      • Distribution
      • Entities
      • ETH 2.0
      • Fees
      • Indicators
      • Institutions
      • Lightning
      • Market
      • Mempool
      • Mining
      • Point-In-Time
      • Protocols
      • Signals
      • Supply
      • Transactions
  • ℹ️Further Information
    • Changelog
      • 2025
      • 2024
      • 2023
      • 2022
      • 2021
      • 2020
    • Support FAQ
    • Affiliate FAQs
    • Exchange Data: Transparency Notice
Powered by GitBook
On this page
  • How to get API access
  • Usage
  1. API

API Key

PreviousIntroductionNextAPI Credits

Last updated 5 months ago

How to get API access

Please note that API access is not included in the Professional Plan by default. It is available as an optional add-on that Professional Plan subscribers can purchase. If you would like to explore purchasing the API add-on or upgrading your account, please contact our .

Once you've upgraded to receive API accessyou can generate an API key by clicking on the user icon in the top right corner of . In the dropdown, you'll find the .

For a detailed overview of the metrics included in your plan, please refer to our and the .

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 http

export API_KEY=YOUR-KEY

# using query parameter
http "https://api.glassnode.com/v1/metrics/assets" api_key==$API_KEY

# using request header
http "https://api.glassnode.com/v1/metrics/assets" "X-Api-Key:${API_KEY}"

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'])
⚙️
Institutional team
Glassnode Studio
API option
metrics catalogue
pricing page