# Studio Glassnode — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-studio-glassnode-com-api-d8f4512b/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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.paywithlocus.com/api/wrapped/parse-studio-glassnode-com-api-d8f4512b/get_asset_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-studio-glassnode-com-api-d8f4512b/get_assets_fundamentals \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-studio-glassnode-com-api-d8f4512b/get_assets_futures \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-studio-glassnode-com-api-d8f4512b/get_assets_overview \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-studio-glassnode-com-api-d8f4512b/get_assets_profit_loss \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-studio-glassnode-com-api-d8f4512b/get_assets_supply_dynamics \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-studio-glassnode-com-api-d8f4512b/get_chart_metric \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-studio-glassnode-com-api-d8f4512b/get_market_overview_metrics \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-studio-glassnode-com-api-d8f4512b/search_assets \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```