# Table of Contents - [Introduction - Token Terminal Docs](#introduction-token-terminal-docs) - [Get a list of all assets - Token Terminal Docs](#get-a-list-of-all-assets-token-terminal-docs) - [Get historical metrics for an asset - Token Terminal Docs](#get-historical-metrics-for-an-asset-token-terminal-docs) - [Get asset details and available metrics - Token Terminal Docs](#get-asset-details-and-available-metrics-token-terminal-docs) - [Best practices - Token Terminal Docs](#best-practices-token-terminal-docs) - [Get asset metrics breakdown - Token Terminal Docs](#get-asset-metrics-breakdown-token-terminal-docs) - [Introduction - Token Terminal Docs](#introduction-token-terminal-docs) - [MCP Server - Token Terminal Docs](#mcp-server-token-terminal-docs) - [Get a list of all market sectors - Token Terminal Docs](#get-a-list-of-all-market-sectors-token-terminal-docs) - [Get market sector data - Token Terminal Docs](#get-market-sector-data-token-terminal-docs) - [Introduction - Token Terminal Docs](#introduction-token-terminal-docs) - [Get a list of all metrics - Token Terminal Docs](#get-a-list-of-all-metrics-token-terminal-docs) - [Get the Insider transactions dataset - Token Terminal Docs](#get-the-insider-transactions-dataset-token-terminal-docs) - [Getting Started with BigQuery - Token Terminal Docs](#getting-started-with-bigquery-token-terminal-docs) - [Get the Cohort analysis dataset - Token Terminal Docs](#get-the-cohort-analysis-dataset-token-terminal-docs) - [Get the Crypto screener dataset - Token Terminal Docs](#get-the-crypto-screener-dataset-token-terminal-docs) - [Get the Project contracts dataset - Token Terminal Docs](#get-the-project-contracts-dataset-token-terminal-docs) - [Discover - Token Terminal Docs](#discover-token-terminal-docs) - [Get the Blockchain comparison dataset - Token Terminal Docs](#get-the-blockchain-comparison-dataset-token-terminal-docs) - [Our data approach - Token Terminal Docs](#our-data-approach-token-terminal-docs) - [Brand assets - Token Terminal Docs](#brand-assets-token-terminal-docs) - [Market sectors - Token Terminal Docs](#market-sectors-token-terminal-docs) - [Get metric aggregations for multiple projects - Token Terminal Docs](#get-metric-aggregations-for-multiple-projects-token-terminal-docs) - [Projects - Token Terminal Docs](#projects-token-terminal-docs) - [Contact - Token Terminal Docs](#contact-token-terminal-docs) - [Introduction - Token Terminal Docs](#introduction-token-terminal-docs) - [Introduction - Token Terminal Docs](#introduction-token-terminal-docs) - [Metrics - Token Terminal Docs](#metrics-token-terminal-docs) - [Microsoft Excel - Token Terminal Docs](#microsoft-excel-token-terminal-docs) - [List all datasets - Token Terminal Docs](#list-all-datasets-token-terminal-docs) - [Get the Stablecoins dataset - Token Terminal Docs](#get-the-stablecoins-dataset-token-terminal-docs) - [Dashboards - Token Terminal Docs](#dashboards-token-terminal-docs) - [General FAQ - Token Terminal Docs](#general-faq-token-terminal-docs) - [Google Sheets - Token Terminal Docs](#google-sheets-token-terminal-docs) - [Datasets - Token Terminal Docs](#datasets-token-terminal-docs) - [Get the Top tokenholders dataset - Token Terminal Docs](#get-the-top-tokenholders-dataset-token-terminal-docs) - [Get metric breakdown aggregation for multiple projects, chains, or products - Token Terminal Docs](#get-metric-breakdown-aggregation-for-multiple-projects-chains-or-products-token-terminal-docs) - [Introduction - Token Terminal Docs](#introduction-token-terminal-docs) - [Get the Trending contracts dataset - Token Terminal Docs](#get-the-trending-contracts-dataset-token-terminal-docs) - [Get metric data for multiple projects - Token Terminal Docs](#get-metric-data-for-multiple-projects-token-terminal-docs) - [Get metric aggregations for a project - Token Terminal Docs](#get-metric-aggregations-for-a-project-token-terminal-docs) - [Get a list of all projects - Token Terminal Docs](#get-a-list-of-all-projects-token-terminal-docs) - [Get details for a specific product of a project - Token Terminal Docs](#get-details-for-a-specific-product-of-a-project-token-terminal-docs) - [Get historical metrics for a project - Token Terminal Docs](#get-historical-metrics-for-a-project-token-terminal-docs) - [Get financial statement for a project - Token Terminal Docs](#get-financial-statement-for-a-project-token-terminal-docs) - [Get metric availability for a project - Token Terminal Docs](#get-metric-availability-for-a-project-token-terminal-docs) - [Syntax - Token Terminal Docs](#syntax-token-terminal-docs) - [Get historical metrics for a specific product of a project - Token Terminal Docs](#get-historical-metrics-for-a-specific-product-of-a-project-token-terminal-docs) - [Charts - Token Terminal Docs](#charts-token-terminal-docs) --- # Introduction - Token Terminal Docs [Skip to main content](https://tokenterminal.com/docs#content-area) [Token Terminal Docs home page![light logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-light.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=de49e0137894962aef5d37455c76ecf1)![dark logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-dark.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=6a5317263edae34558e014343002fe93)](https://tokenterminal.com/docs) Search... ⌘K Search... Navigation Overview Introduction [Overview](https://tokenterminal.com/docs) [Explorer](https://tokenterminal.com/docs/explorer) [Studio](https://tokenterminal.com/docs/studio) [Sheets](https://tokenterminal.com/docs/sheets) [API](https://tokenterminal.com/docs/api-reference/introduction) [Data Room](https://tokenterminal.com/docs/data-room/introduction) Token Terminal lets you analyze both blockchains and decentralized applications using the same frameworks applied to traditional marketplace businesses. With Token Terminal, you can measure and compare the financial performance of these crypto networks using standardized key performance indicators (KPIs) from traditional finance. [Explore standardized onchain data\ ---------------------------------\ \ Discover the financial and business performance of hundreds of projects.](https://tokenterminal.com/docs/explorer) [Create your own dashboards\ --------------------------\ \ Build and share your own charts and dashboards using standardized onchain data.](https://tokenterminal.com/docs/studio) [Analyze data in your spreadsheets\ ---------------------------------\ \ Analyze standardized onchain data directly in your Excel and Google Sheets.](https://tokenterminal.com/docs/sheets) [Access metrics via API\ ----------------------\ \ Get started with querying standardized onchain data programmatically.](https://tokenterminal.com/docs/api-reference) [Leverage the full data warehouse\ --------------------------------\ \ Explore how to integrate high-fidelity blockchain data directly into your data lake.](https://tokenterminal.com/docs/data-room) [Our data approach](https://tokenterminal.com/docs/data-approach) ⌘I --- # Get a list of all assets - Token Terminal Docs [Skip to main content](https://tokenterminal.com/docs/api-reference/assets/get-a-list-of-all-assets#content-area) [Token Terminal Docs home page![light logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-light.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=de49e0137894962aef5d37455c76ecf1)![dark logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-dark.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=6a5317263edae34558e014343002fe93)](https://tokenterminal.com/docs) Search... ⌘K Search... Navigation Assets Get a list of all assets [Overview](https://tokenterminal.com/docs) [Explorer](https://tokenterminal.com/docs/explorer) [Studio](https://tokenterminal.com/docs/studio) [Sheets](https://tokenterminal.com/docs/sheets) [API](https://tokenterminal.com/docs/api-reference/introduction) [Data Room](https://tokenterminal.com/docs/data-room/introduction) Get a list of all assets cURL Copy Ask AI curl --request GET \ --url https://api.tokenterminal.com/v2/assets \ --header 'Authorization: Bearer ' 200 Copy Ask AI { "data": [\ {\ "asset_id": "",\ "asset_type": "",\ "name": "",\ "symbol": "",\ "coingecko_id": "",\ "addresses": [\ {\ "chain_id": "",\ "token_address": "",\ "token_name": "",\ "token_symbol": ""\ }\ ],\ "products": [\ {\ "data_id": "",\ "product_id": "",\ "tags": [\ ""\ ],\ "relation_to_the_project": ""\ }\ ],\ "created_at": "",\ "inserted_at": ""\ }\ ] } GET / v2 / assets Try it Get a list of all assets cURL Copy Ask AI curl --request GET \ --url https://api.tokenterminal.com/v2/assets \ --header 'Authorization: Bearer ' 200 Copy Ask AI { "data": [\ {\ "asset_id": "",\ "asset_type": "",\ "name": "",\ "symbol": "",\ "coingecko_id": "",\ "addresses": [\ {\ "chain_id": "",\ "token_address": "",\ "token_name": "",\ "token_symbol": ""\ }\ ],\ "products": [\ {\ "data_id": "",\ "product_id": "",\ "tags": [\ ""\ ],\ "relation_to_the_project": ""\ }\ ],\ "created_at": "",\ "inserted_at": ""\ }\ ] } #### Authorizations [​](https://tokenterminal.com/docs/api-reference/assets/get-a-list-of-all-assets#authorization-authorization) Authorization string header required Bearer authentication header of the form `Bearer `, where `` is your auth token. #### Query Parameters [​](https://tokenterminal.com/docs/api-reference/assets/get-a-list-of-all-assets#parameter-asset-ids) asset\_ids string\[\] List of asset IDs to filter by. Allows you to select one or more assets. When including multiple assets, separate each one with a comma. Example: `usdc,usdt`. [​](https://tokenterminal.com/docs/api-reference/assets/get-a-list-of-all-assets#parameter-asset-types) asset\_types string\[\] List of asset types to filter by. Allows you to filter assets by their type. When including multiple types, separate each one with a comma. [​](https://tokenterminal.com/docs/api-reference/assets/get-a-list-of-all-assets#parameter-market-sectors) market\_sectors string\[\] List of market sector IDs to filter assets by. Allows you to select one or more market sectors to filter the results. Only assets belonging to any of the specified market sectors will be included. When including multiple market sectors, separate each one with a comma. Example: `blockchains-l1,lending`. The full list of available market sectors can be retrieved from the `/v2/market-sectors` endpoint. [​](https://tokenterminal.com/docs/api-reference/assets/get-a-list-of-all-assets#parameter-limit) limit integer default:1000 Maximum number of assets to return. Required range: `1 <= x <= 1000` [​](https://tokenterminal.com/docs/api-reference/assets/get-a-list-of-all-assets#parameter-offset) offset integer default:0 Number of assets to skip for pagination. Required range: `x >= 0` #### Response 200 - application/json OK [​](https://tokenterminal.com/docs/api-reference/assets/get-a-list-of-all-assets#response-data) data object\[\] Show child attributes [Get the Trending contracts dataset](https://tokenterminal.com/docs/api-reference/datasets/get-the-trending-contracts-dataset) [Get asset details and available metrics](https://tokenterminal.com/docs/api-reference/assets/get-asset-details-and-available-metrics) ⌘I --- # Get historical metrics for an asset - Token Terminal Docs [Skip to main content](https://tokenterminal.com/docs/api-reference/assets/get-historical-metrics-for-an-asset#content-area) [Token Terminal Docs home page![light logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-light.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=de49e0137894962aef5d37455c76ecf1)![dark logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-dark.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=6a5317263edae34558e014343002fe93)](https://tokenterminal.com/docs) Search... ⌘K Search... Navigation Assets Get historical metrics for an asset [Overview](https://tokenterminal.com/docs) [Explorer](https://tokenterminal.com/docs/explorer) [Studio](https://tokenterminal.com/docs/studio) [Sheets](https://tokenterminal.com/docs/sheets) [API](https://tokenterminal.com/docs/api-reference/introduction) [Data Room](https://tokenterminal.com/docs/data-room/introduction) Get historical metrics for an asset cURL Copy Ask AI curl --request GET \ --url https://api.tokenterminal.com/v2/assets/{asset_id}/metrics \ --header 'Authorization: Bearer ' 200 Copy Ask AI { "data": [\ {\ "timestamp": "",\ "asset_id": "",\ "metric_id": "",\ "value": ""\ }\ ] } GET / v2 / assets / {asset\_id} / metrics Try it Get historical metrics for an asset cURL Copy Ask AI curl --request GET \ --url https://api.tokenterminal.com/v2/assets/{asset_id}/metrics \ --header 'Authorization: Bearer ' 200 Copy Ask AI { "data": [\ {\ "timestamp": "",\ "asset_id": "",\ "metric_id": "",\ "value": ""\ }\ ] } #### Authorizations [​](https://tokenterminal.com/docs/api-reference/assets/get-historical-metrics-for-an-asset#authorization-authorization) Authorization string header required Bearer authentication header of the form `Bearer `, where `` is your auth token. #### Path Parameters [​](https://tokenterminal.com/docs/api-reference/assets/get-historical-metrics-for-an-asset#parameter-asset-id) asset\_id string required ID of the asset Allows you to select one of the assets available. The full list is available on the assets endpoint (see above). #### Query Parameters [​](https://tokenterminal.com/docs/api-reference/assets/get-historical-metrics-for-an-asset#parameter-metric-id) metric\_id string Metric to include according to asset metric availability. Allows you to select one of the metrics available for a specific asset. If no metric\_id is selected, the query defaults to `asset_price`. [​](https://tokenterminal.com/docs/api-reference/assets/get-historical-metrics-for-an-asset#parameter-chain-ids) chain\_ids string\[\] List of chains to include according to asset chain availability. Allows you to select one or more of the chains available for a specific asset. When including multiple chains, separate each one with a comma. Example: `ethereum,base`. [​](https://tokenterminal.com/docs/api-reference/assets/get-historical-metrics-for-an-asset#parameter-product-ids) product\_ids string\[\] List of products to include according to asset product availability. Allows you to select one or more of the products available for a specific asset. When including multiple products, separate each one with a comma. Example: `usdc,usdt`. [​](https://tokenterminal.com/docs/api-reference/assets/get-historical-metrics-for-an-asset#parameter-start) start string Start date Allows you to select the start date for the query. If no start is selected, the query defaults to launch date or the first date for which there is data available for the chosen metric. [​](https://tokenterminal.com/docs/api-reference/assets/get-historical-metrics-for-an-asset#parameter-end) end string End date Allows you to select the end date for the query. If no end is selected, the query defaults to the latest date for which there is data available for the chosen metric. [​](https://tokenterminal.com/docs/api-reference/assets/get-historical-metrics-for-an-asset#parameter-aggregate-by) aggregate\_by string\[\] Level of granularity This feature enables more detailed queries of specific metrics. For instance, you can examine an asset's metrics by individual chain. However, it's important to note that this level of granularity is not applicable to all metrics. [​](https://tokenterminal.com/docs/api-reference/assets/get-historical-metrics-for-an-asset#parameter-order-direction) order\_direction enum default:desc Timestamp ordering Allows you to define how the response is sorted. The response is always sorted by timestamp, and by selecting `desc` the response starts from the most recent entry, and vice versa for `asc`. If no order\_direction is selected, the response defaults to `desc`. Available options: `asc`, `desc` [​](https://tokenterminal.com/docs/api-reference/assets/get-historical-metrics-for-an-asset#parameter-one-of-0) interval enuminteger Time interval for data aggregation. Intervals are `24h`, `7d`, `30d`, `90d`, `180d`, `365d`, `max`, `ytd`, `4fullq`, or a number representing days. Available options: `24h`, `7d`, `30d`, `90d`, `180d`, `365d`, `max`, `ytd`, `4fullq` #### Response 200 - application/json OK [​](https://tokenterminal.com/docs/api-reference/assets/get-historical-metrics-for-an-asset#response-data) data object\[\] Show child attributes [Get asset details and available metrics](https://tokenterminal.com/docs/api-reference/assets/get-asset-details-and-available-metrics) [Get asset metrics breakdown](https://tokenterminal.com/docs/api-reference/assets/get-asset-metrics-breakdown) ⌘I --- # Get asset details and available metrics - Token Terminal Docs [Skip to main content](https://tokenterminal.com/docs/api-reference/assets/get-asset-details-and-available-metrics#content-area) [Token Terminal Docs home page![light logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-light.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=de49e0137894962aef5d37455c76ecf1)![dark logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-dark.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=6a5317263edae34558e014343002fe93)](https://tokenterminal.com/docs) Search... ⌘K Search... Navigation Assets Get asset details and available metrics [Overview](https://tokenterminal.com/docs) [Explorer](https://tokenterminal.com/docs/explorer) [Studio](https://tokenterminal.com/docs/studio) [Sheets](https://tokenterminal.com/docs/sheets) [API](https://tokenterminal.com/docs/api-reference/introduction) [Data Room](https://tokenterminal.com/docs/data-room/introduction) Get asset details and available metrics cURL Copy Ask AI curl --request GET \ --url https://api.tokenterminal.com/v2/assets/{asset_id} \ --header 'Authorization: Bearer ' 200 404 Copy Ask AI { "data": { "asset_id": "", "asset_type": "", "name": "", "symbol": "", "coingecko_id": "", "addresses": [\ {\ "chain_id": "",\ "token_address": "",\ "token_name": "",\ "token_symbol": ""\ }\ ], "products": [\ {\ "data_id": "",\ "product_id": "",\ "tags": [\ ""\ ],\ "relation_to_the_project": "",\ "logo": ""\ }\ ], "created_at": "", "inserted_at": "", "available_metrics": [\ ""\ ] } } GET / v2 / assets / {asset\_id} Try it Get asset details and available metrics cURL Copy Ask AI curl --request GET \ --url https://api.tokenterminal.com/v2/assets/{asset_id} \ --header 'Authorization: Bearer ' 200 404 Copy Ask AI { "data": { "asset_id": "", "asset_type": "", "name": "", "symbol": "", "coingecko_id": "", "addresses": [\ {\ "chain_id": "",\ "token_address": "",\ "token_name": "",\ "token_symbol": ""\ }\ ], "products": [\ {\ "data_id": "",\ "product_id": "",\ "tags": [\ ""\ ],\ "relation_to_the_project": "",\ "logo": ""\ }\ ], "created_at": "", "inserted_at": "", "available_metrics": [\ ""\ ] } } #### Authorizations [​](https://tokenterminal.com/docs/api-reference/assets/get-asset-details-and-available-metrics#authorization-authorization) Authorization string header required Bearer authentication header of the form `Bearer `, where `` is your auth token. #### Path Parameters [​](https://tokenterminal.com/docs/api-reference/assets/get-asset-details-and-available-metrics#parameter-asset-id) asset\_id string required ID of the asset Allows you to select one of the assets available. The full list is available on the assets endpoint (see above). #### Response 200 application/json OK [​](https://tokenterminal.com/docs/api-reference/assets/get-asset-details-and-available-metrics#response-data) data object Show child attributes [Get a list of all assets](https://tokenterminal.com/docs/api-reference/assets/get-a-list-of-all-assets) [Get historical metrics for an asset](https://tokenterminal.com/docs/api-reference/assets/get-historical-metrics-for-an-asset) ⌘I --- # Best practices - Token Terminal Docs [Skip to main content](https://tokenterminal.com/docs/api-reference/best-practices#content-area) [Token Terminal Docs home page![light logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-light.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=de49e0137894962aef5d37455c76ecf1)![dark logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-dark.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=6a5317263edae34558e014343002fe93)](https://tokenterminal.com/docs) Search... ⌘K Search... Navigation Overview Best practices [Overview](https://tokenterminal.com/docs) [Explorer](https://tokenterminal.com/docs/explorer) [Studio](https://tokenterminal.com/docs/studio) [Sheets](https://tokenterminal.com/docs/sheets) [API](https://tokenterminal.com/docs/api-reference/introduction) [Data Room](https://tokenterminal.com/docs/data-room/introduction) On this page * [Maintain an up-to-date cache of projects and metrics](https://tokenterminal.com/docs/api-reference/best-practices#maintain-an-up-to-date-cache-of-projects-and-metrics) * [Utilize metric endpoints for detailed data](https://tokenterminal.com/docs/api-reference/best-practices#utilize-metric-endpoints-for-detailed-data) * [Use breakdown aggregation API for summarized responses](https://tokenterminal.com/docs/api-reference/best-practices#use-breakdown-aggregation-api-for-summarized-responses) * [Handling errors and missing data](https://tokenterminal.com/docs/api-reference/best-practices#handling-errors-and-missing-data) * [Managing rate limiting](https://tokenterminal.com/docs/api-reference/best-practices#managing-rate-limiting) To maximize the effectiveness and efficiency of the API, we recommend following these best practices. By structuring your workflow according to these guidelines, you will ensure that your application or analysis is robust, scalable, and performs optimally. [​](https://tokenterminal.com/docs/api-reference/best-practices#maintain-an-up-to-date-cache-of-projects-and-metrics) Maintain an up-to-date cache of projects and metrics ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- Token Terminal regularly updates the list of supported projects and metrics. To ensure your application or analysis remains current, it is best practice to maintain your own cache or index. We recommend caching the responses from the `/projects` and `/metrics` endpoints. This allows you to quickly reference available projects and supported metrics without making redundant API calls. The responses should be updated periodically based on your needs, ideally daily or weekly, depending on how frequently you expect changes in the data. Copy Ask AI // Get the list of projects GET https://api.tokenterminal.com/v2/projects // Get the list of metrics GET https://api.tokenterminal.com/v2/metrics By caching responses from these endpoints, you can easily reference available projects and supported metrics. [​](https://tokenterminal.com/docs/api-reference/best-practices#utilize-metric-endpoints-for-detailed-data) Utilize metric endpoints for detailed data --------------------------------------------------------------------------------------------------------------------------------------------------------- The most flexible and powerful way to interact with Token Terminal data is via metric endpoints. They allow you to retrieve detailed metrics for specific projects, chains, and time ranges. The following call retrieves revenue metrics for Uniswap and Aave projects on Ethereum between specified dates: Copy Ask AI GET https://api.tokenterminal.com/v2/metrics/revenue?project_ids=uniswap,aave&chain_ids=ethereum&start_date=2025-01-01&end_date=2025-03-01 [​](https://tokenterminal.com/docs/api-reference/best-practices#use-breakdown-aggregation-api-for-summarized-responses) Use breakdown aggregation API for summarized responses --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- Instead of fetching time series data first, and then aggregating it, you can directly request summarized data using the breakdown API. This is particularly useful for reducing the amount of data transferred and speeding up response times. The following call retrieves the revenue breakdown aggregation for Uniswap and Aave projects for the specified date range and applying aggregations like **avg**, **change**, **sum** and **trend**: Copy Ask AI GET https://api.tokenterminal.com/v2/metrics-breakdown/revenue?project_ids=uniswap,aave&start_date=2024-01-01&end_date=2024-03-01 [​](https://tokenterminal.com/docs/api-reference/best-practices#handling-errors-and-missing-data) Handling errors and missing data ------------------------------------------------------------------------------------------------------------------------------------- Proper error handling ensures your application remains stable even when data is temporarily unavailable or incorrect parameters are provided. Check HTTP response status codes: * **200**: Successful response * **400**: Bad request (invalid parameters) * **404**: Data not found (possibly unsupported project/metric) * **429**: Too many requests (rate limiting) Here’s an example of how to handle errors in **Python**: Copy Ask AI import requests import os def fetch_data(): # Get API key and set up headers once before the loop api_key = os.environ.get('TOKEN_TERMINAL_API_KEY', '') headers = { 'Authorization': f'Bearer {api_key}' } current_wait_time = wait_time # Use a local variable for exponential backoff for attempt in range(retry_attempts): response = requests.get( 'https://api.tokenterminal.com/v2/metrics/revenue', headers=headers, params={ 'project_ids': 'uniswap', 'chain_ids': 'ethereum', 'start_date': '2024-01-01', 'end_date': '2024-03-01' } ) # Handle success case if response.status_code == 200: print("Successfully fetched data:") print(response.json()) return # Exit after success # Handle rate limit case if response.status_code == 429: print(f"Rate limited. Waiting for {current_wait_time} seconds.") time.sleep(current_wait_time) current_wait_time *= 2 # exponential backoff else: # For other errors, print message and stop retrying print(f"Unexpected error: {response.status_code}") print(f"Response: {response.text}") return print(f"Failed to fetch data after {retry_attempts} attempts.") if __name__ == "__main__": fetch_data() [​](https://tokenterminal.com/docs/api-reference/best-practices#managing-rate-limiting) Managing rate limiting ----------------------------------------------------------------------------------------------------------------- Token Terminal implements rate limiting to ensure fair usage. You should handle rate limits gracefully by implementing exponential backoff or retry logic. Rate limit recommendation: Monitor for HTTP 429 responses and implement retry logic. Here’s an example of how to handle rate limiting in **Python**: Copy Ask AI import requests import os import time retry_attempts = 3 wait_time = 5 # seconds def fetch_data(): for attempt in range(retry_attempts): # Get API key from environment variable or set directly # For security reasons, it's better to use environment variables api_key = os.environ.get('TOKEN_TERMINAL_API_KEY', '') # Set up headers with API key headers = { 'Authorization': f'Bearer {api_key}' } response = requests.get( 'https://api.tokenterminal.com/v2/metrics/revenue', headers=headers, params={ 'project_ids': 'uniswap', 'chain_ids': 'ethereum', 'start_date': '2024-01-01', 'end_date': '2024-03-01' } ) # Here, just handle the rate limit case if response.status_code == 429: print(f"Rate limited. Waiting for {wait_time} seconds.") time.sleep(wait_time) wait_time *= 2 # exponential backoff else: print(f"Unexpected error: {response.status_code}") print(f"Response: {response.text}") if __name__ == "__main__": fetch_data() [MCP Server](https://tokenterminal.com/docs/api-reference/mcp) [Get a list of all projects](https://tokenterminal.com/docs/api-reference/projects/get-a-list-of-all-projects) ⌘I --- # Get asset metrics breakdown - Token Terminal Docs [Skip to main content](https://tokenterminal.com/docs/api-reference/assets/get-asset-metrics-breakdown#content-area) [Token Terminal Docs home page![light logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-light.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=de49e0137894962aef5d37455c76ecf1)![dark logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-dark.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=6a5317263edae34558e014343002fe93)](https://tokenterminal.com/docs) Search... ⌘K Search... Navigation Assets Get asset metrics breakdown [Overview](https://tokenterminal.com/docs) [Explorer](https://tokenterminal.com/docs/explorer) [Studio](https://tokenterminal.com/docs/studio) [Sheets](https://tokenterminal.com/docs/sheets) [API](https://tokenterminal.com/docs/api-reference/introduction) [Data Room](https://tokenterminal.com/docs/data-room/introduction) Get asset metrics breakdown cURL Copy Ask AI curl --request POST \ --url https://api.tokenterminal.com/v2/assets/{asset_id}/metrics-breakdown \ --header 'Authorization: Bearer ' \ --header 'Content-Type: application/json' \ --data ' { "metric_ids": [\ "asset_price",\ "asset_holders"\ ], "group_by": "assets", "interval": "30d", "data_ids": [\ "ethereum"\ ], "product_ids": [\ "usdc"\ ], "asset_ids": [\ ""\ ], "chain_ids": [\ "ethereum",\ "base"\ ], "market_sector_ids": [\ "blockchains-l1",\ "lending"\ ], "includeSelf": false, "start": "2023-12-25", "end": "2023-12-25", "ignore_threshold": false } ' 200 400 Copy Ask AI { "data": [\ {\ "asset_id": "",\ "data_id": "",\ "product_id": "",\ "chain_id": "",\ "market_sector_id": "",\ "metrics": {}\ }\ ], "errors": [\ {\ "code": "NOT_FOUND",\ "field": "project_ids",\ "value": "invalid-project"\ }\ ] } POST / v2 / assets / {asset\_id} / metrics-breakdown Try it Get asset metrics breakdown cURL Copy Ask AI curl --request POST \ --url https://api.tokenterminal.com/v2/assets/{asset_id}/metrics-breakdown \ --header 'Authorization: Bearer ' \ --header 'Content-Type: application/json' \ --data ' { "metric_ids": [\ "asset_price",\ "asset_holders"\ ], "group_by": "assets", "interval": "30d", "data_ids": [\ "ethereum"\ ], "product_ids": [\ "usdc"\ ], "asset_ids": [\ ""\ ], "chain_ids": [\ "ethereum",\ "base"\ ], "market_sector_ids": [\ "blockchains-l1",\ "lending"\ ], "includeSelf": false, "start": "2023-12-25", "end": "2023-12-25", "ignore_threshold": false } ' 200 400 Copy Ask AI { "data": [\ {\ "asset_id": "",\ "data_id": "",\ "product_id": "",\ "chain_id": "",\ "market_sector_id": "",\ "metrics": {}\ }\ ], "errors": [\ {\ "code": "NOT_FOUND",\ "field": "project_ids",\ "value": "invalid-project"\ }\ ] } #### Authorizations [​](https://tokenterminal.com/docs/api-reference/assets/get-asset-metrics-breakdown#authorization-authorization) Authorization string header required Bearer authentication header of the form `Bearer `, where `` is your auth token. #### Path Parameters [​](https://tokenterminal.com/docs/api-reference/assets/get-asset-metrics-breakdown#parameter-asset-id) asset\_id string required ID of the asset Allows you to select one of the assets available. The full list is available on the assets endpoint (see above). #### Body application/json [​](https://tokenterminal.com/docs/api-reference/assets/get-asset-metrics-breakdown#body-metric-ids) metric\_ids string\[\] required List of metrics to include according to asset metric availability. Allows you to select one or more of the metrics available for a specific asset. If an empty array is provided, it defaults to `['asset_price']`. Example: ["asset_price", "asset_holders"] [​](https://tokenterminal.com/docs/api-reference/assets/get-asset-metrics-breakdown#body-group-by) group\_by enum required Dimension to group the breakdown by. Available options: `assets`, `projects`, `product`, `chains`, `market-sector`, `chain-asset`, `chain-project`, `product+chain`. Available options: `assets`, `projects`, `product`, `chains`, `market-sector`, `chain-asset`, `chain-project`, `product+chain` Example: `"assets"` [​](https://tokenterminal.com/docs/api-reference/assets/get-asset-metrics-breakdown#body-interval) interval enum required Time interval for aggregation. Intervals are `24h`, `7d`, `30d`, `90d`, `180d`, `365d`, `max`. Available options: `24h`, `7d`, `30d`, `90d`, `180d`, `365d`, `max` Example: `"30d"` [​](https://tokenterminal.com/docs/api-reference/assets/get-asset-metrics-breakdown#body-data-ids) data\_ids string\[\] List of project data IDs to filter by. Allows you to select one or more projects. When including multiple projects, separate each one with a comma. Example: ["ethereum"] [​](https://tokenterminal.com/docs/api-reference/assets/get-asset-metrics-breakdown#body-product-ids) product\_ids string\[\] List of product IDs to filter by. Allows you to select one or more products. When including multiple products, separate each one with a comma. Example: ["usdc"] [​](https://tokenterminal.com/docs/api-reference/assets/get-asset-metrics-breakdown#body-asset-ids) asset\_ids string\[\] List of asset IDs to filter by. Allows you to select one or more assets. When including multiple assets, separate each one with a comma. [​](https://tokenterminal.com/docs/api-reference/assets/get-asset-metrics-breakdown#body-chain-ids) chain\_ids string\[\] List of chain IDs to filter by. Allows you to select one or more chains. When including multiple chains, separate each one with a comma. Example: ["ethereum", "base"] [​](https://tokenterminal.com/docs/api-reference/assets/get-asset-metrics-breakdown#body-market-sector-ids) market\_sector\_ids string\[\] List of market sector IDs to filter by. Allows you to select one or more market sectors. When including multiple market sectors, separate each one with a comma. The full list of available market sectors can be retrieved from the `/v2/market-sectors` endpoint. Example: ["blockchains-l1", "lending"] [​](https://tokenterminal.com/docs/api-reference/assets/get-asset-metrics-breakdown#body-include-self) includeSelf boolean default:false Include the asset itself in the breakdown results. If not specified, defaults to `false`. [​](https://tokenterminal.com/docs/api-reference/assets/get-asset-metrics-breakdown#body-start) start string Start date for the breakdown. Allows you to select the start date for the query. If not specified, uses the default start date. [​](https://tokenterminal.com/docs/api-reference/assets/get-asset-metrics-breakdown#body-end) end string End date for the breakdown. Allows you to select the end date for the query. If not specified, uses the latest available date. [​](https://tokenterminal.com/docs/api-reference/assets/get-asset-metrics-breakdown#body-ignore-threshold) ignore\_threshold boolean default:false Ignore metric thresholds when calculating breakdowns. If not specified, defaults to `false`. #### Response 200 application/json OK [​](https://tokenterminal.com/docs/api-reference/assets/get-asset-metrics-breakdown#response-data) data object\[\] Show child attributes [​](https://tokenterminal.com/docs/api-reference/assets/get-asset-metrics-breakdown#response-errors) errors object\[\] * Option 1 * Option 2 Show child attributes Example: { "code": "NOT_FOUND", "field": "project_ids", "value": "invalid-project"} [Get historical metrics for an asset](https://tokenterminal.com/docs/api-reference/assets/get-historical-metrics-for-an-asset) ⌘I --- # Introduction - Token Terminal Docs [Skip to main content](https://tokenterminal.com/docs/api-reference/introduction#content-area) [Token Terminal Docs home page![light logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-light.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=de49e0137894962aef5d37455c76ecf1)![dark logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-dark.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=6a5317263edae34558e014343002fe93)](https://tokenterminal.com/docs) Search... ⌘K Search... Navigation Overview Introduction [Overview](https://tokenterminal.com/docs) [Explorer](https://tokenterminal.com/docs/explorer) [Studio](https://tokenterminal.com/docs/studio) [Sheets](https://tokenterminal.com/docs/sheets) [API](https://tokenterminal.com/docs/api-reference/introduction) [Data Room](https://tokenterminal.com/docs/data-room/introduction) On this page * [Rate limiting](https://tokenterminal.com/docs/api-reference/introduction#rate-limiting) * [Authentication](https://tokenterminal.com/docs/api-reference/introduction#authentication) ![API hero](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/images/api.png?w=2500&fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=656131a301e04855993588459744e3c6) Users on the Token Terminal API plan can query the data with their designated API key, which can be found on their account page. The API key should be kept a secret, so make sure to not share it or store it in publicly accessible areas such as GitHub, client-side code, and so forth. If you don’t have an API key, make sure to upgrade your plan to the API plan in your account billing page.If you’re interested in talking to our team about using the API, please reach out to us at [\[email protected\]](https://tokenterminal.com/cdn-cgi/l/email-protection#89fae8e5ecfac9fde6e2ece7fdecfbe4e0e7e8e5a7f1f0f3) for assistance. The API is read-only, supports REST calls, uses predictable resource-oriented URLs, and returns JSON-encoded responses and error messages. We use standard HTTP response codes | Code | Explanation | | --- | --- | | 200 | for success | | 308 | for redirects when e.g. project\_id has been renamed (only when projects make a significant rebranding) | | 400 | for when query parameters are invalid, see included JSON formatted error message for advice | | 402 | for when subscription isn’t valid | | 403 | for invalid access | | 429 | for too many requests (rate limit: 60 requests per minute) | | 500 | if we ever mess up | [​](https://tokenterminal.com/docs/api-reference/introduction#rate-limiting) Rate limiting --------------------------------------------------------------------------------------------- The API has a rate limit of 60 requests per minute. If you exceed this limit, you will receive a **429** HTTP response code. [​](https://tokenterminal.com/docs/api-reference/introduction#authentication) Authentication ----------------------------------------------------------------------------------------------- The API uses HTTP Token Auth to authenticate requests. This means each request must have an Authorization header (your API key). Copy Ask AI curl -X GET "https://api.tokenterminal.com/v2/projects" \ -H "Authorization: Bearer " [MCP Server](https://tokenterminal.com/docs/api-reference/mcp) ⌘I --- # MCP Server - Token Terminal Docs [Skip to main content](https://tokenterminal.com/docs/api-reference/mcp#content-area) [Token Terminal Docs home page![light logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-light.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=de49e0137894962aef5d37455c76ecf1)![dark logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-dark.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=6a5317263edae34558e014343002fe93)](https://tokenterminal.com/docs) Search... ⌘K Search... Navigation Overview MCP Server [Overview](https://tokenterminal.com/docs) [Explorer](https://tokenterminal.com/docs/explorer) [Studio](https://tokenterminal.com/docs/studio) [Sheets](https://tokenterminal.com/docs/sheets) [API](https://tokenterminal.com/docs/api-reference/introduction) [Data Room](https://tokenterminal.com/docs/data-room/introduction) On this page * [1\. Use with Claude](https://tokenterminal.com/docs/api-reference/mcp#1-use-with-claude) * [2\. Use with ChatGPT](https://tokenterminal.com/docs/api-reference/mcp#2-use-with-chatgpt) * [3\. Use with Cursor](https://tokenterminal.com/docs/api-reference/mcp#3-use-with-cursor) * [4\. Use with other clients](https://tokenterminal.com/docs/api-reference/mcp#4-use-with-other-clients) Our Model Context Protocol (MCP) server enables AI models and agents to seamlessly access Token Terminal’s standardized onchain data through a secure, standardized interface. The MCP server integrates natively with ChatGPT,Claude, Cursor, and other compatible clients. Token Terminal’s MCP server is centrally hosted and managed, following the authenticated remote MCP specification. The server provides tools for querying and analyzing Token Terminal data including projects, metrics, financial statements, and market sectors — with additional functionality being continuously added based on user feedback. To use the MCP server, you’ll need an active Token Terminal API plan. If you don’t have API access, contact our team at [\[email protected\]](https://tokenterminal.com/cdn-cgi/l/email-protection#4a392b262f390a3e25212f243e2f382723242b2664323330) . ### [​](https://tokenterminal.com/docs/api-reference/mcp#1-use-with-claude) 1\. Use with Claude 1. Open Claude Desktop and go to Settings (gear icon in the bottom left) 2. Navigate to the “Developers” tab 3. Click “Edit Config” to open your MCP configuration file 4. Add the Token Terminal MCP server configuration: Copy Ask AI { "mcpServers": { "token-terminal": { "command": "npx", "args": ["-y", "mcp-remote@latest", "https://mcp.tokenterminal.net/mcp"] } } } 5. Save the configuration file and restart Claude Desktop 6. The Token Terminal MCP server will open up a new browser tab to authenticate with Token Terminal. 7. Login with your Google account connected to your Token Terminal account. 8. The Token Terminal MCP server should now be available in your Claude conversations Learn more about how to connect remote MCP servers in [the Anthropic documentation](https://modelcontextprotocol.io/docs/develop/connect-remote-servers) . ### [​](https://tokenterminal.com/docs/api-reference/mcp#2-use-with-chatgpt) 2\. Use with ChatGPT MCP connectors are currently only available for the Pro tier or higher with ChatGPT. You will need admin access to your team account in order to turn on developer mode. 1. Open ChatGPT and go to Settings by clicking on the user name in the bottom left cornder. 2. Navigate to “Apps & Connectors” in the left sidebar 3. Scroll to the bottom and click “Advanced” and enable “Developer mode”. Learn more about how to enable developer mode in [the OpenAI documentation](https://help.openai.com/en/articles/12584461-developer-mode-and-full-mcp-connectors-in-chatgpt-beta) . 4. Back in the Connectors tab, click “Create” in the top right 5. Add a name “Token Terminal” and add a description 6. Add the following URL as the MCP Server URL: `https://mcp.tokenterminal.net/mcp` 7. Accept the warnign message at the bottom and click “Create” 8. The Token Terminal MCP server will open up a new browser tab to authenticate with Token Terminal. 9. Login with your connected Token Terminal account. 10. Now in ChatGTP conversation, you can click the ”+” icon, select “More”, and select “Token Terminal” to start using the MCP server. Learn more about connectors and ChatGPT in [the OpenAI documentation](https://help.openai.com/en/articles/11487775-connectors-in-chatgpt) .\` ### [​](https://tokenterminal.com/docs/api-reference/mcp#3-use-with-cursor) 3\. Use with Cursor 1. Open Cursor and go to Settings under the gear icon in the top right or in the Cursor menu item. 2. Navigate to “Tools & MCP” in the left sidebar 3. Click “Add new MCP Server” 4. Add the Token Terminal MCP server configuration to the `mcp.json` file: Copy Ask AI { "mcpServers": { "token-terminal": { "command": "npx", "args": ["-y", "mcp-remote@latest", "https://mcp.tokenterminal.net/mcp"] } } } 5. Save and close the `mcp.json` file. 6. The Token Terminal MCP server will open up a new browser tab to authenticate with Token Terminal. 7. Login with your connected Token Terminal account. 8. The Token Terminal MCP server should now be available in your Cursor conversations ### [​](https://tokenterminal.com/docs/api-reference/mcp#4-use-with-other-clients) 4\. Use with other clients You should be able to use the MCP server with any client that supports MCP using settings similar to those used with Claude or Cursor. Reach out to our team if you have any questions about using the MCP server with your client. [Introduction](https://tokenterminal.com/docs/api-reference/introduction) [Best practices](https://tokenterminal.com/docs/api-reference/best-practices) ⌘I --- # Get a list of all market sectors - Token Terminal Docs [Skip to main content](https://tokenterminal.com/docs/api-reference/market-sectors/get-a-list-of-all-market-sectors#content-area) [Token Terminal Docs home page![light logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-light.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=de49e0137894962aef5d37455c76ecf1)![dark logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-dark.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=6a5317263edae34558e014343002fe93)](https://tokenterminal.com/docs) Search... ⌘K Search... Navigation Market sectors Get a list of all market sectors [Overview](https://tokenterminal.com/docs) [Explorer](https://tokenterminal.com/docs/explorer) [Studio](https://tokenterminal.com/docs/studio) [Sheets](https://tokenterminal.com/docs/sheets) [API](https://tokenterminal.com/docs/api-reference/introduction) [Data Room](https://tokenterminal.com/docs/data-room/introduction) Get a list of all market sectors cURL Copy Ask AI curl --request GET \ --url https://api.tokenterminal.com/v2/market-sectors \ --header 'Authorization: Bearer ' 200 Copy Ask AI { "data": [\ {\ "id": "",\ "name": "",\ "url": ""\ }\ ] } GET / v2 / market-sectors Try it Get a list of all market sectors cURL Copy Ask AI curl --request GET \ --url https://api.tokenterminal.com/v2/market-sectors \ --header 'Authorization: Bearer ' 200 Copy Ask AI { "data": [\ {\ "id": "",\ "name": "",\ "url": ""\ }\ ] } #### Authorizations [​](https://tokenterminal.com/docs/api-reference/market-sectors/get-a-list-of-all-market-sectors#authorization-authorization) Authorization string header required Bearer authentication header of the form `Bearer `, where `` is your auth token. #### Response 200 - application/json OK [​](https://tokenterminal.com/docs/api-reference/market-sectors/get-a-list-of-all-market-sectors#response-data) data object\[\] The Array containing the data for a successful response. Show child attributes [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) [Get market sector data](https://tokenterminal.com/docs/api-reference/market-sectors/get-market-sector-data) ⌘I --- # Get market sector data - Token Terminal Docs [Skip to main content](https://tokenterminal.com/docs/api-reference/market-sectors/get-market-sector-data#content-area) [Token Terminal Docs home page![light logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-light.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=de49e0137894962aef5d37455c76ecf1)![dark logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-dark.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=6a5317263edae34558e014343002fe93)](https://tokenterminal.com/docs) Search... ⌘K Search... Navigation Market sectors Get market sector data [Overview](https://tokenterminal.com/docs) [Explorer](https://tokenterminal.com/docs/explorer) [Studio](https://tokenterminal.com/docs/studio) [Sheets](https://tokenterminal.com/docs/sheets) [API](https://tokenterminal.com/docs/api-reference/introduction) [Data Room](https://tokenterminal.com/docs/data-room/introduction) Get market sector data cURL Copy Ask AI curl --request GET \ --url https://api.tokenterminal.com/v2/market-sectors/{market_sector_id} \ --header 'Authorization: Bearer ' 200 Copy Ask AI { "data": { "market_sector_id": "", "name": "", "description": { "what": "", "how": "" }, "projects": [\ {\ "project_id": "",\ "name": "",\ "url": ""\ }\ ] } } GET / v2 / market-sectors / {market\_sector\_id} Try it Get market sector data cURL Copy Ask AI curl --request GET \ --url https://api.tokenterminal.com/v2/market-sectors/{market_sector_id} \ --header 'Authorization: Bearer ' 200 Copy Ask AI { "data": { "market_sector_id": "", "name": "", "description": { "what": "", "how": "" }, "projects": [\ {\ "project_id": "",\ "name": "",\ "url": ""\ }\ ] } } #### Authorizations [​](https://tokenterminal.com/docs/api-reference/market-sectors/get-market-sector-data#authorization-authorization) Authorization string header required Bearer authentication header of the form `Bearer `, where `` is your auth token. #### Path Parameters [​](https://tokenterminal.com/docs/api-reference/market-sectors/get-market-sector-data#parameter-market-sector-id) market\_sector\_id string required The market sector ID. #### Response 200 - application/json OK [​](https://tokenterminal.com/docs/api-reference/market-sectors/get-market-sector-data#response-data) data object The object containing the data for a successful response. Show child attributes [Get a list of all market sectors](https://tokenterminal.com/docs/api-reference/market-sectors/get-a-list-of-all-market-sectors) [Get a list of all metrics](https://tokenterminal.com/docs/api-reference/metrics/get-a-list-of-all-metrics) ⌘I --- # Introduction - Token Terminal Docs [Skip to main content](https://tokenterminal.com/docs/data-room/introduction#content-area) [Token Terminal Docs home page![light logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-light.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=de49e0137894962aef5d37455c76ecf1)![dark logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-dark.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=6a5317263edae34558e014343002fe93)](https://tokenterminal.com/docs) Search... ⌘K Search... Navigation Introduction [Overview](https://tokenterminal.com/docs) [Explorer](https://tokenterminal.com/docs/explorer) [Studio](https://tokenterminal.com/docs/studio) [Sheets](https://tokenterminal.com/docs/sheets) [API](https://tokenterminal.com/docs/api-reference/introduction) [Data Room](https://tokenterminal.com/docs/data-room/introduction) ![Data Room hero](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/images/data-room.png?w=2500&fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=ce839cc7f7669228be20c385998d6062) The Data Room is Token Terminal’s enterprise-grade data warehouse. This same infrastructure powers all of our downstream data products. It gives analysts and engineers direct access to high-fidelity blockchain and application-level data, delivered straight into their data lake. With Data Room, you get the following benefits: * **Data coverage**: We have the broadest coverage across ecosystems, market sectors with over 100 blockchains and close to 1,000 of applications including millions of labelled smart contract addresses. * **Data depth**: We maintain and end-to-end dataset from raw blockchain and decoded smart contract data to reusable abstractions and standardized metrics. * **Data delivery**: We offer direct delivery from our data warehouse to your data lake. Skip months of engineering and query our data in your environment. If you are interested in using the Data Room, please reach out to us at [**\[email protected\]**](https://tokenterminal.com/cdn-cgi/l/email-protection#5625373a33251622393d33382233243b3f38373a782e2f2c) to discuss your needs and get started. [Getting Started with BigQuery](https://tokenterminal.com/docs/data-room/getting-started-with-bigquery) ⌘I --- # Get a list of all metrics - Token Terminal Docs [Skip to main content](https://tokenterminal.com/docs/api-reference/metrics/get-a-list-of-all-metrics#content-area) [Token Terminal Docs home page![light logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-light.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=de49e0137894962aef5d37455c76ecf1)![dark logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-dark.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=6a5317263edae34558e014343002fe93)](https://tokenterminal.com/docs) Search... ⌘K Search... Navigation Metrics Get a list of all metrics [Overview](https://tokenterminal.com/docs) [Explorer](https://tokenterminal.com/docs/explorer) [Studio](https://tokenterminal.com/docs/studio) [Sheets](https://tokenterminal.com/docs/sheets) [API](https://tokenterminal.com/docs/api-reference/introduction) [Data Room](https://tokenterminal.com/docs/data-room/introduction) Get a list of all metrics cURL Copy Ask AI curl --request GET \ --url https://api.tokenterminal.com/v2/metrics \ --header 'Authorization: Bearer ' 200 Copy Ask AI { "data": [\ {\ "metric_id": "",\ "metric_name": "",\ "description": "",\ "url": ""\ }\ ] } GET / v2 / metrics Try it Get a list of all metrics cURL Copy Ask AI curl --request GET \ --url https://api.tokenterminal.com/v2/metrics \ --header 'Authorization: Bearer ' 200 Copy Ask AI { "data": [\ {\ "metric_id": "",\ "metric_name": "",\ "description": "",\ "url": ""\ }\ ] } #### Authorizations [​](https://tokenterminal.com/docs/api-reference/metrics/get-a-list-of-all-metrics#authorization-authorization) Authorization string header required Bearer authentication header of the form `Bearer `, where `` is your auth token. #### Response 200 - application/json OK [​](https://tokenterminal.com/docs/api-reference/metrics/get-a-list-of-all-metrics#response-data) data object\[\] Show child attributes [Get market sector data](https://tokenterminal.com/docs/api-reference/market-sectors/get-market-sector-data) [Get metric data for multiple projects](https://tokenterminal.com/docs/api-reference/metrics/get-metric-data-for-multiple-projects) ⌘I --- # Get the Insider transactions dataset - Token Terminal Docs [Skip to main content](https://tokenterminal.com/docs/api-reference/datasets/get-the-insider-transactions-dataset#content-area) [Token Terminal Docs home page![light logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-light.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=de49e0137894962aef5d37455c76ecf1)![dark logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-dark.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=6a5317263edae34558e014343002fe93)](https://tokenterminal.com/docs) Search... ⌘K Search... Navigation Datasets Get the Insider transactions dataset [Overview](https://tokenterminal.com/docs) [Explorer](https://tokenterminal.com/docs/explorer) [Studio](https://tokenterminal.com/docs/studio) [Sheets](https://tokenterminal.com/docs/sheets) [API](https://tokenterminal.com/docs/api-reference/introduction) [Data Room](https://tokenterminal.com/docs/data-room/introduction) Get the Insider transactions dataset cURL Copy Ask AI curl --request GET \ --url https://api.tokenterminal.com/v2/datasets/insider_transactions \ --header 'Authorization: Bearer ' 200 Copy Ask AI { "data": { "timestamp": "", "project_name": "", "project_id": "", "market_sector_id": "", "market_sector_name": "", "chain_id": "", "chain_name": "", "token_standard": "", "token_symbol": "", "token_address": "", "insider_account_address": "", "insider_account_title": "", "counterparty_account_address": "", "counterparty_account_title": "", "transaction_hash": "", "transaction_type": "", "transaction_number": "", "dex_name": "", "action_type": "", "amount_native": 123, "amount_usd": 123, "flow_usd": 123, "percentage_of_position": 123, "post_transaction_position": 123, "position_creation_timestamp": "" } } GET / v2 / datasets / insider\_transactions Try it Get the Insider transactions dataset cURL Copy Ask AI curl --request GET \ --url https://api.tokenterminal.com/v2/datasets/insider_transactions \ --header 'Authorization: Bearer ' 200 Copy Ask AI { "data": { "timestamp": "", "project_name": "", "project_id": "", "market_sector_id": "", "market_sector_name": "", "chain_id": "", "chain_name": "", "token_standard": "", "token_symbol": "", "token_address": "", "insider_account_address": "", "insider_account_title": "", "counterparty_account_address": "", "counterparty_account_title": "", "transaction_hash": "", "transaction_type": "", "transaction_number": "", "dex_name": "", "action_type": "", "amount_native": 123, "amount_usd": 123, "flow_usd": 123, "percentage_of_position": 123, "post_transaction_position": 123, "position_creation_timestamp": "" } } #### Authorizations [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-insider-transactions-dataset#authorization-authorization) Authorization string header required Bearer authentication header of the form `Bearer `, where `` is your auth token. #### Query Parameters [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-insider-transactions-dataset#parameter-project-ids) project\_ids string\[\] Allows you to select one or more of the projects available in the dataset. When including multiple projects, separate each one with a comma. Example: `tether,circle`. [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-insider-transactions-dataset#parameter-chain-ids) chain\_ids string\[\] Allows you to select one or more of the chains available in the dataset. When including multiple chains, separate each one with a comma. Example: `ethereum,arbitrum`. [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-insider-transactions-dataset#parameter-order-by) order\_by string Allows you to select a field by which the response array is sorted. [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-insider-transactions-dataset#parameter-order-direction) order\_direction string Allows you to define order direction for the field selected in `order_by`. If no order\_direction is selected, the response defaults to `asc`. [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-insider-transactions-dataset#parameter-limit) limit number Limit the number of results returned. Usage through API reference has max limit of 50. #### Response 200 - application/json OK [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-insider-transactions-dataset#response-data) data object The object containing the data for a successful response. Show child attributes [Get the Crypto screener dataset](https://tokenterminal.com/docs/api-reference/datasets/get-the-crypto-screener-dataset) [Get the Top tokenholders dataset](https://tokenterminal.com/docs/api-reference/datasets/get-the-top-tokenholders-dataset) ⌘I --- # Getting Started with BigQuery - Token Terminal Docs [Skip to main content](https://tokenterminal.com/docs/data-room/getting-started-with-bigquery#content-area) [Token Terminal Docs home page![light logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-light.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=de49e0137894962aef5d37455c76ecf1)![dark logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-dark.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=6a5317263edae34558e014343002fe93)](https://tokenterminal.com/docs) Search... ⌘K Search... Navigation Getting Started with BigQuery [Overview](https://tokenterminal.com/docs) [Explorer](https://tokenterminal.com/docs/explorer) [Studio](https://tokenterminal.com/docs/studio) [Sheets](https://tokenterminal.com/docs/sheets) [API](https://tokenterminal.com/docs/api-reference/introduction) [Data Room](https://tokenterminal.com/docs/data-room/introduction) On this page * [Overview](https://tokenterminal.com/docs/data-room/getting-started-with-bigquery#overview) * [Video Walkthrough](https://tokenterminal.com/docs/data-room/getting-started-with-bigquery#video-walkthrough) * [Steps for adding a Token Terminal dataset in BigQuery](https://tokenterminal.com/docs/data-room/getting-started-with-bigquery#steps-for-adding-a-token-terminal-dataset-in-bigquery) [​](https://tokenterminal.com/docs/data-room/getting-started-with-bigquery#overview) Overview ------------------------------------------------------------------------------------------------ To access data from our datasets on [BigQuery](https://cloud.google.com/bigquery) , you’ll need a Google Cloud Platform (GCP) account and an invitation from our team. If you haven’t been in touch with us yet, please reach out to us at [\[email protected\]](https://tokenterminal.com/cdn-cgi/l/email-protection#8afaefe5fae6efcafee5e1efe4feeff8e7e3e4ebe6a4e9e5e7) to request access. Once you’ve signed up and received access, navigate to BigQuery, where you’ll find the SQL interface. Below, we’ve provided a detailed, step-by-step guide to help you access our datasets. [​](https://tokenterminal.com/docs/data-room/getting-started-with-bigquery#video-walkthrough) Video Walkthrough ------------------------------------------------------------------------------------------------------------------ [​](https://tokenterminal.com/docs/data-room/getting-started-with-bigquery#steps-for-adding-a-token-terminal-dataset-in-bigquery) Steps for adding a Token Terminal dataset in BigQuery ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ 1. Navigate to [console.cloud.google.com/bigquery](https://console.cloud.google.com/bigquery) 2. Click on “ADD”. ![Add project in B](https://mintcdn.com/tokenterminal/OSOuTfyc-ixmyoWE/images/bigquery-add-1.png?w=2500&fit=max&auto=format&n=OSOuTfyc-ixmyoWE&q=85&s=72b503b2c0614f78ad2bd32c89e41fa9) 3. Click on “Star a project by name”. ![Star a project by name in BigQuery](https://mintcdn.com/tokenterminal/OSOuTfyc-ixmyoWE/images/bigquery-star-2.png?w=2500&fit=max&auto=format&n=OSOuTfyc-ixmyoWE&q=85&s=3210956d3de71c0c0a20ccade41a3304) 4. Insert the project (data table) name. The four project names are * `tt-contracts` * `tt-blockchain` * `tt-abstractions` * `tt-prices` ![Insert project name in BigQuery](https://mintcdn.com/tokenterminal/OSOuTfyc-ixmyoWE/images/bigquery-project-3.png?w=2500&fit=max&auto=format&n=OSOuTfyc-ixmyoWE&q=85&s=c22e7076a374fda10fc4546a53c55bd6)[Big Query Syntax Guide\ ----------------------\ \ Check out the official Big Query syntax guide for more information on how to use the platform’s SQL implementation.](https://cloud.google.com/bigquery/docs/reference/standard-sql/query-syntax) [Introduction](https://tokenterminal.com/docs/data-room/introduction) ⌘I --- # Get the Cohort analysis dataset - Token Terminal Docs [Skip to main content](https://tokenterminal.com/docs/api-reference/datasets/get-the-cohort-analysis-dataset#content-area) [Token Terminal Docs home page![light logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-light.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=de49e0137894962aef5d37455c76ecf1)![dark logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-dark.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=6a5317263edae34558e014343002fe93)](https://tokenterminal.com/docs) Search... ⌘K Search... Navigation Datasets Get the Cohort analysis dataset [Overview](https://tokenterminal.com/docs) [Explorer](https://tokenterminal.com/docs/explorer) [Studio](https://tokenterminal.com/docs/studio) [Sheets](https://tokenterminal.com/docs/sheets) [API](https://tokenterminal.com/docs/api-reference/introduction) [Data Room](https://tokenterminal.com/docs/data-room/introduction) Get the Cohort analysis dataset cURL Copy Ask AI curl --request GET \ --url https://api.tokenterminal.com/v2/datasets/cohort_analysis \ --header 'Authorization: Bearer ' 200 Copy Ask AI { "data": { "project_name": "", "project_id": "", "market_sector_id": "", "market_sector_name": "", "cohort": "", "initial_cohort_size": 123, "month_0": 123, "month_1": 123, "month_2": 123, "month_3": 123, "month_4": 123, "month_5": 123, "month_6": 123, "month_7": 123, "month_8": 123, "month_9": 123, "month_10": 123, "month_11": 123 } } GET / v2 / datasets / cohort\_analysis Try it Get the Cohort analysis dataset cURL Copy Ask AI curl --request GET \ --url https://api.tokenterminal.com/v2/datasets/cohort_analysis \ --header 'Authorization: Bearer ' 200 Copy Ask AI { "data": { "project_name": "", "project_id": "", "market_sector_id": "", "market_sector_name": "", "cohort": "", "initial_cohort_size": 123, "month_0": 123, "month_1": 123, "month_2": 123, "month_3": 123, "month_4": 123, "month_5": 123, "month_6": 123, "month_7": 123, "month_8": 123, "month_9": 123, "month_10": 123, "month_11": 123 } } #### Authorizations [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-cohort-analysis-dataset#authorization-authorization) Authorization string header required Bearer authentication header of the form `Bearer `, where `` is your auth token. #### Query Parameters [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-cohort-analysis-dataset#parameter-project-ids) project\_ids string\[\] Allows you to select one or more of the projects available in the dataset. When including multiple projects, separate each one with a comma. Example: `uniswap`. [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-cohort-analysis-dataset#parameter-market-sector-ids) market\_sector\_ids string\[\] Allows you to select one or more of the market sectors available in the dataset. When including multiple market sectors, separate each one with a comma. Example: `exchange,lending`. [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-cohort-analysis-dataset#parameter-order-by) order\_by string Allows you to select a field by which the response array is sorted. [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-cohort-analysis-dataset#parameter-order-direction) order\_direction string Allows you to define order direction for the field selected in `order_by`. If no order\_direction is selected, the response defaults to `asc`. [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-cohort-analysis-dataset#parameter-limit) limit number Limit the number of results returned. Usage through API reference has max limit of 50. #### Response 200 - application/json OK [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-cohort-analysis-dataset#response-data) data object The object containing the data for a successful response. Show child attributes [Get the Blockchain comparison dataset](https://tokenterminal.com/docs/api-reference/datasets/get-the-blockchain-comparison-dataset) [Get the Crypto screener dataset](https://tokenterminal.com/docs/api-reference/datasets/get-the-crypto-screener-dataset) ⌘I --- # Get the Crypto screener dataset - Token Terminal Docs [Skip to main content](https://tokenterminal.com/docs/api-reference/datasets/get-the-crypto-screener-dataset#content-area) [Token Terminal Docs home page![light logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-light.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=de49e0137894962aef5d37455c76ecf1)![dark logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-dark.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=6a5317263edae34558e014343002fe93)](https://tokenterminal.com/docs) Search... ⌘K Search... Navigation Datasets Get the Crypto screener dataset [Overview](https://tokenterminal.com/docs) [Explorer](https://tokenterminal.com/docs/explorer) [Studio](https://tokenterminal.com/docs/studio) [Sheets](https://tokenterminal.com/docs/sheets) [API](https://tokenterminal.com/docs/api-reference/introduction) [Data Room](https://tokenterminal.com/docs/data-room/introduction) Get the Crypto screener dataset cURL Copy Ask AI curl --request GET \ --url https://api.tokenterminal.com/v2/datasets/crypto_screener \ --header 'Authorization: Bearer ' 200 Copy Ask AI { "data": { "project_name": "", "project_id": "", "market_sector_id": "", "market_sector_name": "" } } GET / v2 / datasets / crypto\_screener Try it Get the Crypto screener dataset cURL Copy Ask AI curl --request GET \ --url https://api.tokenterminal.com/v2/datasets/crypto_screener \ --header 'Authorization: Bearer ' 200 Copy Ask AI { "data": { "project_name": "", "project_id": "", "market_sector_id": "", "market_sector_name": "" } } #### Authorizations [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-crypto-screener-dataset#authorization-authorization) Authorization string header required Bearer authentication header of the form `Bearer `, where `` is your auth token. #### Query Parameters [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-crypto-screener-dataset#parameter-project-ids) project\_ids string\[\] Allows you to select one or more of the projects available in the dataset. When including multiple projects, separate each one with a comma. Example: `uniswap`. [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-crypto-screener-dataset#parameter-market-sector-ids) market\_sector\_ids string\[\] Allows you to select one or more of the market sectors available in the dataset. When including multiple market sectors, separate each one with a comma. Example: `exchange,lending`. [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-crypto-screener-dataset#parameter-order-by) order\_by string Allows you to select a field by which the response array is sorted. [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-crypto-screener-dataset#parameter-order-direction) order\_direction string Allows you to define order direction for the field selected in `order_by`. If no order\_direction is selected, the response defaults to `asc`. [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-crypto-screener-dataset#parameter-limit) limit number Limit the number of results returned. Usage through API reference has max limit of 50. #### Response 200 - application/json OK [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-crypto-screener-dataset#response-data) data object The object containing the data for a successful response. Metric columns are not shown here due to abundant amount of metrics. Show child attributes [Get the Cohort analysis dataset](https://tokenterminal.com/docs/api-reference/datasets/get-the-cohort-analysis-dataset) [Get the Insider transactions dataset](https://tokenterminal.com/docs/api-reference/datasets/get-the-insider-transactions-dataset) ⌘I --- # Get the Project contracts dataset - Token Terminal Docs [Skip to main content](https://tokenterminal.com/docs/api-reference/datasets/get-the-project-contracts-dataset#content-area) [Token Terminal Docs home page![light logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-light.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=de49e0137894962aef5d37455c76ecf1)![dark logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-dark.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=6a5317263edae34558e014343002fe93)](https://tokenterminal.com/docs) Search... ⌘K Search... Navigation Datasets Get the Project contracts dataset [Overview](https://tokenterminal.com/docs) [Explorer](https://tokenterminal.com/docs/explorer) [Studio](https://tokenterminal.com/docs/studio) [Sheets](https://tokenterminal.com/docs/sheets) [API](https://tokenterminal.com/docs/api-reference/introduction) [Data Room](https://tokenterminal.com/docs/data-room/introduction) Get the Project contracts dataset cURL Copy Ask AI curl --request GET \ --url https://api.tokenterminal.com/v2/datasets/project_contracts \ --header 'Authorization: Bearer ' 200 Copy Ask AI { "data": [\ {\ "project_id": "",\ "project_name": "",\ "market_sector_id": "",\ "market_sector_name": "",\ "chain_id": "",\ "chain_name": "",\ "account_address": "",\ "account_title": "",\ "account_creation_timestamp": "",\ "gas_used_1d_sum": 123,\ "transaction_count_1d_sum": 123,\ "active_addresses_1d_distinct_count": 123,\ "transaction_gas_1d_avg": 123,\ "gas_market_share_1d_avg": 123,\ "inflows_1d_sum": 123,\ "outflows_1d_sum": 123,\ "net_flows_1d_sum": 123,\ "gas_used_1d_sum_trend": 123,\ "transaction_count_1d_sum_trend": 123,\ "active_addresses_1d_distinct_count_trend": 123,\ "transaction_gas_1d_avg_trend": 123,\ "gas_market_share_1d_avg_trend": 123,\ "inflows_1d_sum_trend": 123,\ "outfows_1d_sum_trend": 123,\ "net_flows_1d_sum_trend": 123,\ "most_emitted_event_1d_name": "",\ "most_emitted_event_1d_signature": "",\ "most_transferred_asset_1d_symbol": ""\ }\ ] } GET / v2 / datasets / project\_contracts Try it Get the Project contracts dataset cURL Copy Ask AI curl --request GET \ --url https://api.tokenterminal.com/v2/datasets/project_contracts \ --header 'Authorization: Bearer ' 200 Copy Ask AI { "data": [\ {\ "project_id": "",\ "project_name": "",\ "market_sector_id": "",\ "market_sector_name": "",\ "chain_id": "",\ "chain_name": "",\ "account_address": "",\ "account_title": "",\ "account_creation_timestamp": "",\ "gas_used_1d_sum": 123,\ "transaction_count_1d_sum": 123,\ "active_addresses_1d_distinct_count": 123,\ "transaction_gas_1d_avg": 123,\ "gas_market_share_1d_avg": 123,\ "inflows_1d_sum": 123,\ "outflows_1d_sum": 123,\ "net_flows_1d_sum": 123,\ "gas_used_1d_sum_trend": 123,\ "transaction_count_1d_sum_trend": 123,\ "active_addresses_1d_distinct_count_trend": 123,\ "transaction_gas_1d_avg_trend": 123,\ "gas_market_share_1d_avg_trend": 123,\ "inflows_1d_sum_trend": 123,\ "outfows_1d_sum_trend": 123,\ "net_flows_1d_sum_trend": 123,\ "most_emitted_event_1d_name": "",\ "most_emitted_event_1d_signature": "",\ "most_transferred_asset_1d_symbol": ""\ }\ ] } #### Authorizations [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-project-contracts-dataset#authorization-authorization) Authorization string header required Bearer authentication header of the form `Bearer `, where `` is your auth token. #### Query Parameters [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-project-contracts-dataset#parameter-project-ids) project\_ids string\[\] Allows you to select one or more of the projects available in the dataset. When including multiple projects, separate each one with a comma. Example: `aave,uniswap`. [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-project-contracts-dataset#parameter-chain-ids) chain\_ids string\[\] Allows you to select one or more of the chains available in the dataset. When including multiple chains, separate each one with a comma. Example: `ethereum,arbitrum`. [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-project-contracts-dataset#parameter-market-sector-ids) market\_sector\_ids string\[\] Allows you to select one or more of the market sectors available in the dataset. When including multiple market sectors, separate each one with a comma. Example: `stablecoin,derivatives`. [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-project-contracts-dataset#parameter-order-by) order\_by string Allows you to select a field by which the response array is sorted. [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-project-contracts-dataset#parameter-order-direction) order\_direction string Allows you to define order direction for the field selected in `order_by`. If no order\_direction is selected, the response defaults to `asc`. [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-project-contracts-dataset#parameter-limit) limit number Limit the number of results returned. Usage through API reference has max limit of 50. #### Response 200 - application/json OK [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-project-contracts-dataset#response-data) data object\[\] The Array containing the data for a successful response. Show child attributes [Get the Top tokenholders dataset](https://tokenterminal.com/docs/api-reference/datasets/get-the-top-tokenholders-dataset) [Get the Stablecoins dataset](https://tokenterminal.com/docs/api-reference/datasets/get-the-stablecoins-dataset) ⌘I --- # Discover - Token Terminal Docs [Skip to main content](https://tokenterminal.com/docs/explorer/discover#content-area) [Token Terminal Docs home page![light logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-light.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=de49e0137894962aef5d37455c76ecf1)![dark logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-dark.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=6a5317263edae34558e014343002fe93)](https://tokenterminal.com/docs) Search... ⌘K Search... Navigation Discover [Overview](https://tokenterminal.com/docs) [Explorer](https://tokenterminal.com/docs/explorer) [Studio](https://tokenterminal.com/docs/studio) [Sheets](https://tokenterminal.com/docs/sheets) [API](https://tokenterminal.com/docs/api-reference/introduction) [Data Room](https://tokenterminal.com/docs/data-room/introduction) ![Discover hero](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/images/discover.jpg?w=2500&fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=92c50b02e00d5f64278d0b428d342780) Discover features curated dashboards created by our research team in collaboration with project teams, as well as select dashboards submitted by external analysts. It serves both as a source of novel insights and as a template library for users who want to fork, modify, and improve dashboards. Forked dashboards remain private and appear only in a user’s personal library. All dashboards refresh automatically once a day. If you have an interesting dashboard you’d like to feature, reach out to us at [\[email protected\]](https://tokenterminal.com/cdn-cgi/l/email-protection#47372228372b220733282c22293322352a2e29262b693f3e3d) . [Introduction](https://tokenterminal.com/docs/explorer) [Market sectors](https://tokenterminal.com/docs/explorer/market-sectors) ⌘I --- # Get the Blockchain comparison dataset - Token Terminal Docs [Skip to main content](https://tokenterminal.com/docs/api-reference/datasets/get-the-blockchain-comparison-dataset#content-area) [Token Terminal Docs home page![light logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-light.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=de49e0137894962aef5d37455c76ecf1)![dark logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-dark.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=6a5317263edae34558e014343002fe93)](https://tokenterminal.com/docs) Search... ⌘K Search... Navigation Datasets Get the Blockchain comparison dataset [Overview](https://tokenterminal.com/docs) [Explorer](https://tokenterminal.com/docs/explorer) [Studio](https://tokenterminal.com/docs/studio) [Sheets](https://tokenterminal.com/docs/sheets) [API](https://tokenterminal.com/docs/api-reference/introduction) [Data Room](https://tokenterminal.com/docs/data-room/introduction) Get the Blockchain comparison dataset cURL Copy Ask AI curl --request GET \ --url https://api.tokenterminal.com/v2/datasets/blockchain_comparison \ --header 'Authorization: Bearer ' 200 Copy Ask AI { "data": [\ {\ "chain_id": "",\ "chain_name": "",\ "market_cap_fd_latest": 123,\ "market_cap_fd_1d_change": 123,\ "market_cap_fd_7d_change": 123,\ "market_cap_fd_30d_change": 123,\ "market_cap_fd_90d_change": 123,\ "market_cap_fd_180d_change": 123,\ "market_cap_fd_365d_change": 123,\ "market_cap_circ_latest": 123,\ "market_cap_circ_1d_change": 123,\ "market_cap_circ_7d_change": 123,\ "market_cap_circ_30d_change": 123,\ "market_cap_circ_90d_change": 123,\ "market_cap_circ_180d_change": 123,\ "market_cap_circ_365d_change": 123,\ "active_users_daily_latest": 123,\ "active_users_daily_1d_change": 123,\ "active_users_daily_7d_change": 123,\ "active_users_daily_30d_change": 123,\ "active_users_daily_90d_change": 123,\ "active_users_daily_180d_change": 123,\ "active_users_daily_365d_change": 123,\ "transaction_count_1d": 123,\ "transaction_count_1d_trend": 123,\ "transaction_count_7d": 123,\ "transaction_count_7d_trend": 123,\ "transaction_count_30d": 123,\ "transaction_count_30d_trend": 123,\ "transaction_count_90d": 123,\ "transaction_count_90d_trend": 123,\ "transaction_count_180d": 123,\ "transaction_count_180d_trend": 123,\ "transaction_count_365d": 123,\ "transaction_count_365d_trend": 123,\ "transaction_count_max": 123,\ "core_developers_latest": 123,\ "core_developers_1d_change": 123,\ "core_developers_7d_change": 123,\ "core_developers_30d_change": 123,\ "core_developers_90d_change": 123,\ "core_developers_180d_change": 123,\ "core_developers_365d_change": 123,\ "ecosystem_fees_1d_sum": 123,\ "ecosystem_fees_1d_trend": 123,\ "ecosystem_fees_7d_sum": 123,\ "ecosystem_fees_7d_trend": 123,\ "ecosystem_fees_30d_sum": 123,\ "ecosystem_fees_30d_trend": 123,\ "ecosystem_fees_90d_sum": 123,\ "ecosystem_fees_90d_trend": 123,\ "ecosystem_fees_180d_sum": 123,\ "ecosystem_fees_180d_trend": 123,\ "ecosystem_fees_365d_sum": 123,\ "ecosystem_fees_365d_trend": 123,\ "ecosystem_fees_max_sum": 123,\ "ecosystem_revenue_1d_sum": 123,\ "ecosystem_revenue_1d_trend": 123,\ "ecosystem_revenue_7d_sum": 123,\ "ecosystem_revenue_7d_trend": 123,\ "ecosystem_revenue_30d_sum": 123,\ "ecosystem_revenue_30d_trend": 123,\ "ecosystem_revenue_90d_sum": 123,\ "ecosystem_revenue_90d_trend": 123,\ "ecosystem_revenue_180d_sum": 123,\ "ecosystem_revenue_180d_trend": 123,\ "ecosystem_revenue_365d_sum": 123,\ "ecosystem_revenue_365d_trend": 123,\ "ecosystem_revenue_max_sum": 123,\ "ecosystem_dex_trading_volume_1d_sum": 123,\ "ecosystem_dex_trading_volume_1d_trend": 123,\ "ecosystem_dex_trading_volume_7d_sum": 123,\ "ecosystem_dex_trading_volume_7d_trend": 123,\ "ecosystem_dex_trading_volume_30d_sum": 123,\ "ecosystem_dex_trading_volume_30d_trend": 123,\ "ecosystem_dex_trading_volume_90d_sum": 123,\ "ecosystem_dex_trading_volume_90d_trend": 123,\ "ecosystem_dex_trading_volume_180d_sum": 123,\ "ecosystem_dex_trading_volume_180d_trend": 123,\ "ecosystem_dex_trading_volume_365d_sum": 123,\ "ecosystem_dex_trading_volume_365d_trend": 123,\ "ecosystem_dex_trading_volume_max_sum": 123,\ "ecosystem_tvl_latest": 123,\ "ecosystem_tvl_1d_change": 123,\ "ecosystem_tvl_7d_change": 123,\ "ecosystem_tvl_30d_change": 123,\ "ecosystem_tvl_90d_change": 123,\ "ecosystem_tvl_180d_change": 123,\ "ecosystem_tvl_365d_change": 123,\ "ecosystem_active_loans_latest": 123,\ "ecosystem_active_loans_1d_change": 123,\ "ecosystem_active_loans_7d_change": 123,\ "ecosystem_active_loans_30d_change": 123,\ "ecosystem_active_loans_90d_change": 123,\ "ecosystem_active_loans_180d_change": 123,\ "ecosystem_active_loans_365d_change": 123,\ "ecosystem_project_count_latest": 123\ }\ ] } GET / v2 / datasets / blockchain\_comparison Try it Get the Blockchain comparison dataset cURL Copy Ask AI curl --request GET \ --url https://api.tokenterminal.com/v2/datasets/blockchain_comparison \ --header 'Authorization: Bearer ' 200 Copy Ask AI { "data": [\ {\ "chain_id": "",\ "chain_name": "",\ "market_cap_fd_latest": 123,\ "market_cap_fd_1d_change": 123,\ "market_cap_fd_7d_change": 123,\ "market_cap_fd_30d_change": 123,\ "market_cap_fd_90d_change": 123,\ "market_cap_fd_180d_change": 123,\ "market_cap_fd_365d_change": 123,\ "market_cap_circ_latest": 123,\ "market_cap_circ_1d_change": 123,\ "market_cap_circ_7d_change": 123,\ "market_cap_circ_30d_change": 123,\ "market_cap_circ_90d_change": 123,\ "market_cap_circ_180d_change": 123,\ "market_cap_circ_365d_change": 123,\ "active_users_daily_latest": 123,\ "active_users_daily_1d_change": 123,\ "active_users_daily_7d_change": 123,\ "active_users_daily_30d_change": 123,\ "active_users_daily_90d_change": 123,\ "active_users_daily_180d_change": 123,\ "active_users_daily_365d_change": 123,\ "transaction_count_1d": 123,\ "transaction_count_1d_trend": 123,\ "transaction_count_7d": 123,\ "transaction_count_7d_trend": 123,\ "transaction_count_30d": 123,\ "transaction_count_30d_trend": 123,\ "transaction_count_90d": 123,\ "transaction_count_90d_trend": 123,\ "transaction_count_180d": 123,\ "transaction_count_180d_trend": 123,\ "transaction_count_365d": 123,\ "transaction_count_365d_trend": 123,\ "transaction_count_max": 123,\ "core_developers_latest": 123,\ "core_developers_1d_change": 123,\ "core_developers_7d_change": 123,\ "core_developers_30d_change": 123,\ "core_developers_90d_change": 123,\ "core_developers_180d_change": 123,\ "core_developers_365d_change": 123,\ "ecosystem_fees_1d_sum": 123,\ "ecosystem_fees_1d_trend": 123,\ "ecosystem_fees_7d_sum": 123,\ "ecosystem_fees_7d_trend": 123,\ "ecosystem_fees_30d_sum": 123,\ "ecosystem_fees_30d_trend": 123,\ "ecosystem_fees_90d_sum": 123,\ "ecosystem_fees_90d_trend": 123,\ "ecosystem_fees_180d_sum": 123,\ "ecosystem_fees_180d_trend": 123,\ "ecosystem_fees_365d_sum": 123,\ "ecosystem_fees_365d_trend": 123,\ "ecosystem_fees_max_sum": 123,\ "ecosystem_revenue_1d_sum": 123,\ "ecosystem_revenue_1d_trend": 123,\ "ecosystem_revenue_7d_sum": 123,\ "ecosystem_revenue_7d_trend": 123,\ "ecosystem_revenue_30d_sum": 123,\ "ecosystem_revenue_30d_trend": 123,\ "ecosystem_revenue_90d_sum": 123,\ "ecosystem_revenue_90d_trend": 123,\ "ecosystem_revenue_180d_sum": 123,\ "ecosystem_revenue_180d_trend": 123,\ "ecosystem_revenue_365d_sum": 123,\ "ecosystem_revenue_365d_trend": 123,\ "ecosystem_revenue_max_sum": 123,\ "ecosystem_dex_trading_volume_1d_sum": 123,\ "ecosystem_dex_trading_volume_1d_trend": 123,\ "ecosystem_dex_trading_volume_7d_sum": 123,\ "ecosystem_dex_trading_volume_7d_trend": 123,\ "ecosystem_dex_trading_volume_30d_sum": 123,\ "ecosystem_dex_trading_volume_30d_trend": 123,\ "ecosystem_dex_trading_volume_90d_sum": 123,\ "ecosystem_dex_trading_volume_90d_trend": 123,\ "ecosystem_dex_trading_volume_180d_sum": 123,\ "ecosystem_dex_trading_volume_180d_trend": 123,\ "ecosystem_dex_trading_volume_365d_sum": 123,\ "ecosystem_dex_trading_volume_365d_trend": 123,\ "ecosystem_dex_trading_volume_max_sum": 123,\ "ecosystem_tvl_latest": 123,\ "ecosystem_tvl_1d_change": 123,\ "ecosystem_tvl_7d_change": 123,\ "ecosystem_tvl_30d_change": 123,\ "ecosystem_tvl_90d_change": 123,\ "ecosystem_tvl_180d_change": 123,\ "ecosystem_tvl_365d_change": 123,\ "ecosystem_active_loans_latest": 123,\ "ecosystem_active_loans_1d_change": 123,\ "ecosystem_active_loans_7d_change": 123,\ "ecosystem_active_loans_30d_change": 123,\ "ecosystem_active_loans_90d_change": 123,\ "ecosystem_active_loans_180d_change": 123,\ "ecosystem_active_loans_365d_change": 123,\ "ecosystem_project_count_latest": 123\ }\ ] } #### Authorizations [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-blockchain-comparison-dataset#authorization-authorization) Authorization string header required Bearer authentication header of the form `Bearer `, where `` is your auth token. #### Query Parameters [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-blockchain-comparison-dataset#parameter-chain-ids) chain\_ids string\[\] Allows you to select one or more of the chains available in the dataset. When including multiple chains, separate each one with a comma. Example: `ethereum,arbitrum`. [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-blockchain-comparison-dataset#parameter-order-by) order\_by string Allows you to select a field by which the response array is sorted. [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-blockchain-comparison-dataset#parameter-order-direction) order\_direction string Allows you to define order direction for the field selected in `order_by`. If no order\_direction is selected, the response defaults to `asc`. [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-blockchain-comparison-dataset#parameter-limit) limit number Limit the number of results returned. Usage through API reference has max limit of 50. #### Response 200 - application/json OK [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-blockchain-comparison-dataset#response-data) data object\[\] The Array containing the data for a successful response. Show child attributes [List all datasets](https://tokenterminal.com/docs/api-reference/datasets/list-all-datasets) [Get the Cohort analysis dataset](https://tokenterminal.com/docs/api-reference/datasets/get-the-cohort-analysis-dataset) ⌘I --- # Our data approach - Token Terminal Docs [Skip to main content](https://tokenterminal.com/docs/data-approach#content-area) [Token Terminal Docs home page![light logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-light.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=de49e0137894962aef5d37455c76ecf1)![dark logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-dark.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=6a5317263edae34558e014343002fe93)](https://tokenterminal.com/docs) Search... ⌘K Search... Navigation Overview Our data approach [Overview](https://tokenterminal.com/docs) [Explorer](https://tokenterminal.com/docs/explorer) [Studio](https://tokenterminal.com/docs/studio) [Sheets](https://tokenterminal.com/docs/sheets) [API](https://tokenterminal.com/docs/api-reference/introduction) [Data Room](https://tokenterminal.com/docs/data-room/introduction) Token Terminal uses an **ELT (Extract, Load, Transform)** paradigm to process raw blockchain data into standardized metrics. This approach ensures data is transparent, reproducible, and auditable at every stage. In a typical **ETL** workflow, data is transformed before it is stored. This can work well if the structure of your data is stable. But in our industry, things change constantly in ways that are different from most traditional data pipelines. For example: * **Protocol upgrades** Blockchains regularly introduce upgrades that can include breaking changes to data schemas. A protocol might add new transaction types, restructure contract storage, or modify how events are emitted. * **Smart contract deployments** Decentralized applications are continuously launching new products or business lines, often across multiple chains. Each new contract introduces additional data that needs to be standardized and integrated. * **Methodology changes** Even the meaning of common metrics evolves over time. How you define metrics like fees, active users, or token incentives can change as protocols mature and industry practices develop. These factors all make blockchain data feel like ongoing R&D that happens in production. Because we use **ELT**, we don’t have to re-ingest everything from scratch when something changes. Instead, we can re-process the same raw data and update our standardized metrics quickly, without interrupting downstream workflows. ![ETL vs ELT paradigm](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/images/etl-vs-elt.png?w=2500&fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=2fe2dce8d1e55703945ea36b13b7e57d) By keeping raw data in its original form, we gain a few important advantages over the traditional ETL approach: * **Traceability** Every metric can be linked directly back to the source. * **Reproducibility** When new smart contracts are deployed or methodologies change, we can re-process historical data within minutes without waiting days to re-ingest it. * **Scale** This approach allows us to maintain standardized metrics across hundreds of blockchains and thousands of applications efficiently. Whether you’re exploring our dashboards, doing analysis in spreadsheets, or querying the API, all data comes from this same high-fidelity data infrastructure. [Introduction](https://tokenterminal.com/docs) [Brand assets](https://tokenterminal.com/docs/brand-assets) ⌘I --- # Brand assets - Token Terminal Docs [Skip to main content](https://tokenterminal.com/docs/brand-assets#content-area) [Token Terminal Docs home page![light logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-light.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=de49e0137894962aef5d37455c76ecf1)![dark logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-dark.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=6a5317263edae34558e014343002fe93)](https://tokenterminal.com/docs) Search... ⌘K Search... Navigation [Overview](https://tokenterminal.com/docs) [Explorer](https://tokenterminal.com/docs/explorer) [Studio](https://tokenterminal.com/docs/studio) [Sheets](https://tokenterminal.com/docs/sheets) [API](https://tokenterminal.com/docs/api-reference/introduction) [Data Room](https://tokenterminal.com/docs/data-room/introduction) On this page * [Token Terminal wordmark](https://tokenterminal.com/docs/brand-assets#token-terminal-wordmark) * [Token Terminal symbol](https://tokenterminal.com/docs/brand-assets#token-terminal-symbol) The Token Terminal wordmark and symbol are important expressions of our brand identity. It is vital that they are always applied consistently to create visual harmony and should never be altered or modified. These simple rules will help you use our wordmark and symbol to communicate the Token Terminal brand effectively.[Download logo kit\ -----------------\ \ Download the Token Terminal logo kit, which includes the wordmark, symbol, and other brand assets.](https://cdn.sanity.io/files/rvtn5kgj/production/92adfa3dbe2888c16a97c5e5cdc6a298b64764ce.zip) [​](https://tokenterminal.com/docs/brand-assets#token-terminal-wordmark) Token Terminal wordmark --------------------------------------------------------------------------------------------------- Our primary graphic device which should be the first choice when choosing a graphic element to represent the Token Terminal brand. ![Token Terminal wordmark](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/images/tt-logo-dark.svg?w=2500&fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=144c165cd071dec316922733846f4d37) ![Token Terminal wordmark](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/images/tt-logo-light.svg?w=2500&fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=8968060ec43d564b590b8c34dacfaa54) [​](https://tokenterminal.com/docs/brand-assets#token-terminal-symbol) Token Terminal symbol ----------------------------------------------------------------------------------------------- The symbol can be used on its own in certain situations when the context and association with Token Terminal is clearly established and controlled. Use with good judgment since the wordmark has stronger brand recognition and is always the preferred way to display Token Terminal. ![Token Terminal symbol](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/images/tt-symbol-light.svg?w=2500&fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=19dc7bd3c5e4540e5bd22e26ca81187d) ![Token Terminal symbol](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/images/tt-symbol-dark.svg?w=2500&fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=390afde6828120e62111890571918503) [Our data approach](https://tokenterminal.com/docs/data-approach) [Contact](https://tokenterminal.com/docs/contact) ⌘I --- # Market sectors - Token Terminal Docs [Skip to main content](https://tokenterminal.com/docs/explorer/market-sectors#content-area) [Token Terminal Docs home page![light logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-light.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=de49e0137894962aef5d37455c76ecf1)![dark logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-dark.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=6a5317263edae34558e014343002fe93)](https://tokenterminal.com/docs) Search... ⌘K Search... Navigation Market sectors [Overview](https://tokenterminal.com/docs) [Explorer](https://tokenterminal.com/docs/explorer) [Studio](https://tokenterminal.com/docs/studio) [Sheets](https://tokenterminal.com/docs/sheets) [API](https://tokenterminal.com/docs/api-reference/introduction) [Data Room](https://tokenterminal.com/docs/data-room/introduction) ![Market sectors hero](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/images/market-sectors.jpg?w=2500&fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=dd0125642a308f7fe521ec270c4e5441) We’ve categorized the entire crypto market into **19 distinct market sectors**, with each project on Token Terminal assigned to one sector. This structure enables sector-level analysis and direct comparisons between projects within the same category. Each market sector includes its own dedicated dashboard experience with relevant projects and custom metrics. All views can be filtered by one or more blockchains. [Discover](https://tokenterminal.com/docs/explorer/discover) [Projects](https://tokenterminal.com/docs/explorer/projects) ⌘I --- # Get metric aggregations for multiple projects - Token Terminal Docs [Skip to main content](https://tokenterminal.com/docs/api-reference/metrics/get-metric-aggregations-for-multiple-projects#content-area) [Token Terminal Docs home page![light logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-light.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=de49e0137894962aef5d37455c76ecf1)![dark logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-dark.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=6a5317263edae34558e014343002fe93)](https://tokenterminal.com/docs) Search... ⌘K Search... Navigation Metrics Get metric aggregations for multiple projects [Overview](https://tokenterminal.com/docs) [Explorer](https://tokenterminal.com/docs/explorer) [Studio](https://tokenterminal.com/docs/studio) [Sheets](https://tokenterminal.com/docs/sheets) [API](https://tokenterminal.com/docs/api-reference/introduction) [Data Room](https://tokenterminal.com/docs/data-room/introduction) Get metric aggregations for multiple projects cURL Copy Ask AI curl --request GET \ --url https://api.tokenterminal.com/v2/metric-aggregations \ --header 'Authorization: Bearer ' 200 Copy Ask AI { "data": [\ {\ "project_name": "",\ "project_id": "",\ "metric_id": "",\ "metric_aggregation_name": "",\ "value": ""\ }\ ], "errors": [\ {\ "code": "NOT_FOUND",\ "field": "project_ids",\ "value": "invalid-project"\ }\ ] } GET / v2 / metric-aggregations Try it Get metric aggregations for multiple projects cURL Copy Ask AI curl --request GET \ --url https://api.tokenterminal.com/v2/metric-aggregations \ --header 'Authorization: Bearer ' 200 Copy Ask AI { "data": [\ {\ "project_name": "",\ "project_id": "",\ "metric_id": "",\ "metric_aggregation_name": "",\ "value": ""\ }\ ], "errors": [\ {\ "code": "NOT_FOUND",\ "field": "project_ids",\ "value": "invalid-project"\ }\ ] } #### Authorizations [​](https://tokenterminal.com/docs/api-reference/metrics/get-metric-aggregations-for-multiple-projects#authorization-authorization) Authorization string header required Bearer authentication header of the form `Bearer `, where `` is your auth token. #### Query Parameters [​](https://tokenterminal.com/docs/api-reference/metrics/get-metric-aggregations-for-multiple-projects#parameter-project-ids) project\_ids string\[\] required Allows you to select one or more of the projects available for a specific metric. When including multiple projects, separate each one with a comma. Example: `aave,uniswap`. You can fetch all available projects by omitting this parameter or using value `all`. [​](https://tokenterminal.com/docs/api-reference/metrics/get-metric-aggregations-for-multiple-projects#parameter-metric-ids) metric\_ids string\[\] Allows you to fetch all aggregations for the given comma separated list of metrics available. The full list is available on the metrics endpoint (see above). You can fetch all available metrics by omitting this parameter or using value `all`. #### Response 200 - application/json OK [​](https://tokenterminal.com/docs/api-reference/metrics/get-metric-aggregations-for-multiple-projects#response-data) data object\[\] Show child attributes [​](https://tokenterminal.com/docs/api-reference/metrics/get-metric-aggregations-for-multiple-projects#response-errors) errors object\[\] Optional array of errors that occurred during request processing. Only present if some requested entities were not found. The endpoint returns data for valid entities even when errors are present, allowing partial success. Show child attributes [Get metric data for multiple projects](https://tokenterminal.com/docs/api-reference/metrics/get-metric-data-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) ⌘I --- # Projects - Token Terminal Docs [Skip to main content](https://tokenterminal.com/docs/explorer/projects#content-area) [Token Terminal Docs home page![light logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-light.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=de49e0137894962aef5d37455c76ecf1)![dark logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-dark.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=6a5317263edae34558e014343002fe93)](https://tokenterminal.com/docs) Search... ⌘K Search... Navigation Projects [Overview](https://tokenterminal.com/docs) [Explorer](https://tokenterminal.com/docs/explorer) [Studio](https://tokenterminal.com/docs/studio) [Sheets](https://tokenterminal.com/docs/sheets) [API](https://tokenterminal.com/docs/api-reference/introduction) [Data Room](https://tokenterminal.com/docs/data-room/introduction) ![Projects hero](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/images/projects.jpg?w=2500&fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=132cfa814d555c18c9c4a13862226165) The Projects section is the central repository for all projects listed on Token Terminal. It features a dynamic, filterable data table that supports chain, market sector, and column-specific filtering. Users can customize the table by adding or editing columns and selecting specific time ranges. Each row also links to the project’s individual data page. Want to see a project listed on Token Terminal? Submit information for the [app](https://tokenterminal.com/get-listed/apps) or [chain](https://tokenterminal.com/get-listed/chains) . [Market sectors](https://tokenterminal.com/docs/explorer/market-sectors) [Metrics](https://tokenterminal.com/docs/explorer/metrics) ⌘I --- # Contact - Token Terminal Docs [Skip to main content](https://tokenterminal.com/docs/contact#content-area) [Token Terminal Docs home page![light logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-light.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=de49e0137894962aef5d37455c76ecf1)![dark logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-dark.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=6a5317263edae34558e014343002fe93)](https://tokenterminal.com/docs) Search... ⌘K Search... Navigation Resources Contact [Overview](https://tokenterminal.com/docs) [Explorer](https://tokenterminal.com/docs/explorer) [Studio](https://tokenterminal.com/docs/studio) [Sheets](https://tokenterminal.com/docs/sheets) [API](https://tokenterminal.com/docs/api-reference/introduction) [Data Room](https://tokenterminal.com/docs/data-room/introduction) On this page * [Contact us directly](https://tokenterminal.com/docs/contact#contact-us-directly) * [Follow us](https://tokenterminal.com/docs/contact#follow-us) * [More way to connect](https://tokenterminal.com/docs/contact#more-way-to-connect) [​](https://tokenterminal.com/docs/contact#contact-us-directly) Contact us directly -------------------------------------------------------------------------------------- Reach us on email [\[email protected\]](https://tokenterminal.com/cdn-cgi/l/email-protection#1d6d78726d71785d697276787369786f7074737c7133656467) or on [Telegram](https://t.me/tokenterminalhq) . [​](https://tokenterminal.com/docs/contact#follow-us) Follow us ------------------------------------------------------------------ [Follow us on X for the latest analysis and product updates.](https://x.com/tokenterminal) [Follow us on LinkedIn for the latest analysis and product updates.](https://www.linkedin.com/company/tokenterminal) [Follow us on YouTube for the latest interviews, demos, and more.](https://www.youtube.com/@tokenterminal) [​](https://tokenterminal.com/docs/contact#more-way-to-connect) More way to connect -------------------------------------------------------------------------------------- [Schedule a demo\ ---------------\ \ Want to learn more about Token Terminal? Schedule a demo or introductory call with our partnership team.](https://calendly.com/token-terminal/intro-call) [Get your project listed\ -----------------------\ \ Submit the basic listing form to kickstart the process. Our team will review your submission.](https://tokenterminal.com/explorer/listings) [Brand assets](https://tokenterminal.com/docs/brand-assets) [General FAQ](https://tokenterminal.com/docs/faq) ⌘I --- # Introduction - Token Terminal Docs [Skip to main content](https://tokenterminal.com/docs/explorer#content-area) [Token Terminal Docs home page![light logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-light.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=de49e0137894962aef5d37455c76ecf1)![dark logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-dark.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=6a5317263edae34558e014343002fe93)](https://tokenterminal.com/docs) Search... ⌘K Search... Navigation Introduction [Overview](https://tokenterminal.com/docs) [Explorer](https://tokenterminal.com/docs/explorer) [Studio](https://tokenterminal.com/docs/studio) [Sheets](https://tokenterminal.com/docs/sheets) [API](https://tokenterminal.com/docs/api-reference/introduction) [Data Room](https://tokenterminal.com/docs/data-room/introduction) ![Explorer Hero](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/images/homepage.jpg?w=2500&fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=f968c710a5fc7c5d97a8d52763939ba4) Explorer is our primary no-code interface for accessing standardized metrics. Built on top of our internal data warehouse, Explorer allows users to view data through customizable charts and tables, all of which can be downloaded in CSV format. [Discover](https://tokenterminal.com/docs/explorer/discover) ⌘I --- # Introduction - Token Terminal Docs [Skip to main content](https://tokenterminal.com/docs/sheets#content-area) [Token Terminal Docs home page![light logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-light.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=de49e0137894962aef5d37455c76ecf1)![dark logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-dark.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=6a5317263edae34558e014343002fe93)](https://tokenterminal.com/docs) Search... ⌘K Search... Navigation Introduction [Overview](https://tokenterminal.com/docs) [Explorer](https://tokenterminal.com/docs/explorer) [Studio](https://tokenterminal.com/docs/studio) [Sheets](https://tokenterminal.com/docs/sheets) [API](https://tokenterminal.com/docs/api-reference/introduction) [Data Room](https://tokenterminal.com/docs/data-room/introduction) ![Sheets hero](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/images/sheets.png?w=2500&fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=36f2364d4fc9be1e3aff9ca2d48322a8) Sheets is a powerful tool for accessing and analyzing Token Terminal’s data directly in spreadsheets. All data can be programmatically updated and downloaded, with historical and daily coverage for hundreds of chains and projects. Sheets is available for both [Google Sheets](https://workspace.google.com/marketplace/app/token_terminal_for_sheets/702043887467) and [Microsoft Excel](https://appsource.microsoft.com/en-us/product/office/wa200007719) . [Google Sheets](https://tokenterminal.com/docs/sheets/google-sheets) ⌘I --- # Metrics - Token Terminal Docs [Skip to main content](https://tokenterminal.com/docs/explorer/metrics#content-area) [Token Terminal Docs home page![light logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-light.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=de49e0137894962aef5d37455c76ecf1)![dark logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-dark.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=6a5317263edae34558e014343002fe93)](https://tokenterminal.com/docs) Search... ⌘K Search... Navigation Metrics [Overview](https://tokenterminal.com/docs) [Explorer](https://tokenterminal.com/docs/explorer) [Studio](https://tokenterminal.com/docs/studio) [Sheets](https://tokenterminal.com/docs/sheets) [API](https://tokenterminal.com/docs/api-reference/introduction) [Data Room](https://tokenterminal.com/docs/data-room/introduction) ![Metrics hero](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/images/metrics.jpg?w=2500&fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=3a96abcff5b7d1b35722fbe4ef067eb1) Our Metrics repository contains detailed explanations for every metric maintained by Token Terminal. Each metric includes both a general definition and project-specific descriptions, helping users understand and contextualize the data more effectively. If there’s a metric definiton that is unclear, reach out to us at [\[email protected\]](https://tokenterminal.com/cdn-cgi/l/email-protection#4333262c332f2603372c28262d3726312e2a2d222f6d3b3a39) . [Projects](https://tokenterminal.com/docs/explorer/projects) ⌘I --- # Microsoft Excel - Token Terminal Docs [Skip to main content](https://tokenterminal.com/docs/sheets/microsoft-excel#content-area) [Token Terminal Docs home page![light logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-light.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=de49e0137894962aef5d37455c76ecf1)![dark logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-dark.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=6a5317263edae34558e014343002fe93)](https://tokenterminal.com/docs) Search... ⌘K Search... Navigation Microsoft Excel [Overview](https://tokenterminal.com/docs) [Explorer](https://tokenterminal.com/docs/explorer) [Studio](https://tokenterminal.com/docs/studio) [Sheets](https://tokenterminal.com/docs/sheets) [API](https://tokenterminal.com/docs/api-reference/introduction) [Data Room](https://tokenterminal.com/docs/data-room/introduction) On this page * [Installing Token Terminal for Excel](https://tokenterminal.com/docs/sheets/microsoft-excel#installing-token-terminal-for-excel) * [Using Token Terminal for Excel](https://tokenterminal.com/docs/sheets/microsoft-excel#using-token-terminal-for-excel) ![Microsoft Excel hero](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/images/excel-sheets-marketplace.png?w=2500&fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=62b76668a8a50e973aa413e4cc013928) [​](https://tokenterminal.com/docs/sheets/microsoft-excel#installing-token-terminal-for-excel) Installing Token Terminal for Excel ------------------------------------------------------------------------------------------------------------------------------------- You can find the [Token Terminal for Excel](https://appsource.microsoft.com/en-us/product/Office365/WA200007719) plugin in the Appsource Marketplace. 1. Click the “Get it Now” button on the plugin page. 2. Login with your Microsoft 365 account 3. Open Excel 4. Start the plug-in by clicking the Token Terminal for Excel button in the Home ribbon In any cell, begin using TT functions: `=TT("ethereum", "price")` [​](https://tokenterminal.com/docs/sheets/microsoft-excel#using-token-terminal-for-excel) Using Token Terminal for Excel --------------------------------------------------------------------------------------------------------------------------- 1. Create or open a spreadsheet 2. Start the plug-in by clicking the Token Terminal for Excel button in the Home ribbon 3. In any cell, begin using TT functions: `=TT("ethereum", "price")` [Syntax Guide\ ------------\ \ Check out our syntax guide for more information on how to use the TT function.](https://tokenterminal.com/docs/sheets/syntax) [Google Sheets](https://tokenterminal.com/docs/sheets/google-sheets) [Syntax](https://tokenterminal.com/docs/sheets/syntax) ⌘I --- # List all datasets - Token Terminal Docs [Skip to main content](https://tokenterminal.com/docs/api-reference/datasets/list-all-datasets#content-area) [Token Terminal Docs home page![light logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-light.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=de49e0137894962aef5d37455c76ecf1)![dark logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-dark.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=6a5317263edae34558e014343002fe93)](https://tokenterminal.com/docs) Search... ⌘K Search... Navigation Datasets List all datasets [Overview](https://tokenterminal.com/docs) [Explorer](https://tokenterminal.com/docs/explorer) [Studio](https://tokenterminal.com/docs/studio) [Sheets](https://tokenterminal.com/docs/sheets) [API](https://tokenterminal.com/docs/api-reference/introduction) [Data Room](https://tokenterminal.com/docs/data-room/introduction) List all datasets cURL Copy Ask AI curl --request GET \ --url https://api.tokenterminal.com/v2/datasets \ --header 'Authorization: Bearer ' 200 Copy Ask AI { "data": { "mart_id": "", "name": "" } } GET / v2 / datasets Try it List all datasets cURL Copy Ask AI curl --request GET \ --url https://api.tokenterminal.com/v2/datasets \ --header 'Authorization: Bearer ' 200 Copy Ask AI { "data": { "mart_id": "", "name": "" } } #### Authorizations [​](https://tokenterminal.com/docs/api-reference/datasets/list-all-datasets#authorization-authorization) Authorization string header required Bearer authentication header of the form `Bearer `, where `` is your auth token. #### Response 200 - application/json OK [​](https://tokenterminal.com/docs/api-reference/datasets/list-all-datasets#response-data) data object The object containing the data for a successful response. Show child attributes [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) [Get the Blockchain comparison dataset](https://tokenterminal.com/docs/api-reference/datasets/get-the-blockchain-comparison-dataset) ⌘I --- # Get the Stablecoins dataset - Token Terminal Docs [Skip to main content](https://tokenterminal.com/docs/api-reference/datasets/get-the-stablecoins-dataset#content-area) [Token Terminal Docs home page![light logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-light.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=de49e0137894962aef5d37455c76ecf1)![dark logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-dark.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=6a5317263edae34558e014343002fe93)](https://tokenterminal.com/docs) Search... ⌘K Search... Navigation Datasets Get the Stablecoins dataset [Overview](https://tokenterminal.com/docs) [Explorer](https://tokenterminal.com/docs/explorer) [Studio](https://tokenterminal.com/docs/studio) [Sheets](https://tokenterminal.com/docs/sheets) [API](https://tokenterminal.com/docs/api-reference/introduction) [Data Room](https://tokenterminal.com/docs/data-room/introduction) Get the Stablecoins dataset cURL Copy Ask AI curl --request GET \ --url https://api.tokenterminal.com/v2/datasets/stablecoins \ --header 'Authorization: Bearer ' 200 Copy Ask AI { "data": [\ {\ "project_id": "",\ "project_name": "",\ "market_sector_id": "",\ "market_sector_name": "",\ "chain_id": "",\ "chain_name": "",\ "stablecoin_ticker": "",\ "stablecoin_name": "",\ "token_address": "",\ "stablecoin_peg": "",\ "account_creation_timestamp": "",\ "transfer_value_average_latest": 123,\ "price_latest": 123,\ "tokenholders_latest": 123,\ "outstanding_supply_latest": 123,\ "percent_off_peg_latest": 123,\ "transfer_volume_1d_sum": 123,\ "transfer_count_1d_sum": 123,\ "percent_off_peg_1d": 123,\ "stablecoin_senders_1d_sum": 123,\ "transfer_volume_1d_trend": 123,\ "transfer_count_1d_trend": 123,\ "stablecoin_senders_1d_trend": 123,\ "transfer_value_average_1d_change": 123,\ "tokenholders_1d_change": 123,\ "price_1d_change": 123,\ "outstanding_supply_1d_change": 123,\ "transfer_volume_7d_sum": 123,\ "transfer_count_7d_sum": 123,\ "percent_off_peg_7d": 123,\ "stablecoin_senders_7d_sum": 123,\ "transfer_volume_7d_trend": 123,\ "transfer_count_7d_trend": 123,\ "stablecoin_senders_7d_trend": 123,\ "transfer_value_average_7d_change": 123,\ "tokenholders_7d_change": 123,\ "price_7d_change": 123,\ "outstanding_supply_7d_change": 123,\ "transfer_volume_max_sum": 123,\ "transfer_count_max_sum": 123,\ "percent_off_peg_max": 123\ }\ ] } GET / v2 / datasets / stablecoins Try it Get the Stablecoins dataset cURL Copy Ask AI curl --request GET \ --url https://api.tokenterminal.com/v2/datasets/stablecoins \ --header 'Authorization: Bearer ' 200 Copy Ask AI { "data": [\ {\ "project_id": "",\ "project_name": "",\ "market_sector_id": "",\ "market_sector_name": "",\ "chain_id": "",\ "chain_name": "",\ "stablecoin_ticker": "",\ "stablecoin_name": "",\ "token_address": "",\ "stablecoin_peg": "",\ "account_creation_timestamp": "",\ "transfer_value_average_latest": 123,\ "price_latest": 123,\ "tokenholders_latest": 123,\ "outstanding_supply_latest": 123,\ "percent_off_peg_latest": 123,\ "transfer_volume_1d_sum": 123,\ "transfer_count_1d_sum": 123,\ "percent_off_peg_1d": 123,\ "stablecoin_senders_1d_sum": 123,\ "transfer_volume_1d_trend": 123,\ "transfer_count_1d_trend": 123,\ "stablecoin_senders_1d_trend": 123,\ "transfer_value_average_1d_change": 123,\ "tokenholders_1d_change": 123,\ "price_1d_change": 123,\ "outstanding_supply_1d_change": 123,\ "transfer_volume_7d_sum": 123,\ "transfer_count_7d_sum": 123,\ "percent_off_peg_7d": 123,\ "stablecoin_senders_7d_sum": 123,\ "transfer_volume_7d_trend": 123,\ "transfer_count_7d_trend": 123,\ "stablecoin_senders_7d_trend": 123,\ "transfer_value_average_7d_change": 123,\ "tokenholders_7d_change": 123,\ "price_7d_change": 123,\ "outstanding_supply_7d_change": 123,\ "transfer_volume_max_sum": 123,\ "transfer_count_max_sum": 123,\ "percent_off_peg_max": 123\ }\ ] } #### Authorizations [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-stablecoins-dataset#authorization-authorization) Authorization string header required Bearer authentication header of the form `Bearer `, where `` is your auth token. #### Query Parameters [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-stablecoins-dataset#parameter-project-ids) project\_ids string\[\] Allows you to select one or more of the projects available in the dataset. When including multiple projects, separate each one with a comma. Example: `tether,circle`. [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-stablecoins-dataset#parameter-chain-ids) chain\_ids string\[\] Allows you to select one or more of the chains available in the dataset. When including multiple chains, separate each one with a comma. Example: `ethereum,arbitrum`. [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-stablecoins-dataset#parameter-market-sector-ids) market\_sector\_ids string\[\] Allows you to select one or more of the market sectors available in the dataset. When including multiple market sectors, separate each one with a comma. Example: `stablecoin,derivatives`. [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-stablecoins-dataset#parameter-order-by) order\_by string Allows you to select a field by which the response array is sorted. [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-stablecoins-dataset#parameter-order-direction) order\_direction string Allows you to define order direction for the field selected in `order_by`. If no order\_direction is selected, the response defaults to `asc`. [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-stablecoins-dataset#parameter-limit) limit number Limit the number of results returned. Usage through API reference has max limit of 50. #### Response 200 - application/json OK [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-stablecoins-dataset#response-data) data object\[\] The Array containing the data for a successful response. Show child attributes [Get the Project contracts dataset](https://tokenterminal.com/docs/api-reference/datasets/get-the-project-contracts-dataset) [Get the Trending contracts dataset](https://tokenterminal.com/docs/api-reference/datasets/get-the-trending-contracts-dataset) ⌘I --- # Dashboards - Token Terminal Docs [Skip to main content](https://tokenterminal.com/docs/studio/dashboards#content-area) [Token Terminal Docs home page![light logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-light.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=de49e0137894962aef5d37455c76ecf1)![dark logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-dark.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=6a5317263edae34558e014343002fe93)](https://tokenterminal.com/docs) Search... ⌘K Search... Navigation Dashboards [Overview](https://tokenterminal.com/docs) [Explorer](https://tokenterminal.com/docs/explorer) [Studio](https://tokenterminal.com/docs/studio) [Sheets](https://tokenterminal.com/docs/sheets) [API](https://tokenterminal.com/docs/api-reference/introduction) [Data Room](https://tokenterminal.com/docs/data-room/introduction) On this page * [Charts](https://tokenterminal.com/docs/studio/dashboards#charts) * [Datasets](https://tokenterminal.com/docs/studio/dashboards#datasets) * [Text & Headings](https://tokenterminal.com/docs/studio/dashboards#text-%26-headings) ![Studio dashboard hero](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/images/studio-dashboard.jpg?w=2500&fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=1a8c99d57ad84a69515eb68dff950e52) Dashboards in Studio allow you to bring together charts, datasets, and text to create a custom dashboard that helps you track your investing ideas or operational goals using onchain data across dozens of chains and hundreds of projects. For Pro users, charts and datasets can be downloaded to use in your own local models. [​](https://tokenterminal.com/docs/studio/dashboards#charts) Charts ---------------------------------------------------------------------- Charts can be added to a dashboard either by creating a new chart in the dashboard or by reusing charts from your chart library. Charts stored in the library can be reused across multiple dashboards. [​](https://tokenterminal.com/docs/studio/dashboards#datasets) Datasets -------------------------------------------------------------------------- Similarly, datasets can be added to a dashboard by creating a new dataset in the dashboard or by reusing datasets from your dataset library. Datasets are based on base datasets that are maintained by the Token Terminal team. [​](https://tokenterminal.com/docs/studio/dashboards#text-&-headings) Text & Headings ---------------------------------------------------------------------------------------- Whether publishing for external audiences or your own team, you can use text and headings to add context and commentary about the charts and datasets in your dashboards. [Introduction](https://tokenterminal.com/docs/studio) [Charts](https://tokenterminal.com/docs/studio/charts) ⌘I --- # General FAQ - Token Terminal Docs [Skip to main content](https://tokenterminal.com/docs/faq#content-area) [Token Terminal Docs home page![light logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-light.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=de49e0137894962aef5d37455c76ecf1)![dark logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-dark.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=6a5317263edae34558e014343002fe93)](https://tokenterminal.com/docs) Search... ⌘K Search... Navigation Resources General FAQ [Overview](https://tokenterminal.com/docs) [Explorer](https://tokenterminal.com/docs/explorer) [Studio](https://tokenterminal.com/docs/studio) [Sheets](https://tokenterminal.com/docs/sheets) [API](https://tokenterminal.com/docs/api-reference/introduction) [Data Room](https://tokenterminal.com/docs/data-room/introduction) On this page * [What does Token Terminal do?](https://tokenterminal.com/docs/faq#what-does-token-terminal-do) * [Where does Token Terminal get data from?](https://tokenterminal.com/docs/faq#where-does-token-terminal-get-data-from) * [How often do you add new projects to the site?](https://tokenterminal.com/docs/faq#how-often-do-you-add-new-projects-to-the-site) * [How can I add my project’s data to Token Terminal?](https://tokenterminal.com/docs/faq#how-can-i-add-my-project%E2%80%99s-data-to-token-terminal) * [How can I schedule a demo of the platform?](https://tokenterminal.com/docs/faq#how-can-i-schedule-a-demo-of-the-platform) * [What payment methods do you support?](https://tokenterminal.com/docs/faq#what-payment-methods-do-you-support) * [How do I get the invoice for my subscription?](https://tokenterminal.com/docs/faq#how-do-i-get-the-invoice-for-my-subscription) * [Is there a discounted pricing option for students to access Token Terminal?](https://tokenterminal.com/docs/faq#is-there-a-discounted-pricing-option-for-students-to-access-token-terminal) * [Where can I find my API key?](https://tokenterminal.com/docs/faq#where-can-i-find-my-api-key) * [Can I download the data visible on Token Terminal?](https://tokenterminal.com/docs/faq#can-i-download-the-data-visible-on-token-terminal) * [Why does the data reported by TT differ from other data providers?](https://tokenterminal.com/docs/faq#why-does-the-data-reported-by-tt-differ-from-other-data-providers) [​](https://tokenterminal.com/docs/faq#what-does-token-terminal-do) What does Token Terminal do? --------------------------------------------------------------------------------------------------- Token Terminal is a platform that aggregates financial and alternative data on blockchains and decentralized applications that run on blockchains. We measure and evaluate the performance of blockchains and decentralized applications using traditional financial key performance indicators. [​](https://tokenterminal.com/docs/faq#where-does-token-terminal-get-data-from) Where does Token Terminal get data from? --------------------------------------------------------------------------------------------------------------------------- We run our own blockchain infrastructure for 14+ blockchains. Our research team then transforms the raw data to standardised project specific metrics. For some metrics we also rely on 3rd party APIs. The data source for each metric can be found on all dashboards. [​](https://tokenterminal.com/docs/faq#how-often-do-you-add-new-projects-to-the-site) How often do you add new projects to the site? --------------------------------------------------------------------------------------------------------------------------------------- We add new projects on a weekly basis. All the latest projects can be found in the search bar by clicking on the “New projects” button. [​](https://tokenterminal.com/docs/faq#how-can-i-add-my-project%E2%80%99s-data-to-token-terminal) How can I add my project’s data to Token Terminal? ------------------------------------------------------------------------------------------------------------------------------------------------------- Submit the listing form to kickstart the process. Please note that due to resource constraints, we’re likely to prioritize submissions with complete smart contract descriptions. [​](https://tokenterminal.com/docs/faq#how-can-i-schedule-a-demo-of-the-platform) How can I schedule a demo of the platform? ------------------------------------------------------------------------------------------------------------------------------- You can book a demo directly from our Calendly. Alternatively, you can schedule a demo by emailing us at [\[email protected\]](https://tokenterminal.com/cdn-cgi/l/email-protection#1b6b7e746b777e5b6f74707e756f7e697672757a7735636261) . [​](https://tokenterminal.com/docs/faq#what-payment-methods-do-you-support) What payment methods do you support? ------------------------------------------------------------------------------------------------------------------- We support credit card payments (Visa, MasterCard & American Express) and wire transfers. [​](https://tokenterminal.com/docs/faq#how-do-i-get-the-invoice-for-my-subscription) How do I get the invoice for my subscription? ------------------------------------------------------------------------------------------------------------------------------------- Please email us at [\[email protected\]](https://tokenterminal.com/cdn-cgi/l/email-protection#ec9c89839c8089ac988387898298899e8185828d80c2949596) [​](https://tokenterminal.com/docs/faq#is-there-a-discounted-pricing-option-for-students-to-access-token-terminal) Is there a discounted pricing option for students to access Token Terminal? ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- Yes, email us at [\[email protected\]](https://tokenterminal.com/cdn-cgi/l/email-protection#aadacfc5dac6cfeadec5c1cfc4decfd8c7c3c4cbc684d2d3d0) using your official student email, and we’ll set up a student account for you. [​](https://tokenterminal.com/docs/faq#where-can-i-find-my-api-key) Where can I find my API key? --------------------------------------------------------------------------------------------------- You can find your API key under your account page. [​](https://tokenterminal.com/docs/faq#can-i-download-the-data-visible-on-token-terminal) Can I download the data visible on Token Terminal? ----------------------------------------------------------------------------------------------------------------------------------------------- Yes, with an active Pro or API subscription you are able to download all data in CSV / Excel files. [​](https://tokenterminal.com/docs/faq#why-does-the-data-reported-by-tt-differ-from-other-data-providers) Why does the data reported by TT differ from other data providers? ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- In most cases, the data differs due to the fact that we use a different methodology, track different versions, and/or chains. You can find all details regarding the chains and versions that we support on the project-specific dashboards. If you have any questions regarding the reported data, you can always message [\[email protected\]](https://tokenterminal.com/cdn-cgi/l/email-protection#6010050f100c0520140f0b050e1405120d090e010c4e18191a) . [Contact](https://tokenterminal.com/docs/contact) ⌘I --- # Google Sheets - Token Terminal Docs [Skip to main content](https://tokenterminal.com/docs/sheets/google-sheets#content-area) [Token Terminal Docs home page![light logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-light.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=de49e0137894962aef5d37455c76ecf1)![dark logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-dark.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=6a5317263edae34558e014343002fe93)](https://tokenterminal.com/docs) Search... ⌘K Search... Navigation Google Sheets [Overview](https://tokenterminal.com/docs) [Explorer](https://tokenterminal.com/docs/explorer) [Studio](https://tokenterminal.com/docs/studio) [Sheets](https://tokenterminal.com/docs/sheets) [API](https://tokenterminal.com/docs/api-reference/introduction) [Data Room](https://tokenterminal.com/docs/data-room/introduction) On this page * [Installing Token Terminal for Sheets](https://tokenterminal.com/docs/sheets/google-sheets#installing-token-terminal-for-sheets) * [Using Token Terminal for Sheets](https://tokenterminal.com/docs/sheets/google-sheets#using-token-terminal-for-sheets) * [Common issues](https://tokenterminal.com/docs/sheets/google-sheets#common-issues) * [Fetch limits](https://tokenterminal.com/docs/sheets/google-sheets#fetch-limits) * [Sharing Sheets](https://tokenterminal.com/docs/sheets/google-sheets#sharing-sheets) * [Performance](https://tokenterminal.com/docs/sheets/google-sheets#performance) ![Google Sheets hero](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/images/sheets-marketplace.png?w=2500&fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=1f6391973a58e6640734843fc0baa2c4) [​](https://tokenterminal.com/docs/sheets/google-sheets#installing-token-terminal-for-sheets) Installing Token Terminal for Sheets ------------------------------------------------------------------------------------------------------------------------------------- You can find the [Token Terminal for Sheets](https://workspace.google.com/marketplace/app/token_terminal_for_sheets/702043887467) plugin in the Google Workspace Marketplace. 1. Click the **Install** button in the upper right hand corner. 2. Choose the account where you’d like to add the plugin and follow the prompts to allow the appropriate permissions to your Google account. 3. Once installed, you can access the Token Terminal for Sheets plugin from the **Extensions** menu in Google Sheets. [​](https://tokenterminal.com/docs/sheets/google-sheets#using-token-terminal-for-sheets) Using Token Terminal for Sheets --------------------------------------------------------------------------------------------------------------------------- Once the plugin is installed, you can start using Token Terminal functions in your Google Sheets. 1. Create a new spreadsheet 2. Start the plugin by navigating to **Extensions** -> **Token Terminal Sheets** -> **Open** 3. In any cell, begin using functions by typing “TT”, e.g. `=TT("ethereum", "fees")` [Syntax Guide\ ------------\ \ Check out our syntax guide for more information on how to use the TT function.](https://tokenterminal.com/docs/sheets/syntax) [​](https://tokenterminal.com/docs/sheets/google-sheets#common-issues) Common issues --------------------------------------------------------------------------------------- ### [​](https://tokenterminal.com/docs/sheets/google-sheets#fetch-limits) Fetch limits Google limits plugin users to 20,000 data pulls per day. If you run into this limit, you will observe the following error: `Service invoked too many times for one day: urlfetch.` You can read more about this [in the Google documentation](https://developers.google.com/apps-script/guides/services/quotas) . ### [​](https://tokenterminal.com/docs/sheets/google-sheets#sharing-sheets) Sharing Sheets When sharing sheets, be advised that the URL Fetch Limit counts towards the owner of the sheet. Therefore if you share a sheet, it is recommended you share it in **View Only** mode in order to reduce data pulls counted towards yourself. ### [​](https://tokenterminal.com/docs/sheets/google-sheets#performance) Performance Google Sheets has a few performance limitations that ultimately reduce the quality of offering we can provide. * Only 30 functions can run simultaneously. * If more than 30 functions are requested, the remaining functions are queued and will wait until upstream functions are finished. [Introduction](https://tokenterminal.com/docs/sheets) [Microsoft Excel](https://tokenterminal.com/docs/sheets/microsoft-excel) ⌘I --- # Datasets - Token Terminal Docs [Skip to main content](https://tokenterminal.com/docs/studio/datasets#content-area) [Token Terminal Docs home page![light logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-light.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=de49e0137894962aef5d37455c76ecf1)![dark logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-dark.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=6a5317263edae34558e014343002fe93)](https://tokenterminal.com/docs) Search... ⌘K Search... Navigation Datasets [Overview](https://tokenterminal.com/docs) [Explorer](https://tokenterminal.com/docs/explorer) [Studio](https://tokenterminal.com/docs/studio) [Sheets](https://tokenterminal.com/docs/sheets) [API](https://tokenterminal.com/docs/api-reference/introduction) [Data Room](https://tokenterminal.com/docs/data-room/introduction) On this page * [Creating datasets](https://tokenterminal.com/docs/studio/datasets#creating-datasets) * [Dataset](https://tokenterminal.com/docs/studio/datasets#dataset) * [Group by](https://tokenterminal.com/docs/studio/datasets#group-by) * [Columns](https://tokenterminal.com/docs/studio/datasets#columns) * [Working with datasets](https://tokenterminal.com/docs/studio/datasets#working-with-datasets) * [Share](https://tokenterminal.com/docs/studio/datasets#share) * [Clone](https://tokenterminal.com/docs/studio/datasets#clone) * [Preview](https://tokenterminal.com/docs/studio/datasets#preview) ![Studio datasets hero](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/images/studio-dataset.jpg?w=2500&fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=a6bf42878aa3a57b80dca24e1af01e34) Datasets allow you to customize any of the datasets built by Token Terminal. These datasets give you a table-first view to the data, allowing you to filter, group, and sort the data in a way that makes sense for your analysis. [​](https://tokenterminal.com/docs/studio/datasets#creating-datasets) Creating datasets ------------------------------------------------------------------------------------------ The first step in creating a dataset is selecting a template. You can do this by clicking the **Create new** button under the **Datasets** tab in Studio. After that you can aggregate and add or remove columns to the dataset. ### [​](https://tokenterminal.com/docs/studio/datasets#dataset) Dataset If you want to change from the dataset you chose previously, you can do it here. ### [​](https://tokenterminal.com/docs/studio/datasets#group-by) Group by Next, you can aggregate the data by one of the following options: * **Market sector**: Aggregate the data by market sector, e.g. Lending. * **Project**: Aggregate the data by project, e.g. Aave. * **Listing date**: Aggregate the data by listing date, e.g. 2023-01-01. ### [​](https://tokenterminal.com/docs/studio/datasets#columns) Columns You can select which columns you want to include in the dataset. You can also change the order of the columns by dragging and dropping them in the list. [​](https://tokenterminal.com/docs/studio/datasets#working-with-datasets) Working with datasets -------------------------------------------------------------------------------------------------- After you’ve saved the dataset, you have a number of options for working with your dataset. You can also find the dataset in your library under the **Datasets** tab. You can share your dataset with others by clicking the **Share** button in the top right corner of the dataset editor. This will generate a unique URL that you can share with anyone. ### [​](https://tokenterminal.com/docs/studio/datasets#clone) Clone You can clone any Studio dataset on Token Terminal, whether it’s from your team or not. Clicking **Clone** will open up the dataset editor with a fresh copy of the dataset that you can now adapt for your own needs. ### [​](https://tokenterminal.com/docs/studio/datasets#preview) Preview With **Preview**, you can see how your dataset will look when added to a dashboard. This is a great way to check that your dataset is configured correctly before adding it to a dashboard. [Charts](https://tokenterminal.com/docs/studio/charts) ⌘I --- # Get the Top tokenholders dataset - Token Terminal Docs [Skip to main content](https://tokenterminal.com/docs/api-reference/datasets/get-the-top-tokenholders-dataset#content-area) [Token Terminal Docs home page![light logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-light.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=de49e0137894962aef5d37455c76ecf1)![dark logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-dark.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=6a5317263edae34558e014343002fe93)](https://tokenterminal.com/docs) Search... ⌘K Search... Navigation Datasets Get the Top tokenholders dataset [Overview](https://tokenterminal.com/docs) [Explorer](https://tokenterminal.com/docs/explorer) [Studio](https://tokenterminal.com/docs/studio) [Sheets](https://tokenterminal.com/docs/sheets) [API](https://tokenterminal.com/docs/api-reference/introduction) [Data Room](https://tokenterminal.com/docs/data-room/introduction) Get the Top tokenholders dataset cURL Copy Ask AI curl --request GET \ --url https://api.tokenterminal.com/v2/datasets/top_tokenholders \ --header 'Authorization: Bearer ' 200 Copy Ask AI { "data": { "project_name": "", "project_id": "", "market_sector_id": "", "market_sector_name": "", "chain_id": "", "chain_name": "", "token_symbol": "", "token_address": "", "account_address": "", "account_title": "", "position_creation_timestamp": "", "transaction_count_sum": 123, "ownership_percentage_ath": 123, "account_balance_native_ath": 123, "account_balance_usd_ath": 123, "ownership_percentage": 123, "account_balance_native": 123, "account_balance_usd": 123, "ownership_percentage_30d_change": 123, "account_balance_native_30d_change": 123, "account_balance_usd_30d_change": 123, "account_balance_rank": 123 } } GET / v2 / datasets / top\_tokenholders Try it Get the Top tokenholders dataset cURL Copy Ask AI curl --request GET \ --url https://api.tokenterminal.com/v2/datasets/top_tokenholders \ --header 'Authorization: Bearer ' 200 Copy Ask AI { "data": { "project_name": "", "project_id": "", "market_sector_id": "", "market_sector_name": "", "chain_id": "", "chain_name": "", "token_symbol": "", "token_address": "", "account_address": "", "account_title": "", "position_creation_timestamp": "", "transaction_count_sum": 123, "ownership_percentage_ath": 123, "account_balance_native_ath": 123, "account_balance_usd_ath": 123, "ownership_percentage": 123, "account_balance_native": 123, "account_balance_usd": 123, "ownership_percentage_30d_change": 123, "account_balance_native_30d_change": 123, "account_balance_usd_30d_change": 123, "account_balance_rank": 123 } } #### Authorizations [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-top-tokenholders-dataset#authorization-authorization) Authorization string header required Bearer authentication header of the form `Bearer `, where `` is your auth token. #### Query Parameters [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-top-tokenholders-dataset#parameter-project-ids) project\_ids string\[\] Allows you to select one or more of the projects available in the dataset. When including multiple projects, separate each one with a comma. Example: `uniswap,aave`. [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-top-tokenholders-dataset#parameter-chain-ids) chain\_ids string\[\] Allows you to select one or more of the chains available in the dataset. When including multiple chains, separate each one with a comma. Example: `ethereum,arbitrum`. [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-top-tokenholders-dataset#parameter-market-sector-ids) market\_sector\_ids string\[\] Allows you to select one or more of the market sectors available in the dataset. When including multiple market sectors, separate each one with a comma. Example: `exchange,lending`. [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-top-tokenholders-dataset#parameter-order-by) order\_by string Allows you to select a field by which the response array is sorted. [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-top-tokenholders-dataset#parameter-order-direction) order\_direction string Allows you to define order direction for the field selected in `order_by`. If no order\_direction is selected, the response defaults to `asc`. [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-top-tokenholders-dataset#parameter-limit) limit number Limit the number of results returned. Usage through API reference has max limit of 50. #### Response 200 - application/json OK [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-top-tokenholders-dataset#response-data) data object The object containing the data for a successful response. Show child attributes [Get the Insider transactions dataset](https://tokenterminal.com/docs/api-reference/datasets/get-the-insider-transactions-dataset) [Get the Project contracts dataset](https://tokenterminal.com/docs/api-reference/datasets/get-the-project-contracts-dataset) ⌘I --- # Get metric breakdown aggregation for multiple projects, chains, or products - Token Terminal Docs [Skip to main content](https://tokenterminal.com/docs/api-reference/metrics/get-metric-breakdown-aggregation-for-multiple-projects-chains-or-products#content-area) [Token Terminal Docs home page![light logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-light.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=de49e0137894962aef5d37455c76ecf1)![dark logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-dark.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=6a5317263edae34558e014343002fe93)](https://tokenterminal.com/docs) Search... ⌘K Search... Navigation Metrics Get metric breakdown aggregation for multiple projects, chains, or products [Overview](https://tokenterminal.com/docs) [Explorer](https://tokenterminal.com/docs/explorer) [Studio](https://tokenterminal.com/docs/studio) [Sheets](https://tokenterminal.com/docs/sheets) [API](https://tokenterminal.com/docs/api-reference/introduction) [Data Room](https://tokenterminal.com/docs/data-room/introduction) Get metric breakdown aggregation for multiple projects, chains, or products cURL Copy Ask AI curl --request POST \ --url https://api.tokenterminal.com/v2/metric-breakdown \ --header 'Authorization: Bearer ' \ --header 'Content-Type: application/json' \ --data ' { "metric_ids": [\ ""\ ], "interval": "24h", "group_by": "projects", "project_ids": [\ ""\ ], "product_ids": [\ ""\ ], "chain_ids": [\ ""\ ], "market_sector_ids": [\ "blockchains-l1",\ "lending"\ ], "start": "2023-12-25", "end": "2023-12-25" } ' 200 Copy Ask AI { "data": [\ {\ "data_id": "usual",\ "chain_id": "usual",\ "product_id": "usual",\ "metrics": {}\ }\ ], "errors": [\ {\ "code": "NOT_FOUND",\ "field": "project_ids",\ "value": "invalid-project"\ }\ ] } POST / v2 / metric-breakdown Try it Get metric breakdown aggregation for multiple projects, chains, or products cURL Copy Ask AI curl --request POST \ --url https://api.tokenterminal.com/v2/metric-breakdown \ --header 'Authorization: Bearer ' \ --header 'Content-Type: application/json' \ --data ' { "metric_ids": [\ ""\ ], "interval": "24h", "group_by": "projects", "project_ids": [\ ""\ ], "product_ids": [\ ""\ ], "chain_ids": [\ ""\ ], "market_sector_ids": [\ "blockchains-l1",\ "lending"\ ], "start": "2023-12-25", "end": "2023-12-25" } ' 200 Copy Ask AI { "data": [\ {\ "data_id": "usual",\ "chain_id": "usual",\ "product_id": "usual",\ "metrics": {}\ }\ ], "errors": [\ {\ "code": "NOT_FOUND",\ "field": "project_ids",\ "value": "invalid-project"\ }\ ] } #### Authorizations [​](https://tokenterminal.com/docs/api-reference/metrics/get-metric-breakdown-aggregation-for-multiple-projects-chains-or-products#authorization-authorization) Authorization string header required Bearer authentication header of the form `Bearer `, where `` is your auth token. #### Body application/json [​](https://tokenterminal.com/docs/api-reference/metrics/get-metric-breakdown-aggregation-for-multiple-projects-chains-or-products#body-metric-ids) metric\_ids string\[\] required Array of metric IDs to retrieve data for [​](https://tokenterminal.com/docs/api-reference/metrics/get-metric-breakdown-aggregation-for-multiple-projects-chains-or-products#body-interval) interval enum required Time interval for aggregation Available options: `24h`, `7d`, `30d`, `90d`, `180d`, `365d`, `ytd`, `max` [​](https://tokenterminal.com/docs/api-reference/metrics/get-metric-breakdown-aggregation-for-multiple-projects-chains-or-products#body-group-by) group\_by enum required How to group the results Available options: `projects`, `chains`, `chain-project`, `chain-product`, `chain-market-sector`, `market-sector`, `product` [​](https://tokenterminal.com/docs/api-reference/metrics/get-metric-breakdown-aggregation-for-multiple-projects-chains-or-products#body-project-ids) project\_ids string\[\] Optional array of project IDs to filter by [​](https://tokenterminal.com/docs/api-reference/metrics/get-metric-breakdown-aggregation-for-multiple-projects-chains-or-products#body-product-ids) product\_ids string\[\] Optional array of product IDs to filter by [​](https://tokenterminal.com/docs/api-reference/metrics/get-metric-breakdown-aggregation-for-multiple-projects-chains-or-products#body-chain-ids) chain\_ids string\[\] Optional array of chain IDs to filter by [​](https://tokenterminal.com/docs/api-reference/metrics/get-metric-breakdown-aggregation-for-multiple-projects-chains-or-products#body-market-sector-ids) market\_sector\_ids string\[\] Optional list of market sector IDs to filter by Example: ["blockchains-l1", "lending"] [​](https://tokenterminal.com/docs/api-reference/metrics/get-metric-breakdown-aggregation-for-multiple-projects-chains-or-products#body-start) start string Start date for the query [​](https://tokenterminal.com/docs/api-reference/metrics/get-metric-breakdown-aggregation-for-multiple-projects-chains-or-products#body-end) end string End date for the query #### Response 200 - application/json OK [​](https://tokenterminal.com/docs/api-reference/metrics/get-metric-breakdown-aggregation-for-multiple-projects-chains-or-products#response-data) data object\[\] Show child attributes [​](https://tokenterminal.com/docs/api-reference/metrics/get-metric-breakdown-aggregation-for-multiple-projects-chains-or-products#response-errors) errors object\[\] Optional array of errors that occurred during request processing. Only present if some requested entities were not found. The endpoint returns data for valid entities even when errors are present, allowing partial success. Show child attributes [Get metric aggregations for multiple projects](https://tokenterminal.com/docs/api-reference/metrics/get-metric-aggregations-for-multiple-projects) [List all datasets](https://tokenterminal.com/docs/api-reference/datasets/list-all-datasets) ⌘I --- # Introduction - Token Terminal Docs [Skip to main content](https://tokenterminal.com/docs/studio#content-area) [Token Terminal Docs home page![light logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-light.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=de49e0137894962aef5d37455c76ecf1)![dark logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-dark.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=6a5317263edae34558e014343002fe93)](https://tokenterminal.com/docs) Search... ⌘K Search... Navigation Introduction [Overview](https://tokenterminal.com/docs) [Explorer](https://tokenterminal.com/docs/explorer) [Studio](https://tokenterminal.com/docs/studio) [Sheets](https://tokenterminal.com/docs/sheets) [API](https://tokenterminal.com/docs/api-reference/introduction) [Data Room](https://tokenterminal.com/docs/data-room/introduction) ![Studio hero](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/images/Studio.jpg?w=2500&fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=7f4c25313ee6d4ba3a00871035fd514b) Studio is a flexible workspace for creating custom, private dashboards. Users can build dashboards from scratch using charts, tables, and text boxes—no code required. All components can be downloaded as CSVs, and dashboards can be shared via private URLs with team members or the wider community. Additionally, any chart in Explorer can be forked and used as a template in Studio. [Dashboards](https://tokenterminal.com/docs/studio/dashboards) ⌘I --- # Get the Trending contracts dataset - Token Terminal Docs [Skip to main content](https://tokenterminal.com/docs/api-reference/datasets/get-the-trending-contracts-dataset#content-area) [Token Terminal Docs home page![light logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-light.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=de49e0137894962aef5d37455c76ecf1)![dark logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-dark.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=6a5317263edae34558e014343002fe93)](https://tokenterminal.com/docs) Search... ⌘K Search... Navigation Datasets Get the Trending contracts dataset [Overview](https://tokenterminal.com/docs) [Explorer](https://tokenterminal.com/docs/explorer) [Studio](https://tokenterminal.com/docs/studio) [Sheets](https://tokenterminal.com/docs/sheets) [API](https://tokenterminal.com/docs/api-reference/introduction) [Data Room](https://tokenterminal.com/docs/data-room/introduction) Get the Trending contracts dataset cURL Copy Ask AI curl --request GET \ --url https://api.tokenterminal.com/v2/datasets/trending_contracts \ --header 'Authorization: Bearer ' 200 Copy Ask AI { "data": [\ {\ "project_id": "",\ "project_name": "",\ "market_sector_id": "",\ "market_sector_name": "",\ "chain_id": "",\ "chain_name": "",\ "account_address": "",\ "account_title": "",\ "account_creation_timestamp": "",\ "gas_used_1d_sum": 123,\ "transaction_count_1d_sum": 123,\ "active_addresses_1d_distinct_count": 123,\ "transaction_gas_1d_avg": 123,\ "gas_market_share_1d_avg": 123,\ "inflows_1d_sum": 123,\ "outflows_1d_sum": 123,\ "net_flows_1d_sum": 123,\ "gas_used_1d_sum_trend": 123,\ "transaction_count_1d_sum_trend": 123,\ "active_addresses_1d_distinct_count_trend": 123,\ "transaction_gas_1d_avg_trend": 123,\ "gas_market_share_1d_avg_trend": 123,\ "inflows_1d_sum_trend": 123,\ "outfows_1d_sum_trend": 123,\ "net_flows_1d_sum_trend": 123,\ "gas_used_1d_sum_rank": 123,\ "most_emitted_event_1d_name": "",\ "most_emitted_event_1d_signature": "",\ "most_transferred_asset_1d_symbol": ""\ }\ ] } GET / v2 / datasets / trending\_contracts Try it Get the Trending contracts dataset cURL Copy Ask AI curl --request GET \ --url https://api.tokenterminal.com/v2/datasets/trending_contracts \ --header 'Authorization: Bearer ' 200 Copy Ask AI { "data": [\ {\ "project_id": "",\ "project_name": "",\ "market_sector_id": "",\ "market_sector_name": "",\ "chain_id": "",\ "chain_name": "",\ "account_address": "",\ "account_title": "",\ "account_creation_timestamp": "",\ "gas_used_1d_sum": 123,\ "transaction_count_1d_sum": 123,\ "active_addresses_1d_distinct_count": 123,\ "transaction_gas_1d_avg": 123,\ "gas_market_share_1d_avg": 123,\ "inflows_1d_sum": 123,\ "outflows_1d_sum": 123,\ "net_flows_1d_sum": 123,\ "gas_used_1d_sum_trend": 123,\ "transaction_count_1d_sum_trend": 123,\ "active_addresses_1d_distinct_count_trend": 123,\ "transaction_gas_1d_avg_trend": 123,\ "gas_market_share_1d_avg_trend": 123,\ "inflows_1d_sum_trend": 123,\ "outfows_1d_sum_trend": 123,\ "net_flows_1d_sum_trend": 123,\ "gas_used_1d_sum_rank": 123,\ "most_emitted_event_1d_name": "",\ "most_emitted_event_1d_signature": "",\ "most_transferred_asset_1d_symbol": ""\ }\ ] } #### Authorizations [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-trending-contracts-dataset#authorization-authorization) Authorization string header required Bearer authentication header of the form `Bearer `, where `` is your auth token. #### Query Parameters [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-trending-contracts-dataset#parameter-project-ids) project\_ids string\[\] Allows you to select one or more of the projects available in the dataset. When including multiple projects, separate each one with a comma. Example: `aave,uniswap`. [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-trending-contracts-dataset#parameter-chain-ids) chain\_ids string\[\] Allows you to select one or more of the chains available in the dataset. When including multiple chains, separate each one with a comma. Example: `ethereum,arbitrum`. [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-trending-contracts-dataset#parameter-market-sector-ids) market\_sector\_ids string\[\] Allows you to select one or more of the market sectors available in the dataset. When including multiple market sectors, separate each one with a comma. Example: `stablecoin,derivatives`. [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-trending-contracts-dataset#parameter-order-by) order\_by string Allows you to select a field by which the response array is sorted. [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-trending-contracts-dataset#parameter-order-direction) order\_direction string Allows you to define order direction for the field selected in `order_by`. If no order\_direction is selected, the response defaults to `asc`. [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-trending-contracts-dataset#parameter-limit) limit number Limit the number of results returned. Usage through API reference has max limit of 50. #### Response 200 - application/json OK [​](https://tokenterminal.com/docs/api-reference/datasets/get-the-trending-contracts-dataset#response-data) data object\[\] The Array containing the data for a successful response. Show child attributes [Get the Stablecoins dataset](https://tokenterminal.com/docs/api-reference/datasets/get-the-stablecoins-dataset) [Get a list of all assets](https://tokenterminal.com/docs/api-reference/assets/get-a-list-of-all-assets) ⌘I --- # Get metric data for multiple projects - Token Terminal Docs [Skip to main content](https://tokenterminal.com/docs/api-reference/metrics/get-metric-data-for-multiple-projects#content-area) [Token Terminal Docs home page![light logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-light.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=de49e0137894962aef5d37455c76ecf1)![dark logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-dark.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=6a5317263edae34558e014343002fe93)](https://tokenterminal.com/docs) Search... ⌘K Search... Navigation Metrics Get metric data for multiple projects [Overview](https://tokenterminal.com/docs) [Explorer](https://tokenterminal.com/docs/explorer) [Studio](https://tokenterminal.com/docs/studio) [Sheets](https://tokenterminal.com/docs/sheets) [API](https://tokenterminal.com/docs/api-reference/introduction) [Data Room](https://tokenterminal.com/docs/data-room/introduction) Get metric data for multiple projects cURL Copy Ask AI curl --request GET \ --url https://api.tokenterminal.com/v2/metrics/{metric_id} \ --header 'Authorization: Bearer ' 200 Copy Ask AI { "data": [\ {\ "timestamp": "",\ "project_id": "",\ "project_name": "",\ "metric_id": "",\ "value": ""\ }\ ], "errors": [\ {\ "code": "NOT_FOUND",\ "field": "project_ids",\ "value": "invalid-project"\ }\ ] } GET / v2 / metrics / {metric\_id} Try it Get metric data for multiple projects cURL Copy Ask AI curl --request GET \ --url https://api.tokenterminal.com/v2/metrics/{metric_id} \ --header 'Authorization: Bearer ' 200 Copy Ask AI { "data": [\ {\ "timestamp": "",\ "project_id": "",\ "project_name": "",\ "metric_id": "",\ "value": ""\ }\ ], "errors": [\ {\ "code": "NOT_FOUND",\ "field": "project_ids",\ "value": "invalid-project"\ }\ ] } #### Authorizations [​](https://tokenterminal.com/docs/api-reference/metrics/get-metric-data-for-multiple-projects#authorization-authorization) Authorization string header required Bearer authentication header of the form `Bearer `, where `` is your auth token. #### Path Parameters [​](https://tokenterminal.com/docs/api-reference/metrics/get-metric-data-for-multiple-projects#parameter-metric-id) metric\_id string required Allows you to select one of the metrics available. The full list is available on the metrics endpoint (see above). #### Query Parameters [​](https://tokenterminal.com/docs/api-reference/metrics/get-metric-data-for-multiple-projects#parameter-project-ids) project\_ids string\[\] Allows you to select one or more of the projects available for a specific metric. When including multiple projects, separate each one with a comma. Example: `aave,uniswap`. You can fetch all available projects for the respective metric by omitting this parameter or using value `all`. [​](https://tokenterminal.com/docs/api-reference/metrics/get-metric-data-for-multiple-projects#parameter-chain-ids) chain\_ids string\[\] List of chains to include according to projects chain availability. Allows you to select one or more of the chains available for a specific project. When including multiple chains, separate each one with a comma. Example: `ethereum,base`. The full list of available chains can be retrieved from the projects/:project\_id endpoint. [​](https://tokenterminal.com/docs/api-reference/metrics/get-metric-data-for-multiple-projects#parameter-product-ids) product\_ids string\[\] List of products to include according to projects product availability. Allows you to select one or more of the products available for a specific project. When including multiple products, separate each one with a comma. Example: `usdc,usdt`. The full list of available products can be retrieved from the projects endpoint. [​](https://tokenterminal.com/docs/api-reference/metrics/get-metric-data-for-multiple-projects#parameter-market-sector-ids) market\_sector\_ids string\[\] List of market sector IDs to filter projects by. Allows you to select one or more market sectors to filter the results. Only projects belonging to any of the specified market sectors will be included. When including multiple market sectors, separate each one with a comma. Example: `blockchains-l1,lending`. The full list of available market sectors can be retrieved from the `/v2/market-sectors` endpoint. [​](https://tokenterminal.com/docs/api-reference/metrics/get-metric-data-for-multiple-projects#parameter-start) start string Allows you to select the start date for the query. If no start is selected, the query defaults to launch date or the first date for which there is data available for the chosen metric(s). [​](https://tokenterminal.com/docs/api-reference/metrics/get-metric-data-for-multiple-projects#parameter-end) end string Allows you to select the end date for the query. If no end is selected, the query defaults to the latest date for which there is data available for the chosen metric(s). #### Response 200 - application/json OK [​](https://tokenterminal.com/docs/api-reference/metrics/get-metric-data-for-multiple-projects#response-data) data object\[\] Show child attributes [​](https://tokenterminal.com/docs/api-reference/metrics/get-metric-data-for-multiple-projects#response-errors) errors object\[\] Optional array of errors that occurred during request processing. Only present if some requested entities were invalid or unavailable. The endpoint returns data for valid entities even when errors are present, allowing partial success. * Option 1 * Option 2 Show child attributes Example: { "code": "NOT_FOUND", "field": "project_ids", "value": "invalid-project"} [Get a list of all metrics](https://tokenterminal.com/docs/api-reference/metrics/get-a-list-of-all-metrics) [Get metric aggregations for multiple projects](https://tokenterminal.com/docs/api-reference/metrics/get-metric-aggregations-for-multiple-projects) ⌘I --- # Get metric aggregations for a project - Token Terminal Docs [Skip to main content](https://tokenterminal.com/docs/api-reference/projects/get-metric-aggregations-for-a-project#content-area) [Token Terminal Docs home page![light logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-light.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=de49e0137894962aef5d37455c76ecf1)![dark logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-dark.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=6a5317263edae34558e014343002fe93)](https://tokenterminal.com/docs) Search... ⌘K Search... Navigation Projects Get metric aggregations for a project [Overview](https://tokenterminal.com/docs) [Explorer](https://tokenterminal.com/docs/explorer) [Studio](https://tokenterminal.com/docs/studio) [Sheets](https://tokenterminal.com/docs/sheets) [API](https://tokenterminal.com/docs/api-reference/introduction) [Data Room](https://tokenterminal.com/docs/data-room/introduction) Get metric aggregations for a project cURL Copy Ask AI curl --request GET \ --url https://api.tokenterminal.com/v2/projects/{project_id}/metric-aggregations \ --header 'Authorization: Bearer ' 200 Copy Ask AI { "data": [\ {\ "project_name": "",\ "project_id": "",\ "metric_id": "",\ "metric_aggregation_name": "",\ "value": ""\ }\ ] } GET / v2 / projects / {project\_id} / metric-aggregations Try it Get metric aggregations for a project cURL Copy Ask AI curl --request GET \ --url https://api.tokenterminal.com/v2/projects/{project_id}/metric-aggregations \ --header 'Authorization: Bearer ' 200 Copy Ask AI { "data": [\ {\ "project_name": "",\ "project_id": "",\ "metric_id": "",\ "metric_aggregation_name": "",\ "value": ""\ }\ ] } #### Authorizations [​](https://tokenterminal.com/docs/api-reference/projects/get-metric-aggregations-for-a-project#authorization-authorization) Authorization string header required Bearer authentication header of the form `Bearer `, where `` is your auth token. #### Path Parameters [​](https://tokenterminal.com/docs/api-reference/projects/get-metric-aggregations-for-a-project#parameter-project-id) project\_id string required ID of the project Allows you to select one of the projects available. #### Response 200 - application/json OK [​](https://tokenterminal.com/docs/api-reference/projects/get-metric-aggregations-for-a-project#response-data) data object\[\] Show child attributes [Get metric availability for a project](https://tokenterminal.com/docs/api-reference/projects/get-metric-availability-for-a-project) [Get financial statement for a project](https://tokenterminal.com/docs/api-reference/projects/get-financial-statement-for-a-project) ⌘I --- # Get a list of all projects - Token Terminal Docs [Skip to main content](https://tokenterminal.com/docs/api-reference/projects/get-a-list-of-all-projects#content-area) [Token Terminal Docs home page![light logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-light.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=de49e0137894962aef5d37455c76ecf1)![dark logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-dark.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=6a5317263edae34558e014343002fe93)](https://tokenterminal.com/docs) Search... ⌘K Search... Navigation Projects Get a list of all projects [Overview](https://tokenterminal.com/docs) [Explorer](https://tokenterminal.com/docs/explorer) [Studio](https://tokenterminal.com/docs/studio) [Sheets](https://tokenterminal.com/docs/sheets) [API](https://tokenterminal.com/docs/api-reference/introduction) [Data Room](https://tokenterminal.com/docs/data-room/introduction) Get a list of all projects cURL Copy Ask AI curl --request GET \ --url https://api.tokenterminal.com/v2/projects \ --header 'Authorization: Bearer ' 200 Copy Ask AI { "data": [\ {\ "name": "",\ "project_id": "",\ "coingecko_id": "",\ "symbol": "",\ "url": "",\ "is_archived": true,\ "archived_reason": "",\ "maintenance_reason": "",\ "products": [\ {\ "product_id": "",\ "product_name": "",\ "symbol": "",\ "url": ""\ }\ ]\ }\ ] } GET / v2 / projects Try it Get a list of all projects cURL Copy Ask AI curl --request GET \ --url https://api.tokenterminal.com/v2/projects \ --header 'Authorization: Bearer ' 200 Copy Ask AI { "data": [\ {\ "name": "",\ "project_id": "",\ "coingecko_id": "",\ "symbol": "",\ "url": "",\ "is_archived": true,\ "archived_reason": "",\ "maintenance_reason": "",\ "products": [\ {\ "product_id": "",\ "product_name": "",\ "symbol": "",\ "url": ""\ }\ ]\ }\ ] } #### Authorizations [​](https://tokenterminal.com/docs/api-reference/projects/get-a-list-of-all-projects#authorization-authorization) Authorization string header required Bearer authentication header of the form `Bearer `, where `` is your auth token. #### Response 200 - application/json OK [​](https://tokenterminal.com/docs/api-reference/projects/get-a-list-of-all-projects#response-data) data object\[\] Show child attributes [Best practices](https://tokenterminal.com/docs/api-reference/best-practices) [Get historical metrics for a project](https://tokenterminal.com/docs/api-reference/projects/get-historical-metrics-for-a-project) ⌘I --- # Get details for a specific product of a project - Token Terminal Docs [Skip to main content](https://tokenterminal.com/docs/api-reference/projects/get-details-for-a-specific-product-of-a-project#content-area) [Token Terminal Docs home page![light logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-light.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=de49e0137894962aef5d37455c76ecf1)![dark logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-dark.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=6a5317263edae34558e014343002fe93)](https://tokenterminal.com/docs) Search... ⌘K Search... Navigation Projects Get details for a specific product of a project [Overview](https://tokenterminal.com/docs) [Explorer](https://tokenterminal.com/docs/explorer) [Studio](https://tokenterminal.com/docs/studio) [Sheets](https://tokenterminal.com/docs/sheets) [API](https://tokenterminal.com/docs/api-reference/introduction) [Data Room](https://tokenterminal.com/docs/data-room/introduction) Get details for a specific product of a project cURL Copy Ask AI curl --request GET \ --url https://api.tokenterminal.com/v2/projects/{project_id}/products/{product_id} \ --header 'Authorization: Bearer ' 200 Copy Ask AI { "data": { "name": "", "product_id": "", "project_id": "", "symbol": "", "market_sectors": {}, "chains": [\ ""\ ], "aggregate_by_options": {}, "metric_availability": {}, "metric_definitions": [\ {}\ ], "metric_sources": [\ {}\ ] } } GET / v2 / projects / {project\_id} / products / {product\_id} Try it Get details for a specific product of a project cURL Copy Ask AI curl --request GET \ --url https://api.tokenterminal.com/v2/projects/{project_id}/products/{product_id} \ --header 'Authorization: Bearer ' 200 Copy Ask AI { "data": { "name": "", "product_id": "", "project_id": "", "symbol": "", "market_sectors": {}, "chains": [\ ""\ ], "aggregate_by_options": {}, "metric_availability": {}, "metric_definitions": [\ {}\ ], "metric_sources": [\ {}\ ] } } #### Authorizations [​](https://tokenterminal.com/docs/api-reference/projects/get-details-for-a-specific-product-of-a-project#authorization-authorization) Authorization string header required Bearer authentication header of the form `Bearer `, where `` is your auth token. #### Path Parameters [​](https://tokenterminal.com/docs/api-reference/projects/get-details-for-a-specific-product-of-a-project#parameter-project-id) project\_id string required ID of the project [​](https://tokenterminal.com/docs/api-reference/projects/get-details-for-a-specific-product-of-a-project#parameter-product-id) product\_id string required ID of the product #### Response 200 application/json OK [​](https://tokenterminal.com/docs/api-reference/projects/get-details-for-a-specific-product-of-a-project#response-data) data object Show child attributes [Get financial statement for a project](https://tokenterminal.com/docs/api-reference/projects/get-financial-statement-for-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) ⌘I --- # Get historical metrics for a project - Token Terminal Docs [Skip to main content](https://tokenterminal.com/docs/api-reference/projects/get-historical-metrics-for-a-project#content-area) [Token Terminal Docs home page![light logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-light.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=de49e0137894962aef5d37455c76ecf1)![dark logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-dark.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=6a5317263edae34558e014343002fe93)](https://tokenterminal.com/docs) Search... ⌘K Search... Navigation Projects Get historical metrics for a project [Overview](https://tokenterminal.com/docs) [Explorer](https://tokenterminal.com/docs/explorer) [Studio](https://tokenterminal.com/docs/studio) [Sheets](https://tokenterminal.com/docs/sheets) [API](https://tokenterminal.com/docs/api-reference/introduction) [Data Room](https://tokenterminal.com/docs/data-room/introduction) Get historical metrics for a project cURL Copy Ask AI curl --request GET \ --url https://api.tokenterminal.com/v2/projects/{project_id}/metrics \ --header 'Authorization: Bearer ' 200 Copy Ask AI { "data": [\ {\ "timestamp": "",\ "project_name": "",\ "project_id": "",\ "chain": "",\ "business_line": "",\ "version": "",\ "metric_id(s)": ""\ }\ ], "errors": [\ {\ "code": "NOT_FOUND",\ "field": "project_ids",\ "value": "invalid-project"\ }\ ] } GET / v2 / projects / {project\_id} / metrics Try it Get historical metrics for a project cURL Copy Ask AI curl --request GET \ --url https://api.tokenterminal.com/v2/projects/{project_id}/metrics \ --header 'Authorization: Bearer ' 200 Copy Ask AI { "data": [\ {\ "timestamp": "",\ "project_name": "",\ "project_id": "",\ "chain": "",\ "business_line": "",\ "version": "",\ "metric_id(s)": ""\ }\ ], "errors": [\ {\ "code": "NOT_FOUND",\ "field": "project_ids",\ "value": "invalid-project"\ }\ ] } #### Authorizations [​](https://tokenterminal.com/docs/api-reference/projects/get-historical-metrics-for-a-project#authorization-authorization) Authorization string header required Bearer authentication header of the form `Bearer `, where `` is your auth token. #### Path Parameters [​](https://tokenterminal.com/docs/api-reference/projects/get-historical-metrics-for-a-project#parameter-project-id) project\_id string required ID of the project Allows you to select one of the projects available. The full list is available on the projects endpoint (see above). #### Query Parameters [​](https://tokenterminal.com/docs/api-reference/projects/get-historical-metrics-for-a-project#parameter-metric-ids) metric\_ids string\[\] List of metrics to include according to projects metric availability. Allows you to select one or more of the metrics available for a specific project. When including multiple metrics, separate each one with a comma. Example: `fees,revenue`. If no metric\_id is selected, the query defaults to returning all available metrics for the project. [​](https://tokenterminal.com/docs/api-reference/projects/get-historical-metrics-for-a-project#parameter-chain-ids) chain\_ids string\[\] List of chains to include according to projects chain availability. Allows you to select one or more of the chains available for a specific project. When including multiple chains, separate each one with a comma. Example: `ethereum,base`. The full list of available chains can be retrieved from the projects/:project\_id endpoint. [​](https://tokenterminal.com/docs/api-reference/projects/get-historical-metrics-for-a-project#parameter-product-ids) product\_ids string\[\] List of products to include according to projects product availability. Allows you to select one or more of the products available for a specific project. When including multiple products, separate each one with a comma. Example: `usdc,usdt`. The full list of available products can be retrieved from the projects endpoint. [​](https://tokenterminal.com/docs/api-reference/projects/get-historical-metrics-for-a-project#parameter-market-sector-ids) market\_sector\_ids string\[\] List of market sector IDs to filter projects by. Allows you to select one or more market sectors to filter the results. Only projects belonging to any of the specified market sectors will be included. When including multiple market sectors, separate each one with a comma. Example: `blockchains-l1,lending`. The full list of available market sectors can be retrieved from the `/v2/market-sectors` endpoint. [​](https://tokenterminal.com/docs/api-reference/projects/get-historical-metrics-for-a-project#parameter-aggregate-by) aggregate\_by string Level of granularity This feature enables more detailed queries of specific metrics. For instance, you can examine a project's revenue by individual chain. However, it's important to note that this level of granularity is not applicable to all metrics. For example, while it is possible to segment the fees metric by chain, the price metric cannot be aggregated in this manner. The availability of granularity options varies between projects. Attempting to apply an inappropriate level of granularity to a project will result in an empty result set. [​](https://tokenterminal.com/docs/api-reference/projects/get-historical-metrics-for-a-project#parameter-start) start string Start date Allows you to select the start date for the query. If no start is selected, the query defaults to launch date or the first date for which there is data available for the chosen metric(s). [​](https://tokenterminal.com/docs/api-reference/projects/get-historical-metrics-for-a-project#parameter-end) end string End date Allows you to select the end date for the query. If no end is selected, the query defaults to the latest date for which there is data available for the chosen metric(s). [​](https://tokenterminal.com/docs/api-reference/projects/get-historical-metrics-for-a-project#parameter-order-direction) order\_direction enum default:desc Timestamp ordering Allows you to define how the response is sorted. The response is always sorted by timestamp, and by selecting `desc` the response starts from the most recent entry, and vice versa for `asc`. If no order\_direction is selected, the response defaults to `desc`. Available options: `asc`, `desc` [​](https://tokenterminal.com/docs/api-reference/projects/get-historical-metrics-for-a-project#parameter-include-project-specific-metrics) include\_project\_specific\_metrics boolean default:false Include project-specific metrics Allows you to include project-specific metrics in the response. Project-specific metrics are metrics that are not available for all projects, but are specific to a particular project. If no include\_project\_specific\_metrics is selected, the response defaults to `false`. #### Response 200 - application/json OK [​](https://tokenterminal.com/docs/api-reference/projects/get-historical-metrics-for-a-project#response-data) data object\[\] Show child attributes [​](https://tokenterminal.com/docs/api-reference/projects/get-historical-metrics-for-a-project#response-errors) errors object\[\] Optional array of errors that occurred during request processing. Only present if some requested entities were not found. The endpoint returns data for valid entities even when errors are present, allowing partial success. Show child attributes [Get a list of all projects](https://tokenterminal.com/docs/api-reference/projects/get-a-list-of-all-projects) [Get metric availability for a project](https://tokenterminal.com/docs/api-reference/projects/get-metric-availability-for-a-project) ⌘I --- # Get financial statement for a project - Token Terminal Docs [Skip to main content](https://tokenterminal.com/docs/api-reference/projects/get-financial-statement-for-a-project#content-area) [Token Terminal Docs home page![light logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-light.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=de49e0137894962aef5d37455c76ecf1)![dark logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-dark.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=6a5317263edae34558e014343002fe93)](https://tokenterminal.com/docs) Search... ⌘K Search... Navigation Projects Get financial statement for a project [Overview](https://tokenterminal.com/docs) [Explorer](https://tokenterminal.com/docs/explorer) [Studio](https://tokenterminal.com/docs/studio) [Sheets](https://tokenterminal.com/docs/sheets) [API](https://tokenterminal.com/docs/api-reference/introduction) [Data Room](https://tokenterminal.com/docs/data-room/introduction) Get financial statement for a project cURL Copy Ask AI curl --request GET \ --url https://api.tokenterminal.com/v2/projects/{project_id}/financial-statement \ --header 'Authorization: Bearer ' 200 Copy Ask AI { "data": [\ {\ "timestamp": "",\ "timestamp_label_heading": "",\ "timestamp_label_subheading": "",\ "timestamp_granularity": "",\ "project_name": "",\ "section": "",\ "metric_id": "",\ "value": "",\ "pop_change": "",\ "definition": ""\ }\ ] } GET / v2 / projects / {project\_id} / financial-statement Try it Get financial statement for a project cURL Copy Ask AI curl --request GET \ --url https://api.tokenterminal.com/v2/projects/{project_id}/financial-statement \ --header 'Authorization: Bearer ' 200 Copy Ask AI { "data": [\ {\ "timestamp": "",\ "timestamp_label_heading": "",\ "timestamp_label_subheading": "",\ "timestamp_granularity": "",\ "project_name": "",\ "section": "",\ "metric_id": "",\ "value": "",\ "pop_change": "",\ "definition": ""\ }\ ] } #### Authorizations [​](https://tokenterminal.com/docs/api-reference/projects/get-financial-statement-for-a-project#authorization-authorization) Authorization string header required Bearer authentication header of the form `Bearer `, where `` is your auth token. #### Path Parameters [​](https://tokenterminal.com/docs/api-reference/projects/get-financial-statement-for-a-project#parameter-project-id) project\_id string required The project ID to retrieve financial statement for. #### Query Parameters [​](https://tokenterminal.com/docs/api-reference/projects/get-financial-statement-for-a-project#parameter-timestamp-granularity) timestamp\_granularity enum default:quarter The financial statement time granularity. Available options: `year`, `quarter`, `month`, `week` [​](https://tokenterminal.com/docs/api-reference/projects/get-financial-statement-for-a-project#parameter-interval) interval enum default:1y The time interval to retrieve financial statement for. Available options: `1m`, `1y`, `2y`, `3y`, `5y`, `max` #### Response 200 - application/json OK [​](https://tokenterminal.com/docs/api-reference/projects/get-financial-statement-for-a-project#response-data) data object\[\] Show child attributes [Get metric aggregations for a project](https://tokenterminal.com/docs/api-reference/projects/get-metric-aggregations-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) ⌘I --- # Get metric availability for a project - Token Terminal Docs [Skip to main content](https://tokenterminal.com/docs/api-reference/projects/get-metric-availability-for-a-project#content-area) [Token Terminal Docs home page![light logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-light.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=de49e0137894962aef5d37455c76ecf1)![dark logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-dark.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=6a5317263edae34558e014343002fe93)](https://tokenterminal.com/docs) Search... ⌘K Search... Navigation Projects Get metric availability for a project [Overview](https://tokenterminal.com/docs) [Explorer](https://tokenterminal.com/docs/explorer) [Studio](https://tokenterminal.com/docs/studio) [Sheets](https://tokenterminal.com/docs/sheets) [API](https://tokenterminal.com/docs/api-reference/introduction) [Data Room](https://tokenterminal.com/docs/data-room/introduction) Get metric availability for a project cURL Copy Ask AI curl --request GET \ --url https://api.tokenterminal.com/v2/projects/{project_id} \ --header 'Authorization: Bearer ' 200 Copy Ask AI { "data": { "name": "", "project_id": "", "symbol": "", "description": {}, "market_sectors": {}, "chains": [\ ""\ ], "links": [\ {\ "summary": "",\ "url": ""\ }\ ], "aggregate_by_options": {}, "metric_availability": "", "metric_definitions": [\ {\ "metric_id": "",\ "definition": ""\ }\ ], "metric_sources": [\ {\ "metric_id": "",\ "definition": ""\ }\ ] } } GET / v2 / projects / {project\_id} Try it Get metric availability for a project cURL Copy Ask AI curl --request GET \ --url https://api.tokenterminal.com/v2/projects/{project_id} \ --header 'Authorization: Bearer ' 200 Copy Ask AI { "data": { "name": "", "project_id": "", "symbol": "", "description": {}, "market_sectors": {}, "chains": [\ ""\ ], "links": [\ {\ "summary": "",\ "url": ""\ }\ ], "aggregate_by_options": {}, "metric_availability": "", "metric_definitions": [\ {\ "metric_id": "",\ "definition": ""\ }\ ], "metric_sources": [\ {\ "metric_id": "",\ "definition": ""\ }\ ] } } #### Authorizations [​](https://tokenterminal.com/docs/api-reference/projects/get-metric-availability-for-a-project#authorization-authorization) Authorization string header required Bearer authentication header of the form `Bearer `, where `` is your auth token. #### Path Parameters [​](https://tokenterminal.com/docs/api-reference/projects/get-metric-availability-for-a-project#parameter-project-id) project\_id string required Required input on the API when retrieving data for a project. #### Response 200 - application/json OK [​](https://tokenterminal.com/docs/api-reference/projects/get-metric-availability-for-a-project#response-data) data object Show child attributes [Get historical metrics for a project](https://tokenterminal.com/docs/api-reference/projects/get-historical-metrics-for-a-project) [Get metric aggregations for a project](https://tokenterminal.com/docs/api-reference/projects/get-metric-aggregations-for-a-project) ⌘I --- # Syntax - Token Terminal Docs [Skip to main content](https://tokenterminal.com/docs/sheets/syntax#content-area) [Token Terminal Docs home page![light logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-light.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=de49e0137894962aef5d37455c76ecf1)![dark logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-dark.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=6a5317263edae34558e014343002fe93)](https://tokenterminal.com/docs) Search... ⌘K Search... Navigation Syntax [Overview](https://tokenterminal.com/docs) [Explorer](https://tokenterminal.com/docs/explorer) [Studio](https://tokenterminal.com/docs/studio) [Sheets](https://tokenterminal.com/docs/sheets) [API](https://tokenterminal.com/docs/api-reference/introduction) [Data Room](https://tokenterminal.com/docs/data-room/introduction) On this page * [Types](https://tokenterminal.com/docs/sheets/syntax#types) * [Functions](https://tokenterminal.com/docs/sheets/syntax#functions) * [Get latest data for a project](https://tokenterminal.com/docs/sheets/syntax#get-latest-data-for-a-project) * [Get list of supported projects](https://tokenterminal.com/docs/sheets/syntax#get-list-of-supported-projects) * [Get list of supported metrics](https://tokenterminal.com/docs/sheets/syntax#get-list-of-supported-metrics) * [Get a financial statement for a project](https://tokenterminal.com/docs/sheets/syntax#get-a-financial-statement-for-a-project) * [Get time series data for a project](https://tokenterminal.com/docs/sheets/syntax#get-time-series-data-for-a-project) * [Get time series data for multiple metrics for a project](https://tokenterminal.com/docs/sheets/syntax#get-time-series-data-for-multiple-metrics-for-a-project) [​](https://tokenterminal.com/docs/sheets/syntax#types) Types ---------------------------------------------------------------- When using TT functions in Token Terminal Sheets, there are a few inputs that are important to understand: * `TICKER`: ticker, token symbol, project name, or project id. (from `=TT_PROJECTS`) * `METRIC_ID`: the `metric_id` returned from a metric row (`=TT_METRICS`) * `GRANULARITY`: `week` | `month` | `quarter` | `year` * `TIME_INTERVAL`: `7d` | `30d` | `90d` | `180d` | `365d` | `1m` | `1y` | `2y` | `3y` | `5y` | `max` **Single tickers and arrays**: Anywhere that you can pass a `TICKER` to a function, you can also pass an array of tickers or a range reference (i.e. `A1:A2`) that has ticker values in it. Arrays can be defined using the syntax `{'ticker_1', 'ticker_2'}` [​](https://tokenterminal.com/docs/sheets/syntax#functions) Functions ------------------------------------------------------------------------ Functions in Token Terminal Sheets allows you to easily access data from Token Terminal inside of your spreadsheet. There a few useful functions to help you retrieve a list of projects or metrics and then to retrieve specific data points for those projects and metrics. ### [​](https://tokenterminal.com/docs/sheets/syntax#get-latest-data-for-a-project) Get latest data for a project The simplest way to get data with Token Terminal Sheets is to use the `=TT()` function. You can pass it a ticker or array of tickers to receive the latest data point for any metric. Copy Ask AI =TT("TICKER", "METRIC_ID") Here are a few examples to demonstrate how you can pull metrics for different projects. Copy Ask AI // Pull latest Circulating market cap from Aave =TT("aave", "market_cap_circulating") // Pull latest Ethereum TVL =TT("ethereum", "tvl") // Pull latest Solana daily active users count =TT("solana", "user_dau") // Pull latest Polygon revenue =TT("polygon", "revenue") ### [​](https://tokenterminal.com/docs/sheets/syntax#get-list-of-supported-projects) Get list of supported projects If you’re not sure about what ticker you should use for a project, asset, or chain, you can use `TT_PROJECTS` to get a list of all supported projects. Copy Ask AI =TT_PROJECTS() You can check out a list of all supported projects in our [**Projects**](https://tokenterminal.com/explorer/projects) . ### [​](https://tokenterminal.com/docs/sheets/syntax#get-list-of-supported-metrics) Get list of supported metrics Like the projects function, `TT_METRICS` helps you know which metrics are available and how they’re abbreviated with the Token Terminal API. You can use this function as a reference point for getting the correct metrics names when building out your spreadsheet models. When using this function, you will get a list of all supported metrics. Copy Ask AI =TT_METRICS() You can check out a list of all supported metrics in our [**Metrics**](https://tokenterminal.com/explorer/metrics) . ### [​](https://tokenterminal.com/docs/sheets/syntax#get-a-financial-statement-for-a-project) Get a financial statement for a project Financial Statements on Token Terminal allow users to easily understand a project in a familiar format: quarterly financial statements for key metrics. You can easily generate a quarterly statement for any project inside of your sheet. Copy Ask AI =TT_FINANCIAL_STATEMENT("TICKER", "GRANULARITY", "TIME_INTERVAL") In the following example, we’ll pull a full year’s financial statement broken into quarters for Ethereum. Copy Ask AI =TT_FINANCIAL_STATEMENT("ethereum", "quarter", "365d") ### [​](https://tokenterminal.com/docs/sheets/syntax#get-time-series-data-for-a-project) Get time series data for a project Time series allow pulling historical data for a specific project, pulling in daily metrics for the time range specified in the function. Copy Ask AI =TT_TIMESERIES("TICKER", "METRIC_ID", "START_TIME", "END_TIME") In the following example, we’ll pull the Bitcoin price from 2022-01-01 to 2022-10-01 in ascending order. Copy Ask AI =TT_TIMESERIES("bitcoin", "price", "2022-01-01", "2022-10-01") We also allow you to pull data in descending order by adding the param `"DESC"`. Copy Ask AI =TT_TIMESERIES("bitcoin", "price", "2022-01-01", "2022-10-01", "DESC") ### [​](https://tokenterminal.com/docs/sheets/syntax#get-time-series-data-for-multiple-metrics-for-a-project) Get time series data for multiple metrics for a project Project time series allows pulling historical data for multiple metrics for a specific project, pulling in daily data for each metric for the time range specified in the function. Copy Ask AI =TT_TIMESERIES("bitcoin", {"price", "market_cap"}, "2022-01-01", "2022-10-01") [Microsoft Excel](https://tokenterminal.com/docs/sheets/microsoft-excel) ⌘I --- # Get historical metrics for a specific product of a project - Token Terminal Docs [Skip to main content](https://tokenterminal.com/docs/api-reference/projects/get-historical-metrics-for-a-specific-product-of-a-project#content-area) [Token Terminal Docs home page![light logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-light.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=de49e0137894962aef5d37455c76ecf1)![dark logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-dark.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=6a5317263edae34558e014343002fe93)](https://tokenterminal.com/docs) Search... ⌘K Search... Navigation Projects Get historical metrics for a specific product of a project [Overview](https://tokenterminal.com/docs) [Explorer](https://tokenterminal.com/docs/explorer) [Studio](https://tokenterminal.com/docs/studio) [Sheets](https://tokenterminal.com/docs/sheets) [API](https://tokenterminal.com/docs/api-reference/introduction) [Data Room](https://tokenterminal.com/docs/data-room/introduction) Get historical metrics for a specific product of a project cURL Copy Ask AI curl --request GET \ --url https://api.tokenterminal.com/v2/projects/{project_id}/products/{product_id}/metrics \ --header 'Authorization: Bearer ' 200 Copy Ask AI { "data": [\ {\ "metric_id": "",\ "date": "",\ "value": 123,\ "chain_id": ""\ }\ ], "errors": [\ {\ "code": "NOT_FOUND",\ "field": "project_ids",\ "value": "invalid-project"\ }\ ] } GET / v2 / projects / {project\_id} / products / {product\_id} / metrics Try it Get historical metrics for a specific product of a project cURL Copy Ask AI curl --request GET \ --url https://api.tokenterminal.com/v2/projects/{project_id}/products/{product_id}/metrics \ --header 'Authorization: Bearer ' 200 Copy Ask AI { "data": [\ {\ "metric_id": "",\ "date": "",\ "value": 123,\ "chain_id": ""\ }\ ], "errors": [\ {\ "code": "NOT_FOUND",\ "field": "project_ids",\ "value": "invalid-project"\ }\ ] } #### Authorizations [​](https://tokenterminal.com/docs/api-reference/projects/get-historical-metrics-for-a-specific-product-of-a-project#authorization-authorization) Authorization string header required Bearer authentication header of the form `Bearer `, where `` is your auth token. #### Path Parameters [​](https://tokenterminal.com/docs/api-reference/projects/get-historical-metrics-for-a-specific-product-of-a-project#parameter-project-id) project\_id string required ID of the project [​](https://tokenterminal.com/docs/api-reference/projects/get-historical-metrics-for-a-specific-product-of-a-project#parameter-product-id) product\_id string required ID of the product #### Query Parameters [​](https://tokenterminal.com/docs/api-reference/projects/get-historical-metrics-for-a-specific-product-of-a-project#parameter-metric-ids) metric\_ids string\[\] List of metrics to include according to product metric availability. Allows you to select one or more of the metrics available for a specific product. When including multiple metrics, separate each one with a comma. Example: `fees,revenue`. If no metric\_id is selected, the query defaults to returning all available metrics for the product. [​](https://tokenterminal.com/docs/api-reference/projects/get-historical-metrics-for-a-specific-product-of-a-project#parameter-chain-ids) chain\_ids string\[\] List of chains to include Allow selection of one or more chains to include in the data, particularly for metrics where chain-level granularity is available. When selecting multiple chains, separate each with a comma. Example: `ethereum,arbitrum`. If no chain\_id is provided, available chains for the product and metric will be used in the response. [​](https://tokenterminal.com/docs/api-reference/projects/get-historical-metrics-for-a-specific-product-of-a-project#parameter-start) start string Start date for data Set the beginning date for the data to be returned. Format: YYYY-MM-DD. If no start date is provided, all historical data will be included from the earliest available date. [​](https://tokenterminal.com/docs/api-reference/projects/get-historical-metrics-for-a-specific-product-of-a-project#parameter-end) end string End date for data Set the ending date for the data to be returned. Format: YYYY-MM-DD. If no end date is provided, data up to the current date will be included. [​](https://tokenterminal.com/docs/api-reference/projects/get-historical-metrics-for-a-specific-product-of-a-project#parameter-aggregate-by) aggregate\_by string Level of granularity This feature enables more detailed queries of specific metrics. For instance, you can examine a product's revenue by individual chain. The availability of granularity options varies between products. Attempting to apply an inappropriate level of granularity to a product will result in an empty result set. [​](https://tokenterminal.com/docs/api-reference/projects/get-historical-metrics-for-a-specific-product-of-a-project#parameter-order-direction) order\_direction enum default:desc Order direction for the results Sort the results in ascending or descending order based on date. Available options: `asc`, `desc` #### Response 200 application/json OK [​](https://tokenterminal.com/docs/api-reference/projects/get-historical-metrics-for-a-specific-product-of-a-project#response-data) data object\[\] Show child attributes [​](https://tokenterminal.com/docs/api-reference/projects/get-historical-metrics-for-a-specific-product-of-a-project#response-errors) errors object\[\] Optional array of errors that occurred during request processing. Only present if some requested entities were invalid. The endpoint returns data for valid entities even when errors are present, allowing partial success. Show child attributes [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) [Get a list of all market sectors](https://tokenterminal.com/docs/api-reference/market-sectors/get-a-list-of-all-market-sectors) ⌘I --- # Charts - Token Terminal Docs [Skip to main content](https://tokenterminal.com/docs/studio/charts#content-area) [Token Terminal Docs home page![light logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-light.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=de49e0137894962aef5d37455c76ecf1)![dark logo](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/logo/tt-logo-dark.svg?fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=6a5317263edae34558e014343002fe93)](https://tokenterminal.com/docs) Search... ⌘K Search... Navigation Charts [Overview](https://tokenterminal.com/docs) [Explorer](https://tokenterminal.com/docs/explorer) [Studio](https://tokenterminal.com/docs/studio) [Sheets](https://tokenterminal.com/docs/sheets) [API](https://tokenterminal.com/docs/api-reference/introduction) [Data Room](https://tokenterminal.com/docs/data-room/introduction) On this page * [Creating charts](https://tokenterminal.com/docs/studio/charts#creating-charts) * [Metric](https://tokenterminal.com/docs/studio/charts#metric) * [Filters](https://tokenterminal.com/docs/studio/charts#filters) * [Group by](https://tokenterminal.com/docs/studio/charts#group-by) * [Chart type](https://tokenterminal.com/docs/studio/charts#chart-type) * [Display value as](https://tokenterminal.com/docs/studio/charts#display-value-as) * [Y-axis](https://tokenterminal.com/docs/studio/charts#y-axis) * [Label](https://tokenterminal.com/docs/studio/charts#label) * [Legend](https://tokenterminal.com/docs/studio/charts#legend) * [Adding multiple metrics](https://tokenterminal.com/docs/studio/charts#adding-multiple-metrics) * [Title & description](https://tokenterminal.com/docs/studio/charts#title-%26-description) * [Footnote](https://tokenterminal.com/docs/studio/charts#footnote) * [Working with charts](https://tokenterminal.com/docs/studio/charts#working-with-charts) * [Share](https://tokenterminal.com/docs/studio/charts#share) * [Clone](https://tokenterminal.com/docs/studio/charts#clone) * [Preview](https://tokenterminal.com/docs/studio/charts#preview) * [Copy as image](https://tokenterminal.com/docs/studio/charts#copy-as-image) * [Sheets formula](https://tokenterminal.com/docs/studio/charts#sheets-formula) * [Download as CSV](https://tokenterminal.com/docs/studio/charts#download-as-csv) ![Studio chart hero](https://mintcdn.com/tokenterminal/ePVzUc4Jyl2mhQdQ/images/studio-chart.jpg?w=2500&fit=max&auto=format&n=ePVzUc4Jyl2mhQdQ&q=85&s=37dcafe653ba8fcaf960cbe12872d17d) Charts offer a no-code way to create custom charts that help you track your investing ideas or operational goals using onchain data across hundreds of chains and projects. [​](https://tokenterminal.com/docs/studio/charts#creating-charts) Creating charts ------------------------------------------------------------------------------------ The first step in building a chart is configuring the data you want to visualize. You can use the left-hand panel to select the metric, filters, groupings, and chart type you want to use. In the chart view, you can finalize the chart by selecting the title, description, footnote, time range, and granularity of the data. ### [​](https://tokenterminal.com/docs/studio/charts#metric) Metric First, select one of our **metrics**. Once you’ve selected a metric, the other filters will update to only show options available for that metric. For instance, if you select **Active loans**, you will only see projects associated with the Lending market sector. ### [​](https://tokenterminal.com/docs/studio/charts#filters) Filters Next, you can filter by one of following options: * **Project**: Any project tracked by Token Terminal. * **Market sector**: Any market sector associated with a project. * **Chain deployed on**: All apps that have deployed on the selected chain. * **Product**: Any product line of a project. ### [​](https://tokenterminal.com/docs/studio/charts#group-by) Group by Next, you can aggregate the data by one of the following options: * **Project**: Aggregate the data by project, e.g. Aave. * **Market sector**: Aggregate the data by market sector, e.g. Lending. * **Chain**: Split the data by chain, e.g. Ethereum, Arbitrum One, Avalanche. * **Product**: Split the data by product line, e.g. Aave v2, Aave v3, and GHO. * **Project & product**: Split the data by project and product line. * **Project & chain**: Split the data by project and chain. * **Product & chain**: Split the data by product line and chain, e.g. Aave v3 on Ethereum, Aave v3 on Arbitrum One, and Aave v3 on Avalanche. ### [​](https://tokenterminal.com/docs/studio/charts#chart-type) Chart type Once you’ve selected your filters and aggregations, you can configure the chart to your liking: * **Bar**: A standard bar chart that shows the data for each date unit. * **Stacked bar**: A standard stacked bar chart that shows the data for each date unit, with each grouping stacked on top of each other. * **Line**: A standard line chart that shows the data for each date unit. * **Area**: A standard area chart that shows the data for each date unit. * **Stacked area**: A standard stacked area chart that shows the data for each date unit, with each grouping stacked on top of each other. * **Number**: These will change your Group by setting to “None” and will aggregate the data into a single value for the selected date range. ### [​](https://tokenterminal.com/docs/studio/charts#display-value-as) Display value as You can choose how the data is displayed in the chart. Options include: * **Time series (default)** - data for each day is shown as a total value for only the date unit of that metric. * **Cumulative** - data is summed up day over day up until the latest date. * **Percent share** - data is split between groupings within the data adding up to 100% per day/week/month/quarter. ### [​](https://tokenterminal.com/docs/studio/charts#y-axis) Y-axis Choose where the axis is located and what label should be applied for the metric. ### [​](https://tokenterminal.com/docs/studio/charts#label) Label Choose the label for the chart. This will be used in the legend when added to a dashboard. ### [​](https://tokenterminal.com/docs/studio/charts#legend) Legend Choose the colors for each of the legend items. Use our default palette, select a common brand color, or choose a custom color for each item. ### [​](https://tokenterminal.com/docs/studio/charts#adding-multiple-metrics) Adding multiple metrics You can add additional metrics to your charts by clicking the **Add metric** button at the bottom of the left hand panel. Each metric will be displayed on the same chart with whatever unique settings you add for that metric. ### [​](https://tokenterminal.com/docs/studio/charts#title-&-description) Title & description You can add add a title and description to your chart. Both will be displayed with the data when the chart is added to a dashboard or shared with others. ### [​](https://tokenterminal.com/docs/studio/charts#footnote) Footnote Footnotes are a great way to add additional context to your chart. You can use footnotes to explain the methodology behind the chart, provide links to sources, or add any other relevant information. [​](https://tokenterminal.com/docs/studio/charts#working-with-charts) Working with charts -------------------------------------------------------------------------------------------- After you’ve saved the chart, you have a number of options for working with your charts. You can also find the chart in your library under the **Charts** tab. You can share your chart with others by clicking the **Share** button in the top right corner of the chart editor. This will generate a unique URL that you can share with anyone. ### [​](https://tokenterminal.com/docs/studio/charts#clone) Clone You can clone any Studio chart on Token Terminal, whether it’s from your team or not. Clicking **Clone** will open up the chart editor with a fresh copy of the chart that you can now adapt for your own needs. ### [​](https://tokenterminal.com/docs/studio/charts#preview) Preview With **Preview**, you can see how your chart will look when added to a dashboard. This is a great way to check that your chart is configured correctly before adding it to a dashboard. ### [​](https://tokenterminal.com/docs/studio/charts#copy-as-image) Copy as image You can copy your chart as an image by clicking the **Copy as image** button in the top right corner of the chart editor. This will copy the chart to your clipboard, which you can then paste into any document or image editor. This is a great way to share your chart with others in social media or to use it in presentations. We offer three options for copying your chart as an image: * **Default**: This will copy the chart as it is displayed in the editor. * **Social media**: This will copy the chart in a format optimized for social media, with a square aspect ratio and a smaller size. * **Slide deck**: This will copy the chart in a format optimized for slide decks, with a brand colored background. ### [​](https://tokenterminal.com/docs/studio/charts#sheets-formula) Sheets formula You can use the **Sheets formula** button to get the equivalent data in a format that can be used in Google Sheets or Excel. This will generate a formula that you can copy and paste into your spreadsheet. ### [​](https://tokenterminal.com/docs/studio/charts#download-as-csv) Download as CSV You can download the data in your chart as a CSV file by clicking the **Download as CSV** button in the top right corner of the chart editor. This will download the data in a format that can be used in any spreadsheet application. [Dashboards](https://tokenterminal.com/docs/studio/dashboards) [Datasets](https://tokenterminal.com/docs/studio/datasets) ⌘I ---