> For the complete documentation index, see [llms.txt](https://docs.glassnode.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.glassnode.com/basic-api/x402.md).

# x402

Access Glassnode metrics and metadata with native crypto payments — no API key or subscription required. Pay per request in USDC using the [x402](https://docs.cdp.coinbase.com/x402/welcome) protocol by Coinbase.

> **Experimental endpoints** — features, pricing, and availability may change without notice. For production systems, use the standard [Glassnode API](https://docs.glassnode.com/basic-api/endpoints) 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](https://docs.cdp.coinbase.com/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.

   ```bash
   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:

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

## Available metrics

All **Advanced** metrics are available via x402. See the full list in the [Advanced Metrics catalog](https://docs.glassnode.com/introduction/metric-catalog#advanced-metrics).

For each metric's supported query parameters and response format, refer to its page in the [API endpoint reference](https://docs.glassnode.com/basic-api/endpoints) — the x402 endpoint behaves identically.

## Metadata endpoints

The Glassnode [Metadata API](https://docs.glassnode.com/basic-api/metadata) 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`. |

```bash
# 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](https://docs.glassnode.com/basic-api/metadata) 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](https://docs.cdp.coinbase.com/x402/bazaar), where agents can find and rank Glassnode metrics and metadata automatically.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.glassnode.com/basic-api/x402.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.