# Token Terminal Docs

> ## Agent Instructions
> To query the Token Terminal data catalog, read https://tokenterminal.com/docs/catalog/agents-manual.md first. It is the whole catalog as one page: table naming grammar, key columns, partition and cluster rules, units, additivity, and the tables that are documented but not served yet.
> Never query a catalog table on a time bound alone. Also filter its cluster key, which you read from INFORMATION_SCHEMA.COLUMNS; an empty result means the object is a view, whose pruning contract is on its page. Compute is billed to the caller's own Google Cloud project.

## Overview

### Overview

- [Introduction](https://tokenterminal.com/docs/index.md): Token Terminal is a full stack onchain data platform focused on standardizing financial and alternative data for the most widely used blockchains and decentralized applications.
- [Our data approach](https://tokenterminal.com/docs/data-approach.md): We process and store over a petabyte of transaction-level onchain data every day directly from the source, to deliver accurate, auditable metrics you can trust.

### Resources

- [Brand assets](https://tokenterminal.com/docs/brand-assets.md)
- [Contact](https://tokenterminal.com/docs/contact.md): Contact us directly, get your project listed, follow us and schedule a demo.
- [General FAQ](https://tokenterminal.com/docs/faq.md): Frequently asked questions about Token Terminal.

### Explorer

- [Introduction](https://tokenterminal.com/docs/explorer/index.md)
- [Discover](https://tokenterminal.com/docs/explorer/discover.md): Explore curated dashboards to discover insights and build your own
- [Market sectors](https://tokenterminal.com/docs/explorer/market-sectors.md): Analyze top market sectors with dashboards and direct project comparisons
- [Projects](https://tokenterminal.com/docs/explorer/projects.md): Explore all projects in a customizable data table
- [Metrics](https://tokenterminal.com/docs/explorer/metrics.md): Understand every metric with clear definitions and project-specific context

### Studio

- [Introduction](https://tokenterminal.com/docs/studio/index.md)
- [Dashboards](https://tokenterminal.com/docs/studio/dashboards.md): Create custom dashboards with charts, datasets, and text to track onchain activity
- [Charts](https://tokenterminal.com/docs/studio/charts.md): Create no-code custom charts with Token Terminal’s standardized data
- [Datasets](https://tokenterminal.com/docs/studio/datasets.md): Create custom datasets from ready-made templates

### Sheets

- [Introduction](https://tokenterminal.com/docs/sheets/index.md): Access Token Terminal's data in Google Sheets and Microsoft Excel
- [Google Sheets](https://tokenterminal.com/docs/sheets/google-sheets.md): Access Token Terminal's data in Google Sheets
- [Microsoft Excel](https://tokenterminal.com/docs/sheets/microsoft-excel.md): Access Token Terminal's data in Microsoft Excel
- [Syntax](https://tokenterminal.com/docs/sheets/syntax.md): Syntax for using Token Terminal Sheets

- [Data catalog (619 pages)](https://tokenterminal.com/docs/_llms/data-catalog.txt): Documentation for Data catalog.

## MCP

### MCP

- [MCP Server](https://tokenterminal.com/docs/mcp/introduction.md): Query Token Terminal data from any MCP-compatible AI client.
- [Claude Code](https://tokenterminal.com/docs/mcp/claude-code.md): Set up the Token Terminal MCP server in Claude Code
- [Claude Desktop](https://tokenterminal.com/docs/mcp/claude-desktop.md): Set up the Token Terminal MCP server in Claude Desktop
- [ChatGPT](https://tokenterminal.com/docs/mcp/chatgpt.md): Set up the Token Terminal MCP server in ChatGPT
- [Codex CLI](https://tokenterminal.com/docs/mcp/codex.md): Set up the Token Terminal MCP server in Codex CLI
- [Cursor](https://tokenterminal.com/docs/mcp/cursor.md): Set up the Token Terminal MCP server in Cursor
- [Gemini CLI](https://tokenterminal.com/docs/mcp/gemini-cli.md): Set up the Token Terminal MCP server in Gemini CLI
- [OpenCode](https://tokenterminal.com/docs/mcp/opencode.md): Set up the Token Terminal MCP server in OpenCode
- [Microsoft Copilot Studio](https://tokenterminal.com/docs/mcp/copilot-studio.md): Set up the Token Terminal MCP server in Microsoft Copilot Studio
- [Other clients](https://tokenterminal.com/docs/mcp/other-clients.md): Use the Token Terminal MCP server with any compatible client

## API

### Overview

- [Introduction](https://tokenterminal.com/docs/api-reference/introduction.md): Get access to Token Terminal's data via our API
- [Best practices](https://tokenterminal.com/docs/api-reference/best-practices.md): Recommendations on how to best use the API

### Endpoints

#### Projects

- [Get a list of all projects](https://tokenterminal.com/docs/api-reference/projects/get-a-list-of-all-projects.md): Use this endpoint to retrieve a list of all projects that are available on the API.
- [Get historical metrics for a project](https://tokenterminal.com/docs/api-reference/projects/get-historical-metrics-for-a-project.md): Use this endpoint to retrieve historical data for a project. Fill in the required fields on the modal to the right.
- [Get metric availability for a project](https://tokenterminal.com/docs/api-reference/projects/get-metric-availability-for-a-project.md): Use this endpoint to retrieve the metric availability for a project.
- [Get metric aggregations for a project](https://tokenterminal.com/docs/api-reference/projects/get-metric-aggregations-for-a-project.md): Use this endpoint to retrieve metric aggregation data for one project.
- [Get financial statement for a project](https://tokenterminal.com/docs/api-reference/projects/get-financial-statement-for-a-project.md): Use this endpoint to retrieve the financial statement report for a project.
- [Get details for a specific product of a project](https://tokenterminal.com/docs/api-reference/projects/get-details-for-a-specific-product-of-a-project.md): Use this endpoint to retrieve detailed information about a specific product within a project.
- [Get historical metrics for a specific product of a project](https://tokenterminal.com/docs/api-reference/projects/get-historical-metrics-for-a-specific-product-of-a-project.md): Use this endpoint to retrieve historical metrics data for a specific product within a project.

#### Market sectors

- [Get a list of all market sectors](https://tokenterminal.com/docs/api-reference/market-sectors/get-a-list-of-all-market-sectors.md): Use this endpoint to retrieve a list of all available market sectors that are available on the API.
- [Get market sector data](https://tokenterminal.com/docs/api-reference/market-sectors/get-market-sector-data.md): Use this endpoint to retrieve a market sector metadata and the list of all projects belonging to market sector.

#### Metrics

- [Get a list of all metrics](https://tokenterminal.com/docs/api-reference/metrics/get-a-list-of-all-metrics.md): Use this endpoint to retrieve a list of all metrics available on the API.
- [Get metric data for multiple projects](https://tokenterminal.com/docs/api-reference/metrics/get-metric-data-for-multiple-projects.md): Use this endpoint to retrieve metric data for multiple projects.
- [Get metric aggregations for multiple projects](https://tokenterminal.com/docs/api-reference/metrics/get-metric-aggregations-for-multiple-projects.md): Use this endpoint to retrieve metric aggregations for multiple projects.
- [Get metric breakdown aggregation for multiple projects, chains, or products](https://tokenterminal.com/docs/api-reference/metrics/get-metric-breakdown-aggregation-for-multiple-projects-chains-or-products.md): Use this endpoint to retrieve metric breakdown aggregation for multiple projects including avg, change, sum, trend, and latest values over a given interval or date range. When looking at cumulative metrics such as fees, reference sums for the total aggregate, and when looking at static metrics such…

#### Datasets

- [List all datasets](https://tokenterminal.com/docs/api-reference/datasets/list-all-datasets.md): Use this endpoint to list all datasets that are available.
- [Get the Blockchain comparison dataset](https://tokenterminal.com/docs/api-reference/datasets/get-the-blockchain-comparison-dataset.md): Use this endpoint to retrieve the Blockchain comparison dataset.
- [Get the Cohort analysis dataset](https://tokenterminal.com/docs/api-reference/datasets/get-the-cohort-analysis-dataset.md): Use this endpoint to retrieve the Cohort analysis dataset.
- [Get the Crypto screener dataset](https://tokenterminal.com/docs/api-reference/datasets/get-the-crypto-screener-dataset.md): Use this endpoint to retrieve the Crypto screener dataset. You can get the whole dataset by omitting all parameters.
- [Get the Insider transactions dataset](https://tokenterminal.com/docs/api-reference/datasets/get-the-insider-transactions-dataset.md): Use this endpoint to retrieve the Insider transactions dataset.
- [Get the Project contracts dataset](https://tokenterminal.com/docs/api-reference/datasets/get-the-project-contracts-dataset.md): Use this endpoint to retrieve the Project contracts dataset.
- [Get the Trending contracts dataset](https://tokenterminal.com/docs/api-reference/datasets/get-the-trending-contracts-dataset.md): Use this endpoint to retrieve the Trending contracts dataset.

#### Assets

- [Get a list of all assets](https://tokenterminal.com/docs/api-reference/assets/get-a-list-of-all-assets.md): Use this endpoint to retrieve a list of all assets that are available on the API.
- [Get asset details and available metrics](https://tokenterminal.com/docs/api-reference/assets/get-asset-details-and-available-metrics.md): Use this endpoint to retrieve detailed information about a specific asset, including the list of available metrics.
- [Get historical metrics for an asset](https://tokenterminal.com/docs/api-reference/assets/get-historical-metrics-for-an-asset.md): Use this endpoint to retrieve historical data for an asset.
- [Get asset metrics breakdown](https://tokenterminal.com/docs/api-reference/assets/get-asset-metrics-breakdown.md): Use this endpoint to retrieve aggregated breakdown data for asset metrics across different dimensions (projects, chains, market sectors, etc.).
- [Get a list of all reference assets](https://tokenterminal.com/docs/api-reference/assets/get-a-list-of-all-reference-assets.md): Use this endpoint to retrieve the reference assets available on the API.
- [Get reference asset details](https://tokenterminal.com/docs/api-reference/assets/get-reference-asset-details.md): Use this endpoint to retrieve a single reference asset by ID — for example to resolve the `reference_asset_id` returned on an asset from the `/v2/assets` endpoint.
- [Get an asset fact sheet](https://tokenterminal.com/docs/api-reference/assets/get-an-asset-fact-sheet.md): Retrieve the latest fact sheet for one asset, including disclosure values, availability statuses and supporting sources. Find covered assets with `GET /v2/assets?has_fact_sheet=true`.
- [Get asset fact sheets](https://tokenterminal.com/docs/api-reference/assets/get-asset-fact-sheets.md): Retrieve the latest fact sheets for 1–20 comma-separated `asset_ids`. Results follow the requested order; duplicate IDs appear once. If any asset has no fact sheet, the whole request returns `404` with missing IDs in `meta.asset_ids`.
- [Get fact sheet field definitions](https://tokenterminal.com/docs/api-reference/assets/get-fact-sheet-field-definitions.md): Retrieve titles, definitions and option descriptions for public disclosure fields, keyed by field ID. Match a disclosure to `data[field_id]` and its stored option ID to `data[field_id].values[option_id]`.

## OpenAPI Specs

- [openapi](/docs/api-reference/openapi.json)

> The links below point to documentation indexes. Follow each `/_llms/` index recursively until you reach documentation pages.

## Indexes

- [Data catalog (619 pages)](https://tokenterminal.com/docs/_llms/data-catalog.txt): Documentation for Data catalog.
- [Data catalog / Chain ecosystems (524 pages)](https://tokenterminal.com/docs/_llms/data-catalog/chain-ecosystems.txt): Documentation for Data catalog / Chain ecosystems.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.