---
title: "List All Metric Definitions"
method: GET
path: "/v1/metrics"
tags: ["Metrics Registry"]
---

# List All Metric Definitions

`GET /v1/metrics`

## Request

- Base URL: `https://api.blocklens.co` (the document declares no server; this is the origin it was published from)
- URL: `https://api.blocklens.co/v1/metrics`
- Auth: none declared

Retrieves the complete list of available metrics with their definitions, including:
- **Metadata**: name, description, category, documentation links
- **Data source**: API endpoint, database field, table
- **Display settings**: default color, unit, format, supported chart types
- **Access control**: grade level (0=basic, 1=pro, 2=enterprise)

Use the `category` parameter to filter by metric category, or `grade` to filter by access level.
This endpoint is essential for building dynamic UIs that need to know what metrics are available.

## Query parameters

- `category` string, nullable: Filter by category (price, supply, valuation, profit)
- `grade` integer, nullable: Filter by grade (0=basic, 1=pro, 2=enterprise)
- `active_only` boolean: Only return active metrics
- `include_docs` boolean: Include the heavy docs_description field. Set false to shrink the payload — the list can exceed 200KB with docs, which stalls on the blocklens.ru path; clients that page per-category use false.

## Response `200`

Successful Response

- ApiResponse: Standard API response model
  - `success` boolean, required
  - `data` unknown, required
  - `message` string, nullable
  - `count` integer, nullable
  - `timestamp` string, date-time

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/blocklens/apis/blocklens-on-chain-api.md) · [All operations](https://skmtc.dev/blocklens/apis/blocklens-on-chain-api/llms.txt) · [OpenAPI document](https://skmtc.dev/blocklens/apis/blocklens-on-chain-api/revisions/dacc02ae0f9a?raw)