x402

Access Glassnode metrics and metadata with native crypto payments — no API key or subscription required. Pay per request in USDC using the x402 protocol by Coinbase.

Experimental endpoints — features, pricing, and availability may change without notice. For production systems, use the standard Glassnode API with a subscription.

How it works

The x402 endpoints mirror the standard Advanced API one-to-one. The only difference is the subdomain:

	Base URL
Standard API (API key)	https://api.glassnode.com
x402 (pay-per-use)	https://x402.glassnode.com

The path, query parameters, and response format are identical. You do not send an API key — the request is authorized by payment instead.

GET https://x402.glassnode.com/v1/metrics/{category}/{metric}
GET https://x402.glassnode.com/v1/metadata/{assets|metrics|metric}

Getting started

1. Set up an x402 client. Follow the x402 Quickstart for Buyers to configure a wallet funded with USDC on Base.

2. Call an endpoint. Request any metric path on x402.glassnode.com. The server replies with HTTP 402 Payment Required and the payment details.

   curl "https://x402.glassnode.com/v1/metrics/market/price_usd_close?a=BTC"

3. Sign and pay. Your x402 client signs a USDC payment authorization and resends the request with the PAYMENT-SIGNATURE header automatically.

4. Receive data. The response is the same time-series format as the standard API:

   [
     { "t": 1781827200, "v": 63490.91 }
   ]

Available metrics

All Advanced metrics are available via x402. See the full list in the Advanced Metrics catalog.

For each metric's supported query parameters and response format, refer to its page in the API endpoint reference — the x402 endpoint behaves identically.

Metadata endpoints

The Glassnode Metadata API is also available via x402, so you can discover assets, list metrics, and inspect a metric's supported parameters before paying for the data itself.

Endpoint	Description
GET /v1/metadata/assets	List all assets and their metadata. Optional CEL filter query.
GET /v1/metadata/metrics	List all available metric paths. Optional filters (a, e, i, c).
GET /v1/metadata/metric	Metadata for a single metric (parameters, ranges, descriptors). Requires path.

# List all assets
curl "https://x402.glassnode.com/v1/metadata/assets"

# List all available metrics
curl "https://x402.glassnode.com/v1/metadata/metrics"

# Parameters and descriptors for a single metric
curl "https://x402.glassnode.com/v1/metadata/metric?path=/addresses/count"

These behave identically to the standard API — see the Metadata API reference for query parameters and response schemas.

Pricing & payment

Endpoint type	Price per request
Metrics (/v1/metrics/...)	$0.05 USDC
Metadata (/v1/metadata/...)	$0.01 USDC

• Payment network: Base.

Pricing is subject to change without notice. Always read the latest price from the 402 response before generating your payment.

Discovery

x402 endpoints are also discoverable through the Coinbase x402 Bazaar, where agents can find and rank Glassnode metrics and metadata automatically.