# Studio Glassnode — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access comprehensive on-chain and market analytics for cryptocurrencies, including asset fundamentals, supply dynamics, futures data, and profit/loss metrics. Search and analyze assets with historical chart data and market overview information to track crypto performance and trends.

**Category:** Web3 & Onchain | **Website:** [studio.glassnode.com/](https://studio.glassnode.com/) | **Docs:** [parse.bot/marketplace/d8f4512b-3f69-4b9d-8014-4f1950d29470/studio-glassnode-com-api](https://parse.bot/marketplace/d8f4512b-3f69-4b9d-8014-4f1950d29470/studio-glassnode-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/studio-glassnode/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get asset categories

Get the complete list of available asset category tags that can be used to filter assets in other endpoints. Returns tag identifiers and their string values. These tags represent asset classifications such as blockchain networks (bitcoin, ethereum, solana), token types (defiToken, memeToken, stablecoin), and curated groups (top).

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/studio-glassnode/get-asset-categories \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get assets fundamentals

Fetch fundamentals data for assets including transfers volume, transfer count, active addresses, and non-zero address count. Each asset returns metric data points with latest values and percentage changes over 24h and 7d windows.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `asset_tag` | string | No | Filter by asset category tag. Use get_asset_categories to discover all available tags. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/studio-glassnode/get-assets-fundamentals \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"asset_tag":"<string>"}'
```

### Get assets futures

Fetch futures and derivatives data for assets including open interest, funding rate, liquidations volume, and open interest to market cap ratio. Each asset returns metric data with latest values and percentage changes.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `asset_tag` | string | No | Filter by asset category tag. Use get_asset_categories to discover all available tags. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/studio-glassnode/get-assets-futures \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"asset_tag":"<string>"}'
```

### Get assets overview

Fetch the paginated list of all cryptocurrencies from the Overview table. Returns asset info and core metrics (price, market cap, volume, open interest, funding rate). Each asset includes name, symbol, tags, and an array of metric data points with latest values and 7-day/24h changes. Optionally filter by asset category tag.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `asset_tag` | string | No | Filter by asset category tag. Use get_asset_categories to discover all available tags. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/studio-glassnode/get-assets-overview \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"asset_tag":"<string>"}'
```

### Get assets profit loss

Fetch profit and loss metrics for assets including cost basis (7d, 30d), NUPL (net unrealized profit/loss), SOPR, realized profit, and realized loss. Each asset returns metric data with latest values and time-series changes.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `asset_tag` | string | No | Filter by asset category tag. Use get_asset_categories to discover all available tags. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/studio-glassnode/get-assets-profit-loss \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"asset_tag":"<string>"}'
```

### Get assets supply dynamics

Fetch supply dynamics data for assets including circulating supply, active supply (7d, 30d), dormant supply, exchange netflows, and whale address counts. Each asset returns metric data with latest values and percentage changes.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `asset_tag` | string | No | Filter by asset category tag. Use get_asset_categories to discover all available tags. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/studio-glassnode/get-assets-supply-dynamics \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"asset_tag":"<string>"}'
```

### Get chart metric

Fetch historical time-series data for a specific metric and asset. Returns an array of timestamped values spanning the full available history at the requested interval. Use search_assets to discover available metric codes. Returns upstream_error if the metric code is invalid or not available for the specified asset/interval combination.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `asset` | string | No | Asset symbol (e.g. BTC, ETH, SOL, DOGE) |
| `interval` | string | No | Time interval for data points. Accepted values: 10m, 1h, 24h, 1w, 1month |
| `metric` | string | No | Metric code in 'category.MetricName' CamelCase format (e.g. market.PriceUsdClose, market.MarketcapUsd). Use search_assets to discover available metric codes. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/studio-glassnode/get-chart-metric \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"asset":"<string>","interval":"<string>","metric":"<string>"}'
```

### Get market overview metrics

Fetch market summary widgets for the home dashboard including top movers (assets ranked by recent performance), sector performance time-series, heatmap of supply in profit, spot volume treemap, and aggregate market cap/volume time-series. Provides a comprehensive snapshot of current crypto market conditions.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/studio-glassnode/get-market-overview-metrics \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Search assets

Search for assets by name or symbol via Algolia full-text search. Returns matching asset hits (with symbol, name, visibility) and related chart/metric hits (with metric codes, paths, descriptions). Useful for discovering asset symbols and available metric codes for use with get_chart_metric.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword — asset name or ticker symbol (e.g. 'bitcoin', 'ETH', 'solana') |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/studio-glassnode/search-assets \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.