# Table of Contents - [Getting started for Developers | Santiment Academy](#getting-started-for-developers-santiment-academy) - [API Reference | Santiment Academy](#api-reference-santiment-academy) - [Santiment products and plans | Santiment Academy](#santiment-products-and-plans-santiment-academy) - [Emerging trends | Santiment Academy](#emerging-trends-santiment-academy) - [Social Volume | Santiment Academy](#social-volume-santiment-academy) - [Getting started for traders | Santiment Academy](#getting-started-for-traders-santiment-academy) - [Sanbase | Santiment Academy](#sanbase-santiment-academy) - [Crypto Academy: Learn How to Analyze Cryptocurrency Market](#crypto-academy-learn-how-to-analyze-cryptocurrency-market) - [Santiment Queries | Santiment Academy](#santiment-queries-santiment-academy) - [Education and Use Cases | Santiment Academy](#education-and-use-cases-santiment-academy) - [SAN tokens | Santiment Academy](#san-tokens-santiment-academy) - [Glossary of API Terms | Santiment Academy](#glossary-of-api-terms-santiment-academy) - [Videos | Santiment Academy](#videos-santiment-academy) - [Sansheets - Crypto Asset Data for Google Sheets | Santiment Academy](#sansheets-crypto-asset-data-for-google-sheets-santiment-academy) - [Changelog | Santiment Academy](#changelog-santiment-academy) - [MVRV - Market Value To Realized Value | Santiment Academy](#mvrv-market-value-to-realized-value-santiment-academy) - [How to Buy SAN Tokens | Santiment Academy](#how-to-buy-san-tokens-santiment-academy) - [Latency | Santiment Academy](#latency-santiment-academy) - [Frequency | Santiment Academy](#frequency-santiment-academy) - [Latency | Santiment Academy](#latency-santiment-academy) - [Data Anomaly Overview | Santiment Academy](#data-anomaly-overview-santiment-academy) - [Social Data | Santiment Academy](#social-data-santiment-academy) - [Realized Value | Santiment Academy](#realized-value-santiment-academy) - [Access | Santiment Academy](#access-santiment-academy) - [Renamed Metrics | Santiment Academy](#renamed-metrics-santiment-academy) - [Marketcap in USD | Santiment Academy](#marketcap-in-usd-santiment-academy) - [Price Metrics | Santiment Academy](#price-metrics-santiment-academy) - [Timebound | Santiment Academy](#timebound-santiment-academy) - [Change Metrics | Santiment Academy](#change-metrics-santiment-academy) - [Decentralized Exchange Metrics | Santiment Academy](#decentralized-exchange-metrics-santiment-academy) - [Ethereum Spent | Santiment Academy](#ethereum-spent-santiment-academy) - [Trading Volume in USD | Santiment Academy](#trading-volume-in-usd-santiment-academy) - [Deprecated Metrics | Santiment Academy](#deprecated-metrics-santiment-academy) - [Labels | Santiment Academy](#labels-santiment-academy) - [Annual inflation rate | Santiment Academy](#annual-inflation-rate-santiment-academy) - [Ethereum fees | Santiment Academy](#ethereum-fees-santiment-academy) - [Daily Aggregated Financial Metrics in USD | Santiment Academy](#daily-aggregated-financial-metrics-in-usd-santiment-academy) - [Mean Coin Age | Santiment Academy](#mean-coin-age-santiment-academy) - [Community Messages Count | Santiment Academy](#community-messages-count-santiment-academy) - [Gini Index | Santiment Academy](#gini-index-santiment-academy) - [RSI | Santiment Academy](#rsi-santiment-academy) - [Sentiment metrics | Santiment Academy](#sentiment-metrics-santiment-academy) - [Social Dominance | Santiment Academy](#social-dominance-santiment-academy) - [Transacted Coin Acquisition Cost | Santiment Academy](#transacted-coin-acquisition-cost-santiment-academy) - [Trending Words Rank | Santiment Academy](#trending-words-rank-santiment-academy) - [Unique Social Volume | Santiment Academy](#unique-social-volume-santiment-academy) - [404: Not found](#404-not-found) - [Price Volatility | Santiment Academy](#price-volatility-santiment-academy) - [Development Activity Metric | Santiment Academy](#development-activity-metric-santiment-academy) - [Development Activity Contributors Count | Santiment Academy](#development-activity-contributors-count-santiment-academy) - [Development Activity Metrics | Santiment Academy](#development-activity-metrics-santiment-academy) - [Crypto Metrics: Explore our Set of Onchain Social & Dev Metrics](#crypto-metrics-explore-our-set-of-onchain-social-dev-metrics) - [NVT | Santiment Academy](#nvt-santiment-academy) - [Mean Realized Price | Santiment Academy](#mean-realized-price-santiment-academy) - [Network Profit Loss | Santiment Academy](#network-profit-loss-santiment-academy) - [Github Activity | Santiment Academy](#github-activity-santiment-academy) - [Daily Active Addresses | Santiment Academy](#daily-active-addresses-santiment-academy) - [Active Addresses 24h | Santiment Academy](#active-addresses-24h-santiment-academy) - [Top Token Holders: Track 100 Addresses With the Highest Balances](#top-token-holders-track-100-addresses-with-the-highest-balances) - [404: Not found](#404-not-found) - [Crypto Active Addresses: Metric to Track Blockchain Activity](#crypto-active-addresses-metric-to-track-blockchain-activity) - [Token Age Consumed metric | Santiment Academy](#token-age-consumed-metric-santiment-academy) - [Crypto Active Addresses: Metric to Track Blockchain Activity](#crypto-active-addresses-metric-to-track-blockchain-activity) - [Realized Market Capitalization Hodl Waves | Santiment Academy](#realized-market-capitalization-hodl-waves-santiment-academy) - [Circulation | Santiment Academy](#circulation-santiment-academy) - [Bitcoin ETF Volume | Santiment Academy](#bitcoin-etf-volume-santiment-academy) - [Amount in Top Holders | Santiment Academy](#amount-in-top-holders-santiment-academy) - [ETH 2.0 Metrics | Santiment Academy](#eth-2-0-metrics-santiment-academy) - [Network Growth | Santiment Academy](#network-growth-santiment-academy) - [MakerDAO DAI Savings Rate | Santiment Academy](#makerdao-dai-savings-rate-santiment-academy) - [Dormant Circulation | Santiment Academy](#dormant-circulation-santiment-academy) - [Exchange Inflow/Outflow | Santiment Academy](#exchange-inflow-outflow-santiment-academy) - [Labeled Exchange | Santiment Academy](#labeled-exchange-santiment-academy) - [Spent Coins Age Band | Santiment Academy](#spent-coins-age-band-santiment-academy) - [Labeled Balance | Santiment Academy](#labeled-balance-santiment-academy) - [Stock To Flow Ratio (S2F): How It's Used and Calculated](#stock-to-flow-ratio-s2f-how-it-s-used-and-calculated) - [Supply On/Outside Exchanges | Santiment Academy](#supply-on-outside-exchanges-santiment-academy) - [Supply Distribution | Santiment Academy](#supply-distribution-santiment-academy) - [Transaction Volume | Santiment Academy](#transaction-volume-santiment-academy) - [DeFi Lending and Borrowing Protocols | Santiment Academy](#defi-lending-and-borrowing-protocols-santiment-academy) - [Total Supply | Santiment Academy](#total-supply-santiment-academy) - [Transaction Volume In Profit Or Loss | Santiment Academy](#transaction-volume-in-profit-or-loss-santiment-academy) - [Whale Transaction Count | Santiment Academy](#whale-transaction-count-santiment-academy) - [Velocity | Santiment Academy](#velocity-santiment-academy) - [Transaction count | Santiment Academy](#transaction-count-santiment-academy) - [Transaction Size | Santiment Academy](#transaction-size-santiment-academy) - [Funding Rates Aggregated | Santiment Academy](#funding-rates-aggregated-santiment-academy) - [Open Interest | Santiment Academy](#open-interest-santiment-academy) - [404: Not found](#404-not-found) - [Bitfinex Derivatives | Santiment Academy](#bitfinex-derivatives-santiment-academy) - [NFT Collection Holders Balance | Santiment Academy](#nft-collection-holders-balance-santiment-academy) - [NFT Market Volume/Count | Santiment Academy](#nft-market-volume-count-santiment-academy) - [dYdX Derivatives | Santiment Academy](#dydx-derivatives-santiment-academy) - [FTX Derivatives | Santiment Academy](#ftx-derivatives-santiment-academy) - [Huobi Derivatives | Santiment Academy](#huobi-derivatives-santiment-academy) - [NFT Collection Price | Santiment Academy](#nft-collection-price-santiment-academy) - [Deribit Derivatives | Santiment Academy](#deribit-derivatives-santiment-academy) - [NFT Network Profit Loss | Santiment Academy](#nft-network-profit-loss-santiment-academy) - [Supported Blockchains | Santiment Academy](#supported-blockchains-santiment-academy) - [Binance Derivatives | Santiment Academy](#binance-derivatives-santiment-academy) - [NFT Trade Volume USD | Santiment Academy](#nft-trade-volume-usd-santiment-academy) - [Historical Balance | Santiment Academy](#historical-balance-santiment-academy) - [NFT Trades Count | Santiment Academy](#nft-trades-count-santiment-academy) - [BitMEX Derivatives | Santiment Academy](#bitmex-derivatives-santiment-academy) - [Labelled Historical Balance | Santiment Academy](#labelled-historical-balance-santiment-academy) - [Interacting Address Count | Santiment Academy](#interacting-address-count-santiment-academy) - [Latest Transactions | Santiment Academy](#latest-transactions-santiment-academy) - [Transactions Count | Santiment Academy](#transactions-count-santiment-academy) - [404: Not found](#404-not-found) - [404: Not found](#404-not-found) - [404: Not found](#404-not-found) - [404: Not found](#404-not-found) - [404: Not found](#404-not-found) - [404: Not found](#404-not-found) - [DEX volume | Santiment Academy](#dex-volume-santiment-academy) - [Number of accounts | Santiment Academy](#number-of-accounts-santiment-academy) - [Assets Issued Metrics | Santiment Academy](#assets-issued-metrics-santiment-academy) - [Trading and Transaction Volume | Santiment Academy](#trading-and-transaction-volume-santiment-academy) - [Trustline Count Metrics | Santiment Academy](#trustline-count-metrics-santiment-academy) - [Timing Market Volatility with Token Age Consumed | Santiment Academy](#timing-market-volatility-with-token-age-consumed-santiment-academy) - [Assets Overview page | Santiment Academy](#assets-overview-page-santiment-academy) - [Sanbase Insights | Santiment Academy](#sanbase-insights-santiment-academy) - [Keyboard Shortcuts | Santiment Academy](#keyboard-shortcuts-santiment-academy) - [Alerts Page | Santiment Academy](#alerts-page-santiment-academy) - [Santiment Pro Report Samples | Santiment Academy](#santiment-pro-report-samples-santiment-academy) - [How to Log in Sanbase | Santiment Academy](#how-to-log-in-sanbase-santiment-academy) - [Account Settings | Santiment Academy](#account-settings-santiment-academy) - [404: Not found](#404-not-found) - [404: Not found](#404-not-found) - [Sanbase Plans | Santiment Academy](#sanbase-plans-santiment-academy) - [Santiment API Plans | Santiment Academy](#santiment-api-plans-santiment-academy) - [How to Request New Projects and Tokens for Display on Sanbase | Santiment Academy](#how-to-request-new-projects-and-tokens-for-display-on-sanbase-santiment-academy) - [Introducing Santiment Queries | Santiment Academy](#introducing-santiment-queries-santiment-academy) - [Fetching Metrics | Santiment Academy](#fetching-metrics-santiment-academy) - [Rate Limits, Restrictions and Credits Cost | Santiment Academy](#rate-limits-restrictions-and-credits-cost-santiment-academy) - [Fetching Prices, Volume, and Market Cap using Santiment Queries | Santiment Academy](#fetching-prices-volume-and-market-cap-using-santiment-queries-santiment-academy) - [How to Create a Correlation Matrix like Cryptowatch.io | Santiment Academy](#how-to-create-a-correlation-matrix-like-cryptowatch-io-santiment-academy) - [Lending Pools Overview | Santiment Academy](#lending-pools-overview-santiment-academy) - [API Complexity | Santiment Academy](#api-complexity-santiment-academy) - [Adding an API Key to Sansheets | Santiment Academy](#adding-an-api-key-to-sansheets-santiment-academy) - [Exploration | Santiment Academy](#exploration-santiment-academy) - [Setting up Sansheets | Santiment Academy](#setting-up-sansheets-santiment-academy) - [Bridge Transactions Table Overview | Santiment Academy](#bridge-transactions-table-overview-santiment-academy) - [DEX Pools Tables Overview | Santiment Academy](#dex-pools-tables-overview-santiment-academy) - [Sansheets Pro Templates | Santiment Academy](#sansheets-pro-templates-santiment-academy) - [Functions We Offer | Santiment Academy](#functions-we-offer-santiment-academy) - [API Rate Limits | Santiment Academy](#api-rate-limits-santiment-academy) - [API Access to Sanqueries | Santiment Academy](#api-access-to-sanqueries-santiment-academy) - [XRPL Tables Overview | Santiment Academy](#xrpl-tables-overview-santiment-academy) - [Writing SQL Queries | Santiment Academy](#writing-sql-queries-santiment-academy) - [Accessing the API | Santiment Academy](#accessing-the-api-santiment-academy) - [How to Pay with Crypto | Santiment Academy](#how-to-pay-with-crypto-santiment-academy) - [Metrics Datasets | Santiment Academy](#metrics-datasets-santiment-academy) - [Access Plans | Santiment Academy](#access-plans-santiment-academy) - [NFT Tables Overview | Santiment Academy](#nft-tables-overview-santiment-academy) - [Centralized exchange | Santiment Academy](#centralized-exchange-santiment-academy) - [How to Create an API Key | Santiment Academy](#how-to-create-an-api-key-santiment-academy) - [Current products of Santiment | Santiment Academy](#current-products-of-santiment-santiment-academy) - [Sanbase PRO Features | Santiment Academy](#sanbase-pro-features-santiment-academy) - [Connect a Wallet to Your Sanbase Account | Santiment Academy](#connect-a-wallet-to-your-sanbase-account-santiment-academy) - [Benefits of Holding SAN Tokens | Santiment Academy](#benefits-of-holding-san-tokens-santiment-academy) - [Asset | Santiment Academy](#asset-santiment-academy) - [Youtube tutorials | Santiment Academy](#youtube-tutorials-santiment-academy) - [Youtube webinars | Santiment Academy](#youtube-webinars-santiment-academy) - [Derivatives Label | Santiment Academy](#derivatives-label-santiment-academy) --- # Getting started for Developers | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/for-developers/#getting-started-for-developers) Getting started for Developers =============================================================================================================== [](https://academy.santiment.net/for-developers/#introduction) Introduction --------------------------------------------------------------------------- The Santiment API is a powerful tool designed to provide crucial data for your financial models. By leveraging this API, you can gain comprehensive insights into the cryptocurrency market, encompassing social trends, developmental metrics, and on-chain activities—all consolidated into a single platform. [](https://academy.santiment.net/for-developers/#what-does-santiment-offer-to-developers) What does Santiment offer to developers? ---------------------------------------------------------------------------------------------------------------------------------- Santiment offers a robust [GraphQL](https://graphql.org/) API, empowering developers with advanced capabilities to fetch essential crypto market data. GraphQL provides a highly flexible query language for APIs that enables more intuitive and descriptive queries compared to traditional REST API methods. With GraphQL, users can request exactly the data they need, minimizing the number of API calls and reducing bandwidth usage. Apart from precomputed metrics, Santiment has the [Santiment Queries](https://academy.santiment.net/santiment-queries/) product, which allows developers to write custom SQL to obtain the data from the database directly. These SQL queries can be executed from the [Queries web page](https://queries.santiment.net/) or [execute the queries through the API](https://academy.santiment.net/santiment-queries/api-access/) ### [](https://academy.santiment.net/for-developers/#graphql-api) GraphQL API In this example, the query fetches the daily active addresses for Bitcoin. The query is self-descriptive and easy to maintain. New members to your team can intuitively understand the query without the need to consult the documentation. 1 2 3 4 5 6 7 8 9 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22daily_active_addresses%22)%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20selector%3A%20%7Bslug%3A%20%22bitcoin%22%7D%0A%20%20%20%20%20%20from%3A%20%222024-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222024-01-31T23%3A59%3A59Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22)%0A%20%20%7D%0A%7D) ** Find more GraphQL query examples on the [Common Queries](https://academy.santiment.net/sanapi/common-queries/) page, or read [How to access the API](https://academy.santiment.net/sanapi/accessing-the-api/) article ### [](https://academy.santiment.net/for-developers/#python-api-wrapper-library) Python API-wrapper library Santiment provides a [Python API wrapper library](https://github.com/santiment/sanpy) that allows you to fetch metrics with a simple function call. The code shows how to translate the GraphQL query from above. The data is returned in a Pandas dataframe. 1 2 3 4 5 6 [](https://academy.santiment.net/for-developers/#metrics-catalog) Metrics Catalog --------------------------------------------------------------------------------- There are a few different ways to explore the available metrics. * Visit the [metrics' docs articles page](https://academy.santiment.net/metrics/) where you can find links to the documentation articles of the metrics. * Open the [Metrics Catalog](https://api.santiment.net/available_metrics) webpage that list all the metrics with information about the available assets. This page allows you to filter the metrics supported by a given asset and download the data as CSV. * Open any [chart page on Sanbase](https://app.santiment.net/charts?slug=ethereum) and explore the metrics on the sidebar. * Use the [GraphQL API](https://api.santiment.net/graphiql?query=%7B%0A%20%20getAccessRestrictions(filter%3A%20METRIC%2C%20product%3A%20SANAPI%2C%20plan%3A%20BUSINESS_PRO)%20%7B%0A%20%20%20%20name%0A%20%20%20%20isAccessible%0A%20%20%20%20isRestricted%0A%20%20%20%20isDeprecated%0A%20%20%20%20restrictedFrom%0A%20%20%20%20restrictedTo%0A%20%20%20%20docs%20%7B%0A%20%20%20%20%20%20link%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) that shows the restrictions for each subscription product -- which metrics are accessible and what are the time range restrictions for them. **Read next: [How to Access the API](https://academy.santiment.net/sanapi/accessing-the-api/) ** Updated 1 month ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # API Reference | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources * [Go to Sanapi](https://api.santiment.net/) [](https://academy.santiment.net/sanapi/#api-reference) API Reference ===================================================================== * [Overview](https://academy.santiment.net/sanapi/#overview) * [How to Access the API](https://academy.santiment.net/sanapi/#how-to-access-the-api) * [Fetching Metrics](https://academy.santiment.net/sanapi/#fetching-metrics) * [Rate Limits](https://academy.santiment.net/sanapi/#rate-limits) * [Complexity](https://academy.santiment.net/sanapi/#complexity) * [Glossary](https://academy.santiment.net/sanapi/#glossary) * [Supported Blockchains](https://academy.santiment.net/sanapi/#supported-blockchains) [](https://academy.santiment.net/sanapi/#overview) Overview ----------------------------------------------------------- Santiment API utilizes [GraphQL](https://graphql.org/) . The decision to use GraphQL over REST was made due to several reasons: * It allows you to request precisely the data you need and conveniently batch requests together. This effectively addresses the issues of underfetching and overfetching data. For instance, why fetch all 20+ fields of a project when you only need its name? * The request describes the format of the response. This eliminates the need to guess what data the result contains and how to parse it. * It provides an easy, out-of-the-box method to explore our API via our Live Explorer. ### [](https://academy.santiment.net/sanapi/#example) Example The example below demonstrates a GraphQL query used to fetch timeseries price data. The parameters control the time range, the interval between data points, and how all the values within an interval are aggregated. 1 2 3 4 5 6 7 8 9 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22twitter_followers%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22ethereum%22%0A%20%20%20%20%20%20from%3A%20%22utc_now-90d%22%0A%20%20%20%20%20%20to%3A%20%22utc_now-60d%22%0A%20%20%20%20%20%20interval%3A%20%221d%22)%0A%20%20%7D%0A%7D) ** [](https://academy.santiment.net/sanapi/#how-to-access-the-api) How to access the API ------------------------------------------------------------------------------------- Instructions how to access the API can be found on the [Accessing the API](https://academy.santiment.net/sanapi/accessing-the-api/) page. [](https://academy.santiment.net/sanapi/#fetching-metrics) Fetching Metrics --------------------------------------------------------------------------- You can find information on how to explore and fetch the available metrics on the [Fetching Metrics](https://academy.santiment.net/sanapi/fetching-metrics/) page. [](https://academy.santiment.net/sanapi/#common-graphql-queries) Common GraphQL queries --------------------------------------------------------------------------------------- The list of [Common GraphQL queries](https://academy.santiment.net/sanapi/common-queries/) gives examples for the different type of queries one can craft and execute. [](https://academy.santiment.net/sanapi/#rate-limits) Rate Limits ----------------------------------------------------------------- The [Rate Limits Page](https://academy.santiment.net/sanapi/rate-limits/) provides detailed information on how API calls are counted and how rate limits are applied. [](https://academy.santiment.net/sanapi/#historical-and-realtime-data-restrictions) Historical and Realtime data restrictions ----------------------------------------------------------------------------------------------------------------------------- The [Historical and Realtime data restrictions](https://academy.santiment.net/sanapi/historical-and-realtime-data-restrictions/) provides information about the applied restrictions per plan. [](https://academy.santiment.net/sanapi/#complexity) Complexity --------------------------------------------------------------- Each API query has a limit to the amount of data points it can fetch. The [Complexity Page](https://academy.santiment.net/sanapi/complexity/) provides a detailed explanation on how complexity analysis determines whether a given query will be executed or rejected. [](https://academy.santiment.net/sanapi/#glossary) Glossary ----------------------------------------------------------- You can find the definitions of some terms used on this page in our dedicated [glossary page](https://academy.santiment.net/glossary/) . [](https://academy.santiment.net/sanapi/#supported-blockchains) Supported Blockchains ------------------------------------------------------------------------------------- You can find information about the blockchains we support on our [Supported Blockchains page](https://academy.santiment.net/sanapi/supported-blockchains/) . Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Santiment products and plans | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/products-and-plans/#santiment-products-and-plans) Santiment products and plans =============================================================================================================== * [Access plans](https://academy.santiment.net/products-and-plans/access-plans/) * [Access plans - Sanbase](https://academy.santiment.net/products-and-plans/sanbase-plans/) * [Access plans - SanAPI](https://academy.santiment.net/products-and-plans/sanapi-plans/) * [Sanbase subscription via SanR NFT](https://academy.santiment.net/products-and-plans/sanbase-subscription-via-sanr-nft/) * [Santiment products](https://academy.santiment.net/products-and-plans/santiment-products/) * [How to pay with crypto](https://academy.santiment.net/products-and-plans/how-to-pay-with-crypto/) * [Create an API key](https://academy.santiment.net/products-and-plans/create-an-api-key/) * [Sanbase PRO features](https://academy.santiment.net/products-and-plans/sanbase-pro-features/) Updated 1 year ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Emerging trends | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/emerging-trends/#emerging-trends) Emerging trends ========================================================================================== ![Emerging trends on Sanbase](https://academy.santiment.net/metrics/emerging-trends/emerging-trends.png) [](https://academy.santiment.net/metrics/emerging-trends/#definition) Definition -------------------------------------------------------------------------------- The **Emerging trends** (or **Trending words**) is a list of words that describe the topics which _emerged_ faster than any others over the last 24 hours. By "emerging" we mean getting more social attraction from the crowd, being discussed much more than any other topic. We detect these words by computing the so called _hype score_ for each single word that is present in the [social data](https://academy.santiment.net/metrics/details/social-data/) after filtering and cleaning the data. Once this number is calculated, the words are ranked according to the corresponding scores in a descending order. The top 10 words in the resulting list are the top emerging trends. We constantly update our labels which helps us to keep labels as fresh as possible but result historical data changes. Any modifications to labels, social sources, or relevant jobs will prompt recalculation for the previous month's data. Within a 12 hour period, metric can be supplemented with new data. * * * [](https://academy.santiment.net/metrics/emerging-trends/#access) Access ------------------------------------------------------------------------ The metric's realtime data is **free**. The metric's historical data is with [restricted access](https://academy.santiment.net/metrics/details/access#restricted-access) . * * * ### [](https://academy.santiment.net/metrics/emerging-trends/#filtering-and-cleaning) Filtering and Cleaning In order to reduce the level of noise, spam and duplicates while calculating the hype scores, we apply some preprocessing to the text data, namely: 1. Clean all the texts from [stopwords](https://en.wikipedia.org/wiki/Stop_words) and non-alphabetic characters. 2. Transform each pair `(user_id, text_documents)` to a [bag of words](https://en.wikipedia.org/wiki/Bag-of-words_model) representation and remove all the bag of words duplicates. 3. For all the text documents that have more than a certain amount of words in general (usually 5) - remove the exact duplicates (i.e. messages that look exactly the same are considered only once). These steps help to make the approach robust to spam and multiple replications of the same word or short word combinations. * * * ### [](https://academy.santiment.net/metrics/emerging-trends/#hype-score) Hype Score After the processing is done, for each of the words we calculate the **hype score** (or **trend score**). For any timestamp we define the hype score as follows: where: * is the _normalized_ social volume of the word at the moment (i.e. the usual [social volume](https://academy.santiment.net/metrics/social-volume/) divided by the total amount of messages in that particular [data source](https://academy.santiment.net/metrics/details/social-data/) ), * is the total amount of unique users that have used the word under consideration at least once. On an intuitive level the hype score tends to be a measuring of how rapidly the social volume of a certain word increased over the last 24 hours in comparison to the past 2 weeks. This is done by comparing the current social volume change to the average social volume of the past 14 days. Additionally we multiply this factor by this way words with a high social volume and a relatively low amount of unique users, that mentioned it at least once, will have a smaller hype score. For example, if a given word was used many times by exactly one user (i.e. most probably it's heavy spam) this word will have a hype score of **0** thanks to the component. On the other hand, words with 100 and 200 users will have more or less the same chance to get a higher hype score. It's also worth noticing that we use the **normalized** social volume instead of the regular one. This makes it easier to compare the resulting hype score across different data sources with different average daily volumes of talks. * * * ### [](https://academy.santiment.net/metrics/emerging-trends/#ranking-the-words) Ranking the Words Once the texts are cleaned and each word has it's hype score, we first rank the words in descending order (the highest hype score goes to the top) and then combine the results across different data sources if necessary: this is done by averaging the hype score for each word across all desired data sources and ranking the words afterwards again. In case a given word is present in source 1 and is not present in source 2 we assume that it's hype score in the second data source is 0. * * * [](https://academy.santiment.net/metrics/emerging-trends/#measuring-unit) Measuring Unit ---------------------------------------------------------------------------------------- The [hype score](https://academy.santiment.net/metrics/emerging-trends/#hype-score) doesn't really have a qualitative meaning, it can be treated as a relative number: the higher it gets - the faster a given word is "emerging". * * * [](https://academy.santiment.net/metrics/emerging-trends/#data-type) Data Type ------------------------------------------------------------------------------ [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/emerging-trends/#frequency) Frequency ------------------------------------------------------------------------------ Emerging Trends are available at [hourly intervals](https://academy.santiment.net/metrics/details/frequency#hourly-frequency) * * * [](https://academy.santiment.net/metrics/emerging-trends/#latency) Latency -------------------------------------------------------------------------- Emerging Trends have [social data Latency](https://academy.santiment.net/metrics/details/latency#social-data-latency) * * * [](https://academy.santiment.net/metrics/emerging-trends/#available-assets) Available Assets -------------------------------------------------------------------------------------------- The algorithm takes into account all the [social data](https://academy.santiment.net/metrics/details/social-data/) , so the list may or may not contain asset names and tickers. We do track the emerging projects separately for the assets only, but currently it is not available through any of the products. * * * [](https://academy.santiment.net/metrics/emerging-trends/#how-to-access) How to Access -------------------------------------------------------------------------------------- ### [](https://academy.santiment.net/metrics/emerging-trends/#sanbase) [Sanbase](https://app.santiment.net/social-trends) The emerging trends are available in the _`Labs`_ section. ### [](https://academy.santiment.net/metrics/emerging-trends/#sanapi) [SanAPI](https://api.santiment.net/) The emerging trends are available as part of the API, the metric is called `getTrendingWords`: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 **[Run in Explorer](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getTrendingWords(from%3A%20%222020-01-01T12%3A00%3A00Z%22%2C%20to%3A%20%222020-01-01T13%3A00%3A00Z%22%2C%20size%3A10%2C%20interval%3A%221h%22)%20%7B%0A%20%20%20%20datetime%0A%20%20%20%20topWords%20%7B%0A%20%20%20%20%20%20word%0A%20%20%20%20%20%20score%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) ** Updated 11 minutes ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Social Volume | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/social-volume/#social-volume) Social Volume ==================================================================================== [](https://academy.santiment.net/metrics/social-volume/#definition) Definition ------------------------------------------------------------------------------ Social Volume is build on top of the [Social Data](https://academy.santiment.net/metrics/details/social-data/) . The total number of [social data text documents](https://academy.santiment.net/metrics/details/social-data/) that contain the given search term at least once. Examples of documents are telegram messages and reddit posts. If a single short telegram message includes the word `crypto` more than once, this message will increase the social volume of the word `crypto` by 1. If a long reddit post contains the word `crypto` 10 times, this again will increase the social volume of the word `crypto` by 1. Social Volume can be computed for an [asset](https://academy.santiment.net/glossary#asset) or for arbitrary search terms. When an asset is used, a special search term is constructed. For example querying the social volume for `santiment` will result in a search term similar to: > (SAN OR santiment OR santoken OR santimentnet OR sancoin OR sansan OR sancoin) AND NOT ((san AND francisco) OR (san AND fran) OR (san AND diego) OR (san AND marino) OR (san AND jose)) which includes documents containg `santiment` or `san` but excludes documents that contain common phrases containing `san` like `San Francisco`. The arbitrary search term can be: * One particular word like `bitcoin`, `crypto` or `blockchain`. * An exact phrase (surrounded by double quotation marks) like `"when moon"`, `"buy high sell low"` or `"btc rekt"`. * [Lucene Query](http://www.lucenetutorial.com/lucene-query-syntax.html) - a search term that allows for logical operators. Examples: * `OR` - The union of two search results. `btc OR bitcoin` returns the documents that contain at least one of the words `btc` and `bitcoin` * `AND` - The intersection of two search results. `btc AND moon` returns the documents that contain both of the words `btc` and `moon` at the same time. * `NOT` - Filter out documents that contain a given search term. `btc NOT lambo` returns the documents that contain the word `btc` and does not contain the word `lambo` * `?` - A wildcard search. `?` in the search term means that it can match any character. For example the query `btc AND 1?k` will be the combined result of `btc AND 10k`, `btc AND 11k`, ..., `btc AND 19k` (but also nonsense like `btc AND 1sk`, `btc AND 1Ak`, etc. will be matched) * Many other operators can be used, documentation for which can be found in the lucene query syntax documentation. The operators can be combined and higher precedence can be expressed by using parentheses `(btc OR bitcoin) AND moon NOT lambo` - it will result in all the documents that contain either the words `btc` and `moon` or the words `bitcoin` and `moon` in one document, excluding any documents that contain the word `lambo`. We constantly update our labels which helps us to keep labels as fresh as possible but result historical data changes. Any modifications to labels, social sources, or relevant jobs will prompt recalculation for the previous month's data. Within a 12 hour period, metric can be supplemented with new data. * * * [](https://academy.santiment.net/metrics/social-volume/#access) Access ---------------------------------------------------------------------- [Restricted Access](https://academy.santiment.net/metrics/details/access#restricted-access) . * * * [](https://academy.santiment.net/metrics/social-volume/#measuring-unit) Measuring Unit -------------------------------------------------------------------------------------- Amount of documents that mention the given text pattern. * * * [](https://academy.santiment.net/metrics/social-volume/#data-type) Data Type ---------------------------------------------------------------------------- [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/social-volume/#change-metrics) Change Metrics -------------------------------------------------------------------------------------- [Change Metrics](https://academy.santiment.net/metrics/details/change_metrics/) * * * [](https://academy.santiment.net/metrics/social-volume/#frequency) Frequency ---------------------------------------------------------------------------- [Five-Minute Intervals](https://academy.santiment.net/metrics/details/frequency#five-minute-frequency) * * * [](https://academy.santiment.net/metrics/social-volume/#latency) Latency ------------------------------------------------------------------------ [Social Data Latency](https://academy.santiment.net/metrics/details/latency#social-data-latency) * * * [](https://academy.santiment.net/metrics/social-volume/#available-assets) Available Assets ------------------------------------------------------------------------------------------ Available for [these assets](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22social_volume_total%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) > Note: `social_volume_total` metric and all metrics for a specific source are available for the same set of assets. * * * [](https://academy.santiment.net/metrics/social-volume/#sanbase) Sanbase ------------------------------------------------------------------------ Combined Social Volume from all sources for an asset can be seen on a [project's page](https://app.santiment.net/charts) . Social Volume for arbitrary search terms can be viewed from the [trends page](https://app.santiment.net/social-trends) ![trends page](https://academy.santiment.net/metrics/social-volume/trends-page.png) The combined social volume from all sources is displayed. From the bottom of the page social volume for a specific source can be displayed, too. ![social volume\ search term](https://academy.santiment.net/metrics/social-volume/social-volume-search-term.png) [](https://academy.santiment.net/metrics/social-volume/#sanapi) SanAPI ---------------------------------------------------------------------- Available under the `social_volume_total` and `social_volume_` names, where the available sources are: * 4chan * telegram * reddit * twitter * bitcointalk * youtube\_videos * farcaster * total (combines all sources) ### [](https://academy.santiment.net/metrics/social-volume/#social-volume-for-an-asset) Social Volume for an asset 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22social_volume_total%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20selector%3A%20%7B%20slug%3A%20%22santiment%22%20%7D%0A%20%20%20%20%20%20from%3A%20%222020-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-01-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** * * * ### [](https://academy.santiment.net/metrics/social-volume/#social-volume-for-arbitrary-search-term) Social Volume for arbitrary search term 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22social_volume_telegram%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20selector%3A%20%7B%20text%3A%20%22btc%20AND%201%3Fk%22%20%7D%0A%20%20%20%20%20%20from%3A%20%222020-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-01-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** * * * ### [](https://academy.santiment.net/metrics/social-volume/#market-social-volume) Market Social Volume There is an option to get Market Social Volume 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22social_volume_telegram%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20selector%3A%20%7B%20slug%3A%20%22crypto_market%22%20%7D%0A%20%20%20%20%20%20from%3A%20%222020-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-01-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** [](https://academy.santiment.net/metrics/social-volume/#full-list-of-metrics) Full list of metrics -------------------------------------------------------------------------------------------------- The full list of Social Volume metrics is: Open Metrics List * social\_volume\_4chan * social\_volume\_bitcointalk * social\_volume\_reddit * social\_volume\_telegram * social\_volume\_total * social\_volume\_twitter * social\_volume\_youtube\_videos * social\_volume\_farcaster Open Change Metrics List * social\_volume\_total\_change\_1d * social\_volume\_total\_change\_30d * social\_volume\_total\_change\_7d Updated 11 minutes ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Getting started for traders | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/for-traders/#getting-started-for-traders) Getting started for traders ====================================================================================================== Santiment is an all-in-one market behavior and network intelligence platform for cryptocurrencies. As a trader, our tools can help you identify, contextualize, and eventually - predict market behavior. All Santiment tools and products serve a singular purpose - to help users understand the behavioral patterns and activities of crucial market stakeholders. Instead of relying on pricing data, which is notoriously prone to manipulation in crypto, our indicators and custom trading strategies leverage on-chain data, as well as custom social and development information collected and processed by Santiment. This also means that many of our metrics are entirely custom-built and unavailable anywhere else. You can find out more about our data feeds on [SanAPI page](https://api.santiment.net/) . [](https://academy.santiment.net/for-traders/#use-cases) Use cases ------------------------------------------------------------------ As a general overview, Santiment tools can enhance and complement your trading in several principal ways: [](https://academy.santiment.net/for-traders/#spot-tops-and-exit-opportunities) Spot tops and exit opportunities ---------------------------------------------------------------------------------------------------------------- A number of our metrics have proven highly effective in signalling forming tops and impending corrections. Here’s just a few examples: \-> Using our social data, we found that extreme spikes in a coin’s social volume during a rally are often a reliable indicator of local tops. This is especially the case with mid and low-cap coins, who mostly ever attract ‘mainstream’ crypto attention during breakouts, so the increased social chatter is almost always pump-related. This period of ‘peak hype’ for a coin is an exceedingly risky time to enter into position - or not exit the one you’re already in. On Sanbase, you can subscribe to alerts whenever a coin you’re interested in experiences a surge in social volume, signaling a correction. Our [Social Trends tool](https://app.santiment.net/social-trends) lets you view any coin’s social volume over time to prove the effectiveness of this approach. Example: MATIC ![](https://academy.santiment.net/for-traders/image7.png) Example: NEO ![](https://academy.santiment.net/for-traders/image6.png) Example: Tezos ![](https://academy.santiment.net/for-traders/image8.png) \-> Another custom Santiment metric - **Mean Dollar Invested Age** - has been a reliable top indicator for Bitcoin over its entire lifespan. Mean dollar invested age calculates how long each Bitcoin has stayed in its current address, and then computes the average ‘age’ of all money (expressed in dollars) used to buy Bitcoins. In other words, a rising slope on the MDIA chart indicates hodler accumulation, while dips indicate sudden movements of previously idle coins. Every major Bitcoin top so far was accompanied by a significant drop in mean dollar age: ![](https://academy.santiment.net/for-traders/image2.png) There are dozens of examples of different Santiment metrics being able to predict tops. Check out the ‘Metrics’ tab on the Academy’s homepage for more use cases and metric tutorials. [](https://academy.santiment.net/for-traders/#spot-bottoms-and-entry-opportunities) Spot bottoms and entry opportunities ------------------------------------------------------------------------------------------------------------------------ While still relatively sparse compared to our top indicators, we have also started building out our repository of reliable bottom indicators and entry point signals. Like the above, many of these are exclusive to Santiment and are a result of rigorous backtesting and analysis by our data science team. For instance: \-> The MVRV Long/Short Divergence is a custom indicator built atop the MVRV ratio, a popular metric that calculates the average profit or loss across all coin holders. In short, the MVRV Long/Short Divergence calculates the difference in the MVRV ratio of longtime holders and the MVRV ratio of ‘new money’ to identify potential deviations. You can read more on the exact methodology [here](https://insights.santiment.net/read/btc's-mvrv-long%252Fshort-difference-waves-a-bullish-flag-5620) . Historically, whenever the Long/Short Divergence line crossed 0, it indicated an end of a bear cycle for Bitcoin and jumpstarted the next bull cycle. The last time this indicator crossed 0 was on May 7th 2019 when Bitcoin was around $5830. Within a week, it broke $8000: ![](https://academy.santiment.net/for-traders/image4.png) \-> We have recently developed another novel bottom indicator while examining the divergences in price and on-chain activity, namely daily active addresses (DAA for short) You can read the full methodology [in our insight](https://insights.santiment.net/read/price---daily-addresses-divergence%3A-%0Aa-primer-on-on-chain-trading-strategies-2222) . In short, at times when the asset’s price trended downwards while the amount of DAA shifted in the opposite direction (above a certain angle/threshold), this divergence has often presented very effective entry points for Bitcoin, Ethereum and other crypto assets in the past. The opposite trend also proved a potent top indicator on many occasions: ![](https://academy.santiment.net/for-traders/image9.png) This strategy is currently being integrated into Sanbase - in the meantime, if you’d like access to future Price-DAA Divergence signals, you can email us at [\[email protected\]](https://academy.santiment.net/cdn-cgi/l/email-protection) for more information. [](https://academy.santiment.net/for-traders/#identify-and-monitor-volatility-markers) Identify and monitor volatility markers ------------------------------------------------------------------------------------------------------------------------------ Not all metrics need to tell you if the price is likely to go ↑ or ↓ in order to be effective. Several of our on-chain and social indicators also serve to alert you of major behavioral shifts or trend reversals among market participants. For example, our Token Age Consumed metric tracks the activity of coins based on how long they’ve stayed in their current wallets. Spikes on the TAC chart indicate the movement of previously idle coins, i.e. those owned by longterm HODLers or even ICO investors. Depending on general market conditions and recent PA, this kind of holder behavior can mean different things, but it’s almost always an omen of growing instability. The spikes in TAC can precede explosive growth or extreme downward pressure, making it a great starting point for further analysis to decide which is more likely. For instance, we recently wrote about elevated activity on Bitcoin’s Token Age Consumed graph, suggesting that longtime HODLers are starting to move their coins and warning of volatility ahead: ![](https://academy.santiment.net/for-traders/image10.png) At the time of writing, Bitcoin was in a week-long consolidation mode and trading in the $8300-$8500 range. Within days of the article, Bitcoin first dropped more than % down to $7475, only to then grow by 28.6% in 24 hours, finally slowing down at $9650. Volatility markers are used most effectively as an initial indicator of upcoming trend reversals, a starting point that you can build upon and leverage by analyzing additional metrics, signals and information. [](https://academy.santiment.net/for-traders/#study-and-contextualize-market-activity) Study and contextualize market activity ------------------------------------------------------------------------------------------------------------------------------ Finally, Santiment tools do a lot more than inform you of - and enable you to react to - prospective exit and entry points, or help you trade market anomalies. Many of our metrics and indicators warrant deep analysis and close study if you truly want to understand crypto market behavior, network activity or crowd sentiment. For example, if you looked at pure on-chain transaction volumes for Ethereum over its lifsepan, you’d be forgiven if you assumed that the network suffered mass exodus since its 2018 top, and is currently a shell of its former self: ![](https://academy.santiment.net/for-traders/image11.png) This is why deep network analysis is so important for successful traders. Compare the above graph with our Token Velocity chart for Ethereum, which measures how often each token is used in daily transactions: ![](https://academy.santiment.net/for-traders/image1.png) Higher token velocity means that the same token is used in transactions more often. You can notice the same steep drop-off in ETH’s velocity around the start of 2018. This heightened activity (and subsequent dip) correlates strongly with the huge ETH mixer that operated between March 2017-2018, artificially inflation on-chain trx volumes by moving the same coins many times over. Once the mixer was liquidated, token velocity toppled back to ‘normal’ levels (as tokens weren’t mixed as much anymore), where it’s remained ever since. This lets us know that the decline in trx volume wasn’t due to speculative, but rather technical reasons, allowing us to better understand - and valuate the network. Speaking of valuation metrics, Santiment offers a number of highly effective long-term indicators of project health. These will not tell you where the price is headed short-term, but it will give you a strong sense of the project’s well-being, adoption and ongoing development - all crucial longterm investment factors. For example, network growth (number of new addresses created on the network daily) is a strong on-chain proxy for project adoption over time. Compare the network growth of a project with strong community backing like BAT, which continues to add hundreds of new addresses to its network each day: ![](https://academy.santiment.net/for-traders/image3.png) To a wasteland that is hundreds of failed altcoins, whose only real on-chain activity occurred around the ICO days, and has since fallen to oblivion: ![](https://academy.santiment.net/for-traders/image5.png) Which project are you more likely to invest in? Updated 1 month ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Sanbase | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources * [Go to Sanbase](https://app.santiment.net/) [](https://academy.santiment.net/sanbase/#sanbase) Sanbase ========================================================== Sanbase is a platform designed for in-depth coin analysis, low-latency signals, and asset watchlists. Here are some of the key features you can explore: * [Account Settings](https://academy.santiment.net/sanbase/account-settings/) : Manage your account settings here. * [Alerts](https://academy.santiment.net/sanbase/alerts-page/) : Here, you can create and manage your own alerts or subscribe to existing alerts from other users. * [Assets Overview page](https://academy.santiment.net/sanbase/assets-page/) : This page provides an overview of your watchlists, screeners, and common categories. * [Insights](https://academy.santiment.net/sanbase/insights/) : This feature allows you to create note-like posts, share them with the community, or browse existing posts. * [Keyboard Shortcuts](https://academy.santiment.net/sanbase/keyboard-shortcuts/) : Learn the keyboard shortcuts to navigate Sanbase more efficiently. * [Logging into Sanbase](https://academy.santiment.net/sanbase/logging-into-sanbase/) : Find out how to log into your Sanbase account. * [Request to Display New Project](https://academy.santiment.net/sanbase/requesting-display-new-project/) : Learn how to request a new project display on Sanbase. * [Social Tool](https://academy.santiment.net/sanbase/social-tool/) : This tool allows you to monitor interest in any topic across dedicated cryptocurrency social channels, including over 1000 Telegram groups, Discord servers, crypto subreddits, Twitter accounts, and more. * [Social Trends](https://academy.santiment.net/sanbase/emerging-trends-page/) : This feature contains the `Top 10` trending words in crypto, providing a quick overview of the top developing topics in the crypto world at the moment. Updated 2 years ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Crypto Academy: Learn How to Analyze Cryptocurrency Market ![](https://academy.santiment.net/static/tutle-waving-6cc3cabd20e1cf833ef42429054c69bc.svg) Hi, I’m Turtoshi — your AI guide to Academy =========================================== What is Santiment known forHow can Santiment help me become profitable?How can I use MVRV to identify tops and bottoms?What is dev activity metric? #### Getting started [### Getting Started With Santiment\ \ Exploring the purpose and benefits of Santiment, this document highlights the available tools and provides guidance on effectively utilizing them.](https://academy.santiment.net/santiment-introduction/) [### For Traders\ \ Explanations, tutorials and use cases for Santiment metrics and tools. Learn how to use our platform to better understand market behavior, network activity and stakeholder trends.](https://academy.santiment.net/for-traders/) [### For Developers\ \ Technical documentation on Santiment metrics and indicators. Understand the calculations, logic and algorithms behind our metrics - many of them custom-built by the Santiment Team.](https://academy.santiment.net/for-developers/) #### Guides [#### Education and Use cases\ \ Examples and use cases \ for Santiment metrics](https://academy.santiment.net/education-and-use-cases/) [#### Sanbase\ \ Our crypto analytics \ & behavior platform](https://academy.santiment.net/sanbase/) [#### Santiment Queries\ \ Our database explorer \ & research tool](https://academy.santiment.net/santiment-queries/) [#### SanAPI\ \ Our API, available metrics \ & documentation](https://academy.santiment.net/sanapi/) [#### Sansheets\ \ Our Spreadsheets plugin \ for Santiment data](https://academy.santiment.net/sansheets/) [#### Products and Plans\ \ On the Santiment suite \ and available plans](https://academy.santiment.net/products-and-plans/) [#### SAN Tokens\ \ Use cases, roadmap \ and where to buy](https://academy.santiment.net/san-tokens/) [#### Glossary\ \ Introduction to all relevant \ terms and concepts](https://academy.santiment.net/glossary/) [#### Youtube Videos\ \ Santiment webinars, video \ tutorials and more](https://academy.santiment.net/youtube-videos/) #### References [#### Metrics\ \ Introduction to Santiment's on-chain, social and development indicators](https://academy.santiment.net/metrics/) [#### Changelog\ \ Development updates, new features and other platform-wide improvements](https://academy.santiment.net/changelog/) [#### Labels\ \ List and descriptions of all address labels on Santiment](https://academy.santiment.net/labels/) [#### Signals\ \ Directory of key stakeholder data anomalies available on Santiment](https://academy.santiment.net/signals/) [### Join our discord!\ \ Talk directly with the Santiment Team](https://santiment.net/discord) [### Contact us\ \ Reach out to us directly via email](https://app.santiment.net/support) --- # Santiment Queries | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/santiment-queries/#santiment-queries) Santiment Queries ======================================================================================== > 👉 **We no longer offer this product, but still support it for legacy users** 👈 [Santiment Queries](https://app.santiment.net/queries) gives access to a Clickhouse Database cluster via SQL interface that holds crypto-related on-chain, financial, social and development activity data. * [Introduction](https://academy.santiment.net/santiment-queries/introduction/) gives information what this tool is about and why it exists. * [Exploration](https://academy.santiment.net/santiment-queries/exploration/) shows how to navigate the database and explore the tables structure. * [Writing SQL Queries](https://academy.santiment.net/santiment-queries/writing-sql-queries/) is a comprehensive guide to your first steps in writing SQL queries using Clickhouse SQL and Santiment datasets. * [Rate Limiting and Credits Cost](https://academy.santiment.net/santiment-queries/rate-limits-and-credits-cost/) describes what limits are applied when you run queries. * [API Access](https://academy.santiment.net/santiment-queries/api-access/) shows how to execute the queries using the API instead of the web interface. * [Prices Tables Overview](https://academy.santiment.net/santiment-queries/prices-tables/) gives information about the tables related to prices, trading volume and marketcap. * [Pre-computed Metrics Tables Overview](https://academy.santiment.net/santiment-queries/metric-tables/) provides info about fetching a wide range of pre-computed Santiment metrics. * [Bridge Transactions Table Overview](https://academy.santiment.net/santiment-queries/bridges/) show how to gather data on cryptocurrency exchanges across various blockchain networks. * [Lending Pools Overview](https://academy.santiment.net/santiment-queries/lending-pools/) tracks the deposits, borrows, repayments, withdraws and liquidate actions happened on lending protocols. * [DEX Pools Overview](https://academy.santiment.net/santiment-queries/dex-pools/) gives information about the dex pools tables in Santiment Queries. * [NFT Tables Overview](https://academy.santiment.net/santiment-queries/nft-tables/) gives information about the nft related tables in Santiment Queries. * [XRPL Tables Overview](https://academy.santiment.net/santiment-queries/xrpl-tables/) gives information about the tables for the XRPL chain in Santiment Queries. Updated 2 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Education and Use Cases | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/education-and-use-cases/#education-and-use-cases) Education and Use Cases ========================================================================================================== ###### Alerts * [Alerts - Age Consumed Example](https://academy.santiment.net/education-and-use-cases/alerts-on-sanbase/) * [Alerts - Social Trends/Trending Words Example](https://academy.santiment.net/education-and-use-cases/social-trends-alerts/) * [Alerts - Whale Activity Example](https://academy.santiment.net/education-and-use-cases/whale-alert/) ###### Market Analysis Examples * [Case Study 1: DeFi liquidations and Sentiment Ratio for Dip Buying](https://academy.santiment.net/education-and-use-cases/case-study-liquidations-and-sentiment-ratio/) * [Case Study 2: NRPL and 3y MVRV to Spot Macro Cycle Bottoms](https://academy.santiment.net/education-and-use-cases/case-study-2-nrpl-and-3ymvrv/) * [Case Study 3: Social Volume Indicates a Top](https://academy.santiment.net/education-and-use-cases/case-study-social-volume/) * [Case Study 4: Using Retail Balances for Profit-Taking Analysis](https://academy.santiment.net/education-and-use-cases/case-study-retail-profit-taking/) * [Timing Market Volatility with Token Age Consumed](https://academy.santiment.net/education-and-use-cases/timing-market-volatility-with-token-age-consumed/) * [Investigate Speculative Activity with Santiment’s Exchange Metrics](https://academy.santiment.net/education-and-use-cases/investigate-speculative-activity-with-santiment%E2%80%99s-exchange-metrics/) * [Price to Daily Addresses Divergence - Primer on On-chain Trading Strategies](https://academy.santiment.net/education-and-use-cases/price-to-daily-addresses-divergence---primer-on-on-chain-trading-strategies/) * [Trading and Transaction Volume](https://academy.santiment.net/education-and-use-cases/trading-and-transaction-volume/) * [Understanding Long-Term Market Trends and Cycles](https://academy.santiment.net/education-and-use-cases/understanding-long-term-market-trends-and-cycles/) * [Understanding Short-Term Market Trends](https://academy.santiment.net/education-and-use-cases/understanding-short-term-market-trends/) * [Understanding Crypto Market Cycles Through Lending Metrics](https://academy.santiment.net/education-and-use-cases/understanding-crypto-market-cycles-through-lending-metrics/) * [Understanding Market Expectations Through Historical Crypto Trends](https://academy.santiment.net/education-and-use-cases/understanding-market-expectations-through-historical-crypto-trends/) * [Whale monitoring to predict Crypto's next moves](https://academy.santiment.net/education-and-use-cases/whale-monitoring-to-predict-crypto-next-moves/) ###### Pro Reports * [Santiment Pro Report Samples](https://academy.santiment.net/education-and-use-cases/santiment-pro-reports-samples/) ###### Jupyter Notebooks Examples * [Santiment Hands-On Tutorial](https://github.com/santiment/san-sdk/blob/master/ICDM_2019/ICDM.ipynb) * [Correlation Analysis Between Bitcoin and Gold](https://github.com/santiment/san-sdk/blob/master/correlation-analysis/BTC%20vs%20GOLD.ipynb) * [Backtesting Trading Based on GitHub Data](https://github.com/santiment/san-sdk/blob/master/example-backtesting-with-sanpy/Backtest_GitHub_Activity_Portfolio.ipynb) * [Stablecoin Comparisons](https://github.com/santiment/san-sdk/blob/master/example-stablecoin-analysis/stablecoin%20comparison.ipynb) * [How to Spot Tops with Price-Network Activity Divergences](https://academy.santiment.net/education-and-use-cases/how-to-spot-tops-with-price---network-activity-divergences/) ###### Other * [SanR - Practice Makes Perfect](https://academy.santiment.net/education-and-use-cases/sanr-practice-makes-perfect/) Updated 1 month ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # SAN tokens | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/san-tokens/#san-tokens) SAN tokens =================================================================== [SAN token](https://etherscan.io/token/0x7c5a0ce9267ed19b22f8cae653f198e3e8daf098) is an ERC-20 token issued by Santiment on the Ethereum blockchain. Santiment is a market data and analytic research platform that aims to help crypto beginners and experts by providing in-depth and accessible analyses of the market's condition at any given time. [](https://academy.santiment.net/san-tokens/#understanding-santiment-business-model) Understanding Santiment business model --------------------------------------------------------------------------------------------------------------------------- Santiment is at the forefront of a strategic evolution, pivoting from a traditional Web 2.0 subscription model towards a Web 3.0 framework, with a stronger integration of SAN token economy. During the transition, access to a suite of tools, data, and metrics remains versatile. As we navigate through this transition, anticipate a gradual shift where the utility of SAN token will become central to the operation and governance of Santiment. Stay informed and be part of the journey towards a token-centric future. [](https://academy.santiment.net/san-tokens/#how-to-buy-san-tokens) [How to Buy SAN Tokens](https://academy.santiment.net/san-tokens/how-to-buy-san-tokens/) ------------------------------------------------------------------------------------------------------------------------------------------------------------- Learn how to acquire SAN tokens with our simple 3-step guide and enjoy the benefits of holding them. You can swap ETH or any ERC-20 tokens for SAN tokens. We are also working on an improved method to purchase SAN tokens directly on our website using a credit card. [](https://academy.santiment.net/san-tokens/#connect-a-wallet-to-your-sanbase-account) [Connect a Wallet to Your Sanbase Account](https://academy.santiment.net/san-tokens/connect-a-wallet-to-the-sanbase-account/) --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- Easily connect your cryptocurrency wallet and SAN token balance to your Sanbase account by following our straightforward and comprehensive instructions. [](https://academy.santiment.net/san-tokens/#san-token-holding-benefits) [SAN Token Holding Benefits](https://academy.santiment.net/san-tokens/san-tokens-holding-benefits/) ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- Discover all the benefits provided to users who hold, stake, and contribute to SAN token liquidity. This includes various levels of discounts, the option to pay by burning SAN tokens, and even FREE access to a Sanbase PRO subscription. Updated 1 year ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Glossary of API Terms | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/glossary/#glossary-of-api-terms) Glossary of API Terms ======================================================================================= This glossary provides definitions for terms frequently used throughout our documentation. * [GraphQL-related](https://academy.santiment.net/glossary/#graphql-related) * [Query](https://academy.santiment.net/glossary/#query) * [Field](https://academy.santiment.net/glossary/#field) * [Santiment-related](https://academy.santiment.net/glossary/#santiment-related) * [Metric](https://academy.santiment.net/glossary/#metric) * [Asset](https://academy.santiment.net/glossary/#asset) * [Slug](https://academy.santiment.net/glossary/#slug) * [Interval](https://academy.santiment.net/glossary/#interval) * [ISO8601](https://academy.santiment.net/glossary/#iso8601) * [API Key](https://academy.santiment.net/glossary/#api-key) [](https://academy.santiment.net/glossary/#graphql-related) GraphQL-related =========================================================================== More about all the GraphQL-related terms can be found on the [GraphQL documentation](https://graphql.org/learn/) website. [](https://academy.santiment.net/glossary/#query) query ------------------------------------------------------- A "query" in the context of [GraphQL](https://graphql.org/learn/) refers to a read operation. For instance, in the example below, `getAccessRestrictions` is the query. Essentially, in a GraphQL request, the `query` is the function that is invoked. 1 2 3 4 5 6 7 8 9 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getAccessRestrictions%20%7B%0A%20%20%20%20name%0A%20%20%20%20type%0A%20%20%20%20isRestricted%0A%20%20%20%20restrictedFrom%0A%20%20%20%20restrictedTo%0A%20%20%7D%0A%7D) ** A single GraphQL request can accommodate multiple queries. In the following example, there are two `getMetric` queries. To avoid name collision in the returned result, each query is given an alias. 1 2 3 4 5 6 7 8 9 10 11 12 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20price_usd_min_interval%3A%20getMetric(metric%3A%20%22price_usd%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20minInterval%0A%20%20%20%20%7D%0A%20%20%7D%0A%20%20nvt_min_interval%3A%20getMetric(metric%3A%20%22nvt%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20minInterval%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D) ** If different queries are used, aliases can be omitted. In the next example, the queries are `getMetric` and `currentUser`. 1 2 3 4 5 6 7 8 9 10 11 12 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22price_usd%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20minInterval%0A%20%20%20%20%7D%0A%20%20%7D%0A%20%20currentUser%20%7B%0A%20%20%20%20id%0A%20%20%20%20username%0A%20%20%20%20email%0A%20%20%7D%0A%7D) ** A query can either return the specified result directly or provide a set of fields that the user can choose from. [](https://academy.santiment.net/glossary/#field) Field ------------------------------------------------------- The term refers to a [GraphQL field](https://graphql.org/learn/queries/#fields) . Fields are used to specify which parts of a complex object should be returned in a query. The following examples demonstrate the use of different fields in the same `getMetric` query. In the first example, the `timeseriesData` field is used. The `datetime` and `value` are also fields. This illustrates that fields can either have arguments or not. 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22active_addresses_24h%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22ethereum%22%0A%20%20%20%20%20%20from%3A%20%222019-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222019-01-01T03%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%2230m%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** In the second example, the `aggregatedTimeseriesData` field is used. 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22active_addresses_24h%22)%20%7B%0A%20%20%20%20aggregatedTimeseriesData(%0A%20%20%20%20%20%20slug%3A%20%22ethereum%22%0A%20%20%20%20%20%20from%3A%20%222019-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222019-01-01T03%3A00%3A00Z%22%0A%20%20%20%20%20%20aggregation%3A%20AVG%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** [](https://academy.santiment.net/glossary/#santiment-related) Santiment-related =============================================================================== [](https://academy.santiment.net/glossary/#metric) Metric --------------------------------------------------------- In the context of Santiment's API, a metric is a term with a specific meaning. It refers to a set of data points that carry a particular significance. There are two types of metrics: [timeseries metrics](https://academy.santiment.net/metrics/details/data-type#timeseries-data) and [histogram metrics](https://academy.santiment.net/metrics/details/data-type#histogram-data) . Consider the following example where `nvt` is the metric and `getMetric` is the query. 1 2 3 4 5 6 7 8 9 10 11 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22nvt%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22santiment%22%0A%20%20%20%20%20%20from%3A%20%222019-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222019-09-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20includeIncompleteData%3A%20true%0A%20%20%20%20%20%20interval%3A%20%227d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** In some instances, the query and the metric are identical. In the next example, `historicalBalance` is both the query and the metric. This scenario occurs when a query fetches exactly one metric (the metric argument is implicit), unlike `getMetric` where the metric argument is explicitly passed with the `metric` argument. 1 2 3 4 5 6 7 8 9 10 11 12 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20historicalBalance(%0A%20%20%20%20selector%3A%20%7B%20slug%3A%20%22santiment%22%2C%20infrastructure%3A%20%22ETH%22%20%7D%0A%20%20%20%20address%3A%20%220xA0D8F33Ef9B44DaAE522531DD5E7252962b09207%22%0A%20%20%20%20from%3A%20%222019-01-01T00%3A00%3A00Z%22%0A%20%20%20%20to%3A%20%222019-09-01T00%3A00%3A00Z%22%0A%20%20%20%20interval%3A%20%2230d%22%0A%20%20)%20%7B%0A%20%20%20%20datetime%0A%20%20%20%20balance%0A%20%20%7D%0A%7D) ** [](https://academy.santiment.net/glossary/#asset) Asset ------------------------------------------------------- An asset refers to any cryptocurrency or crypto token that can be associated with a specific price. Examples of assets include Bitcoin, Ethereum, and Santiment tokens. For more detailed information, please visit our [glossary on assets](https://academy.santiment.net/glossary/asset/) . [](https://academy.santiment.net/glossary/#slug) Slug ----------------------------------------------------- A slug is a unique string that identifies an [asset](https://academy.santiment.net/glossary/asset/) . You can find the slug of various projects, along with their names, tickers, and other data, by using the [allProjects API](https://api.santiment.net/graphiql?query=%7B%0A%20%20allProjects%20%7B%0A%20%20%20%20slug%0A%20%20%20%20name%0A%20%20%20%20ticker%0A%20%20%20%20infrastructure%0A%20%20%20%20mainContractAddress%0A%20%20%7D%0A%7D%0A) . [](https://academy.santiment.net/glossary/#interval) Interval ------------------------------------------------------------- An interval is a representation of time intervals such as 5 minutes, 12 hours, 10 days, or 4 weeks. There are two types of interval representations: fixed time intervals and functions. A fixed time interval is a string that begins with a number and is followed by one of these suffixes: * `s` - second * `m` - minute * `h` - hour * `d` - day * `w` - week Here are examples of intervals: * 5 minutes - `5m` * 12 hours - `12h` * 10 days - `10d` * 4 weeks - `4w` > **Note:** There is no suffix for specifying months because a month does not contain a fixed number of days. The second type of interval representation is through function names. Functions can achieve two main objectives that fixed intervals cannot: * Functions can create non-fixed interval ranges, such as months, which can have between 28 and 31 days. * Functions can change the alignment. For example, if the requirement is not just 7 days, but also for the time intervals to start on Monday or Sunday. The following functions are supported: * toStartOfHour * toStartOfDay * toMonday * toStartOfWeek (aligns dates on Sundays) * toStartOfMonth * toStartOfQuarter * toStartOfYear Intervals are used when fetching timeseries data. If the raw data is available at 5-minute intervals but you want to fetch it daily, you should provide `interval: "1d"` as a parameter. In this case, the default aggregation will be applied to all 288 5-minute data points in a day to compute the value for the entire day. The type of aggregation varies based on the metric. In some cases, taking the average or the last value is required (price), while in other cases, taking the sum of all values is necessary (transaction volume), and so on. [](https://academy.santiment.net/glossary/#iso8601) ISO8601 ----------------------------------------------------------- The API uses the ISO8601 format for date and time. The format is structured as follows: `--T::Z`. For instance, January 10th, 2019 at 12:34:56 would be represented as `2019-01-10T12:34:56Z`. [](https://academy.santiment.net/glossary/#api-key) API Key ----------------------------------------------------------- Your API key is essential for accessing the premium features provided by our API. For more detailed information, please refer to the [API Authentication](https://academy.santiment.net/sanapi/accessing-the-api/#authentication) section. Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Videos | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources * [Go to Youtube channel](https://www.youtube.com/c/santimentnetwork) [](https://academy.santiment.net/youtube-videos/#videos) Videos =============================================================== * [The Santiment Youtube Channel](https://www.youtube.com/@Santimentfeed/videos) has many videos not necessarily featured here. * [Tutorials](https://academy.santiment.net/youtube-videos/tutorials/) * [Full Walkthroughs](https://academy.santiment.net/youtube-videos/walkthroughs/) * [Webinars](https://academy.santiment.net/youtube-videos/webinars/) Updated 2 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Sansheets - Crypto Asset Data for Google Sheets | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources * [Go to Sansheets](https://sheets.santiment.net/) [](https://academy.santiment.net/sansheets/#sansheets-crypto-asset-data-for-google-sheets) Sansheets - Crypto Asset Data for Google Sheets ========================================================================================================================================== Access on-chain, social, development activity, prices, and volume data with Sansheets! [](https://academy.santiment.net/sansheets/#getting-started) Getting Started ---------------------------------------------------------------------------- * [Setting up Sansheets](https://academy.santiment.net/sansheets/setting-up/) * [Adding an API key to Sansheets](https://academy.santiment.net/sansheets/adding-an-api-key/) * [How to create a correlation matrix like Cryptowatch.io](https://academy.santiment.net/sansheets/assets-correlation-matrix-google-sheets/) [](https://academy.santiment.net/sansheets/#api) API ---------------------------------------------------- * [List of All Functions](https://academy.santiment.net/sansheets/functions/) [](https://academy.santiment.net/sansheets/#pro-templates) Pro Templates ------------------------------------------------------------------------ * [Descriptions for all Pro Templates](https://academy.santiment.net/sansheets/pro-templates/) Updated 2 years ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Changelog | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources Development changelog ===================== Keep track of development updates, new product features and other items from our changelog. We update this page every two weeks or more frequently. * [Assets](https://academy.santiment.net/changelog/assets) * [Metrics](https://academy.santiment.net/changelog/metrics) * [Legacy Changelog](https://academy.santiment.net/changelog/legacy-changelog) [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # MVRV - Market Value To Realized Value | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/mvrv/#mvrv-market-value-to-realized-value) MVRV - Market Value To Realized Value ========================================================================================================================= [](https://academy.santiment.net/metrics/mvrv/#definition) Definition --------------------------------------------------------------------- MVRV (Market Value to Realized Value) ratio is defined as an asset's market capitalization divided by realized capitalization. [](https://academy.santiment.net/metrics/mvrv/#mvrv-ratio-overview) MVRV Ratio Overview --------------------------------------------------------------------------------------- MVRV shows the ratio between the current price and the average price of every coin/token acquired. The more the ratio increases, the more people will be willing to sell as the potential profits increase. The value of MVRV gives an idea of how much overvalued or undervalued an asset is. [](https://academy.santiment.net/metrics/mvrv/#how-mvrv-measured) How MVRV Measured ----------------------------------------------------------------------------------- The MVRV Ratio is used as an on-chain indicator for the purpose of studying aggregate investor behaviors as price moves to/from their cost basis. It can be considered as a mean reversion style model, where the Realized Cap (aggregate market cost basis) functions as the mean and MVRV measures deviations from this mean. The value of an asset's given MVRV gives an idea of how much overvalued or undervalued an asset is based on short, mid, or long-term timeframes. An MVRV value of 100% (or 2.0) means that if all holders sell their coins/tokens at the current price, they will generate a 100% (x2) profit on average. The more this ratio increases, the more likely traders have historically demonstrated their willingness to sell. On the other side of the spectrum, a negative MVRV value indicates that the asset is "undervalued" on average. This means that if all coins were sold, most traders will be realizing losses at the asset's current price. MVRV values (regardless of which timeframe) will hover around 0%, assuming the asset has had enough time to normalize after its introduction as a publicly-traded asset. Overall, MVRV shows the average profit/loss of all the coins currently in circulation given the current price. We need to define two terms: * `MV` as in `Market Value` refers to the well-known capitalization. The second part is the * `RV` as in [Realized Value](https://academy.santiment.net/metrics/realized-value/) . It is an alternative to the Market Value where instead of the current price, every coin/token is multiplied by its acquisition price. The definition of MVRV is: [](https://academy.santiment.net/metrics/mvrv/#usage-guide) Usage Guide ----------------------------------------------------------------------- The MVRV ratio allows traders to gauge both actual profitability vs. loss on the network, as well as gauge the inherent degree of fear and greed that comes with it. Assets have different extremes in terms of how far a positive or negative fluctuation in its MVRV can go. And if we measure the coin's current MVRV vs. its lowest and highest points, it's usually fair to make educated presumptions of when price tops and bottoms are forming. ### [](https://academy.santiment.net/metrics/mvrv/#mvrv-bitcoin-chart) MVRV Bitcoin chart ### [](https://academy.santiment.net/metrics/mvrv/#high-mvrv-values-2) High MVRV Values ( > 2 ) MVRV value of 2 means that if all holders sell their coins/tokens at the current price, they will generate an x2 profit on average. ### [](https://academy.santiment.net/metrics/mvrv/#low-mvrv-values-1) Low MVRV Values ( < 1 ) If the MVRV value is between 0 and 1, then the market is "undervalued" on average, meaning most people will realize losses if they all sell their holdings at the current price. [](https://academy.santiment.net/metrics/mvrv/#timebound) Timebound ------------------------------------------------------------------- [Timebound Metrics](https://academy.santiment.net/metrics/details/timebound/) available. The timebound metrics can help exclude the inactive addresses. These metrics are computed the same way as the MVRV metric, with the only difference that they take into account only the coins/tokens that have moved in the desired time range. Examples: `mvrv_usd_365d` is computed on the coins/tokens that moved at least once in the past 365 days. `mvrv_usd_60d` is computed by taking only the coins/tokens that moved at least once in the past 60 days. Comparing timebound MVRV values of different time ranges can clarify how much profit/loss long-term and short-term holders can realize. * * * [](https://academy.santiment.net/metrics/mvrv/#change-metrics) Change Metrics ----------------------------------------------------------------------------- [Change Metrics](https://academy.santiment.net/metrics/details/change_metrics/) * * * ### [](https://academy.santiment.net/metrics/mvrv/#mvrv-long-short-difference) MVRV Long/Short Difference MVRV Long/Short Difference is defined as: Negative values mean that short-term holders will realize higher profits than long-term holders if they sell at a price at this moment. Positive values show the opposite. During strong and long bull runs, this metric tends to grow, and during bear markets it is decreasing. The rationale is that during strong bull runs, the long term holders are determining when the bull run will end when they start selling, while during bear markets, the long term holders are at a loss on average and the short term holders manage to realize profits * * * [](https://academy.santiment.net/metrics/mvrv/#access) Access ------------------------------------------------------------- [Restricted Access](https://academy.santiment.net/metrics/details/access#restricted-access) * * * [](https://academy.santiment.net/metrics/mvrv/#measuring-unit) Measuring Unit ----------------------------------------------------------------------------- Ratio * * * [](https://academy.santiment.net/metrics/mvrv/#data-type) Data Type ------------------------------------------------------------------- [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/mvrv/#frequency) Frequency ------------------------------------------------------------------- All available assets have [Daily Intervals](https://academy.santiment.net/metrics/details/frequency#daily-frequency) A subset of the available assets that consists of some of the bigger assets have [Five-Minute Intervals](https://academy.santiment.net/metrics/details/frequency#five-minute-frequency) * * * [](https://academy.santiment.net/metrics/mvrv/#latency) Latency --------------------------------------------------------------- [On-Chain Latency](https://academy.santiment.net/metrics/details/latency#on-chain-latency) * * * [](https://academy.santiment.net/metrics/mvrv/#available-assets) Available Assets --------------------------------------------------------------------------------- The daily interval MVRV metrics are available for [these assets](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22mvrv_usd%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) The 5-minute MVRV metrics are available for [these assets](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22mvrv_usd_intraday%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) * * * [](https://academy.santiment.net/metrics/mvrv/#sanapi) SanAPI ------------------------------------------------------------- The daily metrics are available under the `mvrv_usd` name under the `mvrv_usd_` name for the timebound metrics. The 5-minute interval metrics are available under the `mvrv_usd_intraday` name under the `mvrv_usd_intraday_` name for the timebound metrics. Example of query for **mvrv\_usd**: 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22mvrv_usd%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22santiment%22%0A%20%20%20%20%20%20from%3A%20%222019-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222019-09-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%227d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Example of query for **mvrv\_usd\_intraday**: 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22mvrv_usd_intraday%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22bitcoin%22%0A%20%20%20%20%20%20from%3A%20%22utc_now-90d%22%0A%20%20%20%20%20%20to%3A%20%22utc_now-30d%22%0A%20%20%20%20%20%20interval%3A%20%223d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Example of query for **timebound MVRV**: 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22mvrv_usd_7d%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22santiment%22%0A%20%20%20%20%20%20from%3A%20%222019-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222019-09-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%227d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Example of query for **MVRV Long/Short Difference** 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22mvrv_long_short_diff_usd%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22santiment%22%0A%20%20%20%20%20%20from%3A%20%222019-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222019-09-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%227d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** [](https://academy.santiment.net/metrics/mvrv/#full-list-of-metrics) Full list of metrics ----------------------------------------------------------------------------------------- The full list of MVRV metrics is: Open Metrics List * mvrv\_long\_short\_diff\_usd * mvrv\_usd * mvrv\_usd\_10y * mvrv\_usd\_180d * mvrv\_usd\_180d\_change\_1d * mvrv\_usd\_180d\_change\_30d * mvrv\_usd\_180d\_change\_7d * mvrv\_usd\_1d * mvrv\_usd\_2y * mvrv\_usd\_30d * mvrv\_usd\_30d\_change\_1d * mvrv\_usd\_30d\_change\_30d * mvrv\_usd\_30d\_change\_7d * mvrv\_usd\_365d * mvrv\_usd\_365d\_change\_1d * mvrv\_usd\_365d\_change\_30d * mvrv\_usd\_365d\_change\_7d * mvrv\_usd\_3y * mvrv\_usd\_5y * mvrv\_usd\_60d * mvrv\_usd\_60d\_change\_1d * mvrv\_usd\_60d\_change\_30d * mvrv\_usd\_60d\_change\_7d * mvrv\_usd\_7d * mvrv\_usd\_7d\_change\_1d * mvrv\_usd\_7d\_change\_30d * mvrv\_usd\_7d\_change\_7d * mvrv\_usd\_90d * mvrv\_usd\_90d\_change\_1d * mvrv\_usd\_90d\_change\_30d * mvrv\_usd\_90d\_change\_7d * mvrv\_usd\_change\_1d * mvrv\_usd\_change\_30d * mvrv\_usd\_change\_7d * mvrv\_usd\_intraday * mvrv\_usd\_intraday\_10y * mvrv\_usd\_intraday\_180d * mvrv\_usd\_intraday\_1d * mvrv\_usd\_intraday\_2y * mvrv\_usd\_intraday\_30d * mvrv\_usd\_intraday\_365d * mvrv\_usd\_intraday\_3y * mvrv\_usd\_intraday\_5y * mvrv\_usd\_intraday\_60d * mvrv\_usd\_intraday\_7d * mvrv\_usd\_intraday\_90d * mvrv\_usd\_z\_score Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # How to Buy SAN Tokens | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/san-tokens/how-to-buy-san-tokens/#how-to-buy-san-tokens) How to Buy SAN Tokens =============================================================================================================== To use SAN tokens with our platform, you need to have them in a MetaMask wallet or a wallet supported by MetaMask (such as Trezor or Ledger). We will outline the three necessary steps to accomplish this. [](https://academy.santiment.net/san-tokens/how-to-buy-san-tokens/#step-1-install-and-set-up-metamask) Step 1: Install and Set Up MetaMask ------------------------------------------------------------------------------------------------------------------------------------------ For instructions on how to install and set up MetaMask, visit [MetaMask.io](https://metamask.io/) . You will need an Ethereum address to hold SAN tokens and interact with the Santiment platform. You can create a new wallet in MetaMask, import an existing wallet, or connect MetaMask to a hardware wallet like **Ledger** or **Trezor**. **Result of Step 1:** Installed and working Metamask [](https://academy.santiment.net/san-tokens/how-to-buy-san-tokens/#step-2-add-funds-to-metamask-wallet) Step 2: Add Funds to MetaMask Wallet -------------------------------------------------------------------------------------------------------------------------------------------- To acquire SAN tokens, you will need to swap them for ETH or another ERC20 token. You can obtain ETH from a centralized exchange like [Bitfinex](https://bitfinex.com/t/ETH:USD) and then transfer it to your MetaMask wallet. **Result of Step 2:** Metamask wallet with ETH or ERC-20 token balance [](https://academy.santiment.net/san-tokens/how-to-buy-san-tokens/#step-3-swap-eth-to-san-tokens) Step 3: Swap ETH to SAN Tokens -------------------------------------------------------------------------------------------------------------------------------- You can use decentralized exchanges or decentralized exchange aggregators to swap ETH or another ERC20 token for SAN tokens. These platforms operate in a similar manner. First, connect your Metamask wallet, and then proceed to swap ETH for SAN tokens. ### [](https://academy.santiment.net/san-tokens/how-to-buy-san-tokens/#decentralized-exchanges) Decentralized Exchanges #### [](https://academy.santiment.net/san-tokens/how-to-buy-san-tokens/#uniswap) Uniswap The SAN token is also available on [Uniswap](https://app.uniswap.org/#/swap?outputCurrency=0x7C5A0CE9267ED19B22F8cae653F198e3E8daf098&inputCurrency=ETH) at competitive rates. ![noborder](https://academy.santiment.net/san-tokens/how-to-buy-san-tokens/Uniswap.png) #### [](https://academy.santiment.net/san-tokens/how-to-buy-san-tokens/#kyber) Kyber San tokens are also available on [Kyber](https://kyber.network/) via [Kyber Swap](https://kyberswap.com/swap/ethereum/eth-to-san) . If you don’t have any crypto, you may get it on [Kyber](https://kyberswap.com/buy-crypto) using your credit card. ![noborder](https://academy.santiment.net/san-tokens/how-to-buy-san-tokens/Kyber.png) #### [](https://academy.santiment.net/san-tokens/how-to-buy-san-tokens/#bancor) Bancor The SAN token is available on [Bancor](https://app.bancor.network/trade?from=0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE&to=0x7C5A0CE9267ED19B22F8cae653F198e3E8daf098) . Once you connect your Metamask, you can [purchase ETH on Bancor](https://app.bancor.network/fiat) using your credit card and then swap it for SAN Tokens. ![noborder](https://academy.santiment.net/san-tokens/how-to-buy-san-tokens/Bancor.png) ### [](https://academy.santiment.net/san-tokens/how-to-buy-san-tokens/#decentralized-exchange-aggregators) Decentralized Exchange Aggregators You can use a decentralized exchange aggregator like [ParaSwap.io](http://app.paraswap.io/) or [1inch.exchange](https://1inch.exchange/) to acquire SAN tokens. Using an aggregator may sometimes provide a better price than using an exchange directly. **Result of Step 3:** Metamask wallet with SAN token balance [](https://academy.santiment.net/san-tokens/how-to-buy-san-tokens/#what-to-do-next) What to do next? ---------------------------------------------------------------------------------------------------- Now, simply [log in with a MetaMask](https://app.santiment.net/login) account that holds SAN tokens. Alternatively, you can [connect your Sanbase account](https://academy.santiment.net/san-tokens/connect-a-wallet-to-the-sanbase-account/) with your MetaMask wallet in the settings. We'll detect the SAN tokens you're holding and grant you access to our discounts, based on the amount of tokens you hold. ###### Here are a few resources you can refer to: 🔮 [Connect a wallet to the Sanbase account](https://academy.santiment.net/san-tokens/connect-a-wallet-to-the-sanbase-account/) 💎 [SAN tokens holding benefits](https://academy.santiment.net/san-tokens/san-tokens-holding-benefits/) Updated 1 year ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Latency | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/details/data-type#latency) Latency =========================================================================== * [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * [Histogram Data](https://academy.santiment.net/metrics/details/data-type#histogram-data) [](https://academy.santiment.net/metrics/details/data-type#timeseries-data) Timeseries Data ------------------------------------------------------------------------------------------- Timeseries data is a sequence taken at successive equally spaced points in time (every 5 minutes, every day, every year, etc.). The metric is represtented as a list of data points, where every point is represented by a tuple containing a `datetime` an a `value`. ### [](https://academy.santiment.net/metrics/details/data-type#example-timeseries-data) Example (timeseries data) The `daily_active_addresses` metric is represented as pairs of date `D` and a number `N` with the following meaning: The count of the unique addresses `N` that participated in at least one transaction, either as sender or receiver, during the day `D`. The daily active addresses for bitcoin in the period April 01 - April 04 is represented as the following list: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 [](https://academy.santiment.net/metrics/details/data-type#histogram-data) Histogram Data ----------------------------------------------------------------------------------------- A histogram is an approximate representation of the distribution of numerical or categorical data. The metric is represented as a list of data points, where every point is represented represented by a tuple containing a `range` an a `value`. ### [](https://academy.santiment.net/metrics/details/data-type#example-histogram-data) Example (histogram data) The `price_histogram` (or `spent_coins_cost`) shows at what price were acquired the coins/tokens transacted on a given day `D`. The metric is represented as a list of price ranges and values with the following meaning: Out of all coins/tokens transacted on day `D`, `value` amount of them were acquired when the price was in the range `range`. On April 07, the bitcoins that circulated during that day were 124k and the average price for the day was $7307\. Out of all of the 124k bitcoins, 13.8k of them were acquired when the price was in the range $8692.08 - $10845.62, so they were last moved when the price was higher. The same logic applies for all of the ranges. 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 Updated 5 years ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Frequency | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/details/frequency#frequency) Frequency =============================================================================== * [Five-minute frequency](https://academy.santiment.net/metrics/details/frequency#five-minute-frequency) * [Hourly frequency](https://academy.santiment.net/metrics/details/frequency#hourly-frequency) * [Eight-hour frequency](https://academy.santiment.net/metrics/details/frequency#eight-hour-frequency) * [Daily frequency](https://academy.santiment.net/metrics/details/frequency#daily-frequency) [](https://academy.santiment.net/metrics/details/frequency#five-minute-frequency) Five-minute frequency ------------------------------------------------------------------------------------------------------- One value is computed for each 5-minute interval and each asset. The date and time is taken according to the UTC timezone. Example: The value of the Transaction Volume metric for Bitcoin on June 10, 2019 will have 288 distinct values for the intervals: * `2019-06-10 00:00:00 UTC` and `2019-06-10 00:04:59 UTC` * `2019-06-10 00:05:00 UTC` and `2019-06-10 00:09:59 UTC` * `2019-06-10 00:10:00 UTC` and `2019-06-10 00:14:59 UTC` ... * `2019-06-10 23:55:00 UTC` and `2019-06-10 23:59:59 UTC` If the data is needed at daily intervals, different metrics have different default and proper aggregations that are applied to get this value. Examples: * Daily Transaction Volume is the `SUM` of all 5-minute interval transaction volumes during the day. * Daily Price in USD can be either `LAST` or `AVG` [](https://academy.santiment.net/metrics/details/frequency#hourly-frequency) Hourly frequency --------------------------------------------------------------------------------------------- One value is computed for every hour of the day. Example: The emerging trends are being computed for every round hour in a day. [](https://academy.santiment.net/metrics/details/frequency#eight-hour-frequency) Eight-hour frequency ----------------------------------------------------------------------------------------------------- One value is computed for every eight hours of the day. Example: The binance funding rate metrics are being computed once every eight hours in a day. [](https://academy.santiment.net/metrics/details/frequency#daily-frequency) Daily frequency ------------------------------------------------------------------------------------------- One value is computed for each day and each asset. The day is taken according to the UTC timezone. Example: The value of the Daily Active Addresses metric for Bitcoin on June 10, 2019 will contain the number of distinct addresses for transfers that happened between 2019-06-10 00:00:00 UTC and 2019-06-10 23:59:59 UTC. Updated 1 year ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Latency | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/details/latency#latency) Latency ========================================================================= * [On-Chain Latency](https://academy.santiment.net/metrics/details/latency#on-chain-latency) * [Funding Rates Latency](https://academy.santiment.net/metrics/details/latency#funding-rates-latency) * [Price Latency](https://academy.santiment.net/metrics/details/latency#price-latency) * [Development Activity Latency](https://academy.santiment.net/metrics/details/latency#development-activity-latency) [](https://academy.santiment.net/metrics/details/latency#on-chain-latency) On-Chain Latency ------------------------------------------------------------------------------------------- In order to compute on-chain data, a number block confirmations are required before fetching the data for a given block. Measured in time: * Bitcoin - Around 30 minutes * Ethereum - Around 5 minutes * Bitcoin Cash - Around 5 minutes * Litecoin - Around 5 minutes * Binance Chain - Around 5 minutes * XRPL Chain - Around 5 minutes After the block is considered confirmed and its data is fetched, the data processing can take anywhere from a few minutes to few hours. The upper limits are: * For 5-minute interval metrics processing the data can take up to 20 minutes most * For daily metrics processing the data can take up to 2 hours [](https://academy.santiment.net/metrics/details/latency#social-data-latency) Social Data Latency ------------------------------------------------------------------------------------------------- Each one of the social data source: * Telegram * Reddit * Bitcointalk * Twitter * 4chan * Youtube Videos is being processed separately and usually doesn't take longer than 1 minute. The emerging trends are computed once per hour so they become available a few minutes after every round hour. The data for assets is usually computed and it takes 20-40 minutes to compute. Data for text terms is computed on-the-fly on the raw data and can be accessed as soon as the text messages are stored in our database. [](https://academy.santiment.net/metrics/details/latency#funding-rates-latency) Funding Rates Latency ----------------------------------------------------------------------------------------------------- The funding rates are updated every 15 minutes [](https://academy.santiment.net/metrics/details/latency#price-latency) Price Latency ------------------------------------------------------------------------------------- The prices are updated every 5 minutes [](https://academy.santiment.net/metrics/details/latency#development-activity-latency) Development Activity Latency ------------------------------------------------------------------------------------------------------------------- The development activity metrics are updated every 1 hour with max delays of 6 hours [](https://academy.santiment.net/metrics/details/latency#daily-metrics-latency) Daily Metrics Latency ----------------------------------------------------------------------------------------------------- The daily metrics have one value per day. The value is finalized at least 1 hour after the day is over, using the UTC timezone. Updated 1 year ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Data Anomaly Overview | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/signals/#data-anomaly-overview) Data Anomaly Overview ====================================================================================== The crypto market is noisy by the minute. We keep it simple: we surface meaningful anomalies from on-chain activity, social signals, and derivatives microstructure, and turn them into clear, ready-to-use signals. Unlike traditional dashboards, we focus on actionability and reliability. Every signal is validated with rigorous statistical tests and out-of-sample checks to reduce false positives. Integrate notifications to fit your workflow—use the actionable anomalies in a way you like. If you’re looking for a systematic way to improve decision quality in a complex market, Data Anomaly is the simplest place to start. * [Large Exchange Transactions 1M](https://academy.santiment.net/signals/large-exchange-transactions-1m/) * [Binance Funding Rate](https://academy.santiment.net/signals/binance-funding-rate/) * [BTC Correlation](https://academy.santiment.net/signals/btc-correlation/) * [Dex Exchanges 1M USD](https://academy.santiment.net/signals/dex-exchanges-1m-usd/) * [ETH Whale Dump](https://academy.santiment.net/signals/eth-whale-dump/) * [Hyperliquid Average Funding Rates](https://academy.santiment.net/signals/hyperliquid-average-funding-rates/) * [Large Transfers](https://academy.santiment.net/signals/large-transfers/) * [Large USDC-USDT Mint](https://academy.santiment.net/signals/large-usdc-usdt-mint/) * [Liquidations](https://academy.santiment.net/signals/liquidations/) * [MVRV Danger (Overvaluation) Zone](https://academy.santiment.net/signals/mvrv-danger-zone/) * [MVRV Opportunity (Undervaluation) Zone](https://academy.santiment.net/signals/mvrv-opportunity-zone/) * [Network Activity - Price Divergence](https://academy.santiment.net/signals/network-activity-price-divergence/) * [Project in Trends](https://academy.santiment.net/signals/project-in-trends/) * [Social Dominance Spike](https://academy.santiment.net/signals/social-dominance-spike/) * [Social-Dev Score](https://academy.santiment.net/signals/social-dev-score/) * [USDC Borrow](https://academy.santiment.net/signals/usdc-borrow/) Deprecated Signals There are signals that have been deprecated, are scheduled for deprecation, or are now available under a new name. Please refrain from using the old signals and migrate to the updated versions as necessary. * [Deprecated Signals](https://academy.santiment.net/signals/deprecated/) Updated 4 days ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Social Data | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/details/social-data/#social-data) Social Data ====================================================================================== [](https://academy.santiment.net/metrics/details/social-data/#definition) Definition ------------------------------------------------------------------------------------ By **Social data**, we consider a set of crypto-related discussions from the internet that we collect and store in the form of text documents. It includes chat conversations, forum posts and comments, tweets, and other pieces of text (usually pretty short). In addition to the text itself, we also store some metadata that depends on the data source: user\_id, hashtags, chat\_title, etc. The **Social data** serves as a base layer for various statistics and metrics that we build on top of it. [](https://academy.santiment.net/metrics/details/social-data/#how-the-data-is-collected) How the data is collected ------------------------------------------------------------------------------------------------------------------ We have a custom data scraper for each of the data sources we track. The scrapers collect all the new incoming messages/posts/comments in real-time. We also have a historical scraper to fetch historical text data from the past for almost all sources. We store the data in a NoSQL database, which enables us to run full-text search queries on top of it very fast. [](https://academy.santiment.net/metrics/details/social-data/#available-assets) Available Assets ------------------------------------------------------------------------------------------------ For each data source, we have a curated list of accounts/sub-sources from where we scrape the data. We collect all the available text documents and don't separate the incoming data by assets, i.e., the metrics we build on top of the social data are theoretically available for **any asset** (although in fact, for projects with a small market capitalization, the level of conversation around them is usually very low). [](https://academy.santiment.net/metrics/details/social-data/#available-data-sources) Available data sources ------------------------------------------------------------------------------------------------------------ ### [](https://academy.santiment.net/metrics/details/social-data/#telegram) Telegram We track a curated list with over 400 crypto-related Telegram chats. For each of them, we have the entire history of the chat. In the metric name this source is available as `telegram`. Example: `social_volume_telegram`. **Latency**. We collect the messages in real-time (1-2s delay max.) **History**. Each chat has its complete historical data; the oldest discussion starts at `2016-03-29`. * * * ### [](https://academy.santiment.net/metrics/details/social-data/#twitter) Twitter We track a curated list with over 4000 crypto-related and NFT-related Twitter accounts. For each of them, we collect their tweets, their retweets, and all the replies to their tweets. In the metric name this source is typed as `twitter`. Example: `social_volume_twitter`. **Latency**: We collect all the tweets in real-time. **History**: The historical data starts at `2018-02-13`. * * * ### [](https://academy.santiment.net/metrics/details/social-data/#reddit) Reddit We track a curated list with over 350 crypto-related subreddits. For each of them we collect the posts themselves, as well as all the comments to these posts. In the metric name this source is typed as `reddit`. Example: `social_volume_reddit`. **Latency**: All the posts and comments are collected in real-time (1-2s delay max.) **History**: The historical data starts at `2016-01-01`. * * * ### [](https://academy.santiment.net/metrics/details/social-data/#bitcointalk) Bitcointalk We collect all the new public posts from [bitcointalk.org](https://bitcointalk.org/) . We also have the full historical data for the whole forum. In the metric name this source is typed as `bitcointalk`. Example: `social_volume_bitcointalk`. **Latency**: The scraper goes through all the new messages once per 10 seconds. **History**: we have collected the entire forum history, starting from `2009-11-22`. * * * ### [](https://academy.santiment.net/metrics/details/social-data/#youtube-videos) Youtube Videos We collect the transcribed text from youtube videos from a manually curated list of channels. In the metric name this source is typed as `youtube_videos`. Example: `social_volume_youtube_videos` **Latency**: The scraper goes through all the new videos once per day. **History**: The historical data starts at `2021-06-02` * * * ### [](https://academy.santiment.net/metrics/details/social-data/#4chan) 4chan We collect posts from [4chan.org/biz](https://boards.4chan.org/biz/) In the metric name this source is typed as `4chan`. Example: `social_volume_4chan` **Latency**: The scraper goes though all the new posts once per 5 minute. **History**: The historical data starts at `2023-02-05` ### [](https://academy.santiment.net/metrics/details/social-data/#farcaster) Farcaster We collect posts from [Farcaster](https://www.farcaster.xyz/) In the metrics' names this source is typed as `farcaster`. Example: `social_volume_farcaster` **Latency**: The scraper goes though all the new posts once per 5 minute. **History**: The historical data starts at `2024-04-01` * * * ### [](https://academy.santiment.net/metrics/details/social-data/#total) Total A combination of all available sources. In the metric name this source is typed as `total`. Example: `social_volume_total`. Updated 1 year ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Realized Value | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/realized-value/#realized-value) Realized Value ======================================================================================= [](https://academy.santiment.net/metrics/realized-value/#definition) Definition ------------------------------------------------------------------------------- Realized Value is an alternative to Market Capitalization (Market Value). Instead of multiplying all coins/tokens by the last price, every coin/token is assigned the price at which it was last moved. Assigning age to coin/tokens is done according to the [coin-age model](https://academy.santiment.net/metrics/details/stack-coin-age-model/) . Realized Value metric is also available for different [time bounds](https://academy.santiment.net/metrics/details/timebound/) , which computes realized value for tokens moved at least once no longer than a specific number of days or years ago. * * * [](https://academy.santiment.net/metrics/realized-value/#access) Access ----------------------------------------------------------------------- [Restricted Access](https://academy.santiment.net/metrics/details/access#restricted-access) . * * * [](https://academy.santiment.net/metrics/realized-value/#timebound) Timebound ----------------------------------------------------------------------------- [Timebound Metrics](https://academy.santiment.net/metrics/details/timebound/) available * * * [](https://academy.santiment.net/metrics/realized-value/#measuring-unit) Measuring Unit --------------------------------------------------------------------------------------- Dollars * * * [](https://academy.santiment.net/metrics/realized-value/#data-type) Data Type ----------------------------------------------------------------------------- [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/realized-value/#frequency) Frequency ----------------------------------------------------------------------------- [Daily Intervals](https://academy.santiment.net/metrics/details/frequency#daily-frequency) * * * [](https://academy.santiment.net/metrics/realized-value/#latency) Latency ------------------------------------------------------------------------- [On-Chain Latency](https://academy.santiment.net/metrics/details/latency#on-chain-latency) * * * [](https://academy.santiment.net/metrics/realized-value/#available-assets) Available Assets ------------------------------------------------------------------------------------------- Available for [these assets](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22realized_value_usd%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) > Note: `realized_value_usd` metric and all timebound realized value metrics are available for the same set of assets. * * * [](https://academy.santiment.net/metrics/realized-value/#sanapi) SanAPI ----------------------------------------------------------------------- Available under the `realized_value_usd` and `realized_value_usd_` names. 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22realized_value_usd%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22santiment%22%0A%20%20%20%20%20%20from%3A%20%222020-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-01-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** [](https://academy.santiment.net/metrics/realized-value/#full-list-of-metrics) Full list of metrics --------------------------------------------------------------------------------------------------- Realized value metrics * realized\_value\_usd * realized\_value\_usd\_1d * realized\_value\_usd\_7d * realized\_value\_usd\_30d * realized\_value\_usd\_60d * realized\_value\_usd\_90d * realized\_value\_usd\_180d * realized\_value\_usd\_365d * realized\_value\_usd\_2y * realized\_value\_usd\_3y * realized\_value\_usd\_5y * realized\_value\_usd\_10y Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Access | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/details/access#access) Access ====================================================================== * [Free Access](https://academy.santiment.net/metrics/details/access#free-access) * [Restricted Access](https://academy.santiment.net/metrics/details/access#restricted-access) [](https://academy.santiment.net/metrics/details/access#free-access) Free Access -------------------------------------------------------------------------------- Metrics with free access have full historical and realtime data available in the `Free` plan and all paid plans. [](https://academy.santiment.net/metrics/details/access#restricted-access) Restricted Access -------------------------------------------------------------------------------------------- Metrics with restricted access have partial access to the metric data. The restrictions depend both on the product used (Sanbase, SanAPI) and the subscription plan used (Free, Basic, Pro, etc.). Some of the metrics that are available on Sanbase might not be available in the Free and Basic SanAPI plans, but only in Pro and higher. [](https://academy.santiment.net/metrics/details/access#detailed-access-restrictions-per-product-plan) Detailed Access Restrictions per product/plan ---------------------------------------------------------------------------------------------------------------------------------------------------- Detailed access restrictions per product and plan can be found here: * [SanAPI Free](https://api.santiment.net/graphiql?query=%7B%0A%20%20getAccessRestrictions(plan%3A%20FREE%2C%20product%3A%20SANAPI)%20%7B%0A%20%20%20%20name%0A%20%20%20%20type%0A%20%20%20%20isAccessible%0A%20%20%20%20isRestricted%0A%20%20%20%20restrictedFrom%0A%20%20%20%20restrictedTo%0A%20%20%7D%0A%7D%0A) * [SanAPI Basic](https://api.santiment.net/graphiql?query=%7B%0A%20%20getAccessRestrictions(plan%3A%20BASIC%2C%20product%3A%20SANAPI)%20%7B%0A%20%20%20%20name%0A%20%20%20%20type%0A%20%20%20%20isAccessible%0A%20%20%20%20isRestricted%0A%20%20%20%20restrictedFrom%0A%20%20%20%20restrictedTo%0A%20%20%7D%0A%7D%0A) * [SanAPI Pro](https://api.santiment.net/graphiql?query=%7B%0A%20%20getAccessRestrictions(plan%3A%20PRO%2C%20product%3A%20SANAPI)%20%7B%0A%20%20%20%20name%0A%20%20%20%20type%0A%20%20%20%20isAccessible%0A%20%20%20%20isRestricted%0A%20%20%20%20restrictedFrom%0A%20%20%20%20restrictedTo%0A%20%20%7D%0A%7D%0A) * [Sanbase Free](https://api.santiment.net/graphiql?query=%7B%0A%20%20getAccessRestrictions(plan%3A%20FREE%2C%20product%3A%20SANBASE)%20%7B%0A%20%20%20%20name%0A%20%20%20%20type%0A%20%20%20%20isAccessible%0A%20%20%20%20isRestricted%0A%20%20%20%20restrictedFrom%0A%20%20%20%20restrictedTo%0A%20%20%7D%0A%7D%0A) * [Sanbase Pro](https://api.santiment.net/graphiql?query=%7B%0A%20%20getAccessRestrictions(plan%3A%20PRO%2C%20product%3A%20SANBASE)%20%7B%0A%20%20%20%20name%0A%20%20%20%20type%0A%20%20%20%20isAccessible%0A%20%20%20%20isRestricted%0A%20%20%20%20restrictedFrom%0A%20%20%20%20restrictedTo%0A%20%20%7D%0A%7D%0A) * [Sanbase Pro+](https://api.santiment.net/graphiql?query=%7B%0A%20%20getAccessRestrictions(plan%3A%20PRO%2C%20product%3A%20SANBASE)%20%7B%0A%20%20%20%20name%0A%20%20%20%20type%0A%20%20%20%20isAccessible%0A%20%20%20%20isRestricted%0A%20%20%20%20restrictedFrom%0A%20%20%20%20restrictedTo%0A%20%20%7D%0A%7D%0A) Description of the fields: * `type` - Either [query](https://academy.santiment.net/glossary/#query) or [metric](https://academy.santiment.net/glossary/#metric) * `name` - The name of the query or metric. Check the [query](https://academy.santiment.net/glossary/#query) and [metric](https://academy.santiment.net/glossary/#metric) definition and examples in order to understand what the name represents exactly. * `isAccessible` - Shows if the given metric/query is accessible for the provided product/plan. * `isRestricted` - Shows if any time (historical or realtime) restrictions are applied. * `restrictedFrom` - Shows the first date the given product/plan has access to for the specific metric/query. If it is `null` then no restrictions are applied. * `restrictedTo` - Shows the last date the given product/plan has access to for the specific metric/query. If it is `null` then no restrictions are applied. > Note: The `isRestricted`, `restrictedFrom` and `restrictedTo` fields are meaningful only if `isAccessible` is `true`. Updated 4 years ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Renamed Metrics | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/renamed-metrics/#renamed-metrics) Renamed Metrics ========================================================================================== [](https://academy.santiment.net/metrics/renamed-metrics/#renamed-metrics) Renamed Metrics ------------------------------------------------------------------------------------------ ⚠️ Renamed metrics are those that have undergone a name change within our system, reflecting updates to terminology or standardization efforts. These metrics remain actively supported for analysis and reporting but may now be referred to by a different name than previously used. It's important for users to be aware of these changes to ensure clarity and consistency in their analytical processes. While the underlying data and calculation methods for renamed metrics remain unchanged, their updated names help align our reporting practices with industry standards and best practices. Relying on renamed metrics allows for smoother communication and interpretation of analytical results across teams and stakeholders. [](https://academy.santiment.net/metrics/renamed-metrics/#why-do-we-rename-metrics) Why Do We Rename Metrics? ------------------------------------------------------------------------------------------------------------- Metrics undergo renaming for several reasons, driven by our commitment to enhancing clarity, consistency, and alignment with industry standards. Here's why certain metrics may be renamed: 1. **Standardization Efforts**: In response to evolving industry norms or best practices, we periodically update our metric terminology to align with widely accepted standards. Renaming metrics ensures consistency in communication and facilitates interoperability with external partners or industry peers, enhancing the clarity and accessibility of our analytical outputs. 2. **Clarification of Concepts**: Renaming metrics may also serve to clarify their underlying concepts or methodologies, reducing ambiguity and improving understanding among users. By adopting more intuitive or descriptive names, we enhance the interpretability of metrics and facilitate more informed decision-making based on our analytical insights. 3. **Alignment with User Feedback**: Feedback from users and stakeholders often informs our decisions to rename metrics, addressing concerns or confusion surrounding existing terminology. By incorporating user input, we strive to optimize the usability and relevance of our metrics, ensuring that they effectively meet the needs of our diverse user base. [](https://academy.santiment.net/metrics/renamed-metrics/#benefits-of-renaming-metrics) Benefits of Renaming Metrics -------------------------------------------------------------------------------------------------------------------- While metrics undergo name changes, their underlying definitions and calculations remain consistent, ensuring continuity and comparability in our analytical outputs. By staying informed about renamed metrics and updating documentation and training materials accordingly, users can seamlessly transition to using the updated terminology without disrupting their analytical workflows. Embracing renamed metrics supports our commitment to clarity, consistency, and alignment with industry standards, enhancing the effectiveness and relevance of our data analysis processes. [](https://academy.santiment.net/metrics/renamed-metrics/#list-of-renamed-metrics) List Of Renamed Metrics ---------------------------------------------------------------------------------------------------------- * [Age Consumed Metrics](https://academy.santiment.net/metrics/age-consumed/) - Renamed from **age\_destroyed\[..\]** to **age\_consumed\[..\]** * [Weighted Sentiment Metrics](https://academy.santiment.net/metrics/sentiment-metrics/weighted-sentiment-metrics/) - Renamed from **sentiment\_volume\_consumed\_\[..\]** to **sentiment\_weighted\_\[..\]** * [Exchange Inflow/Outflow Metrics](https://academy.santiment.net/metrics/exchange-funds-flow/) - Renamed from **inflow\_per\_label\_and\_owner** to **exchange\_inflow\_per\_exchange** and **outflow\_per\_label\_and\_owner** to **exchange\_outflow\_per\_exchange** Updated 1 year ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Marketcap in USD | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/marketcap/#marketcap-in-usd) Marketcap in USD ====================================================================================== [](https://academy.santiment.net/metrics/marketcap/#definition) Definition -------------------------------------------------------------------------- The marketcap in USD is derived as the price of an asset in USD multiplied by the circulating supply of the same asset. * * * [](https://academy.santiment.net/metrics/marketcap/#access) Access ------------------------------------------------------------------ [Free Access](https://academy.santiment.net/metrics/details/access#free-access) * * * [](https://academy.santiment.net/metrics/marketcap/#measuring-unit) Measuring Unit ---------------------------------------------------------------------------------- USD * * * [](https://academy.santiment.net/metrics/marketcap/#data-type) Data Type ------------------------------------------------------------------------ [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/marketcap/#change-metrics) Change Metrics ---------------------------------------------------------------------------------- [Change Metrics](https://academy.santiment.net/metrics/details/change_metrics/) * * * [](https://academy.santiment.net/metrics/marketcap/#frequency) Frequency ------------------------------------------------------------------------ [Five-Minute Intervals](https://academy.santiment.net/metrics/details/frequency#five-minute-frequency) * * * [](https://academy.santiment.net/metrics/marketcap/#latency) Latency -------------------------------------------------------------------- [Price Latency](https://academy.santiment.net/metrics/details/latency#price-latency) * * * [](https://academy.santiment.net/metrics/marketcap/#available-assets) Available Assets -------------------------------------------------------------------------------------- Available assets for [marketcap\_usd](https://api.santiment.net/graphiql?query=%7B%0A++getMetric%28metric%3A+%22marketcap_usd%22%29%7B%0A++++metadata%7B%0A++++++availableSlugs%0A++++%7D%0A++%7D%0A%7D) * * * [](https://academy.santiment.net/metrics/marketcap/#sanapi) SanAPI ------------------------------------------------------------------ ### [](https://academy.santiment.net/metrics/marketcap/#marketcap-usd) Marketcap USD 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22marketcap_usd%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22ethereum%22%0A%20%20%20%20%20%20from%3A%20%222020-04-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-04-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** [](https://academy.santiment.net/metrics/marketcap/#full-list-of-metrics) Full list of metrics ---------------------------------------------------------------------------------------------- The full list of Marketcap in USD metrics is: Open Metrics List * marketcap\_usd * marketcap\_usd\_change\_1d * marketcap\_usd\_change\_30d * marketcap\_usd\_change\_7d Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Price Metrics | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/price/#price-metrics) Price Metrics ============================================================================ [](https://academy.santiment.net/metrics/price/#definition) Definition ---------------------------------------------------------------------- The following metrics are provided: * `price_usd` - Price in USD, sourced from a 3rd party provider * `price_usd_5m` - The same as `price_usd`, but the data points are aligned at 5 minute intervals and any gaps are filled with the last known value * `price_btc` - Price in BTC * `price_usdt` - Price in USDT * Open-High-Close-Low Price in USD * * * [](https://academy.santiment.net/metrics/price/#access) Access -------------------------------------------------------------- [Free Access](https://academy.santiment.net/metrics/details/access#free-access) * * * [](https://academy.santiment.net/metrics/price/#measuring-unit) Measuring Unit ------------------------------------------------------------------------------ Amount in dollars/usdt/bitcoins * * * [](https://academy.santiment.net/metrics/price/#data-type) Data Type -------------------------------------------------------------------- [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/price/#change-metrics) Change Metrics ------------------------------------------------------------------------------ [Change Metrics](https://academy.santiment.net/metrics/details/change_metrics/) * * * [](https://academy.santiment.net/metrics/price/#frequency) Frequency -------------------------------------------------------------------- [Five-Minute Intervals](https://academy.santiment.net/metrics/details/frequency#five-minute-frequency) * * * [](https://academy.santiment.net/metrics/price/#latency) Latency ---------------------------------------------------------------- [Price Latency](https://academy.santiment.net/metrics/details/latency#price-latency) * * * [](https://academy.santiment.net/metrics/price/#available-assets) Available Assets ---------------------------------------------------------------------------------- * Available assets for [price\_usd](https://api.santiment.net/graphiql?query=%7B%0A++getMetric%28metric%3A+%22price_usd%22%29%7B%0A++++metadata%7B%0A++++++availableSlugs%0A++++%7D%0A++%7D%0A%7D) * Available assets for [price\_usd\_5m](https://api.santiment.net/graphiql?query=%7B%0A++getMetric%28metric%3A+%22price_usd_5m%22%29%7B%0A++++metadata%7B%0A++++++availableSlugs%0A++++%7D%0A++%7D%0A%7D) * Available assets for [price\_btc](https://api.santiment.net/graphiql?query=%7B%0A++getMetric%28metric%3A+%22price_btc%22%29%7B%0A++++metadata%7B%0A++++++availableSlugs%0A++++%7D%0A++%7D%0A%7D) * Available assets for [price\_usdt](https://api.santiment.net/graphiql?query=%7B%0A++getMetric%28metric%3A+%22price_usdt%22%29%7B%0A++++metadata%7B%0A++++++availableSlugs%0A++++%7D%0A++%7D%0A%7D) * Available assets for [price\_eth](https://api.santiment.net/graphiql?query=%7B%0A++getMetric%28metric%3A+%22price_eth%22%29%7B%0A++++metadata%7B%0A++++++availableSlugs%0A++++%7D%0A++%7D%0A%7D) * * * [](https://academy.santiment.net/metrics/price/#sanapi) SanAPI -------------------------------------------------------------- ### [](https://academy.santiment.net/metrics/price/#price-usd) Price USD 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22price_usd%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22ethereum%22%0A%20%20%20%20%20%20from%3A%20%222020-04-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-04-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** ### [](https://academy.santiment.net/metrics/price/#average-price-in-usd-over-five-minute-intervals) Average price in USD over five-minute intervals 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22price_usd_5m%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22ethereum%22%0A%20%20%20%20%20%20from%3A%20%222020-04-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-04-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%225m%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** ### [](https://academy.santiment.net/metrics/price/#price-btc) Price BTC 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22price_btc%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22ethereum%22%0A%20%20%20%20%20%20from%3A%20%222020-04-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-04-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** ### [](https://academy.santiment.net/metrics/price/#price-usdt) Price USDT 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22price_usdt%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22ethereum%22%0A%20%20%20%20%20%20from%3A%20%222020-04-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-04-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** ### [](https://academy.santiment.net/metrics/price/#ohlc) OHLC 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22price_usd%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22ethereum%22%0A%20%20%20%20%20%20from%3A%20%222020-04-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-04-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20%20%20aggregation%3A%20OHLC)%0A%20%20%7D%0A%7D) ** [](https://academy.santiment.net/metrics/price/#full-list-of-metrics) Full list of metrics ------------------------------------------------------------------------------------------ The full list of Price metrics is: Open Metrics List * price\_btc * price\_eth * price\_usd * price\_usd\_5m * price\_usdt Open Change Metrics List * price\_btc\_change\_1d * price\_btc\_change\_30d * price\_btc\_change\_7d * price\_eth\_change\_1d * price\_eth\_change\_30d * price\_eth\_change\_7d * price\_usd\_change\_1d * price\_usd\_change\_1h * price\_usd\_change\_30d * price\_usd\_change\_7d Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Timebound | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/details/timebound/#timebound) Timebound ================================================================================ * [Definition](https://academy.santiment.net/metrics/details/timebound/#definition) * [Examples](https://academy.santiment.net/metrics/details/timebound/#examples) * [circulation\_1d](https://academy.santiment.net/metrics/details/timebound/#circulation_1d) [](https://academy.santiment.net/metrics/details/timebound/#definition) Definition ---------------------------------------------------------------------------------- Typically metrics are computed by taking into account all coins/tokens. For some metrics, it makes sense also to compute a derivation of them on the subset of coins/tokens that have been moved at least once no longer than X days/years ago. UTXO blockchains naturally define the age of a coin, but this is not true for account-based blockchains. To define the age of a coin in account-based blockchains we developed our own [Coin Age Model](https://academy.santiment.net/metrics/details/stack-coin-age-model/) Timebound metrics names are formed from the original metric name plus a timebound suffix. Available timebound suffixes are: * `_1d` - 1 day * `_7d` - 7 days * `_30d` - 30 days * `_60d` - 60 days * `_90d` - 90 days * `_180d` - 180 days * `_365d` - 365 days * `_2y` - 2 years * `_3y` - 3 years * `_5y` - 5 years * `_10y` - 10 years > Note: There are metrics that support only part of the timebounds. For example, the mean\_coin\_age has only `_90d`, `_180d`, `_365d`, `_2y`, `_3y` and `_5y`. Examples: * mvrv\_usd\_30d - The MVRV metric is computed by considering only the coins/tokens that were active in the past 30 days. * circulation\_3y - The number of tokens transacted at least once in the past 3 years. If a coin/token is considered dead/lost (sent to graveyard address, the owner lost private key, etc.), such circulation can approximate total supply minus lost/dead coins. [](https://academy.santiment.net/metrics/details/timebound/#examples) Examples ------------------------------------------------------------------------------ ### [](https://academy.santiment.net/metrics/details/timebound/#circulation-1d) circulation\_1d The `circulation_1d` metric counts the number of coins/tokens that participated in on-chain transactions in the past 24 hours. On one particular day, Alice sends 20 ETH to Bob, Bob sends 10 ETH to Charlie and Charlie sends 5 ETH to Dean. 1 2 3 4 5 6 In this scenario the transaction volume is 20 + 10 + 5 = 35 ETH, but the ETH in circulation is 20 ETH. This difference can be explained as having twenty $1 bills. Alice sends all of them to Bob, Bob sends 10 of the received bills to Charlie, and Charlie sends 5 of them to Dean. There are 20 dollars in circulation total in this case. One of the most valuable properties of circulation is that it is immune to mixers and gives a much better view of the actual amount of tokens that are being transacted on-chain. Updated 3 years ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Change Metrics | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/details/change_metrics/#change-metrics) Change Metrics =============================================================================================== * [Definition](https://academy.santiment.net/metrics/details/change_metrics/#definition) * [Units](https://academy.santiment.net/metrics/details/change_metrics/#units) * [Examples](https://academy.santiment.net/metrics/details/change_metrics/#examples) * [price\_usd\_change\_1d](https://academy.santiment.net/metrics/details/change_metrics/#price_usd_change_1d) * [circulation\_180d\_change\_1d](https://academy.santiment.net/metrics/details/change_metrics/#circulation_180d_change_1d) * [API examples](https://academy.santiment.net/metrics/details/change_metrics/#api-examples) * [Get timeseries data of a change metric](https://academy.santiment.net/metrics/details/change_metrics/#get-timeseries-data-of-a-change-metric) * [Get aggregated value for multiple assets](https://academy.santiment.net/metrics/details/change_metrics/#get-aggregated-value-for-multiple-assets) metric\](#get-timeseries-data-of-a-change-metric) * [Get aggregated value for multiple assets](https://academy.santiment.net/metrics/details/change_metrics/#get-aggregated-value-for-multiple-assets) [](https://academy.santiment.net/metrics/details/change_metrics/#definition) Definition --------------------------------------------------------------------------------------- The metrics with the suffix `_change_` indicate the percent value change at the given time compared to `interval` time ago. This allows the percent changes to be fetched historically and to be plotted on charts. Change metrics' names are formed from the original metric name and a change suffix. Available change intervals and their suffixes are: * `_change_1h` - 1 hour. Available only for USD price * `_change_1d` - 1 day * `_change_7d` - 7 days * `_change_30d` - 30 days > Note: Change metrics are also available for some of the [Timebound Metrics](https://academy.santiment.net/metrics/details/timebound/) > . In such cases, both suffixes are appended, and their order is important. In all cases, the order is timebound suffix, followed by change suffix. [](https://academy.santiment.net/metrics/details/change_metrics/#units) Units ----------------------------------------------------------------------------- The metric units are numbers where `0` corresponds to 0% change, `1` corresponds to 100% change. Negative values indicate decrease. These values cannot be aggregated using `SUM`. The default aggregation is `LAST`. [](https://academy.santiment.net/metrics/details/change_metrics/#examples) Examples ----------------------------------------------------------------------------------- ### [](https://academy.santiment.net/metrics/details/change_metrics/#price-usd-change-1d) price\_usd\_change\_1d This metric represents the 24h price percent change. ### [](https://academy.santiment.net/metrics/details/change_metrics/#circulation-180d-change-1d) circulation\_180d\_change\_1d This metric represents the 24h percent change of the `circulation_180d` [timebound metric](https://academy.santiment.net/metrics/details/timebound/) [](https://academy.santiment.net/metrics/details/change_metrics/#api-examples) API examples ------------------------------------------------------------------------------------------- ### [](https://academy.santiment.net/metrics/details/change_metrics/#get-timeseries-data-of-a-change-metric) Get timeseries data of a change metric 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22price_usd_change_1d%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22bitcoin%22%0A%20%20%20%20%20%20from%3A%20%22utc_now-7d%22%0A%20%20%20%20%20%20to%3A%20%22utc_now%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** ### [](https://academy.santiment.net/metrics/details/change_metrics/#get-aggregated-value-for-multiple-assets) Get aggregated value for multiple assets 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 [**Run in Explorer**](https://api.santiment.net/graphiql?query=%7B%0A++getMetric%28metric%3A+%22price_usd_change_1d%22%29+%7B%0A++++timeseriesData%28%0A++++++slug%3A+%22bitcoin%22%0A++++++from%3A+%22utc_now-7d%22%0A++++++to%3A+%22utc_now%22%0A++++++interval%3A+%221d%22%0A++++%29+%7B%0A++++++datetime%0A++++++value%0A++++%7D%0A++%7D%0A%7D) Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Decentralized Exchange Metrics | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/decentralized-exchange-metrics/#decentralized-exchange-metrics) Decentralized Exchange Metrics ======================================================================================================================================= > DEX metrics have been migrated to a new framework, with new data starting from May 5, 2022. Data between February 9, 2017 and May 5, 2022, is sourced from the old framework ([Available DEXs for old framework](https://academy.santiment.net/metrics/decentralized-exchange-metrics/old_dex_list/) > ). **Although older data remains accessible through the API, we do not recommend its use.** [](https://academy.santiment.net/metrics/decentralized-exchange-metrics/#description) Description ------------------------------------------------------------------------------------------------- Decentralized exchanges, or DEXs, revolutionize cryptocurrency trading by eliminating the need for a central authority. Operating on blockchain technology, these exchanges empower users with direct peer-to-peer transactions, enhancing security and control over funds. DEXs embody the principles of transparency and trustlessness, offering users a more resilient and inclusive financial ecosystem. List of decentralized exchanges: [Available Decentralized Exchanges](https://academy.santiment.net/metrics/decentralized-exchange-metrics/dex_list/) . Additionally, there is a label `unknown` for DEXs that haven't been labeled. Metrics are divided into four groups: #### [](https://academy.santiment.net/metrics/decentralized-exchange-metrics/#trade-volume-in-usd-segmented-by-dex) Trade volume in USD segmented by DEX: * `total_trade_volume_by_dex` - Total trading volume in USD * `eth_based_trade_volume_by_dex` - Trading volume in USD involving ETH-based tokens[1](https://academy.santiment.net/metrics/decentralized-exchange-metrics/#eth-based-tokens) * `stablecoin_trade_volume_by_dex` - Trading volume in USD involving Stablecoins[2](https://academy.santiment.net/metrics/decentralized-exchange-metrics/#usd-based-stablecoins) * `other_trade_volume_by_dex` - The trading volume in USD involving tokens not falling into any of the above categories #### [](https://academy.santiment.net/metrics/decentralized-exchange-metrics/#number-of-trades-segmented-by-dex) Number of trades segmented by DEX: * `total_trade_amount_by_dex` - Number of all trades * `eth_based_trade_amount_by_dex` - Number of trades involving ETH-Based tokens[1](https://academy.santiment.net/metrics/decentralized-exchange-metrics/#eth-based-tokens) * `stablecoin_trade_amount_by_dex` - Number of trades involving Stablecoins[2](https://academy.santiment.net/metrics/decentralized-exchange-metrics/#usd-based-stablecoins) * `other_trade_amount_by_dex` - Number of trades involving tokens not falling into any of the above categories #### [](https://academy.santiment.net/metrics/decentralized-exchange-metrics/#trade-volume-segmented-by-dex-and-asset) Trade volume segmented by DEX and asset: * `eth_trade_volume_by_token` - Trading volume in ETH between ERC20 token and ETH-Based tokens[1](https://academy.santiment.net/metrics/decentralized-exchange-metrics/#eth-based-tokens) * `stablecoin_trade_volume_by_token` - Trading volume in USD between ERC20 token and Stablecoins[2](https://academy.santiment.net/metrics/decentralized-exchange-metrics/#usd-based-stablecoins) #### [](https://academy.santiment.net/metrics/decentralized-exchange-metrics/#token-price-in-eth-segmented-by-dex-and-asset) Token price in ETH segmented by DEX and asset: * `token_eth_price_by_dex_5m` - Token price in ETH segmented by DEX for trades between given ERC20 token and ETH-based tokens [1](https://academy.santiment.net/metrics/decentralized-exchange-metrics/#eth-based-tokens) * * * ### [](https://academy.santiment.net/metrics/decentralized-exchange-metrics/#eth-based-tokens) ETH Based Tokens ETH, WETH, ETH Kyber, ETHWrapped and Bancor ETH. ### [](https://academy.santiment.net/metrics/decentralized-exchange-metrics/#usd-based-stablecoins) USD-based Stablecoins Tether, USD coin, DAI, Binance USD, TrueUSD and other stablecoins. [](https://academy.santiment.net/metrics/decentralized-exchange-metrics/#access) Access --------------------------------------------------------------------------------------- [Restricted Access](https://academy.santiment.net/metrics/details/access#restricted-access) . * * * [](https://academy.santiment.net/metrics/decentralized-exchange-metrics/#measuring-unit) Measuring Unit ------------------------------------------------------------------------------------------------------- * `total_trade_volume_by_dex`, `eth_based_trade_volume_by_dex`, `stablecoin_trade_volume_by_dex`, `other_trade_volume_by_dex` - Amount in USD * `total_trade_amount_by_dex`, `eth_based_trade_amount_by_dex`, `stablecoin_trade_amount_by_dex`, `other_trade_amount_by_dex` - Number of trades * `eth_trade_volume_by_token` - Amount in ETH * `stablecoin_trade_volume_by_token` - Amount in stablecoins * `token_eth_price_by_dex_5m` - Amount in ETH * * * [](https://academy.santiment.net/metrics/decentralized-exchange-metrics/#data-type) Data Type --------------------------------------------------------------------------------------------- [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/decentralized-exchange-metrics/#frequency) Frequency --------------------------------------------------------------------------------------------- [Five-minute Intervals](https://academy.santiment.net/metrics/details/frequency#five-minute-frequency) * * * [](https://academy.santiment.net/metrics/decentralized-exchange-metrics/#latency) Latency ----------------------------------------------------------------------------------------- [Price Latency](https://academy.santiment.net/metrics/details/latency#price-latency) * * * [](https://academy.santiment.net/metrics/decentralized-exchange-metrics/#available-assets) Available Assets ----------------------------------------------------------------------------------------------------------- * `total_trade_volume_by_dex`, `eth_based_trade_volume_by_dex`, `stablecoin_trade_volume_by_dex`, `other_trade_volume_by_dex`: multi-collateral-dai * `total_trade_amount_by_dex`, `eth_based_trade_amount_by_dex`, `stablecoin_trade_amount_by_dex`, `other_trade_amount_by_dex`: multi-collateral-dai * `eth_trade_volume_by_token`, `stablecoin_trade_volume_by_token`, `token_eth_price_by_dex_5m`: [ERC20 assets](https://api.santiment.net/graphiql?variables=%7B%7D&query=%7B%0A%20%20getMetric(metric%3A%20%22token_eth_price_by_dex_5m%22)%7B%0A%20%20%20%20metadata%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D) > **Note:** `<>_trade_volume_by_dex` and `<>_trade_amount_by_dex` metrics are not asset-based. They are related to DEX data and `multi-collateral-dai` is placeholder for the data. * * * ### [](https://academy.santiment.net/metrics/decentralized-exchange-metrics/#sanapi) SanAPI Trade volume metrics: `total_trade_volume_by_dex`, `eth_based_trade_volume_by_dex`, `stablecoin_trade_volume_by_dex` and `other_trade_volume_by_dex` 1 2 3 4 5 6 7 8 9 10 11 12 13 14 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22total_trade_volume_by_dex%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20selector%3A%20%7B%0A%20%20%20%20%20%20%20%20slug%3A%20%22multi-collateral-dai%22%0A%20%20%20%20%20%20%09owner%3A%20%22bancor_v3%22%0A%20%20%20%20%20%20%09label%3A%20%22decentralized_exchange%22%0A%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20from%3A%20%222023-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222023-01-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%225m%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Number of trades metrics: `total_trade_amount_by_dex`, `eth_based_trade_amount_by_dex`, `stablecoin_trade_amount_by_dex` and `other_trade_amount_by_dex` 1 2 3 4 5 6 7 8 9 10 11 12 13 14 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22total_trade_amount_by_dex%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20selector%3A%20%7B%0A%20%20%20%20%20%20%20%20slug%3A%20%22multi-collateral-dai%22%0A%20%20%20%20%20%20%09owner%3A%20%22sushi_v2%22%0A%20%20%20%20%20%20%09label%3A%20%22decentralized_exchange%22%0A%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20from%3A%20%222023-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222023-01-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%225m%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Trade volume between ERC20 token and ETH-based tokens: `eth_trade_volume_by_token` 1 2 3 4 5 6 7 8 9 10 11 12 13 14 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22eth_trade_volume_by_token%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20selector%3A%20%7B%0A%20%20%20%20%20%20%20%20slug%3A%20%22chainlink%22%0A%20%20%20%20%20%20%09owner%3A%20%22uniswap_v2%22%0A%20%20%20%20%20%20%09label%3A%20%22decentralized_exchange%22%0A%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20from%3A%20%222023-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222023-01-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%225m%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Trade volume between ERC20 token and stablecoins: `stablecoin_trade_volume_by_token` 1 2 3 4 5 6 7 8 9 10 11 12 13 14 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22stablecoin_trade_volume_by_token%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20selector%3A%20%7B%0A%20%20%20%20%20%20%20%20slug%3A%20%22wrapped-bitcoin%22%0A%20%20%20%20%20%20%09owner%3A%20%22uniswap_v3%22%0A%20%20%20%20%20%20%09label%3A%20%22decentralized_exchange%22%0A%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20from%3A%20%222023-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222023-01-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%225m%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Token ETH Price by DEX: `token_eth_price_by_dex_5m` 1 2 3 4 5 6 7 8 9 10 11 12 13 14 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22token_eth_price_by_dex_5m%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20selector%3A%20%7B%0A%20%20%20%20%20%20%20%20slug%3A%20%22usd-coin%22%0A%20%20%20%20%20%20%09owner%3A%20%22uniswap_v3%22%0A%20%20%20%20%20%20%09label%3A%20%22decentralized_exchange%22%0A%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20from%3A%20%222023-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222023-01-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%225m%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Ethereum Spent | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/ethereum-spent/#ethereum-spent) Ethereum Spent ======================================================================================= [](https://academy.santiment.net/metrics/ethereum-spent/#definition) Definition ------------------------------------------------------------------------------- Track the amount of ETH leaving the wallets where ICO funds were collected. > Note: Transactions are not followed to exchanges. #### [](https://academy.santiment.net/metrics/ethereum-spent/#example) Example Below is the ETH spent over time of Golem plotted against the Golem price and ETH price. Enabling the ETH is useful to give you an approximation for the value in USD that this ETH movement generated. Most often ICOs move ethereum out of their ICO wallets to sell them on exchanges to fund the project. ![golem-eth-spent](https://academy.santiment.net/metrics/ethereum-spent/golem-eth-spent.png) [](https://academy.santiment.net/metrics/ethereum-spent/#access) Access ----------------------------------------------------------------------- [Free Access](https://academy.santiment.net/metrics/details/access#free-access) * * * [](https://academy.santiment.net/metrics/ethereum-spent/#measuring-unit) Measuring Unit --------------------------------------------------------------------------------------- Ethereum amount * * * [](https://academy.santiment.net/metrics/ethereum-spent/#data-type) Data Type ----------------------------------------------------------------------------- [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/ethereum-spent/#frequency) Frequency ----------------------------------------------------------------------------- [Five-minute Intervals](https://academy.santiment.net/metrics/details/frequency#five-minute-frequency) * * * [](https://academy.santiment.net/metrics/ethereum-spent/#latency) Latency ------------------------------------------------------------------------- [On-Chain Latency](https://academy.santiment.net/metrics/details/latency#on-chain-latency) * * * [](https://academy.santiment.net/metrics/ethereum-spent/#available-assets) Available Assets ------------------------------------------------------------------------------------------- Available for [these assets](https://api.santiment.net/graphiql?query=%7B%0A%20%20allErc20Projects%20%7B%0A%20%20%20%20slug%0A%20%20%7D%0A%7D%0A) * * * [](https://academy.santiment.net/metrics/ethereum-spent/#sanapi) SanAPI ----------------------------------------------------------------------- ### [](https://academy.santiment.net/metrics/ethereum-spent/#timeseries-data) Timeseries data Available as a field of the project graphql type, fetch the amount of ETH spent for every `interval` in the time range. 1 2 3 4 5 6 7 8 9 10 11 12 **[Run in Explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20projectBySlug(slug%3A%20%22santiment%22)%20%7B%0A%20%20%20%20ethSpentOverTime(from%3A%20%222019-01-01T00%3A00%3A00Z%22%2C%20to%3A%20%222020-01-07T00%3A00%3A00Z%22%2C%20interval%3A%20%2230d%22)%20%7B%0A%20%20%20%20%20%20datetime%0A%20%20%20%20%20%20ethSpent%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A&variables=%7B%7D) ** ### [](https://academy.santiment.net/metrics/ethereum-spent/#aggregated-data-per-project) Aggregated data per project In order to fetch how many ETH every project spent in a the last N days, you can execute the following GraphQL query (the `days` can contain any number of days): 1 2 3 4 5 6 **[Run in Explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20allProjects%20%7B%0A%20%20%20%20slug%0A%20%20%20%20ethSpent(days%3A%2030)%0A%20%20%7D%0A%7D%0A) ** Updated 5 years ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Trading Volume in USD | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/trading-volume/#trading-volume-in-usd) Trading Volume in USD ===================================================================================================== [](https://academy.santiment.net/metrics/trading-volume/#definition) Definition ------------------------------------------------------------------------------- The Trading Volume is the volume in USD traded on exchanges. The metric is taking into consideration all the trading pairs. The trading pairs that are not pegged to USD are multiplied by the USD price of the asset. Trading Volume in USD metrics: * `volume_usd` - 24-hour sliding window trading volume across centralized and decentralized exchanges. All transactions are converted to USD. The data is sourced from a 3rd party provider. * `volume_usd_5m` - The same as `volume_usd`, but the data points are aligned at 5 minute intervals and any gaps are filled with the last known value * * * [](https://academy.santiment.net/metrics/trading-volume/#access) Access ----------------------------------------------------------------------- [Free Access](https://academy.santiment.net/metrics/details/access#free-access) * * * [](https://academy.santiment.net/metrics/trading-volume/#measuring-unit) Measuring Unit --------------------------------------------------------------------------------------- Amount in dollars/usdt/bitcoins * * * [](https://academy.santiment.net/metrics/trading-volume/#data-type) Data Type ----------------------------------------------------------------------------- [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/trading-volume/#change-metrics) Change Metrics --------------------------------------------------------------------------------------- [Change Metrics](https://academy.santiment.net/metrics/details/change_metrics/) * * * [](https://academy.santiment.net/metrics/trading-volume/#frequency) Frequency ----------------------------------------------------------------------------- [Five-Minute Intervals](https://academy.santiment.net/metrics/details/frequency#five-minute-frequency) * * * [](https://academy.santiment.net/metrics/trading-volume/#latency) Latency ------------------------------------------------------------------------- [Price Latency](https://academy.santiment.net/metrics/details/latency#price-latency) * * * [](https://academy.santiment.net/metrics/trading-volume/#available-assets) Available Assets ------------------------------------------------------------------------------------------- Available assets for [volume\_usd](https://api.santiment.net/graphiql?query=%7B%0A++getMetric%28metric%3A+%22volume_usd%22%29%7B%0A++++metadata%7B%0A++++++availableSlugs%0A++++%7D%0A++%7D%0A%7D) * * * [](https://academy.santiment.net/metrics/trading-volume/#sanapi) SanAPI ----------------------------------------------------------------------- ### [](https://academy.santiment.net/metrics/trading-volume/#volume-usd) Volume USD Available under `volume_usd` and `volume_usd_5m` names 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22volume_usd%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22ethereum%22%0A%20%20%20%20%20%20from%3A%20%222020-04-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-04-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** [](https://academy.santiment.net/metrics/trading-volume/#full-list-of-metrics) Full list of metrics --------------------------------------------------------------------------------------------------- The full list of GitHub Activity metrics is: Open Metrics List * volume\_usd * volume\_usd\_5m * volume\_usd\_change\_1d * volume\_usd\_change\_30d * volume\_usd\_change\_7d Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Deprecated Metrics | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/deprecated-metrics/#deprecated-metrics) Deprecated Metrics =================================================================================================== [](https://academy.santiment.net/metrics/deprecated-metrics/#deprecated-metrics) Deprecated Metrics --------------------------------------------------------------------------------------------------- ⚠️ Deprecated metrics are ones that our system has designated as being out of date or obsolete. These metrics are no longer actively supported or recommended for use in current analysis or reporting. They represent historical data points that may not accurately reflect current trends or insights. While the data for deprecated metrics still exists within our system, we do not recommend using them due to their deprecated status. Relying on deprecated metrics can lead to inaccurate analysis and decision-making, as they may no longer align with the most up-to-date information and methodologies. It's crucial for users to be aware of the deprecation status of these metrics and to transition to alternative, more relevant metrics for their analysis needs. [](https://academy.santiment.net/metrics/deprecated-metrics/#why-do-we-deprecate-metrics) Why Do We Deprecate Metrics? ---------------------------------------------------------------------------------------------------------------------- Metrics become deprecated for various reasons, reflecting the dynamic nature of our systems and data analysis practices. Here's why certain metrics may be marked as deprecated: 1. **Adaptation to Changing Needs**: Over time, shifts in business priorities, market dynamics, or user requirements may render certain metrics obsolete or redundant. Metrics that no longer serve a meaningful purpose due to changes in events, processes, or stakeholder demands are deprecated to streamline analysis efforts and maintain focus on metrics that drive actionable insights. 2. **Improving Data Integrity**: Deprecating metrics helps maintain data integrity by discouraging the use of outdated or unreliable indicators that may skew analyses or mislead decision-making. By phasing out obsolete metrics, we uphold the quality and accuracy of our analytical outputs, ensuring that stakeholders can confidently rely on the insights derived from our data. 3. **Evolution of Data Sources**: As our data infrastructure advances, we often transition to new and improved data sources that offer enhanced accuracy, granularity, or coverage. Metrics tied to outdated data sources become deprecated as we migrate towards more reliable sources, ensuring that our analyses are based on the most up-to-date and comprehensive information available. [](https://academy.santiment.net/metrics/deprecated-metrics/#why-do-we-keep-them) Why Do We Keep Them? ------------------------------------------------------------------------------------------------------ While deprecated metrics may no longer be actively supported, it's essential to stay informed about their deprecation to ensure accurate and relevant analysis. By understanding why metrics are deprecated and identifying suitable replacements, you can maintain the integrity and effectiveness of your data analysis processes. [](https://academy.santiment.net/metrics/deprecated-metrics/#list-of-deprecated-metrics) List Of Deprecated Metrics ------------------------------------------------------------------------------------------------------------------- * [Deprecated MakerDAO Metrics](https://academy.santiment.net/metrics/deprecated-metrics/deprecated-makerdao-metrics/) - MakerDAO metrics have been migrated to a new framework * [Deprecated Defi Metrics](https://academy.santiment.net/metrics/deprecated-metrics/deprecated-defi-metrics/) - The underlying data for metrics is no longer supported * [Deprecated Uniswap Airdrop Metrics](https://academy.santiment.net/metrics/deprecated-metrics/deprecated-uniswap-metrics/) - The Airdrop occurred in September 2020, but there are no more claims * [Deprecated Social Metrics](https://academy.santiment.net/metrics/deprecated-metrics/deprecated-social-metrics/) - Some of the socual sources were combined into one. Updated 9 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Labels | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/labels/#labels) Labels ======================================================= [](https://academy.santiment.net/labels/#labels-overview) Labels overview ------------------------------------------------------------------------- Generally speaking, an **address label** is a piece of information attached to a wallet address. The most common use case of one is to denote the owner of the given address. E.g. address “A” belongs to Alice, and address “B” belongs to Binance exchange. Another use-case would be marking (aka labeling) an address as a smart contract. E.g. address “C” is an ERC-721 standard contract. In the context of market analysis we are interested in the market participants' addresses mostly. Information about excanhges, whales, traders, DeFi protocols, etc gives a lot of insights on what's going on on the market. There are a lot of label types and use-cases which are described below. [](https://academy.santiment.net/labels/#how-we-gather-labels) How we gather labels ----------------------------------------------------------------------------------- Collecting labels is not a trivial task. To keep our explanation concise, there are three main ways to gather a label: 1. **Open sources** Some people or projects are willing to share their addresses. E.g. most DeFi projects post their smart contract addresses, and some centralized exchanges reveal their addresses to prove that they hold a certain amount of funds. We collect these addresses and store them in our database. 2. **Manual label collection** In order to collect some labels, manual research is required. For instance, we can manually deposit some ETH to a centralized exchange and track its flow. The ETH will flow first to a deposit address, and then to the centralized exchange. 3. **Algorithms** This is the most powerful method if you need to label many addresses. At Santiment, we have a lot of manually developed algorithms for labeling different types of addresses. Some of our algorithms are native (e.g. in order to find NFT traders, we can just track trades on an NFT trading platform). Others are quite sophisticated (e.g. we developed an algorithm that tracks coinbase cold wallets and relies on some counterintuitive assumptions and filters the whole history of ETH transactions to find these cold wallets). Very often, we combine different methods. For instance, we could manually collect some addresses, manually analyze its on-chain behavior, and design an algorithm gathering all addresses of the initial type. [](https://academy.santiment.net/labels/#limitations) Limitations ----------------------------------------------------------------- Although we are constantly working on adding and improving labels, there are two types of errors that may occur: 1. **False positive error** (wrong label was added to the address) At Santiment, we care a great deal about false positive errors. We do not add labels without making sure the label is correct, or mark the label as suspicious and exclude the address from further computations. Our goal is to build trustworthy labels so that low false positive error rates are ensured. 2. **False negative error** (address was not labelled properly) It is not a trivial task to find all addresses that belong to a person. Let's say you decided to label all addresses belonging to your friend, Alice. Once you find some Alice addresses it's very hard to prove there are no other addresses that are controlled by Alice. Moreover, Alice might want to hide her funds or transactions, so she might use different addresses, use mixers, or design some sophisticated way to distribute her funds so no one can find them. So we always have to assume that there might be addresses that we missed and didn't label. In case you found any mistakes in our labeling, please let us know (via discord or email). We appreciate your help a great deal 😃 [](https://academy.santiment.net/labels/#naming) Naming ------------------------------------------------------- Each label has it's own name, so called label FQN (Fully Qualified Name). [Read about label FQNs here](https://academy.santiment.net/labels/label-fqn/) [](https://academy.santiment.net/labels/#label-groups) Label Groups ------------------------------------------------------------------- At Santiment, we label millions of addresses with dozens of different labels. In order to keep it easy to work with labels, we created a way to split all labels into logical groups. Here's a simplified description of how we handle labels. We split all labels into major groups. Each major group might consist of smaller groups. Here's a list of major groups: * **Domains** The group includes legal entities (exchanges, platforms, mining pools, etc.), DAOs, and smart contracts. * **Owner** A standalone label which denotes the person or company which controls a given address. Note that the owner label is not a nickname. Owner is a broader term rather than nickname which is an owner's attribute (e.g. Vitalik Buterin might have several nicknames: 'Vitaliy', 'ETH\_daddy', 'John Galt', etc) * **Infrastructure** A group including addresses that are bound to any other group and serve any internal tasks. * **Activity** A group including addresses which are actively or passively engaged in a certain type of activity (for example: trading, receiving airdrop, blogging, etc.) * **Social networks** A group including users’ nicknames on social networks, forums, platforms, etc. * **Status** A group that includes the status of the project: blocked, hacked or associated with fraudulent activity (scam). * * * Below you can find labels which are attached to every group from above. Please note that an address might have many labels. For example, every _DEX_ address is labeled as _DeFi_ as well (_DeFi_ is a parent group for _DEX_ group) or _centralized\_exchange_ addresses most often owe a dedicated _owner_ label. ### [](https://academy.santiment.net/labels/#domains) Domains * [DeFi](https://academy.santiment.net/labels/defi/) * [Bridge](https://academy.santiment.net/labels/bridge/) * [Decentralized exchange](https://academy.santiment.net/labels/decentralized-exchange/) * [Derivatives](https://academy.santiment.net/labels/derivatives/) * [Lending](https://academy.santiment.net/labels/lending/) * [Liquidity](https://academy.santiment.net/labels/liquidity/) * TBA: liquid\_staking * TBA: staking * [Yield Farming](https://academy.santiment.net/labels/yield/) * [CeFi](https://academy.santiment.net/labels/cefi/) * [Centralized exchange](https://academy.santiment.net/labels/centralized-exchange/) * [Fund](https://academy.santiment.net/labels/fund/) * TBA: Market maker * [NFT](https://academy.santiment.net/labels/nft/) * [NFT collection](https://academy.santiment.net/labels/nft-collection/) * [NFT collection name](https://academy.santiment.net/labels/nft-collection-name/) * [NFT collection symbol](https://academy.santiment.net/labels/nft-collection-symbol/) * [NFT marketplace](https://academy.santiment.net/labels/nft-marketplace/) * [ETH2\_Staking](https://academy.santiment.net/labels/eth2-staking/) * [GameFi](https://academy.santiment.net/labels/gamefi/) * [Gambling](https://academy.santiment.net/labels/gambling/) * TBA: mining\_pool ### [](https://academy.santiment.net/labels/#owner) Owner * [Owner](https://academy.santiment.net/labels/owner/) ### [](https://academy.santiment.net/labels/#infrastructure) Infrastructure * [Airdrop Sender](https://academy.santiment.net/labels/airdrop-sender/) * [Deposit](https://academy.santiment.net/labels/deposit/) * [Contract](https://academy.santiment.net/labels/contract/) * [ERC721](https://academy.santiment.net/labels/erc721/) * [ERC1155](https://academy.santiment.net/labels/erc1155/) * [Factory](https://academy.santiment.net/labels/factory/) * [Proxy](https://academy.santiment.net/labels/proxy/) * TBA: Multisig * [Cold wallet](https://academy.santiment.net/labels/cold-wallet/) * [Dead address](https://academy.santiment.net/labels/dead-address/) * [Migration Address](https://academy.santiment.net/labels/migration-address/) * TBA: team\_wallet ### [](https://academy.santiment.net/labels/#activity) Activity * [Airdrop Receiver](https://academy.santiment.net/labels/airdrop-receiver/) * [Charity](https://academy.santiment.net/labels/charity/) * [DEX user](https://academy.santiment.net/labels/dex-user/) * [ETH2 Staking Address](https://academy.santiment.net/labels/eth2-staking-address/) * [Genesis](https://academy.santiment.net/labels/genesis/) * [Miner](https://academy.santiment.net/labels/miner/) * [NFT trader](https://academy.santiment.net/labels/nft-trader/) * [NFT trader threshold](https://academy.santiment.net/labels/nft-trader-threshold/) * [NFT user](https://academy.santiment.net/labels/nft-user/) * [NFT Influencer](https://academy.santiment.net/labels/nft-influencer/) * [Used NFT marketplace](https://academy.santiment.net/labels/used-nft-marketplace/) * [Whale](https://academy.santiment.net/labels/whale/) * [Whale USD Balance](https://academy.santiment.net/labels/whale-usd-balance/) * [Lending User](https://academy.santiment.net/labels/lending-user/) * [Withdrawal](https://academy.santiment.net/labels/withdrawal/) * [Withdrawn From](https://academy.santiment.net/labels/withdrawn-from/) ### [](https://academy.santiment.net/labels/#social-networks) Social networks * TBA: twitter * TBA: opensea\_username ### [](https://academy.santiment.net/labels/#status) Status * [Blocked](https://academy.santiment.net/labels/blocked/) * [Closed](https://academy.santiment.net/labels/closed/) * TBA: Hacked * [Sanctioned](https://academy.santiment.net/labels/sanctioned/) ### [](https://academy.santiment.net/labels/#chain) Chain * TBA: L2 Updated 1 year ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Annual inflation rate | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/annual-inflation-rate/#annual-inflation-rate) Annual inflation rate ============================================================================================================ [](https://academy.santiment.net/metrics/annual-inflation-rate/#description) Description ---------------------------------------------------------------------------------------- The annual inflation rate of cryptocurrencies varies widely depending on the specific cryptocurrency. Unlike traditional fiat currencies, which are often centrally controlled and have predictable inflation rates, cryptocurrencies can have different mechanisms governing their supply. Some cryptocurrencies, like Bitcoin, have a predetermined issuance schedule with a decreasing rate of new coin creation over time, while others may have variable or dynamic supply mechanisms. Additionally, factors such as network consensus rules, mining rewards, and tokenomics can influence the inflation rate of cryptocurrencies. Annual inflation rate metric: * `annual_inflation_rate` - annual inflation rate * * * [](https://academy.santiment.net/metrics/annual-inflation-rate/#access) Access ------------------------------------------------------------------------------ [Free Access](https://academy.santiment.net/metrics/details/access#free-access) * * * [](https://academy.santiment.net/metrics/annual-inflation-rate/#measuring-unit) Measuring Unit ---------------------------------------------------------------------------------------------- Decimal percentage * * * [](https://academy.santiment.net/metrics/annual-inflation-rate/#data-type) Data Type ------------------------------------------------------------------------------------ [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/annual-inflation-rate/#frequency) Frequency ------------------------------------------------------------------------------------ [Daily Intervals](https://academy.santiment.net/metrics/details/frequency#daily-frequency) * * * [](https://academy.santiment.net/metrics/annual-inflation-rate/#latency) Latency -------------------------------------------------------------------------------- [Price Latency](https://academy.santiment.net/metrics/details/latency#price-latency) * * * [](https://academy.santiment.net/metrics/annual-inflation-rate/#available-assets) Available Assets -------------------------------------------------------------------------------------------------- Available for [these assets](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22annual_inflation_rate%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) * * * ### [](https://academy.santiment.net/metrics/annual-inflation-rate/#sanapi) SanAPI Available under name: `annual_inflation_rate` 1 2 3 4 5 6 7 8 9 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22annual_inflation_rate%22)%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22bitcoin%22%0A%20%20%20%20%20%20from%3A%20%222024-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222024-02-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22)%0A%20%20%7D%0A%7D) ** Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Ethereum fees | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/ethereum-fees/#ethereum-fees) Ethereum fees ==================================================================================== [](https://academy.santiment.net/metrics/ethereum-fees/#description) Description -------------------------------------------------------------------------------- Gas fees are the fees paid for the computational efforts required to execute a transaction or operation within a smart contract on the Ethereum network. Each operation in a transaction consumes a specific amount of gas. The total gas fee you pay consists of several components: * Base fee: This is a mandatory fee established by the network for processing a transaction. * Priority fee: An additional, voluntary payment intended to motivate node operators to prioritize your transaction. * Units of gas used: Gas signifies computational effort. More complex tasks, such as interacting with a smart contract, require more gas compared to simpler actions like sending a transaction. The base fee is computed independently of the current block and instead relies on the preceding blocks, enhancing predictability for users regarding transaction fees. Upon block creation, this base fee is burned, effectively removing it from circulation. The gas units consumed per transaction represent the amount of gas used during the transaction, essentially reflecting the complexity of the transaction. Ethereum fees metrics: * `fees`: Total fees paid in ETH over a daily interval * `fees_intraday`: Total fees paid in ETH over 5-minute time intervals * `fees_usd`: Total fees paid in USD over a daily interval * `fees_usd_intraday`: Total fees paid in USD over 5-minute time intervals Aggregated fees metrics: * `average_fees_usd`: Average fees paid in USD over a daily interval * `average_fees_usd_5m`: Average fees paid in USD over 5-minute time intervals * `median_fees_usd`: Median fees paid in USD over a daily interval * `median_fees_usd_5m`: Median fees paid in USD over 5-minute time intervals Fees burnt metrics: * `fees_burnt_5m`: Fees burnt (removed from circulation) in ETH within a 5-minute interval * `fees_burnt_usd_5m`: Fees burnt (removed from circulation) in USD within a 5-minute interval Fees to network circulation metric: * `fees_to_network_circulation_usd_1d`: Calculated using the formula: where represents the total value in USD of all coins moved on Ethereum Gas used metrics: * `avg_gas_used` - Average amount of gas consumed per transaction over 5-minute time intervals in Gwei * `total_gas_used` - Total amount of gas used over 5-minute time intervals * * * [](https://academy.santiment.net/metrics/ethereum-fees/#access) Access ---------------------------------------------------------------------- [Free Access](https://academy.santiment.net/metrics/details/access#free-access) * * * [](https://academy.santiment.net/metrics/ethereum-fees/#measuring-unit) Measuring Unit -------------------------------------------------------------------------------------- * Fees metrics - amount in ETH or USD * `avg_gas_used` - amount in Gwei * `total_gas_used` - gas units * * * [](https://academy.santiment.net/metrics/ethereum-fees/#data-type) Data Type ---------------------------------------------------------------------------- [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/ethereum-fees/#frequency) Frequency ---------------------------------------------------------------------------- [Five-minute Intervals](https://academy.santiment.net/metrics/details/frequency#five-minute-frequency) * * * [](https://academy.santiment.net/metrics/ethereum-fees/#latency) Latency ------------------------------------------------------------------------ [On-Chain Latency](https://academy.santiment.net/metrics/details/latency#on-chain-latency) * * * [](https://academy.santiment.net/metrics/ethereum-fees/#available-assets) Available Assets ------------------------------------------------------------------------------------------ Available for `ethereum` * * * ### [](https://academy.santiment.net/metrics/ethereum-fees/#sanapi) SanAPI Fees metrics in ETH: `fees` and `fees_intraday` 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22fees%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22ethereum%22%0A%20%20%20%20%20%20from%3A%20%222024-03-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222024-03-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Fees metrics in USD: `fees_usd` and `fees_usd_intraday` 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22fees_usd_intraday%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22ethereum%22%0A%20%20%20%20%20%20from%3A%20%222024-03-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222024-03-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%225m%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Aggregated fees metrics: `average_fees_usd`, `average_fees_usd_5m`, `median_fees_usd` and `median_fees_usd_5m` 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22average_fees_usd_5m%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22ethereum%22%0A%20%20%20%20%20%20from%3A%20%222024-03-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222024-03-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%225m%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Fees burnt metrics: `fees_burnt_5m` and `fees_burnt_usd_5m` 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22fees_burnt_5m%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22ethereum%22%0A%20%20%20%20%20%20from%3A%20%222024-03-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222024-03-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Fees to network circulation metric: `fees_to_network_circulation_usd_1d` 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22fees_to_network_circulation_usd_1d%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22ethereum%22%0A%20%20%20%20%20%20from%3A%20%222024-03-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222024-03-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Gas used metrics: `avg_gas_used` and `total_gas_used` 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22avg_gas_used%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22ethereum%22%0A%20%20%20%20%20%20from%3A%20%222024-03-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222024-03-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Daily Aggregated Financial Metrics in USD | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/daily-aggregated-financial-metrics/#daily-aggregated-financial-metrics-in-usd) Daily Aggregated Financial Metrics in USD ================================================================================================================================================================= [](https://academy.santiment.net/metrics/daily-aggregated-financial-metrics/#definition) Definition --------------------------------------------------------------------------------------------------- The following metrics are computed by applying an aggregation of all the values of a metric in a given day. * daily\_avg\_marketcap\_usd * daily\_avg\_price\_usd * daily\_closing\_marketcap\_usd * daily\_closing\_price\_usd * daily\_high\_price\_usd * daily\_low\_price\_usd * daily\_opening\_price\_usd * daily\_trading\_volume\_usd * * * [](https://academy.santiment.net/metrics/daily-aggregated-financial-metrics/#access) Access ------------------------------------------------------------------------------------------- [Free Access](https://academy.santiment.net/metrics/details/access#free-access) * * * [](https://academy.santiment.net/metrics/daily-aggregated-financial-metrics/#measuring-unit) Measuring Unit ----------------------------------------------------------------------------------------------------------- Amount in USD * * * [](https://academy.santiment.net/metrics/daily-aggregated-financial-metrics/#data-type) Data Type ------------------------------------------------------------------------------------------------- [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) [](https://academy.santiment.net/metrics/daily-aggregated-financial-metrics/#frequency) Frequency ------------------------------------------------------------------------------------------------- [Daily Intervals](https://academy.santiment.net/metrics/details/frequency#daily-frequency) * * * [](https://academy.santiment.net/metrics/daily-aggregated-financial-metrics/#latency) Latency --------------------------------------------------------------------------------------------- [Daily Metrics Latency](https://academy.santiment.net/metrics/details/latency#daily-metrics-latency) * * * [](https://academy.santiment.net/metrics/daily-aggregated-financial-metrics/#available-assets) Available Assets --------------------------------------------------------------------------------------------------------------- Available Assets for [daily\_avg\_marketcap\_usd](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22daily_avg_marketcap_usd%22)%7B%0A%20%20%20%20metadata%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D) Use the same API call to check the available metrics for the other metrics. * * * [](https://academy.santiment.net/metrics/daily-aggregated-financial-metrics/#sanapi) SanAPI ------------------------------------------------------------------------------------------- 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22daily_closing_price_usd%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22ethereum%22%0A%20%20%20%20%20%20from%3A%20%222020-04-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-04-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Mean Coin Age | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/mean-coin-age/#mean-coin-age) Mean Coin Age ==================================================================================== [](https://academy.santiment.net/metrics/mean-coin-age/#definition) Definition ------------------------------------------------------------------------------ Recall that the **[coin-age model](https://academy.santiment.net/metrics/details/stack-coin-age-model/) ** allows us at each given point in time to assign age to each coin/token. There are two coin age defined metrics: * Mean Coin Age - The average age of all coins/tokens on the blockchain. * Mean Dollar Invested Age - The average age of every dollar invested into the market cap of a coin. Mean Coin Age metrics are also available for different [time bounds](https://academy.santiment.net/metrics/details/timebound/) , which compute the mean coin age for tokens moved at least once no longer than a specific number of days or years ago. ### [](https://academy.santiment.net/metrics/mean-coin-age/#example-mean-coin-age) Example (Mean Coin age) Given there are 100 tokens in existence: * 50 of them have age 10 days * 50 of them have age 20 days then the average coin age is: ### [](https://academy.santiment.net/metrics/mean-coin-age/#example-mean-dollar-invested-age) Example (Mean Dollar Invested Age) Given there 100 tokens in existence: * 50 of them have age 10 days and the token's price was $1 at that time * 50 of them have age 20 days and the token's price was $2 at that time then the mean dollar invested age is: > More technical definition and computation description can be found [here](https://academy.santiment.net/metrics/mean-coin-age/mean-coin-age-technical/) * * * [](https://academy.santiment.net/metrics/mean-coin-age/#access) Access ---------------------------------------------------------------------- [Restricted Access](https://academy.santiment.net/metrics/details/access#restricted-access) * * * [](https://academy.santiment.net/metrics/mean-coin-age/#measuring-unit) Measuring Unit -------------------------------------------------------------------------------------- * Coin Age in Days * Coin Dollar Age in Days * * * [](https://academy.santiment.net/metrics/mean-coin-age/#data-type) Data Type ---------------------------------------------------------------------------- [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/mean-coin-age/#timebound) Timebound ---------------------------------------------------------------------------- [Timebound Metrics](https://academy.santiment.net/metrics/details/timebound/) * * * [](https://academy.santiment.net/metrics/mean-coin-age/#change-metrics) Change Metrics -------------------------------------------------------------------------------------- [Change Metrics](https://academy.santiment.net/metrics/details/change_metrics/) * * * [](https://academy.santiment.net/metrics/mean-coin-age/#frequency) Frequency ---------------------------------------------------------------------------- [Daily Intervals](https://academy.santiment.net/metrics/details/frequency#daily-frequency) * * * [](https://academy.santiment.net/metrics/mean-coin-age/#latency) Latency ------------------------------------------------------------------------ [On-Chain Latency](https://academy.santiment.net/metrics/details/latency#on-chain-latency) * * * [](https://academy.santiment.net/metrics/mean-coin-age/#available-assets) Available Assets ------------------------------------------------------------------------------------------ * Mean Coin Age is available for [these assets](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22mean_age%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) * Mean Dollar Invested Age is available for [these assets](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22mean_dollar_invested_age%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) > Note: timebound Mean Age metrics are available for [these assets](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22mean_age_90d%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) * * * [](https://academy.santiment.net/metrics/mean-coin-age/#sanapi) SanAPI ---------------------------------------------------------------------- Available under the `mean_age` and `mean_age_` names. 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22mean_age%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22santiment%22%0A%20%20%20%20%20%20from%3A%20%222020-01-13T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-01-18T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** * * * Available under the `mean_dollar_invested_age` and `mean_dollar_invested_age_` names. 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22mean_dollar_invested_age%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22santiment%22%0A%20%20%20%20%20%20from%3A%20%222020-01-13T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-01-18T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** [](https://academy.santiment.net/metrics/mean-coin-age/#full-list-of-metrics) Full list of metrics -------------------------------------------------------------------------------------------------- Mean coin age metrics * mean\_age * mean\_age\_90d * mean\_age\_180d * mean\_age\_365d * mean\_age\_2y * mean\_age\_3y * mean\_age\_5y Mean dollar invested age metrics * mean\_dollar\_invested\_age * mean\_dollar\_invested\_age\_90d * mean\_dollar\_invested\_age\_180d * mean\_dollar\_invested\_age\_365d * mean\_dollar\_invested\_age\_2y * mean\_dollar\_invested\_age\_3y * mean\_dollar\_invested\_age\_5y * mean\_dollar\_invested\_age\_change\_1d * mean\_dollar\_invested\_age\_change\_7d * mean\_dollar\_invested\_age\_change\_30d Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Community Messages Count | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/community-messages-count/#community-messages-count) Community Messages Count ===================================================================================================================== [](https://academy.santiment.net/metrics/community-messages-count/#definition) Definition ----------------------------------------------------------------------------------------- Community Messages Count is build on top of the [Social Data](https://academy.santiment.net/metrics/details/social-data/) . Community Messages Count returns the number of messages written in the asset's own community chat (telegram server) or subreddit (reddit). Currently `telegram` and `reddit` are supported. We constantly update our labels which helps us to keep labels as fresh as possible but result historical data changes. Any modifications to labels, social sources, or relevant jobs will prompt recalculation for the previous month's data. Within a 12 hour period, metric can be supplemented with new data. Experimental metrics, might undergo changes if a future. [](https://academy.santiment.net/metrics/community-messages-count/#access) Access --------------------------------------------------------------------------------- [Restricted Access](https://academy.santiment.net/metrics/details/access#restricted-access) . * * * [](https://academy.santiment.net/metrics/community-messages-count/#measuring-unit) Measuring Unit ------------------------------------------------------------------------------------------------- Amount of documents that mention the given text pattern. * * * [](https://academy.santiment.net/metrics/community-messages-count/#data-type) Data Type --------------------------------------------------------------------------------------- [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/community-messages-count/#frequency) Frequency --------------------------------------------------------------------------------------- [Five-Minute Intervals](https://academy.santiment.net/metrics/details/frequency#five-minute-frequency) * * * [](https://academy.santiment.net/metrics/community-messages-count/#latency) Latency ----------------------------------------------------------------------------------- [Social Data Latency](https://academy.santiment.net/metrics/details/latency#social-data-latency) * * * [](https://academy.santiment.net/metrics/community-messages-count/#available-assets) Available Assets ----------------------------------------------------------------------------------------------------- Available for [these assets](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22community_messages_count_telegram%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) > Note: `community_messages_count_telegram`, `community_messages_count_reddit` metric are available for the same set of assets. * * * [](https://academy.santiment.net/metrics/community-messages-count/#sanapi) SanAPI --------------------------------------------------------------------------------- Available under the `community_messages_count_reddit` and `community_messages_count_telegram` names. 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22community_messages_count_reddit%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20selector%3A%20%7B%20slug%3A%20%22solana%22%20%7D%0A%20%20%20%20%20%20from%3A%20%222025-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222025-01-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** [](https://academy.santiment.net/metrics/community-messages-count/#full-list-of-metrics) Full list of metrics ------------------------------------------------------------------------------------------------------------- The full list of Community Message Count metrics is: Open Metrics List * community\_messages\_count\_telegram * community\_messages\_count\_reddit Updated 11 minutes ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Gini Index | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/gini-index/#gini-index) Gini Index =========================================================================== [](https://academy.santiment.net/metrics/gini-index/#description) Description ----------------------------------------------------------------------------- The Gini index is a statistical measure of income or wealth distribution within a population, ranging from 0 (perfect equality) to 1 (perfect inequality). It quantifies the extent of economic inequality, with lower values indicating more equitable distributions and higher values indicating greater disparities. Mathematically, the Gini index is calculated using the Lorenz curve, which plots the cumulative share of income or wealth held by the bottom x% of the population against the cumulative share of the population. The Gini index is then calculated as the area between the Lorenz curve and the line of perfect equality, divided by the total area under the line of perfect equality. The Gini index can also be applied to cryptocurrencies to measure the distribution of wealth or coins within a particular cryptocurrency ecosystem. By analyzing the distribution of cryptocurrency holdings among addresses or users, the Gini index can provide insights into the concentration of wealth or coins within the cryptocurrency network. Gini index metric: * `gini_index` - Gini index * * * [](https://academy.santiment.net/metrics/gini-index/#access) Access ------------------------------------------------------------------- [Free Access](https://academy.santiment.net/metrics/details/access#free-access) * * * [](https://academy.santiment.net/metrics/gini-index/#measuring-unit) Measuring Unit ----------------------------------------------------------------------------------- Value between 0 and 1 * * * [](https://academy.santiment.net/metrics/gini-index/#data-type) Data Type ------------------------------------------------------------------------- [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/gini-index/#frequency) Frequency ------------------------------------------------------------------------- [Daily Intervals](https://academy.santiment.net/metrics/details/frequency#daily-frequency) * * * [](https://academy.santiment.net/metrics/gini-index/#latency) Latency --------------------------------------------------------------------- [Price Latency](https://academy.santiment.net/metrics/details/latency#price-latency) * * * [](https://academy.santiment.net/metrics/gini-index/#available-assets) Available Assets --------------------------------------------------------------------------------------- Available for [these assets](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22gini_index%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) * * * ### [](https://academy.santiment.net/metrics/gini-index/#sanapi) SanAPI Available under name: `gini_index` 1 2 3 4 5 6 7 8 9 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22gini_index%22)%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22bitcoin%22%0A%20%20%20%20%20%20from%3A%20%222024-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222024-02-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22)%0A%20%20%7D%0A%7D) ** Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # RSI | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/rsi/#rsi) RSI ====================================================== [](https://academy.santiment.net/metrics/rsi/#description) Description ---------------------------------------------------------------------- The Relative Strength Index (RSI) is a popular momentum oscillator used in technical analysis to assess the magnitude and speed of price movements. RSI is typically applied to identify overbought or oversold conditions in a financial instrument, helping traders gauge potential trend reversals. The metric is calculated using the average gains and losses over a specified period, often 14 days, and is expressed as a numerical value between 0 and 100. A reading above 70 on the RSI suggests that an asset may be overbought, indicating a potential reversal or correction, while a reading below 30 suggests oversold conditions, signaling a possible upward price movement. Traders commonly use RSI in conjunction with other technical indicators to make informed decisions about entering or exiting positions in financial markets. RSI metric is available for 3 different time periods * `rsi_4h` - RSI for a 4-hour time frame * `rsi_1d` - RSI for a 1-day time frame * `rsi_7d` - RSI for a 7-day time frame > Note: Even though metrics are available for 5-minute intervals, the recommendation is to use them within their designated time frame. For instance, consider using a 1-day interval for `rsi_1d`. * * * [](https://academy.santiment.net/metrics/rsi/#access) Access ------------------------------------------------------------ [Restricted Access](https://academy.santiment.net/metrics/details/access#restricted-access) * * * [](https://academy.santiment.net/metrics/rsi/#measuring-unit) Measuring Unit ---------------------------------------------------------------------------- Numerical value between 0 and 100 * * * [](https://academy.santiment.net/metrics/rsi/#data-type) Data Type ------------------------------------------------------------------ [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/rsi/#frequency) Frequency ------------------------------------------------------------------ [Five-minute Intervals](https://academy.santiment.net/metrics/details/frequency#five-minute-frequency) * * * [](https://academy.santiment.net/metrics/rsi/#latency) Latency -------------------------------------------------------------- [Price Latency](https://academy.santiment.net/metrics/details/latency#price-latency) * * * [](https://academy.santiment.net/metrics/rsi/#available-assets) Available Assets -------------------------------------------------------------------------------- Available for [these assets](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22rsi_4h%22)%7B%0A%20%20%20%20metadata%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D) > Note: All metrics are available for the same set of assets * * * ### [](https://academy.santiment.net/metrics/rsi/#sanapi) SanAPI Available under names: `rsi_4h`, `rsi_1d` and `rsi_7d` 1 2 3 4 5 6 7 8 9 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22rsi_1d%22)%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22bitcoin%22%0A%20%20%20%20%20%20from%3A%20%222023-11-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222023-12-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22)%0A%20%20%7D%0A%7D) ** Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Sentiment metrics | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/sentiment-metrics/#sentiment-metrics) Sentiment metrics ================================================================================================ [](https://academy.santiment.net/metrics/sentiment-metrics/#our-sentiment-metrics) Our Sentiment Metrics -------------------------------------------------------------------------------------------------------- * [Positive/Negative Sentiment](https://academy.santiment.net/metrics/sentiment-metrics/positive-negative-sentiment-metrics/) - Shows how many mentions of a term/asset are expressed in a positive/negative manner. * [Bullish/Bearish Sentiment](https://academy.santiment.net/metrics/sentiment-metrics/bullish-bearish-sentiment-metrics/) - Shows how many mentions of a term/asset are expressed in a bullish/bearish manner. * [Sentiment Balance](https://academy.santiment.net/metrics/sentiment-metrics/positive-negative-sentiment-metrics/) - The difference between Positive Sentiment and Negative Sentiment * [Sentiment Weighted](https://academy.santiment.net/metrics/sentiment-metrics/weighted-sentiment-metrics/) - An improved version of the Sentiment Balance that adjusts the values by considering the number of mentions, standardizing data to make diverse asset sentiments comparable. [](https://academy.santiment.net/metrics/sentiment-metrics/#what-is-sentiment) What is Sentiment? ------------------------------------------------------------------------------------------------- **Sentiment** is the attitude, thought or judgement that people have which is based on their feelings. **Positive sentiment** is an attitude that is hopeful, confident, and considering of the good aspects of a situation or a subject. In the context of cryptocurrencies this can manifest as optimism about the future of a coin, hope that the price will increase, belief in the success of a token, and many more. **Negative sentiment** is an attitude that is critical, disapproving, and considering of the bad aspects of a situation or a subject. In the context of cryptocurrencies this can manifest as expressing the opinion that a token is a scam, belief that a coin will fail, and many more. **Sentiment Analysis** is the problem of computationally identifying and categorizing emotions, opinions and subjective information in a given piece of text. ⚠️ We constantly update our labels which helps us to keep labels as fresh as possible but result historical data changes. Any modifications to labels, social sources, or relevant jobs will prompt recalculation for the previous month's data. Within a 12 hour period, metric can be supplemented with new data. [](https://academy.santiment.net/metrics/sentiment-metrics/#sentiment-score) Sentiment Score -------------------------------------------------------------------------------------------- We trained a machine learning model on a large Twitter dataset that contains over 1.6 million tweets, each labelled as either **positive** or **negative**. The model is then used to evaluate the sentiment of each single document in the [Social Data](https://academy.santiment.net/metrics/details/social-data/) set it assigns a positive and negative **sentiment score** to each message/post/comment/etc. The score is the probability that the content of the text is positive or negative respectively. Therefore both the **positive** and **negative** sentiment scores fall in a range between 0 (not positive/negative at all) and 1 (extremely positive/negative). Moreover, the sum of these two scores always equals 1. Example: > I'm really excited about the new Libra currency! This message has a **positive** score of **0.75** and a **negative** score of **0.25**. We use this approach for messages and comments from social networks conversations because the structure of the text there is usually more or less the same: short messages with a single and/or simple idea behind them. But this is not the case for all the messages: some of them might be long and complicated, some might be just neutral or contain spam or other irrelevant information. These kind of messages usually have a pretty vanished pair of sentiment scores: both **positive** and **negative** scores are close to 0.5. We don't include these kind of messages while calculating the **Sentiment Metrics**: they are filtered out by a certain threshold. [](https://academy.santiment.net/metrics/sentiment-metrics/#bullish-bearish-sentiment-score) Bullish Bearish Sentiment Score ---------------------------------------------------------------------------------------------------------------------------- We are using `ElKulako/cryptobert` model from [Hugging Face](https://huggingface.co/) 🤗. This model was trained on crypto related tweets, reddit comments, and telegram posts. Model returns three probability scores: `bullish`, `neutral`, `bearish`. Each probability score is fall in a range between 0 and 1. Sum of all three scores equals to 1. Because it is based on the BERT model, it better understands the context of the text. [](https://academy.santiment.net/metrics/sentiment-metrics/#metrics-calculation) Metrics Calculation ---------------------------------------------------------------------------------------------------- To ensure relevance and accuracy, only text with a sentiment score above a certain threshold is considered in our sentiment metrics. This approach filters out neutral, spam, or irrelevant messages, focusing on the most impactful data. Our sentiment metrics are recalculated monthly to account for any changes in our models or data sources, providing you with the most up-to-date insights. Updated 11 minutes ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Social Dominance | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/social-dominance/#social-dominance) Social Dominance ============================================================================================= [](https://academy.santiment.net/metrics/social-dominance/#definition) Definition --------------------------------------------------------------------------------- Social Dominance shows the share of the discussions in crypto media that is referring to a particular asset or phrase. The metric is build on top of the [Social Data](https://academy.santiment.net/metrics/details/social-data/) . We constantly update our labels which helps us to keep labels as fresh as possible but result historical data changes. Any modifications to labels, social sources, or relevant jobs will prompt recalculation for the previous month's data. Within a 12 hour period, metric can be supplemented with new data. ### [](https://academy.santiment.net/metrics/social-dominance/#social-dominance-for-an-asset) Social Dominance for an Asset Social Dominance for an asset compares the [Social Volume](https://academy.santiment.net/metrics/social-volume/) of that asset to the combined social volume of the 100 largest assets by marketcap. Social Dominance of 50% for an asset means that the number of messages/posts that discuss this asset equal half the number of messages/posts that discuss the Top 100 assets. > This definition allows the social dominance of an asset to exceed 100%. This can happen for assets whose name and/or ticker is a very common English word. ### [](https://academy.santiment.net/metrics/social-dominance/#social-dominance-for-a-text-phrase) Social Dominance for a text phrase Social Dominance for an arbitrary text phrase compares the [Social Volume](https://academy.santiment.net/metrics/social-volume/) of that search term to the total number of documents available. This essentially computes the percentage of all documents that match this search term. [](https://academy.santiment.net/metrics/social-dominance/#access) Access ------------------------------------------------------------------------- [Restricted Access](https://academy.santiment.net/metrics/details/access#restricted-access) . * * * [](https://academy.santiment.net/metrics/social-dominance/#measuring-unit) Measuring Unit ----------------------------------------------------------------------------------------- Number - % between 0 and 100 * * * [](https://academy.santiment.net/metrics/social-dominance/#data-type) Data Type ------------------------------------------------------------------------------- [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/social-dominance/#change-metrics) Change Metrics ----------------------------------------------------------------------------------------- [Change Metrics](https://academy.santiment.net/metrics/details/change_metrics/) * * * [](https://academy.santiment.net/metrics/social-dominance/#frequency) Frequency ------------------------------------------------------------------------------- [Five-Minute Intervals](https://academy.santiment.net/metrics/details/frequency#five-minute-frequency) * * * [](https://academy.santiment.net/metrics/social-dominance/#latency) Latency --------------------------------------------------------------------------- [Social Data Latency](https://academy.santiment.net/metrics/details/latency#social-data-latency) * * * [](https://academy.santiment.net/metrics/social-dominance/#available-assets) Available Assets --------------------------------------------------------------------------------------------- Available for [these assets](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22social_dominance_total%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) > Note: `social_dominance_total` metric and all metrics for a specific source are available for the same set of assets. * * * [](https://academy.santiment.net/metrics/social-dominance/#sanbase) Sanbase --------------------------------------------------------------------------- Combined Social Dominance from all sources for an asset can be seen on a [project's page](https://app.santiment.net/projects/santiment?from=2019-10-12T21%3A00%3A00.000Z&interval=12h&isAnomalyActive=false&isCartesianGridActive=false&isICOPriceActive=true&isLogScale=false&isMultiChartsActive=false&metrics=price_usd,social_dominance_total&projectId=101605&slug=santiment&ticker=SAN&timeRange=6m&title=Santiment%20%28SAN%29&to=2020-04-13T21%3A00%3A00.000Z) . Social Dominance for arbitrary search terms can be viewed from the [trends page](https://app.santiment.net/social-trends) ![trends page](https://academy.santiment.net/metrics/social-dominance/trends-page.png) and enabling the Social Dominance toggle on the next page that shows the result. The combined social dominance from all sources is displayed ![social dominance search term](https://academy.santiment.net/metrics/social-dominance/social-dominance-search-term.png) [](https://academy.santiment.net/metrics/social-dominance/#sanapi) SanAPI ------------------------------------------------------------------------- Available under the `social_dominance_total` and `social_dominance_total_` names, where the available sources are: * 4chan * telegram * reddit * twitter * bitcointalk * youtube\_videos * farcaster * total (combines all sources) ### [](https://academy.santiment.net/metrics/social-dominance/#social-dominance-for-an-asset) Social Dominance for an asset 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22social_dominance_total%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20selector%3A%20%7B%20slug%3A%20%22santiment%22%20%7D%0A%20%20%20%20%20%20from%3A%20%222020-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-01-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** * * * ### [](https://academy.santiment.net/metrics/social-dominance/#social-dominance-for-arbitrary-search-term) Social Dominance for arbitrary search term 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22social_dominance_telegram%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20selector%3A%20%7B%20text%3A%20%22btc%20AND%201%3Fk%22%20%7D%0A%20%20%20%20%20%20from%3A%20%222020-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-01-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** [](https://academy.santiment.net/metrics/social-dominance/#full-list-of-metrics) Full list of metrics ----------------------------------------------------------------------------------------------------- The full list of Social Dominance metrics is: Open Metrics List * social\_dominance\_4chan * social\_dominance\_ai\_total * social\_dominance\_bitcointalk * social\_dominance\_reddit * social\_dominance\_telegram * social\_dominance\_total * social\_dominance\_twitter * social\_dominance\_youtube\_videos * social\_dominance\_farcaster Open Change Metrics List * social\_dominance\_total\_change\_1d * social\_dominance\_total\_change\_30d * social\_dominance\_total\_change\_7d Open Moving Average Metrics List * social\_dominance\_4chan\_1h\_moving\_average * social\_dominance\_4chan\_24h\_moving\_average * social\_dominance\_ai\_total\_1h\_moving\_average * social\_dominance\_ai\_total\_24h\_moving\_average * social\_dominance\_bitcointalk\_1h\_moving\_average * social\_dominance\_bitcointalk\_24h\_moving\_average * social\_dominance\_reddit\_1h\_moving\_average * social\_dominance\_reddit\_24h\_moving\_average * social\_dominance\_telegram\_1h\_moving\_average * social\_dominance\_telegram\_24h\_moving\_average * social\_dominance\_total\_1h\_moving\_average * social\_dominance\_total\_24h\_moving\_average * social\_dominance\_twitter\_1h\_moving\_average * social\_dominance\_twitter\_24h\_moving\_average * social\_dominance\_youtube\_videos\_1h\_moving\_average * social\_dominance\_youtube\_videos\_24h\_moving\_average * social\_dominance\_farcaster\_1h\_moving\_average * social\_dominance\_farcaster\_24h\_moving\_average Open Moving Average Change Metrics List * social\_dominance\_total\_1h\_moving\_average\_change\_1d * social\_dominance\_total\_1h\_moving\_average\_change\_30d * social\_dominance\_total\_1h\_moving\_average\_change\_7d * social\_dominance\_total\_24h\_moving\_average\_change\_1d * social\_dominance\_total\_24h\_moving\_average\_change\_30d * social\_dominance\_total\_24h\_moving\_average\_change\_7d Updated 11 minutes ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Transacted Coin Acquisition Cost | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/transacted-coin-acquisition-cost/#transacted-coin-acquisition-cost) Transacted Coin Acquisition Cost ============================================================================================================================================= [](https://academy.santiment.net/metrics/transacted-coin-acquisition-cost/#definition) Definition ------------------------------------------------------------------------------------------------- For the coins/tokens transacted on a given day, get the price they were acquired at. Any movement of coins/tokens on-chain is treated as an acquisition. The metric does not include: * Minting/mining/uncle rewards. * Transactions of coins/tokens that were acquired on the same day. This would handle most situation with deposit/withdrawal addresses. * Example: There are two transactions on the same day: `A - 10ETH -> B` and `B -> 10ETH C` - `B` moves the coins on the same day that they were received. This second transaction is not counted. The total number of coins/tokens that are counted is equal to the [1-day circulation](https://academy.santiment.net/metrics/circulation/) (**not** the [transaction volume](https://academy.santiment.net/metrics/transaction-volume/) ) **minus** the block rewards/uncle rewards/mints. The metric returns a list of prices ranges and a number of coins/tokens that were last time moved when the price was in that range. The ranges have even length with the exception of the range that contains the queried day price. This range is split around that price, resulting in two ranges. This has the benefit of knowing exactly how many coins/tokens were last time moved when the price was above or below the queried day price. ### [](https://academy.santiment.net/metrics/transacted-coin-acquisition-cost/#example) Example Let's take a look at what prices were aquired the bitcoins transacted on 09 November 2021 when bitcoin reached an all time high of over $68,000: * `[$low - $high]` - `number of bitcoins` * `[$0 - $16,886.13]` - `9,497.95` * `[$16,886.13 - $33,772.26]` - `1290.67` * `[$33,772.26 - $50,658.39]` - `14,159.67` * `[$50,658.39 - $59,987.51]` - `2711.52` * `[$59,987.51 - ∞]` - `178,339.76` It is clear that when the price is at its all time high all of the sellers are profiting but some are profiting much more than others. The majority of the bitcoins were last time moved when the price was in the range $59.9k-$57.5k. But there are 9,497.95 bitcoins that moved last when the price was under $16.9k. ### [](https://academy.santiment.net/metrics/transacted-coin-acquisition-cost/#example) Example Let's take a look at what prices were aquired the bitcoins transacted on 20 July 2021 when bitcoin reached a local minimum of around $29,000, after reaching to over $64,000 just 3 months before that: * `[$low - $high]` - `number of bitcoins` * `[$0 - $15880.41]` - `13586.16` * `[$15880.41 - $29842.86]` - `694.53` * `[$29842.86 - $31760.82]` - `52818.93` * `[$31760.82 - $47641.23]` - `41785.33` * `[$47641.23 - $63521.64]` - `4693.35` * `[$63521.64 - ∞]` - `146.27` Looking at this data we concule that majority of the bitcoins, around 99.9k or around 87% of all bitcoins transacted, were last moved when the price was higher. This would mean that most of transactions on that day resulted in a loss. [](https://academy.santiment.net/metrics/transacted-coin-acquisition-cost/#access) Access ----------------------------------------------------------------------------------------- [Restricted Access](https://academy.santiment.net/metrics/details/access#restricted-access) * * * [](https://academy.santiment.net/metrics/transacted-coin-acquisition-cost/#measuring-unit) Measuring Unit --------------------------------------------------------------------------------------------------------- Number coins/tokens per price range * * * [](https://academy.santiment.net/metrics/transacted-coin-acquisition-cost/#data-type) Data Type ----------------------------------------------------------------------------------------------- [Histogram Data](https://academy.santiment.net/metrics/details/data-type#histogram-data) * * * [](https://academy.santiment.net/metrics/transacted-coin-acquisition-cost/#frequency) Frequency ----------------------------------------------------------------------------------------------- [Five-Minute Intervals](https://academy.santiment.net/metrics/details/frequency#five-minute-frequency) * * * [](https://academy.santiment.net/metrics/transacted-coin-acquisition-cost/#latency) Latency ------------------------------------------------------------------------------------------- [On-Chain Latency](https://academy.santiment.net/metrics/details/latency#on-chain-latency) * * * [](https://academy.santiment.net/metrics/transacted-coin-acquisition-cost/#available-assets) Available Assets ------------------------------------------------------------------------------------------------------------- Available for [these assets](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22price_histogram%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) * * * [](https://academy.santiment.net/metrics/transacted-coin-acquisition-cost/#sanapi) SanAPI ----------------------------------------------------------------------------------------- Available under `price_histogram` and `spent_coins_cost` metric names. Both metrics return exactly the same data. 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 **[Run in Explorer](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22price_histogram%22)%20%7B%0A%20%20%20%20histogramData(%0A%20%20%20%20%20%20slug%3A%20%22santiment%22%0A%20%20%20%20%20%20from%3A%20%222020-04-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-04-08T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20%20%20limit%3A%2010%0A%20%20%20%20)%20%7B%0A%20%20%20%20%20%20values%20%7B%0A%20%20%20%20%20%20%20%20...%20on%20FloatRangeFloatValueList%20%7B%0A%20%20%20%20%20%20%20%20%20%20data%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20range%0A%20%20%20%20%20%20%20%20%20%20%20%20value%0A%20%20%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20%7D%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D) ** Updated 4 years ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Trending Words Rank | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/trending-words-rank/#trending-words-rank) Trending Words Rank ====================================================================================================== [](https://academy.santiment.net/metrics/trending-words-rank/#definition) Definition ------------------------------------------------------------------------------------ Trending Words Rank is build on top of the [Social Data](https://academy.santiment.net/metrics/details/social-data/) . Trending Words Rank for an asset represents position of that asset based on top trending words score. Data for asset and some time interval only appears if asset for that time interval is in top trending words. Please note that metrics may undergo changes in historical values due to automated recalculations triggered monthly. We constantly update our labels which helps us to keep labels as fresh as possible but result historical data changes. Any modifications to labels, social sources, or relevant jobs will prompt recalculation for the previous month's data. Within a 12 hour period, metric can be supplemented with new data. [](https://academy.santiment.net/metrics/trending-words-rank/#access) Access ---------------------------------------------------------------------------- [Restricted Access](https://academy.santiment.net/metrics/details/access#restricted-access) . * * * [](https://academy.santiment.net/metrics/trending-words-rank/#measuring-unit) Measuring Unit -------------------------------------------------------------------------------------------- Ordinal number * * * [](https://academy.santiment.net/metrics/trending-words-rank/#data-type) Data Type ---------------------------------------------------------------------------------- [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/trending-words-rank/#frequency) Frequency ---------------------------------------------------------------------------------- [Daily Intervals](https://academy.santiment.net/metrics/details/frequency#daily-frequency) * * * [](https://academy.santiment.net/metrics/trending-words-rank/#latency) Latency ------------------------------------------------------------------------------ [Social Data Latency](https://academy.santiment.net/metrics/details/latency#social-data-latency) * * * [](https://academy.santiment.net/metrics/trending-words-rank/#available-assets) Available Assets ------------------------------------------------------------------------------------------------ Available for [these assets](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22trending_words_rank%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) * * * [](https://academy.santiment.net/metrics/trending-words-rank/#sanapi) SanAPI ---------------------------------------------------------------------------- Available under the `trending_words_rank` name. 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22trending_words_rank%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22santiment%22%0A%20%20%20%20%20%20from%3A%20%222022-05-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222022-05-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Unique Social Volume | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/unique-social-volume/#unique-social-volume) Unique Social Volume ========================================================================================================= [](https://academy.santiment.net/metrics/unique-social-volume/#definition) Definition ------------------------------------------------------------------------------------- Unique Social Volume is build on top of the [Social Data](https://academy.santiment.net/metrics/details/social-data/) . The **Unique Social Volume** is the same type of aggregation on top of the social data as the **Social Volume**, but it takes into account only the unique text documents for each interval, i.e. completely duplicated messages will be excluded from the calculations, which results in a slightly lower and to some degree cleaner way to measure the volume of mentions for a given asset or word. There are two separate metrics for the unique social volume: * unique\_social\_volume\_total\_5m * unique\_social\_volume\_total\_1h * unique\_social\_volume\_total\_1d The `5m`, `1h` and `1d` control what range of data is used. If some spam messages are posted in the span of 30 minutes, then every one of the six 5-minute buckets would have one copy of that message. In the case of `1h` all these messages would be reduced to a single one, thus providing more aggresive spam filtering. When comparing `unique_social_volume_total_1h` and `unique_social_volume_total_5m` aggregated at `1h` intervals, the `unique_social_volume_total_1h` will always have less or equal values. We constantly update our labels which helps us to keep labels as fresh as possible but result historical data changes. Any modifications to labels, social sources, or relevant jobs will prompt recalculation for the previous month's data. Within a 12 hour period, metric can be supplemented with new data. * * * [](https://academy.santiment.net/metrics/unique-social-volume/#access) Access ----------------------------------------------------------------------------- [Restricted Access](https://academy.santiment.net/metrics/details/access#restricted-access) . * * * [](https://academy.santiment.net/metrics/unique-social-volume/#measuring-unit) Measuring Unit --------------------------------------------------------------------------------------------- Amount of distinct documents that mention the given text pattern. * * * [](https://academy.santiment.net/metrics/unique-social-volume/#data-type) Data Type ----------------------------------------------------------------------------------- [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/unique-social-volume/#frequency) Frequency ----------------------------------------------------------------------------------- [Five-Minute Intervals](https://academy.santiment.net/metrics/details/frequency#five-minute-frequency) [One-Hour Intervals](https://academy.santiment.net/metrics/details/frequency#hourly-frequency) * * * [](https://academy.santiment.net/metrics/unique-social-volume/#latency) Latency ------------------------------------------------------------------------------- [Social Data Latency](https://academy.santiment.net/metrics/details/latency#social-data-latency) * * * [](https://academy.santiment.net/metrics/unique-social-volume/#available-assets) Available Assets ------------------------------------------------------------------------------------------------- Available for [these assets](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22unique_social_volume_5m%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) > Note: All the unique social volume metrics are available for the same set of assets. * * * [](https://academy.santiment.net/metrics/unique-social-volume/#sanapi) SanAPI ----------------------------------------------------------------------------- Available under the: * unique\_social\_volume\_total\_5m * unique\_social\_volume\_total\_1h * unique\_social\_volume\_total\_1d * unique\_social\_volume\_telegram\_5m * unique\_social\_volume\_telegram\_1h * unique\_social\_volume\_telegram\_1d * unique\_social\_volume\_reddit\_5m * unique\_social\_volume\_reddit\_1h * unique\_social\_volume\_reddit\_1d * unique\_social\_volume\_twitter\_5m * unique\_social\_volume\_twitter\_1h * unique\_social\_volume\_twitter\_1d * unique\_social\_volume\_bitcointalk\_5m * unique\_social\_volume\_bitcointalk\_1h * unique\_social\_volume\_bitcointalk\_1d * unique\_social\_volume\_4chan\_5m * unique\_social\_volume\_4chan\_1h * unique\_social\_volume\_4chan\_1d * unique\_social\_volume\_farcaster\_5m * unique\_social\_volume\_farcaster\_1h * unique\_social\_volume\_farcaster\_1d ### [](https://academy.santiment.net/metrics/unique-social-volume/#unique-social-volume-computed-on-5-minute-intervals) Unique Social Volume computed on 5 minute intervals 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22unique_social_volume_total_5m%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20selector%3A%20%7B%20slug%3A%20%22santiment%22%20%7D%0A%20%20%20%20%20%20from%3A%20%222017-11-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-12-31T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221w%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** * * * ### [](https://academy.santiment.net/metrics/unique-social-volume/#unique-social-volume-computed-on-1-hour-intervals) Unique Social Volume computed on 1 hour intervals 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22unique_social_volume_total_1h%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20selector%3A%20%7B%20slug%3A%20%22santiment%22%20%7D%0A%20%20%20%20%20%20from%3A%20%222017-11-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-12-31T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221w%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Updated 3 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # 404: Not found Looks like you got lost ======================= The page you're looking for is missing or your link is incorrect. [Back to home page](https://academy.santiment.net/) --- # Price Volatility | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/price-volatility/#price-volatility) Price Volatility ============================================================================================= [](https://academy.santiment.net/metrics/price-volatility/#description) Description ----------------------------------------------------------------------------------- Price volatility is used to describe price fluctuations of an asset. If we use and to denote mean and standard deviation of asset prices, then we define **Price Volatility** as: Price volatility metrics are available for 4 different time periods * `price_volatility_1d` - Price volatility for the last day * `price_volatility_1w` - Price volatility for the last 7 days * `price_volatility_2w` - Price volatility for the last 14 days * `price_volatility_4w` - Price volatility for the last 28 days Examples of use cases: * Traders seek volatile assets because they move more quickly and have larger price changes. Those price changes are both upward and downward. Keeping this in mind, a trader needs effective risk management in order to trade volatile assets profitably. * On the other hand, some traders seek exposure to the assets that are the least volatile, and they might use this metric to identify those assets. * * * [](https://academy.santiment.net/metrics/price-volatility/#access) Access ------------------------------------------------------------------------- [Free Access](https://academy.santiment.net/metrics/details/access#free-access) * * * [](https://academy.santiment.net/metrics/price-volatility/#measuring-unit) Measuring Unit ----------------------------------------------------------------------------------------- Volatility * * * [](https://academy.santiment.net/metrics/price-volatility/#data-type) Data Type ------------------------------------------------------------------------------- [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/price-volatility/#frequency) Frequency ------------------------------------------------------------------------------- [Five-minute Intervals](https://academy.santiment.net/metrics/details/frequency#five-minute-frequency) * * * [](https://academy.santiment.net/metrics/price-volatility/#latency) Latency --------------------------------------------------------------------------- [Price Latency](https://academy.santiment.net/metrics/details/latency#price-latency) * * * [](https://academy.santiment.net/metrics/price-volatility/#available-assets) Available Assets --------------------------------------------------------------------------------------------- Available for [these assets](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22price_volatility_1d%22)%7B%0A%20%20%20%20metadata%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D) > Note: All metrics are available for the same set of assets * * * ### [](https://academy.santiment.net/metrics/price-volatility/#sanapi) SanAPI Available under names: `price_volatility_1d`, `price_volatility_1w`, `price_volatility_2w` and `price_volatility_4w` 1 2 3 4 5 6 7 8 9 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22price_volatility_1d%22)%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22santiment%22%0A%20%20%20%20%20%20from%3A%20%222022-11-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222022-11-03T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%225m%22)%0A%20%20%7D%0A%7D) ** Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Development Activity Metric | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/development-activity/development-activity/#development-activity-metric) Development Activity Metric ============================================================================================================================================ [](https://academy.santiment.net/metrics/development-activity/development-activity/#definition) Definition ---------------------------------------------------------------------------------------------------------- Development Activity metric shows the 'pure' development activity. It excludes events that are not related to development like: * Comments on issues; * Issues created and closed; * Creating of forks; * Comments on commits; * People following an issue; * Downloading releases; * Watching a repository; * Project management events; * Other. This allows for better comparison between projects that use GitHub for issue tracking and projects that use an external tool (like Notion) for issue tracking. If such events are not excluded then some projects have inflated activity just by discussing what they are going to build without actually building it. Inactive projects might have non-zero activity caused by people creating issues and asking the team to fix something, without any actual work being done. There are 3 development activity metrics available: * `dev_activity` - Computed on-the-fly using the Github data. Because of this the metric can compute data for any asset or just any random Github organization that has public repositories like Google, Facebook, or any other organization. * `dev_activity_1d` - Precomputed daily metric for each asset that is available on Santiment. This allows the metric to be aggregated when the value is needed for all assets at once. * `ecosystem_dev_activity` - Precomputed for each ecosystem. An ecosystem dev activity is defined as the sum of the dev activities of all assets that belong to it. For example the `ethereum` ecosystem contains all the projects that build on the Ethereum blockchain or contribute to the blockchain in any other way. * * * [](https://academy.santiment.net/metrics/development-activity/development-activity/#access) Access -------------------------------------------------------------------------------------------------- [Free Access](https://academy.santiment.net/metrics/details/access#free-access) * * * [](https://academy.santiment.net/metrics/development-activity/development-activity/#data-type) Data Type -------------------------------------------------------------------------------------------------------- [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/development-activity/development-activity/#change-metrics) Change Metrics ------------------------------------------------------------------------------------------------------------------ [Change Metrics](https://academy.santiment.net/metrics/details/change_metrics/) * * * [](https://academy.santiment.net/metrics/development-activity/development-activity/#frequency) Frequency -------------------------------------------------------------------------------------------------------- * `dev_activity` - [Five-Minute Intervals](https://academy.santiment.net/metrics/details/frequency#five-minute-frequency) * `dev_activity_1d` - [Daily Intervals](https://academy.santiment.net/metrics/details/frequency#daily-frequency) * `ecosystem_dev_activity` - [Daily Intervals](https://academy.santiment.net/metrics/details/frequency#daily-frequency) * * * [](https://academy.santiment.net/metrics/development-activity/development-activity/#latency) Latency ---------------------------------------------------------------------------------------------------- [Development Activity Data Latency](https://academy.santiment.net/metrics/details/latency#development-activity-latency) * * * [](https://academy.santiment.net/metrics/development-activity/development-activity/#available-assets) Available Assets ---------------------------------------------------------------------------------------------------------------------- * `dev_activity` [available assets](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric:%20%22dev_activity%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) * `dev_activity_1d` [available assets](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric:%20%22dev_activity_1d%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) * `ecosystem_dev_activity` [available ecosystems](https://api.santiment.net/graphiql?query=%7B%0A%20%20getEcosystems%20%7B%0A%20%20%20%20name%0A%20%20%7D%0A%7D%0A) * * * [](https://academy.santiment.net/metrics/development-activity/development-activity/#sanapi) SanAPI -------------------------------------------------------------------------------------------------- Fetch the dev activity for an asset: 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22dev_activity%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22santiment%22%0A%20%20%20%20%20%20from%3A%20%222020-01-13T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-01-18T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** * * * Fetch the `dev_activity` for an arbitrary organization. You need to provide only the organization name to the parameter, not the whole URL. Github links look like this: `https://github.com//`. 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22dev_activity%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20selector%3A%20%7Borganization%3A%20%22google%22%7D%0A%20%20%20%20%20%20from%3A%20%222020-01-13T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-01-18T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** * * * Fetch the `ecosystem_dev_activity`, combining the dev activities of all assets that contribute to that ecosystem: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getEcosystems(ecosystems%3A%20%5B%22Ethereum%22%5D)%20%7B%0A%20%20%20%20timeseriesData(%0A%20%20%20%20%20%20metric%3A%20%22ecosystem_dev_activity%22%0A%20%20%20%20%20%20from%3A%20%222024-03-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222024-03-10T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%20%20%7B%0A%20%20%20%20%20%20datetime%0A%20%20%20%20%20%20value%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D) ** * * * To check what assets are part of the ecosystem and what are their github links: 1 2 3 4 5 6 7 8 9 **[Run in Explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getEcosystems(ecosystems%3A%20%5B%22ethereum%22%5D)%7B%0A%20%20%20%20name%0A%20%20%20%20projects%7B%0A%20%20%20%20%20%20slug%0A%20%20%20%20%20%20githubLinks%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) ** * * * [](https://academy.santiment.net/metrics/development-activity/development-activity/#full-list-of-metrics) Full list of metrics ------------------------------------------------------------------------------------------------------------------------------ The full list of Dev Activity metrics is: Open Metrics List * 30d\_moving\_avg\_dev\_activity\_change\_1d * dev\_activity * dev\_activity\_1d * dev\_activity\_change\_1d * ecosystem\_dev\_activity Updated 1 month ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Development Activity Contributors Count | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/development-activity/development-activity-contributors-count/#development-activity-contributors-count) Development Activity Contributors Count ======================================================================================================================================================================================= [](https://academy.santiment.net/metrics/development-activity/development-activity-contributors-count/#definition) Definition ----------------------------------------------------------------------------------------------------------------------------- The Development Activity Contributors Count metrics show the unique number of people (represented as Github accounts) that have contributed to a public Github repository in an organization that is followed. Only those events that constitute 'pure' development work are taken into consideration. There are 3 development activity contributors count metrics available: * `dev_activity_contributors_count` - Computed on-the-fly using the Github data. Because of this the metric can compute data for any asset or just any random Github organization that has public repositories like Google, Facebook, or any other organization. * `dev_activity_contributors_count_7d` - Precomputed metric for each asset. Each data point shows the number of unique contributors for the past 7 days. * `ecosystem_dev_activity_contributors_count_7d` - Precomputed for each ecosystem. Each data point shows the number of unique contributors for the past 7 days. > Note: The precomputed metrics `dev_activity_contributors_count_7d` and `ecosystem_dev_activty_contributors_count_7d` cannot be aggregated using the `SUM` aggregation, i.e. you cannot obtain the number of monthly contributors by taking the sum of 4 weekly values. This is because the same contributors may or may not make up the separate values, so the `SUM` operation can count some contributors multiple times. To achieve monthly contributors, use the `dev_activity_contributors_count` metric with `interval: "30d"` * * * [](https://academy.santiment.net/metrics/development-activity/development-activity-contributors-count/#access) Access --------------------------------------------------------------------------------------------------------------------- [Free Access](https://academy.santiment.net/metrics/details/access#free-access) * * * [](https://academy.santiment.net/metrics/development-activity/development-activity-contributors-count/#measuring-unit) Measuring Unit ------------------------------------------------------------------------------------------------------------------------------------- Number of github accounts * * * [](https://academy.santiment.net/metrics/development-activity/development-activity-contributors-count/#data-type) Data Type --------------------------------------------------------------------------------------------------------------------------- [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/development-activity/development-activity-contributors-count/#frequency) Frequency --------------------------------------------------------------------------------------------------------------------------- * `dev_activity_contributors_count` - [Five-Minute Intervals](https://academy.santiment.net/metrics/details/frequency#five-minute-frequency) * `dev_activity_contributors_count_7d` - [Daily Intervals](https://academy.santiment.net/metrics/details/frequency#daily-frequency) * `ecosystem_dev_activty_contributors_count_7d` - [Daily Intervals](https://academy.santiment.net/metrics/details/frequency#daily-frequency) * * * [](https://academy.santiment.net/metrics/development-activity/development-activity-contributors-count/#latency) Latency ----------------------------------------------------------------------------------------------------------------------- [Development Activity Data Latency](https://academy.santiment.net/metrics/details/latency#development-activity-latency) * * * [](https://academy.santiment.net/metrics/development-activity/development-activity-contributors-count/#available-assets) Available Assets ----------------------------------------------------------------------------------------------------------------------------------------- * `dev_activity_contributors_count` [available assets](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric:%20%22dev_activity_contributors_count%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) * `dev_activity_contributors_count_7d` [available assets](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22dev_activity_contributors_count_7d%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) * `ecosystem_dev_activity_contributors_count_7d` [available ecosystems](https://api.santiment.net/graphiql?query=%7B%0A%20%20getEcosystems%20%7B%0A%20%20%20%20name%0A%20%20%7D%0A%7D%0A) * * * [](https://academy.santiment.net/metrics/development-activity/development-activity-contributors-count/#sanapi) SanAPI --------------------------------------------------------------------------------------------------------------------- Fetch hourly `dev_activity_contributors_count` for an asset: 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22dev_activity_contributors_count%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22santiment%22%0A%20%20%20%20%20%20from%3A%20%222020-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-03-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221h%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** * * * Fetch monthly `dev_activity_contributors_count` for an asset: 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22dev_activity_contributors_count%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22santiment%22%0A%20%20%20%20%20%20from%3A%20%222020-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-03-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%2230d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** * * * Fetch the precomputed weekly `dev_activity_contributors_count_7d` for an asset: 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22dev_activity_contributors_count_7d%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22santiment%22%0A%20%20%20%20%20%20from%3A%20%222020-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-03-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%227d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** * * * Because `dev_activity_contributors_count_7d` is precomputed, you can also fetch an aggregated value for many assets at the same time: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 **[Run in Explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20allProjects(%0A%20%20%20%20selector%3A%20%7B%0A%20%20%20%20%20%20baseProjects%3A%20%7Bslugs%3A%20%5B%22bitcoin%22%2C%20%22ethereum%22%2C%20%22santiment%22%2C%20%22maker%22%5D%7D%0A%20%20%20%20%7D)%20%7B%0A%20%20%20%20%20%20slug%0A%20%20%20%20%20%20contributors%3A%20aggregatedTimeseriesData(%0A%20%20%20%20%20%20%20%20metric%3A%20%22dev_activity_contributors_count_7d%22%0A%20%20%20%20%20%20%20%20from%3A%20%22utc_now-1d%22%0A%20%20%20%20%20%20%20%20to%3A%20%22utc_now%22%0A%20%20%20%20%20%20%20%20aggregation%3A%20LAST%0A%20%20%20%20%20%20)%0A%20%20%7D%0A%7D%0A) ** * * * Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Development Activity Metrics | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/development-activity/#development-activity-metrics) Development Activity Metrics ========================================================================================================================= [](https://academy.santiment.net/metrics/development-activity/#metrics) Metrics ------------------------------------------------------------------------------- The development-related data allows the definition of different metrics. These metrics include: * [Development Activity](https://academy.santiment.net/metrics/development-activity/development-activity/) - Ignore the non-development related events. Excluding this allows values of projects who use Github for issue tracking and projects who do not use Github for issue tracking to be faily compared * [Development Activity Contributors Count](https://academy.santiment.net/metrics/development-activity/development-activity-contributors-count/) * Track the number of unique development activity contributors. * [Github Activity](https://academy.santiment.net/metrics/development-activity/github-activity/) - Count all events for a project. * [Github Activity Contributors Count](https://academy.santiment.net/metrics/development-activity/github-activity-contributors-count/) - Track the number of unique github activity contributors. * * * [](https://academy.santiment.net/metrics/development-activity/#why-development-acitivty-matters) Why Development Acitivty matters? ---------------------------------------------------------------------------------------------------------------------------------- The development activity of a project that Santiment tracks is done in the project's public GitHub repositories. The work done in private repositories cannot be tracked. In crypto, a lot of the work is done in public repositories, so this metric is available for many projects. A developer's time is an expensive resource, so high development activity implies that: * The project is serious about its business proposition; * The project will likely ship new features in the future and address existing issues; * It's less likely that the project is just an exit scam. Simply put, development-related metrics can be used to gauge a project's commitment to creating a working product, and continuously polishing and upgrading its features. > **Note:** Only development work done in public github repositories can be tracked. Work done in private/unknown repositories or public repositories outside GitHub won't be counted. In Github, switching a repository from private to public does not emit events for past actions, so the development activity will track only the work done after making the repository public. * * * [](https://academy.santiment.net/metrics/development-activity/#how-is-development-activity-tracked) How is development activity tracked? ---------------------------------------------------------------------------------------------------------------------------------------- Development-related metrics are using the events emitted by Github. The metrics **do not** use the number of commits in a repository. When developers work they encapsulate their code changes in commits. When a repository page [like this](https://github.com/santiment/sanbase2) is opened in github one of the first things shown is the number of commits. ![github-status-bar](https://academy.santiment.net/metrics/development-activity/github-status-bar.png) One naturally would think that counting commits is an accurate approximation of development activity. A lot of the data aggregators track the number of Github commits, an unfortunate solution that returns skewed data. ### [](https://academy.santiment.net/metrics/development-activity/#why-is-counting-commits-not-optimal) Why is counting commits not optimal? There are a lot of projects that fork (copy everything up until this moment) other blockchains' source code and make small changes on top of it, without the intent of proposing these changes back to the original repository. The process of forking inherits all commits, but this is other people's work -- this is not work done by the team that makes the fork. #### [](https://academy.santiment.net/metrics/development-activity/#example) Example For example, if a person forks the [Bitcoin Github repository](https://github.com/bitcoin/bitcoin) they will inherit all 40,000+ commits, while performing just one action of forking. ### [](https://academy.santiment.net/metrics/development-activity/#how-santiment-measures-development-activity) How Santiment measures development activity? At Santiment, we implemented a more reliable approach tracking the number of [Github events](https://docs.github.com/en/rest/using-the-rest-api/github-event-types?apiVersion=2022-11-28) that the project generates. Pushing a commit generates an event, but there are also many other activities that generate an event: * Creating an Issue * Creating a Pull Request * Commenting an issue/Pull Request * Forking/starring/watching a repository * many others. More importantly, when a project is forked, it does not inherit any of the already emitted events. Our custom method dramatically improves both accuracy and serviceability of Github data. The reason is that the process of forking a repository generates just a single `ForkEvent` instead creating an event for every commit that gets inherited. At the time of writing this the [bitcoin](https://github.com/bitcoin/bitcoin) repository has around 40k commits and [Bitoin SV](https://github.com/bitcoin-sv/bitcoin-sv) repository has around 18.9k commits. Let's take a look at the events counting approach: Bitcoin: ![bitcoin-dev-activity](https://academy.santiment.net/metrics/development-activity/bitcoin-dev-activity.png) Bitcoin SV: ![bitcoin-sv-dev-activity](https://academy.santiment.net/metrics/development-activity/bitcoin-sv-dev-activity.png) We observe that Bitcoin has a high development activity all the time. Meanwhile, Bitcoin SV has 0 dev activity most of the time. If you want to learn more about the difference - and the benefits of our bespoke approach - I highly suggest [this piece](https://medium.com/santiment/tracking-github-activity-of-crypto-projects-introducing-a-better-approach-9fb1af3f1c32) by Valentin, our ex-CTO. * * * [](https://academy.santiment.net/metrics/development-activity/#as-a-trading-strategy) As a Trading Strategy ----------------------------------------------------------------------------------------------------------- While not common, Development-related metrics can also be used as a novel trading strategy. Some time ago, we tested a portfolio of only the top ERC20 projects by development activity, refreshed each month. We backtested the strategy from August 2017 to October 2018. [The portfolio 1](https://santiment.net/blog/github-activity-portfolio/) turned a profit, but didn't beat hodling BTC overall. ![dev-activity-backtest](https://academy.santiment.net/metrics/development-activity/dev-activity-backtest.png) However, our portfolio was also more volatile than hodling over time, registering significantly larger tops in January and May of 2018. If you were to sell at one of those intersections instead, our Github portfolio would in fact be the winner. As a custom metric, dev activity can help you understand a project's dedication to its product, and in turn - its end users. * * * Updated 1 year ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Crypto Metrics: Explore our Set of Onchain Social & Dev Metrics ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/#santiment-crypto-metrics-overview) Santiment Crypto Metrics Overview ============================================================================================================== ###### Deprecated and Renamed Metrics There are metrics that are deprecated, scheduled for deprecation, or the metrics are available under a new name and the old name should be not used. * [Deprecated Metrics](https://academy.santiment.net/metrics/deprecated-metrics/) * [Renamed Metrics](https://academy.santiment.net/metrics/renamed-metrics/) ###### Video explanations of some metrics * [Breakdown of Santiment's Top 15 Metrics](https://www.youtube.com/watch?v=FFJB48Z8tfM) * [Top metrics for new users](https://www.youtube.com/watch?v=c6q4RsQvA58) * [Finding future crypto pumps](https://www.youtube.com/watch?v=2UpK0CnzzuE) * [Social Trends metrics](https://www.youtube.com/watch?v=p60ZlNes8WEo) * [Using Top Stakeholders metrics](https://www.youtube.com/watch?v=lLyd8GzPixY) * [How to use MVRV](https://www.youtube.com/watch?v=vbYQLNJ40yw) ###### Data Integrity * [Finalized Metrics](https://academy.santiment.net/metrics/finalized/) ###### Financial Traditional fundamentals including price, volume and market cap, mean coin age * [Price in USD, BTC and USDT](https://academy.santiment.net/metrics/price/) * [Marketcap in USD](https://academy.santiment.net/metrics/marketcap/) * [Trading Volume in USD](https://academy.santiment.net/metrics/trading-volume/) * [Fully Diluted Valuation in USD](https://academy.santiment.net/metrics/fully-diluted-valuation/) * [Decentralized Exchange Metrics](https://academy.santiment.net/metrics/decentralized-exchange-metrics/) * [Ethereum Fees](https://academy.santiment.net/metrics/ethereum-fees/) * [Ethereum Spent](https://academy.santiment.net/metrics/ethereum-spent/) * [Mean Coin Age](https://academy.santiment.net/metrics/mean-coin-age/) * [OHLC (Open-High-Low-Close)](https://academy.santiment.net/metrics/price/#ohlc) * [Price Volatility](https://academy.santiment.net/metrics/price-volatility/) * [RSI](https://academy.santiment.net/metrics/rsi/) * [Annual Inflation Rate](https://academy.santiment.net/metrics/annual-inflation-rate/) * [Gini Index](https://academy.santiment.net/metrics/gini-index/) * [Transacted Coin Acquisition Cost](https://academy.santiment.net/metrics/transacted-coin-acquisition-cost/) * [Daily Aggregated Financial Metrics in USD](https://academy.santiment.net/metrics/daily-aggregated-financial-metrics/) * [BTC and S&P 500 Price Divergence](https://academy.santiment.net/metrics/btc-and-s-and-p-500-price-divergence/) * [M2 Money Supply](https://academy.santiment.net/metrics/m2-money-supply/) ###### Social/Sentiment Metrics build on top of [Social Data](https://academy.santiment.net/metrics/details/social-data/) They are taken from measuring social activity on crypto-related forums and channels, plus custom sentiment measurements analyzing crowd behavior. * [Community Messages Count](https://academy.santiment.net/metrics/community-messages-count/) * [Community Social Volume](https://academy.santiment.net/metrics/community-social-volume/) * [Emerging Trends](https://academy.santiment.net/metrics/emerging-trends/) * [Sentiment Metrics](https://academy.santiment.net/metrics/sentiment-metrics/) * [Social Dominance](https://academy.santiment.net/metrics/social-dominance/) * [Social Volume](https://academy.santiment.net/metrics/social-volume/) * [Unique Social Volume](https://academy.santiment.net/metrics/unique-social-volume/) * [Trending Words Rank](https://academy.santiment.net/metrics/trending-words-rank/) ###### Development [Development Activity Metrics](https://academy.santiment.net/metrics/development-activity/) are used to measure a team’s development activity. * [Development Activity](https://academy.santiment.net/metrics/development-activity/development-activity/) * [Github Activity](https://academy.santiment.net/metrics/development-activity/github-activity/) * [Development Activity Contributors Count](https://academy.santiment.net/metrics/development-activity/development-activity-contributors-count/) * [Development Activity](https://academy.santiment.net/metrics/development-activity/development-activity-contributors-count/) ###### Network Value (On-Chain) * [MVRV](https://academy.santiment.net/metrics/mvrv/) * [NVT](https://academy.santiment.net/metrics/nvt/) * [Realized Value](https://academy.santiment.net/metrics/realized-value/) * [Mean Realized Price](https://academy.santiment.net/metrics/mean-realized-price/) * [Network Profit Loss](https://academy.santiment.net/metrics/network-profit-loss/) * [Realized Market Capitalization Hodl Waves](https://academy.santiment.net/metrics/realized-market-capitalization-hodl-waves/) ###### Network Activity (On-Chain) * [Daily Active Addresses](https://academy.santiment.net/metrics/daily-active-addresses/) * [Active Addresses 24h](https://academy.santiment.net/metrics/active-addresses-24h/) * [Active Deposits](https://academy.santiment.net/metrics/active-deposits/) * [Active Withdrawals](https://academy.santiment.net/metrics/active-withdrawals/) * [Network Growth](https://academy.santiment.net/metrics/network-growth/) ###### Other On-Chain * [Age Consumed](https://academy.santiment.net/metrics/age-consumed/) * [Amount in Top Holders](https://academy.santiment.net/metrics/amount-in-top-holders/) * [Bitcoin ETF Volume](https://academy.santiment.net/metrics/bitcoin-etf-volume/) * [Circulation](https://academy.santiment.net/metrics/circulation/) * [CrvUSD Savings](https://academy.santiment.net/metrics/crvusd-savings/) * [Dormant Circulation](https://academy.santiment.net/metrics/dormant-circulation/) * [ETF Flow](https://academy.santiment.net/metrics/etf-flow/) * [ETH 2.0](https://academy.santiment.net/metrics/eth-2/) * [Ethena Protocol](https://academy.santiment.net/metrics/ethena-protocol/) * [Exchange Funds Flow](https://academy.santiment.net/metrics/exchange-funds-flow/) * [Labeled Balance](https://academy.santiment.net/metrics/labeled-balance/) * [Labeled Exchange](https://academy.santiment.net/metrics/labeled-exchange/) * [Lending and Borrowing Protocols](https://academy.santiment.net/metrics/lending-and-borrowing-protocols/) * [MakerDAO DAI Savings Rate](https://academy.santiment.net/metrics/makerdao-dai-savings-rate/) * [New Deployed Contracts](https://academy.santiment.net/metrics/new-deployed-contracts/) * [Pendle Markets](https://academy.santiment.net/metrics/pendle-markets/) * [Sky Savings](https://academy.santiment.net/metrics/sky-savings/) * [Spent Coins Age Band](https://academy.santiment.net/metrics/spent-coins-age-band/) * [Stock To Flow ratio](https://academy.santiment.net/metrics/stock-to-flow/) * [Supply Distribution](https://academy.santiment.net/metrics/supply-distribution/) * [Supply On Or Outside Exchanges](https://academy.santiment.net/metrics/supply-on-or-outside-exchanges/) * [Top Holders](https://academy.santiment.net/metrics/top-holders/) * [Total Supply](https://academy.santiment.net/metrics/total-supply/) * [Transaction Count](https://academy.santiment.net/metrics/transaction-count/) * [Transaction Size](https://academy.santiment.net/metrics/transaction-size/) * [Transaction Volume](https://academy.santiment.net/metrics/transaction-volume/) * [Transaction Volume In Profit Or Loss](https://academy.santiment.net/metrics/transaction-volume-in-profit-or-loss/) * [Velocity](https://academy.santiment.net/metrics/velocity/) * [Whale Transaction Count](https://academy.santiment.net/metrics/whale-transaction-count/) * [Whale Transaction Volume](https://academy.santiment.net/metrics/whale-transaction-volume/) ###### Derivatives * [Funding Rates Aggregated](https://academy.santiment.net/metrics/funding-rates-aggregated/) * [Open Interest](https://academy.santiment.net/metrics/open-interest/) * [BitMEX](https://academy.santiment.net/metrics/bitmex-derivatives/) * [Binance](https://academy.santiment.net/metrics/binance-derivatives/) * [Bitfinex](https://academy.santiment.net/metrics/bitfinex-derivatives/) * [Deribit](https://academy.santiment.net/metrics/deribit-derivatives/) * [FTX](https://academy.santiment.net/metrics/ftx-derivatives/) * [dYdX](https://academy.santiment.net/metrics/dydx-derivatives/) * [Huobi](https://academy.santiment.net/metrics/huobi-derivatives/) ###### NFT * [NFT Collection Holders Balance](https://academy.santiment.net/metrics/nft-collection-holders-balance/) * [NFT Collection Price](https://academy.santiment.net/metrics/nft-collection-price/) * [NFT Market Volume](https://academy.santiment.net/metrics/nft-market-volume/) * [NFT Network Profit Loss](https://academy.santiment.net/metrics/nft-network-profit-loss/) * [NFT Trades Count](https://academy.santiment.net/metrics/nft-trades-count/) * [NFT Trade Volume USD](https://academy.santiment.net/metrics/nft-trade-volume-usd/) ###### Blockchain Address Metrics We have a bunch of API methods related to blockchain addresses. The list of supported blockchains [can be found here](https://academy.santiment.net/sanapi/supported-blockchains/) . Some of this methods return [timeseries](https://academy.santiment.net/sanapi/metrics/#timeseriesdata) and other return tables, eg "Top Trasfres Table". * [Historical Balance](https://academy.santiment.net/metrics/historical-balance/) * [Labelled Historical Balance](https://academy.santiment.net/metrics/labelled-historical-balance/) * [Latest Transactions](https://academy.santiment.net/metrics/latest-transactions/) * [Contract Transaction Count](https://academy.santiment.net/metrics/contract-transactions-count/) * [Contract Interacting Address Count](https://academy.santiment.net/metrics/contract-interacting-address-count/) ###### XRPL Metrics [XRP Ledger (XRPL)](https://xrpl.org/) is a decentralized, public blockchain led by a global developer community. Santiment provides key metrics about the XRPL Chain which are listed below. The rest of metrics are also available for XRP. The XRP-specific metrics are: #### [](https://academy.santiment.net/metrics/#holders-metrics) Holders metrics * [Number of accounts](https://academy.santiment.net/metrics/xrpl-metrics/number-of-accounts/) #### [](https://academy.santiment.net/metrics/#activity-metrics) Activity metrics * [DEX Volume in USD](https://academy.santiment.net/metrics/xrpl-metrics/dex-volume/) * [Number of assets issued](https://academy.santiment.net/metrics/xrpl-metrics/assets-issued/) * [Number of active trustlines](https://academy.santiment.net/metrics/xrpl-metrics/trustline-count/) * [Liquidty in XRPL AMM Pools](https://academy.santiment.net/metrics/xrpl-metrics/liquidity-amm-pools/) Updated 10 minutes ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # NVT | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/nvt/#nvt) NVT ====================================================== [](https://academy.santiment.net/metrics/nvt/#definition) Definition -------------------------------------------------------------------- The typical formula for NVT is the following: `NVT = Daily Market Cap / Daily Transaction Volume` Santiment provides an alternative formula for NVT: `NVT = Daily Market Cap / Daily Circulation` Since daily circulation is zero at the beginning of each day, NVT based on it would have a spike at the day beginning, we solve it with rolling NVT metric which uses rolling circulation for last 24 hours and is computed using following formula: `NVT = Intraday Market Cap / Rolling Circulation` For some assets there is a more prceise metric called Circulation NVT, which takes 24 hour rolling daily circulation instead of daily. The `Network Value-to-Transaction` (NVT) ratio is an asset valuation metric similar to the [P/E ratio](https://www.investopedia.com/terms/p/price-earningsratio.asp) traditionally used in equity markets to gauge a stock's growth potential. The P/E or `Price-to-Earnings` ratio is calculated by dividing the company's current price per share with its earnings per share. A high P/E could mean a stock's price is high relative to its earnings and therefore possibly overvalued. Conversely, a low P/E might indicate that the current stock price is low relative to earnings and possibly undervalued. As crypto assets are not companies, their earnings are not known , so Transaction Volume is often used as a proxy for the blockchain's underlying value. Since Transaction Volume gets rather noisy and often includes duplicate transactions (sending 10 ETH to a deposit address which then sends them to the exchange hot wallet counts as 20 ETH Transaction Volume even though it's the same 10 ETH being transacted), it's not an ideal measure of a network's economic activity. That's why at Santiment we calculate NVT using Daily Trx Volume, but also by using [Circulation](https://academy.santiment.net/metrics/circulation/) instead, which filters out excess transactions and provides a cleaner overview of a blockchain's daily transaction throughput. You'll find both approaches plotted on the graph and can choose which one you prefer. As with P/E, a high NVT indicates that an asset's network valuation is higher than the value being transmitted on the network. In other words, the network is expensive relative to how much value it moves, signaling a potentially overvalued asset. Conversely, a low NVT denotes an asset that is cheaper per unit of on-chain transaction volume, signaling a potentially undervalued asset. NVT is often used as a long-term indicator of an asset's price trends, rather than a day-to-day valuation metric. * * * [](https://academy.santiment.net/metrics/nvt/#access) Access ------------------------------------------------------------ [Restricted Access](https://academy.santiment.net/metrics/details/access#restricted-access) . * * * [](https://academy.santiment.net/metrics/nvt/#measuring-unit) Measuring Unit ---------------------------------------------------------------------------- Ratio * * * [](https://academy.santiment.net/metrics/nvt/#data-type) Data Type ------------------------------------------------------------------ [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/nvt/#frequency) Frequency ------------------------------------------------------------------ [Five Minute Intervals](https://academy.santiment.net/metrics/details/frequency#five-minute-frequency) and [Daily Intervals](https://academy.santiment.net/metrics/details/frequency#daily-frequency) * * * [](https://academy.santiment.net/metrics/nvt/#latency) Latency -------------------------------------------------------------- [On-Chain Latency](https://academy.santiment.net/metrics/details/latency#on-chain-latency) * * * [](https://academy.santiment.net/metrics/nvt/#available-assets) Available Assets -------------------------------------------------------------------------------- * NVT using 1-day circulation is available for [these assets](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22nvt%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) * NVT Transaction Volume is available for [these assets](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22nvt_transaction_volume%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) * * * [](https://academy.santiment.net/metrics/nvt/#sanapi) SanAPI ------------------------------------------------------------ * `nvt` - NVT using 1 day Circulation. Computed with daily frequency. * `nvt_5min` - Same as `nvt`, but computed with 5-minute frequency. * `nvt_transaction_volume` - NVT using Transaction Volume. Computed with daily frequency. 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22nvt%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22santiment%22%0A%20%20%20%20%20%20from%3A%20%22utc_now-90d%22%0A%20%20%20%20%20%20to%3A%20%22utc_now-60d%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** * * * 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22nvt_transaction_volume%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22santiment%22%0A%20%20%20%20%20%20from%3A%20%22utc_now-90d%22%0A%20%20%20%20%20%20to%3A%20%22utc_now-60d%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Mean Realized Price | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/mean-realized-price/#mean-realized-price) Mean Realized Price ====================================================================================================== [](https://academy.santiment.net/metrics/mean-realized-price/#definition) Definition ------------------------------------------------------------------------------------ The Mean Realized Price metric calculates the average price at which tokens were obtained. It provides insights into the average profitability of token transactions by considering the [Realized Value](https://academy.santiment.net/metrics/realized-value/) against the [Total Circulating](https://academy.santiment.net/metrics/circulation/) tokens. It can be understood as the price level that acts as support or resistance. Mean Realized Price metric is also available for different [time bounds](https://academy.santiment.net/metrics/details/timebound/) , which computes the mean realized price for tokens moved at least once no longer than a specific number of days or years ago. ### [](https://academy.santiment.net/metrics/mean-realized-price/#bottom-indicator-use-case) Bottom Indicator Use Case ![Mean Realized Price](https://academy.santiment.net/metrics/mean-realized-price/mean-realized-price.png) The Mean Realized Price carries considerable weight for crypto investors. In times of market instability, it serves as a crucial indicator. If the price falls below the Mean Realized Price, it suggests that, on average, token holders are facing unrealized losses. These periods are highlighted on the chart above (red rectangles), and investors view them as opportunities to accumulate more tokens. * * * [](https://academy.santiment.net/metrics/mean-realized-price/#access) Access ---------------------------------------------------------------------------- [Restricted Access](https://academy.santiment.net/metrics/details/access#restricted-access) . * * * [](https://academy.santiment.net/metrics/mean-realized-price/#timebound) Timebound ---------------------------------------------------------------------------------- [Timebound Metrics](https://academy.santiment.net/metrics/details/timebound/) available * * * [](https://academy.santiment.net/metrics/mean-realized-price/#measuring-unit) Measuring Unit -------------------------------------------------------------------------------------------- USD * * * [](https://academy.santiment.net/metrics/mean-realized-price/#data-type) Data Type ---------------------------------------------------------------------------------- [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/mean-realized-price/#frequency) Frequency ---------------------------------------------------------------------------------- [Daily Intervals](https://academy.santiment.net/metrics/details/frequency#daily-frequency) * * * [](https://academy.santiment.net/metrics/mean-realized-price/#latency) Latency ------------------------------------------------------------------------------ [On-Chain Latency](https://academy.santiment.net/metrics/details/latency#on-chain-latency) * * * [](https://academy.santiment.net/metrics/mean-realized-price/#available-assets) Available Assets ------------------------------------------------------------------------------------------------ Available for [these assets](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22mean_realized_price_usd%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) > Note: `mean_realized_price_usd` metric and all timebound realized value metrics are available for the same set of assets. * * * [](https://academy.santiment.net/metrics/mean-realized-price/#sanapi) SanAPI ---------------------------------------------------------------------------- Available under the `mean_realized_price_usd` and `mean_realized_price_usd_` names. 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22mean_realized_price_usd%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22santiment%22%0A%20%20%20%20%20%20from%3A%20%222020-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-01-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** [](https://academy.santiment.net/metrics/mean-realized-price/#full-list-of-metrics) Full list of metrics -------------------------------------------------------------------------------------------------------- Mean Realized Price metrics * mean\_realized\_price\_usd * mean\_realized\_price\_usd\_1d * mean\_realized\_price\_usd\_7d * mean\_realized\_price\_usd\_30d * mean\_realized\_price\_usd\_60d * mean\_realized\_price\_usd\_90d * mean\_realized\_price\_usd\_180d * mean\_realized\_price\_usd\_365d * mean\_realized\_price\_usd\_2y * mean\_realized\_price\_usd\_3y * mean\_realized\_price\_usd\_5y * mean\_realized\_price\_usd\_10y Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Network Profit Loss | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/network-profit-loss/#network-profit-loss) Network Profit Loss ====================================================================================================== [](https://academy.santiment.net/metrics/network-profit-loss/#definition) Definition ------------------------------------------------------------------------------------ Network Profit/Loss (NPL for short) computes the average profit or loss of all coins that change addresses daily. For each coin that moves on-chain, NPL takes the price at which it was last moved and assumes this to be its acquisition price. Once it changes addresses again, NPL assumes the coin was sold. * * * [](https://academy.santiment.net/metrics/network-profit-loss/#access) Access ---------------------------------------------------------------------------- [Restricted Access](https://academy.santiment.net/metrics/details/access#restricted-access) . * * * [](https://academy.santiment.net/metrics/network-profit-loss/#measuring-unit) Measuring Unit -------------------------------------------------------------------------------------------- Amount in dollars * * * [](https://academy.santiment.net/metrics/network-profit-loss/#data-type) Data Type ---------------------------------------------------------------------------------- [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/network-profit-loss/#change-metrics) Change Metrics -------------------------------------------------------------------------------------------- [Change Metrics](https://academy.santiment.net/metrics/details/change_metrics/) * * * [](https://academy.santiment.net/metrics/network-profit-loss/#frequency) Frequency ---------------------------------------------------------------------------------- [Five-Minute Intervals](https://academy.santiment.net/metrics/details/frequency#five-minute-freqency) * * * [](https://academy.santiment.net/metrics/network-profit-loss/#latency) Latency ------------------------------------------------------------------------------ [On-Chain Latency](https://academy.santiment.net/metrics/details/latency#on-chain-latency) * * * [](https://academy.santiment.net/metrics/network-profit-loss/#available-assets) Available Assets ------------------------------------------------------------------------------------------------ Available for [these assets](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22network_profit_loss%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) * * * [](https://academy.santiment.net/metrics/network-profit-loss/#sanapi) SanAPI ---------------------------------------------------------------------------- Example of query for **network\_profit\_loss**: 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22network_profit_loss%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22santiment%22%0A%20%20%20%20%20%20from%3A%20%222021-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222021-02-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** [](https://academy.santiment.net/metrics/network-profit-loss/#full-list-of-metrics) Full list of metrics -------------------------------------------------------------------------------------------------------- The full list of Network Profit Loss metrics is: Open Metrics List * network\_profit\_loss * network\_profit\_loss\_change\_1d * network\_profit\_loss\_change\_30d * network\_profit\_loss\_change\_7d Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Github Activity | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/development-activity/github-activity/#github-activity) Github Activity =============================================================================================================== [](https://academy.santiment.net/metrics/development-activity/github-activity/#definition) Definition ----------------------------------------------------------------------------------------------------- Unlike [Development Activity](https://academy.santiment.net/metrics/development-activity/development-activity/) which excludes some of the events, the GitHub Activity metric uses all events to compute the metric. There are 3 github activity metrics available: * `github_activity` - Computed on-the-fly using the Github data. Because of this the metric can compute data for any asset or any random Github organization that has public repositories like Google, Facebook, or any other organization. * `github_activity_1d` - Precomputed daily metric for each asset that is available on Santiment. This allows the metric to be aggregated when the value is needed for all assets at once. * `ecosystem_github_activity` - Precomputed for each ecosystem. An ecosystem github activity is defined as the sum of the github activities of all assets that belong to it. For example the `ethereum` ecosystem contains all the projects that build on the Ethereum blockchain or contribute to the blockchain in any other way. * * * [](https://academy.santiment.net/metrics/development-activity/github-activity/#access) Access --------------------------------------------------------------------------------------------- [Free Access](https://academy.santiment.net/metrics/details/access#free-access) * * * [](https://academy.santiment.net/metrics/development-activity/github-activity/#data-type) Data Type --------------------------------------------------------------------------------------------------- [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/development-activity/github-activity/#change-metrics) Change Metrics ------------------------------------------------------------------------------------------------------------- [Change Metrics](https://academy.santiment.net/metrics/details/change_metrics/) * * * [](https://academy.santiment.net/metrics/development-activity/github-activity/#frequency) Frequency --------------------------------------------------------------------------------------------------- * `github_activity` - [Five-Minute Intervals](https://academy.santiment.net/metrics/details/frequency#five-minute-frequency) * `github_activity_1d` - [Daily Intervals](https://academy.santiment.net/metrics/details/frequency#daily-frequency) * `ecosystem_github_activity` - [Daily Intervals](https://academy.santiment.net/metrics/details/frequency#daily-frequency) * * * [](https://academy.santiment.net/metrics/development-activity/github-activity/#latency) Latency ----------------------------------------------------------------------------------------------- [Development Activity Data Latency](https://academy.santiment.net/metrics/details/latency#development-activity-latency) * * * [](https://academy.santiment.net/metrics/development-activity/github-activity/#available-assets) Available Assets ----------------------------------------------------------------------------------------------------------------- * `github_activity` [available assets](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric:%20%22github_activity%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) * `github_activity_1d` [available assets](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric:%20%22github_activity_1d%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) * `ecosystem_github_activity` [available ecosystems](https://api.santiment.net/graphiql?query=%7B%0A%20%20getEcosystems%20%7B%0A%20%20%20%20name%0A%20%20%7D%0A%7D%0A) * * * [](https://academy.santiment.net/metrics/development-activity/github-activity/#sanapi) SanAPI --------------------------------------------------------------------------------------------- Fetch the dev activity for an asset: 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22github_activity%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22santiment%22%0A%20%20%20%20%20%20from%3A%20%222020-01-13T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-01-18T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** * * * Fetch the `github_activity` for an arbitrary organization. You need to provide only the organization name to the parameter, not the whole URL. Github links look like this: `https://github.com//`. 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22github_activity%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20selector%3A%20%7Borganization%3A%20%22google%22%7D%0A%20%20%20%20%20%20from%3A%20%222020-01-13T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-01-18T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** * * * Fetch the `ecosystem_github_activity`, combining the dev activities of all assets that contribute to that ecosystem: 1 2 3 4 5 6 7 8 9 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getEcosystems(ecosystems%3A%20%5B%22ethereum%22%5D)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20metric%3A%20%22ecosystem_github_activity%22%0A%20%20%20%20%20%20from%3A%20%222024-03-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222024-03-10T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22)%0A%20%20%7D%0A%7D) ** * * * To check what assets are part of the ecosystem and what are their github links: 1 2 3 4 5 6 7 8 9 **[Run in Explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getEcosystems(ecosystems%3A%20%5B%22ethereum%22%5D)%7B%0A%20%20%20%20name%0A%20%20%20%20projects%7B%0A%20%20%20%20%20%20slug%0A%20%20%20%20%20%20githubLinks%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) ** * * * GitHub Activity Change for Ethereum Repository Over 7 Days 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22github_activity_change_30d%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20selector%3A%20%7Bslug%3A%20%22ethereum%22%7D%0A%20%20%20%20%20%20from%3A%20%222024-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222024-01-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** * * * [](https://academy.santiment.net/metrics/development-activity/github-activity/#full-list-of-metrics) Full list of metrics ------------------------------------------------------------------------------------------------------------------------- The full list of GitHub Activity metrics is: Open Metrics List * ecosystem\_github\_activity * github\_activity\_change\_30d Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Daily Active Addresses | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/daily-active-addresses/#daily-active-addresses) Daily Active Addresses =============================================================================================================== [](https://academy.santiment.net/metrics/daily-active-addresses/#definition) Definition --------------------------------------------------------------------------------------- The number of distinct addresses that participated in a transfer for the given asset in any given day. Each address is counted only once for the day, regardless of the amount of transfers it participates in. Both the senders and the receivers of the asset are counted. ![Daily Active Addresses for Bitcoin](https://academy.santiment.net/metrics/daily-active-addresses/bitcoin-daa.png) [](https://academy.santiment.net/metrics/daily-active-addresses/#access) Access ------------------------------------------------------------------------------- [Free Access](https://academy.santiment.net/metrics/details/access#free-access) * * * [](https://academy.santiment.net/metrics/daily-active-addresses/#measuring-unit) Measuring Unit ----------------------------------------------------------------------------------------------- Non-negative number of addresses * * * [](https://academy.santiment.net/metrics/daily-active-addresses/#data-type) Data Type ------------------------------------------------------------------------------------- [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/daily-active-addresses/#frequency) Frequency ------------------------------------------------------------------------------------- [Daily Intervals](https://academy.santiment.net/metrics/details/frequency#daily-frequency) * * * [](https://academy.santiment.net/metrics/daily-active-addresses/#latency) Latency --------------------------------------------------------------------------------- [On-Chain Latency](https://academy.santiment.net/metrics/details/latency#on-chain-latency) * * * [](https://academy.santiment.net/metrics/daily-active-addresses/#available-assets) Available Assets --------------------------------------------------------------------------------------------------- Available for [these assets](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22daily_active_addresses%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) * * * [](https://academy.santiment.net/metrics/daily-active-addresses/#api) API ------------------------------------------------------------------------- Available under the `daily_active_addresses` name. 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22daily_active_addresses%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22santiment%22%0A%20%20%20%20%20%20from%3A%20%222020-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-01-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Active Addresses 24h | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/active-addresses-24h/#active-addresses-24h) Active Addresses 24h ========================================================================================================= [](https://academy.santiment.net/metrics/active-addresses-24h/#definition) Definition ------------------------------------------------------------------------------------- The number of distinct addresses that participated in a transfer for the given asset in the past 24 hours window. Each address is counted only once for the window. Both the senders and the receivers are counted. This metric is similar to the Daily Active Addresses. The difference is that the daily active addresses is computed on whole days only - it counts the active addresses for every day (between 00:00:00 and 23:59:59). The active addresses 24h is computed every 5 minutes and counts the active addresses for the past 24 hours. Example: The value of the metric at 17:30pm on March 22 contains the active addresses in the interval [17:30pm March 21, 17:30pm March 22](https://academy.santiment.net/metrics/active-addresses-24h/) . [](https://academy.santiment.net/metrics/active-addresses-24h/#access) Access ----------------------------------------------------------------------------- [Free Access](https://academy.santiment.net/metrics/details/access#free-access) * * * [](https://academy.santiment.net/metrics/active-addresses-24h/#measuring-unit) Measuring Unit --------------------------------------------------------------------------------------------- Non-negative number of addresses * * * [](https://academy.santiment.net/metrics/active-addresses-24h/#data-type) Data Type ----------------------------------------------------------------------------------- [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/active-addresses-24h/#change-metrics) Change Metrics --------------------------------------------------------------------------------------------- [Change Metrics](https://academy.santiment.net/metrics/details/change_metrics/) * * * [](https://academy.santiment.net/metrics/active-addresses-24h/#frequency) Frequency ----------------------------------------------------------------------------------- [Five-Minute Intervals](https://academy.santiment.net/metrics/details/frequency#five-minute-frequency) * * * [](https://academy.santiment.net/metrics/active-addresses-24h/#latency) Latency ------------------------------------------------------------------------------- [On-Chain Latency](https://academy.santiment.net/metrics/details/latency#on-chain-latency) * * * [](https://academy.santiment.net/metrics/active-addresses-24h/#available-assets) Available Assets ------------------------------------------------------------------------------------------------- Available for [these assets](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22active_addresses_24h%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) * * * [](https://academy.santiment.net/metrics/active-addresses-24h/#api) API ----------------------------------------------------------------------- Available under the `active_addresses_24h` name. 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22active_addresses_24h%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22santiment%22%0A%20%20%20%20%20%20from%3A%20%222020-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-01-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** [](https://academy.santiment.net/metrics/active-addresses-24h/#full-list-of-metrics) Full list of metrics --------------------------------------------------------------------------------------------------------- The full list of Active Addresses metrics is: Open Metrics List * active\_addresses\_1h * active\_addresses\_24h * active\_addresses\_24h\_change\_1d * active\_addresses\_24h\_change\_30d * active\_addresses\_24h\_change\_7d * active\_addresses\_7d * active\_addresses\_30d * active\_addresses\_60d * active\_addresses\_90d Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Top Token Holders: Track 100 Addresses With the Highest Balances ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/top-holders/#top-holders) Top Holders ============================================================================== `Top Holders` describes a set of up to 100 Ethereum addresses which have the highest balances at a given time, either in Ether or in a specific ERC-20 token. The amount of addresses can be reduced, but 100 is the maximum. So one could analyse the 20 top holders for BAT, as well as the 100 top holders for ETH. Top Holders metrics are calculated daily. The top holder metrics can be found under `ETH Top Holders` for Ether (ETH) itself. To find top holder information about a specific ERC-20 token, look for `Overview. All ERC-20 tokens`, which will lead you to a list of all ERC-20 tokens Santiment is currently including in its calculations. Find the needed token and select `Open Dashboard` in the very last column, which should be named `Top Holders`. As all top holder metrics are shown in the same overview, they share a set of options: ![](https://academy.santiment.net/metrics/top-holders/29_top_holders_options.png) * **_`Currency`_** - lets you switch the price from being displayed in USD to BTC * **_`HoldersCount`_** - sets the amount of top holders to include, maximum is 100 * **_`Hide "remains" status in details`_** - refers only to the fourth metric listed below and hides specific table rows. See its article for more information * **_`Balance in USD`_** - display the top holders balances in amount of tokens or converted to USD ### [](https://academy.santiment.net/metrics/top-holders/#our-current-metrics-for-top-holders) Our current metrics for top holders: [](https://academy.santiment.net/metrics/top-holders/#top-holders-balance) Top Holders - Balance ------------------------------------------------------------------------------------------------ This graph shows the sum of all the top holders balances plotted against the asset\`s price. ![](https://academy.santiment.net/metrics/top-holders/30_top_holders_balance.png) As you can see, we also display the total balance split by exchange- and non-exchange wallets. The amount of top holders addresses included in the calculation can be chosen at the top by selecting `HoldersCount`. The HoldersCount in the above screenshot of BAT's top holders balances is set to 50. The assets's price can be displayed in USD or BTC, which can be selected through the `Currency` field at the top. The `Balance in USD` field lets you switch between displaying the balances in amount of tokens and displaying them converted to USD. [](https://academy.santiment.net/metrics/top-holders/#top-holders-percent-of-total-supply) Top Holders - Percent of Total Supply -------------------------------------------------------------------------------------------------------------------------------- This graph shows the relative amount of tokens held by all the top holders compared to the total amount of tokens in existence, as well as the asset\`s price. ![](https://academy.santiment.net/metrics/top-holders/31_top_holders_percentof.png) As you can see, we also display the top holder\`s share of the total supply split by exchange- and non-exchange wallets. The amount of top holders addresses included in the calculation can be chosen at the top by selecting `HoldersCount`. The HoldersCount in the above screenshot of BAT\`s top holders percentage of total supply is set to 50. The assets\`s price can be displayed in USD or BTC, which can be selected through the `Currency` field at the top. [](https://academy.santiment.net/metrics/top-holders/#top-holders-changes) Top Holders - Changes ------------------------------------------------------------------------------------------------ This graph shows the total number of new addresses entering the top holders list. ![](https://academy.santiment.net/metrics/top-holders/32_top_holders_changes.png) The amount of top holders addresses included in the calculation can be chosen at the top by selecting `HoldersCount`. The HoldersCount in the above screenshot of BAT\`s changes to the top holders list is set to 50. So at the day shown in the screenshot, three out of 50 addresses where not in the 50 top holders list the day before. The assets\`s price can be displayed in USD or BTC, which can be selected through the `Currency` field at the top. [](https://academy.santiment.net/metrics/top-holders/#top-holders-details) Top Holders - Details ------------------------------------------------------------------------------------------------ It shows detailed data for the top holders for the selected period, sorted by date (the current day compared to the previous day). ![](https://academy.santiment.net/metrics/top-holders/33_top_holders_details.png) The **status** column specifies whether the address either (was) 1. `added` 2. `removed` 3. `remained` unchanged from that particular spot in the top holders list on the given day. Select `Hide "remains" status in details` to toggle on showing the `remains` status, which will make it easier to see the full list of top holders accounts for a particular day. Along with the rank among the top holders, the table shows **balance** (the balance of that particular account, in amount of tokens or USD) and **% of total** (the share of the total token supply this specific top holders address holds) - both for the day listed and the previous one. In case you are having trouble finding specific data points in this potentially very long list, please consider reducing the time frame - either by using the options in the upper right corner of the screen or by selecting a time frame straight in the graph by clicking and dragging your mouse. The Details list will only show data from the selected time frame. Clicking any top holders address will lead you to its details on [https://etherscan.io](https://etherscan.io/) . Updated 1 year ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # 404: Not found Looks like you got lost ======================= The page you're looking for is missing or your link is incorrect. [Back to home page](https://academy.santiment.net/) --- # Crypto Active Addresses: Metric to Track Blockchain Activity ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/active-deposits/#active-deposits) Active Deposits ========================================================================================== [](https://academy.santiment.net/metrics/active-deposits/#definition) Definition -------------------------------------------------------------------------------- ### [](https://academy.santiment.net/metrics/active-deposits/#active-deposits) Active Deposits Shows the **number of unique deposit addresses** that have been active on a particular day for a given asset. Refer to a [deposit address explanation here](https://academy.santiment.net/labels/deposit/) ![ethereum daily active deposits](https://academy.santiment.net/metrics/active-deposits/daily-active-deposits-ethereum.png) `active_deposits` metric shows the number of **daily** active deposits. `active_deposits_5m` shows the amount of active deposits for a given **5 minutes** interval. ### [](https://academy.santiment.net/metrics/active-deposits/#deposit-transactions) Deposit Transactions Deposit transactions metric shows the total number of all **incoming and outcoming transactions** involving deposit addresses on a particular day for `deposit_transactions` and for a particlar 5 minutes interval for `deposit_transactions_5m`. As such, this metric accounts for both user-to-exchange transactions: 1. from a personal wallet to a deposit address, and 2. from a deposit address to the main exchange wallet. Deposit-related Transactions is often valuable when used in conjunction with **Exchange Inflow** -- [another one of our metrics](https://academy.santiment.net/metrics/exchange-funds-flow/) -- which shows the total amount of coins moving to exchange wallets on a particular day. So, for example, an **increase in exchange inflow** but a **plateauing number of deposit-related transactions** means that more coins are entering the exchanges, although the number of transactions to the exchanges stayed the same. In other words, **the average deposit size has increased.** For an exchange-specific data please refer to [that page](https://academy.santiment.net/metrics/labeled-exchange/) * * * [](https://academy.santiment.net/metrics/active-deposits/#access) Access ------------------------------------------------------------------------ The metric is with [restricted access](https://academy.santiment.net/metrics/details/access#restricted-access) . * * * [](https://academy.santiment.net/metrics/active-deposits/#measuring-unit) Measuring Unit ---------------------------------------------------------------------------------------- Non-negative number of addresses * * * [](https://academy.santiment.net/metrics/active-deposits/#data-type) Data Type ------------------------------------------------------------------------------ [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/active-deposits/#frequency) Frequency ------------------------------------------------------------------------------ [Daily intervals:](https://academy.santiment.net/metrics/details/frequency#daily-frequency) * `active_deposits` * `deposit_transactions` [Five-Minute Intervals:](https://academy.santiment.net/metrics/details/frequency#five-minute-frequency) * `active_deposits_5m` * `deposit_transactions_5m` * * * [](https://academy.santiment.net/metrics/active-deposits/#latency) Latency -------------------------------------------------------------------------- Daily Active Deposits has [on-chain Latency](https://academy.santiment.net/metrics/details/latency#on-chain-latency) * * * [](https://academy.santiment.net/metrics/active-deposits/#available-assets) Available Assets -------------------------------------------------------------------------------------------- [active\_deposits](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22active_deposits%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) [deposit\_transactions](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22deposit_transactions%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) [active\_deposits\_5m](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22active_deposits_5m%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) [deposit\_transactions\_5m](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22deposit_transactions_5m%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) * * * [](https://academy.santiment.net/metrics/active-deposits/#sanapi) SanAPI ------------------------------------------------------------------------ 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22active_deposits%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22maker%22%0A%20%20%20%20%20%20from%3A%20%222019-05-09T11%3A25%3A04.894Z%22%0A%20%20%20%20%20%20to%3A%20%222019-06-23T11%3A25%3A04.894Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Deposit transactions are available under `deposit_transactions` and `deposit_transactions_5m` names. 1 2 3 4 5 6 7 8 9 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22deposit_transactions_5m%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22ethereum%22%0A%20%20%20%20%20%20from%3A%20%222024-01-01T00%3A00%3A00.000Z%22%0A%20%20%20%20%20%20to%3A%20%222024-01-02T00%3A00%3A00.000Z%22%0A%20%20%20%20%20%20interval%3A%20%221h%22)%0A%20%20%7D%0A%7D) ** Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Token Age Consumed metric | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/age-consumed/#token-age-consumed-metric) Token Age Consumed metric =========================================================================================================== _For a more in-depth technical explanation of Age Consumed, please click_ [_here_](https://academy.santiment.net/metrics/age-consumed/age-consumed-technical/) * * * [](https://academy.santiment.net/metrics/age-consumed/#definition) Definition ----------------------------------------------------------------------------- Age Consumed shows the amount of tokens changing addresses on a certain date, multiplied by the time since they last moved. Spikes on the graph signal a large amount of tokens moving after being idle for an extended period of time. One potential use case for this metric is identifying when big market players exit the project post ICO. Here's the Token Age Consumed graph for [Golem](https://golem.network/) , an ERC-20 project that lets you rent other people's computing power. ![golem-age-consumed](https://academy.santiment.net/metrics/age-consumed/golem-age-consumed.png) We can easily spot several significant spikes over time: each could be a large early investor selling their tokens, which commonly results in a parallel price decline. * * * [](https://academy.santiment.net/metrics/age-consumed/#access) Access --------------------------------------------------------------------- [Restricted Access](https://academy.santiment.net/metrics/details/access#restricted-access) * * * [](https://academy.santiment.net/metrics/age-consumed/#measuring-unit) Measuring Unit ------------------------------------------------------------------------------------- Time passed × Token/Coin amount * * * [](https://academy.santiment.net/metrics/age-consumed/#data-type) Data Type --------------------------------------------------------------------------- [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/age-consumed/#change-metrics) Change Metrics ------------------------------------------------------------------------------------- [Change Metrics](https://academy.santiment.net/metrics/details/change_metrics/) * * * [](https://academy.santiment.net/metrics/age-consumed/#frequency) Frequency --------------------------------------------------------------------------- [Five-Minute Intervals](https://academy.santiment.net/metrics/details/frequency#five-minute-frequency) * * * [](https://academy.santiment.net/metrics/age-consumed/#latency) Latency ----------------------------------------------------------------------- [On-Chain Latency](https://academy.santiment.net/metrics/details/latency#on-chain-latency) * * * [](https://academy.santiment.net/metrics/age-consumed/#available-assets) Available Assets ----------------------------------------------------------------------------------------- Available for [these assets](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22age_destroyed%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) * * * [](https://academy.santiment.net/metrics/age-consumed/#api) API --------------------------------------------------------------- Available under the `age_destroyed` and `age_consumed` names, one being an alias for the other: 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22age_consumed%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22santiment%22%0A%20%20%20%20%20%20from%3A%20%222020-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-01-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** [](https://academy.santiment.net/metrics/age-consumed/#full-list-of-metrics) Full list of metrics ------------------------------------------------------------------------------------------------- The full list of Age Consumed metrics is: Open Metrics List * age\_consumed * age\_consumed\_change\_1d * age\_consumed\_change\_30d * age\_consumed\_change\_7d Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Crypto Active Addresses: Metric to Track Blockchain Activity ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/active-withdrawals/#active-withdrawals) Active Withdrawals =================================================================================================== [](https://academy.santiment.net/metrics/active-withdrawals/#definition) Definition ----------------------------------------------------------------------------------- ### [](https://academy.santiment.net/metrics/active-withdrawals/#active-withdrawals) Active Withdrawals Shows the **number of unique withdrawal addresses** that have been active on a particular day for a given asset. Refer to a [withdrawal address explanation here](https://academy.santiment.net/labels/withdrawal/) ### [](https://academy.santiment.net/metrics/active-withdrawals/#withdrawal-transactions) Withdrawal Transactions Withdrawal transactions metric shows the total number of all **outgoing transactions** involving withdrawal addresses on a particular day. Basically, this metric accounts for exchange-to-user transactions. For an exchange-specific data please refer to [that page](https://academy.santiment.net/metrics/labeled-exchange/) * * * [](https://academy.santiment.net/metrics/active-withdrawals/#access) Access --------------------------------------------------------------------------- The metric is with [restricted access](https://academy.santiment.net/metrics/details/access#restricted-access) . * * * [](https://academy.santiment.net/metrics/active-withdrawals/#measuring-unit) Measuring Unit ------------------------------------------------------------------------------------------- Non-negative number of addresses * * * [](https://academy.santiment.net/metrics/active-withdrawals/#data-type) Data Type --------------------------------------------------------------------------------- [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/active-withdrawals/#frequency) Frequency --------------------------------------------------------------------------------- [Daily intervals:](https://academy.santiment.net/metrics/details/frequency#daily-frequency) * `active_withdrawals` * `withdrawal_transactions` [Five-Minute Intervals:](https://academy.santiment.net/metrics/details/frequency#five-minute-frequency) * `active_withdrawals_5m` * `withdrawal_transactions_5m` * * * [](https://academy.santiment.net/metrics/active-withdrawals/#latency) Latency ----------------------------------------------------------------------------- [On-chain Latency](https://academy.santiment.net/metrics/details/latency#on-chain-latency) * * * [](https://academy.santiment.net/metrics/active-withdrawals/#available-assets) Available Assets ----------------------------------------------------------------------------------------------- [active\_withdrawals](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22active_withdrawals%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) [withdrawal\_transactions](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22withdrawal_transactions%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) [active\_withdrawals\_5m](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22active_withdrawals_5m%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) [withdrawal\_transactions\_5m](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22withdrawal_transactions_5m%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) * * * [](https://academy.santiment.net/metrics/active-withdrawals/#sanapi) SanAPI --------------------------------------------------------------------------- The metric is available under the `active_withdrawals` name for daily resolution and `active_withdrawals_5m` for intraday resolution. 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22active_withdrawals%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22ethereum%22%0A%20%20%20%20%20%20from%3A%20%222023-05-09T11%3A25%3A04.894Z%22%0A%20%20%20%20%20%20to%3A%20%222023-06-23T11%3A25%3A04.894Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Withdrawal transactions are available under `withdrawal_transactions` and `withdrawal_transactions_5m` names. 1 2 3 4 5 6 7 8 9 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22withdrawal_transactions_5m%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22ethereum%22%0A%20%20%20%20%20%20from%3A%20%222024-01-01T00%3A00%3A00.000Z%22%0A%20%20%20%20%20%20to%3A%20%222024-01-02T00%3A00%3A00.000Z%22%0A%20%20%20%20%20%20interval%3A%20%221h%22)%0A%20%20%7D%0A%7D) ** Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Realized Market Capitalization Hodl Waves | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/realized-market-capitalization-hodl-waves/#realized-market-capitalization-hodl-waves) Realized Market Capitalization Hodl Waves ======================================================================================================================================================================== [](https://academy.santiment.net/metrics/realized-market-capitalization-hodl-waves/#definition) Definition ---------------------------------------------------------------------------------------------------------- Realized Market Capitalization Hodl Waves is an alternative to Circulation Hodl Waves. This metric is representing the percentage of realized cap for a given timebound interval in total realized cap value. For example `realized_cap_hodl_waves_1d_to_7d` is computed by dividing the realized cap of coins that are 1 to 7 days old with total realized market cap: `(realized_cap_usd_7d - realized_cap_usd_1d) / realized_cap_usd` Assigning age to coin/tokens is done according to the [coin-age model](https://academy.santiment.net/metrics/details/stack-coin-age-model/) . * * * [](https://academy.santiment.net/metrics/realized-market-capitalization-hodl-waves/#access) Access -------------------------------------------------------------------------------------------------- [Restricted Access](https://academy.santiment.net/metrics/details/access#restricted-access) . * * * [](https://academy.santiment.net/metrics/realized-market-capitalization-hodl-waves/#timebound) Timebound -------------------------------------------------------------------------------------------------------- [Interval Timebound Metrics](https://academy.santiment.net/metrics/details/interval_timebound/) available * * * [](https://academy.santiment.net/metrics/realized-market-capitalization-hodl-waves/#measuring-unit) Measuring Unit ------------------------------------------------------------------------------------------------------------------ Number - % between 0 and 100 * * * [](https://academy.santiment.net/metrics/realized-market-capitalization-hodl-waves/#data-type) Data Type -------------------------------------------------------------------------------------------------------- [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/realized-market-capitalization-hodl-waves/#frequency) Frequency -------------------------------------------------------------------------------------------------------- [Daily Intervals](https://academy.santiment.net/metrics/details/frequency#daily-frequency) * * * [](https://academy.santiment.net/metrics/realized-market-capitalization-hodl-waves/#latency) Latency ---------------------------------------------------------------------------------------------------- [On-Chain Latency](https://academy.santiment.net/metrics/details/latency#on-chain-latency) * * * [](https://academy.santiment.net/metrics/realized-market-capitalization-hodl-waves/#available-assets) Available Assets ---------------------------------------------------------------------------------------------------------------------- Available for [these assets](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22realized_cap_hodl_waves_1d_to_7d%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) * * * [](https://academy.santiment.net/metrics/realized-market-capitalization-hodl-waves/#sanapi) SanAPI -------------------------------------------------------------------------------------------------- Available under `realized_cap_hodl_waves_` names. 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22realized_cap_hodl_waves_1d_to_7d%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22santiment%22%0A%20%20%20%20%20%20from%3A%20%222022-05-25T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222022-06-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** [](https://academy.santiment.net/metrics/realized-market-capitalization-hodl-waves/#full-list-of-metrics) Full list of metrics ------------------------------------------------------------------------------------------------------------------------------ Realized Market Capitalization Hodl Waves Metrics * realized\_cap\_hodl\_waves\_0d\_to\_1d * realized\_cap\_hodl\_waves\_1d\_to\_7d * realized\_cap\_hodl\_waves\_7d\_to\_30d * realized\_cap\_hodl\_waves\_30d\_to\_60d * realized\_cap\_hodl\_waves\_60d\_to\_90d * realized\_cap\_hodl\_waves\_90d\_to\_180d * realized\_cap\_hodl\_waves\_180d\_to\_365d * realized\_cap\_hodl\_waves\_365d\_to\_2y * realized\_cap\_hodl\_waves\_2y\_to\_3y * realized\_cap\_hodl\_waves\_3y\_to\_5y * realized\_cap\_hodl\_waves\_5y\_to\_10y * realized\_cap\_hodl\_waves\_10y\_to\_20y Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Circulation | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/circulation/#circulation) Circulation ============================================================================== [](https://academy.santiment.net/metrics/circulation/#definition) Definition ---------------------------------------------------------------------------- Circulation shows number of unique coins/tokens being used during a time period. Examples: * `circulation_1d` - Shows how many unique coins/tokens were transacted during a day. If one token/coin changes hands 5 times on a given day, it will be counted once by the token circulation, but 5 times by the transaction volume. * `circulation_1y` - Shows how many unique coins/tokens were transacted for the past 1 year. There are also circulation metrics `circulation_usd_*` that represent the USD value of all unique coins or tokens that were transacted within a single day. Unlike simple circulation metrics that count the unique cryptocurrencies moved, `circulation_usd_*` metrics convert the quantity of these coins or tokens into their equivalent value in USD. ![circulation for bitcoin](https://academy.santiment.net/metrics/circulation/circulation-bitcoin.png) * * * [](https://academy.santiment.net/metrics/circulation/#access) Access -------------------------------------------------------------------- [Restricted Access](https://academy.santiment.net/metrics/details/access#restricted-access) * * * [](https://academy.santiment.net/metrics/circulation/#measuring-unit) Measuring Unit ------------------------------------------------------------------------------------ Token/Coin amount * * * [](https://academy.santiment.net/metrics/circulation/#data-type) Data Type -------------------------------------------------------------------------- [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/circulation/#timebound) Timebound -------------------------------------------------------------------------- [Timebound Metrics](https://academy.santiment.net/metrics/details/timebound/) * * * [](https://academy.santiment.net/metrics/circulation/#change-metrics) Change Metrics ------------------------------------------------------------------------------------ [Change Metrics](https://academy.santiment.net/metrics/details/change_metrics/) * * * [](https://academy.santiment.net/metrics/circulation/#frequency) Frequency -------------------------------------------------------------------------- [Daily Intervals](https://academy.santiment.net/metrics/details/frequency#daily-frequency) * * * [](https://academy.santiment.net/metrics/circulation/#latency) Latency ---------------------------------------------------------------------- [On-Chain Latency](https://academy.santiment.net/metrics/details/latency#on-chain-latency) * * * [](https://academy.santiment.net/metrics/circulation/#available-assets) Available Assets ---------------------------------------------------------------------------------------- Available for [these assets](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22circulation%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) > **Note:** `circulation` metric and all circulation metrics are available for the same set of assets. * * * [](https://academy.santiment.net/metrics/circulation/#sanapi) SanAPI -------------------------------------------------------------------- Available under the `circulation` and `circulation_` names. Gets the total amount of tokens that have been sent at least once during each day for given time period. Projects are referred to by a unique identifier (slug). This metric is calculated daily, so the interval should be selected accordingly. 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22circulation_1d%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22santiment%22%0A%20%20%20%20%20%20from%3A%20%222020-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-01-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Without any suffixes like \_1d, the metric returns the number of coins/tokens ever seen up until now, which is equal to the total supply at that datetime. 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22circulation%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22santiment%22%0A%20%20%20%20%20%20from%3A%20%222020-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-01-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** [](https://academy.santiment.net/metrics/circulation/#full-list-of-metrics) Full list of metrics ------------------------------------------------------------------------------------------------ The full list of Circulation metrics is: Open Metrics List * circulation * circulation\_10y * circulation\_180d * circulation\_1d * circulation\_2y * circulation\_30d * circulation\_365d * circulation\_3y * circulation\_5y * circulation\_60d * circulation\_7d * circulation\_90d * circulation\_change\_1d * circulation\_change\_30d * circulation\_change\_7d * circulation\_180d\_change\_1d * circulation\_180d\_change\_30d * circulation\_180d\_change\_7d * circulation\_usd\_180d * circulation\_usd\_180d\_change\_1d * circulation\_usd\_180d\_change\_30d * circulation\_usd\_180d\_change\_7d Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Bitcoin ETF Volume | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/bitcoin-etf-volume/#bitcoin-etf-volume) Bitcoin ETF Volume =================================================================================================== [](https://academy.santiment.net/metrics/bitcoin-etf-volume/#description) Description ------------------------------------------------------------------------------------- The Bitcoin ETF Volume metric tracks the total volume in USD traded for a Bitcoin Exchange-Traded Fund (ETF) within a specified period. This metric provides insight into the level of investor activity and interest in trading Bitcoin through ETFs on traditional stock exchanges. Analyzing Bitcoin ETF volume can help investors gauge market sentiment, liquidity, and the overall demand for Bitcoin exposure within the traditional financial markets. > Note: Keep in mind that this metric is available during the working hours of the US stock exchange. * * * [](https://academy.santiment.net/metrics/bitcoin-etf-volume/#access) Access --------------------------------------------------------------------------- [Free Access](https://academy.santiment.net/metrics/details/access#free-access) * * * [](https://academy.santiment.net/metrics/bitcoin-etf-volume/#measuring-unit) Measuring Unit ------------------------------------------------------------------------------------------- Amount in USD * * * [](https://academy.santiment.net/metrics/bitcoin-etf-volume/#data-type) Data Type --------------------------------------------------------------------------------- [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/bitcoin-etf-volume/#frequency) Frequency --------------------------------------------------------------------------------- [Five-minute Intervals](https://academy.santiment.net/metrics/details/frequency#five-minute-frequency) * * * [](https://academy.santiment.net/metrics/bitcoin-etf-volume/#latency) Latency ----------------------------------------------------------------------------- [Price Latency](https://academy.santiment.net/metrics/details/latency#price-latency) * * * [](https://academy.santiment.net/metrics/bitcoin-etf-volume/#available-assets) Available Assets ----------------------------------------------------------------------------------------------- * arkb * bitb * btco * fbtc * gbtc * hodl * ibit * * * ### [](https://academy.santiment.net/metrics/bitcoin-etf-volume/#sanapi) SanAPI Available under `etf_volume_usd_5m` name. 1 2 3 4 5 6 7 8 9 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22etf_volume_usd_5m%22)%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22ibit%22%0A%20%20%20%20%20%20from%3A%20%222024-04-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222024-04-03T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%225m%22)%0A%20%20%7D%0A%7D) ** Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Amount in Top Holders | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/amount-in-top-holders/#amount-in-top-holders) Amount in Top Holders ============================================================================================================ [](https://academy.santiment.net/metrics/amount-in-top-holders/#definition) Definition -------------------------------------------------------------------------------------- Show the amount of coins/tokens help by the top holders. By default the top 10 holders are taken. Metrics available: * `amount_in_top_holders` - All holders are taken into account. * `amount_in_exchange_top_holders` - Only holders that are known exchange addresses are taken into account. * `amount_in_non_exchange_top_holders` - Only holders that are not exchange addresses are taken into account. * * * [](https://academy.santiment.net/metrics/amount-in-top-holders/#access) Access ------------------------------------------------------------------------------ [Restricted Access](https://academy.santiment.net/metrics/details/access#restricted-access) * * * [](https://academy.santiment.net/metrics/amount-in-top-holders/#measuring-unit) Measuring Unit ---------------------------------------------------------------------------------------------- Token/Coin amount * * * [](https://academy.santiment.net/metrics/amount-in-top-holders/#data-type) Data Type ------------------------------------------------------------------------------------ [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/amount-in-top-holders/#frequency) Frequency ------------------------------------------------------------------------------------ [Daily Intervals](https://academy.santiment.net/metrics/details/frequency#daily-frequency) * * * [](https://academy.santiment.net/metrics/amount-in-top-holders/#latency) Latency -------------------------------------------------------------------------------- [On-Chain Latency](https://academy.santiment.net/metrics/details/latency#on-chain-latency) * * * [](https://academy.santiment.net/metrics/amount-in-top-holders/#available-assets) Available Assets -------------------------------------------------------------------------------------------------- Available for: * `amount_in_top_holders` - [these assets](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22amount_in_top_holders%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) * `amount_in_exchange_top_holders` - [these assets](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22amount_in_exchange_top_holders%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) * `amount_in_non_exchange_top_holders` - [these assets](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22amount_in_non_exchange_top_holders%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) * * * [](https://academy.santiment.net/metrics/amount-in-top-holders/#sanapi) SanAPI ------------------------------------------------------------------------------ The available metrics are: * `amount_in_top_holders` * `amount_in_exchange_top_holders` * `amount_in_non_exchange_top_holders` 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22amount_in_top_holders%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22santiment%22%0A%20%20%20%20%20%20from%3A%20%222020-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-01-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22amount_in_exchange_top_holders%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22santiment%22%0A%20%20%20%20%20%20from%3A%20%222020-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-01-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22amount_in_non_exchange_top_holders%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22santiment%22%0A%20%20%20%20%20%20from%3A%20%222020-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-01-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # ETH 2.0 Metrics | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/eth-2/#eth-2-0-metrics) ETH 2.0 Metrics ================================================================================ [](https://academy.santiment.net/metrics/eth-2/#description) Description ------------------------------------------------------------------------ Metrics that show stats related to the ETH 2.0 Staking Contract * `eth2_stakers_count` - Amount of addresses that sent ETH to the ETH 2.0 Staking Contract * `eth2_stakers_realized_value_usd_` - [Realized value](https://academy.santiment.net/metrics/realized-value/) of stakers addresses. Metric is available for different [time bounds](https://academy.santiment.net/metrics/details/timebound/) . * `eth2_stakers_mvrv_usd_` - [MVRV](https://academy.santiment.net/metrics/mvrv/) of stakers addresses. Metric is available for different [time bounds](https://academy.santiment.net/metrics/details/timebound/) . * `eth2_roi` - The annual return on staking in the ETH 2.0 contract ETH 2.0 histogram metrics - see [examples](https://academy.santiment.net/metrics/eth-2/#sanapi) for details how to query it: * `eth2_top_stakers` - Top addresses by staked amount * `eth2_staked_amount_per_label` - Total staked amount by label * `eth2_staked_address_count_per_label` - Amount of addresses that staked ETH by label Beacon chain metrics: * `eth_beacon_deposits` - Amount of ETH deposited into the Beacon Chain contract * `eth_beacon_validator_withdrawals` - Withdrawals made by validators from the Ethereum Beacon Chain contract * `eth_beacon_reward_withdrawals` - Withdrawals of rewards by validators from the Ethereum Beacon Chain contract * * * [](https://academy.santiment.net/metrics/eth-2/#access) Access -------------------------------------------------------------- [Restricted Access](https://academy.santiment.net/metrics/details/access#restricted-access) . * * * [](https://academy.santiment.net/metrics/eth-2/#measuring-unit) Measuring Unit ------------------------------------------------------------------------------ * `eth2_stakers_count` - Amount of addresses * `eth2_roi` - Percents * `eth2_stakers_realized_value_usd_` and `eth2_stakers_mvrv_usd_` - USD * `eth_beacon_deposits`, `eth_beacon_validator_withdrawals` and `eth_beacon_reward_withdrawals` - Amount in ETH * * * [](https://academy.santiment.net/metrics/eth-2/#data-type) Data Type -------------------------------------------------------------------- [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/eth-2/#frequency) Frequency -------------------------------------------------------------------- [Five-minute Intervals](https://academy.santiment.net/metrics/details/frequency#five-minute-frequency) * * * [](https://academy.santiment.net/metrics/eth-2/#latency) Latency ---------------------------------------------------------------- [Price Latency](https://academy.santiment.net/metrics/details/latency#price-latency) * * * [](https://academy.santiment.net/metrics/eth-2/#available-assets) Available Assets ---------------------------------------------------------------------------------- `ethereum` * * * ### [](https://academy.santiment.net/metrics/eth-2/#sanapi) SanAPI ETH 2.0 Staker Count: 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22eth2_stakers_count%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20selector%3A%20%7B%20slug%3A%20%22ethereum%22%20%7D%0A%20%20%20%20%20%20from%3A%20%222020-12-05T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-12-06T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%225m%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** ETH 2.0 Staking ROI: 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22eth2_roi%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20selector%3A%20%7B%20slug%3A%20%22ethereum%22%20%7D%0A%20%20%20%20%20%20from%3A%20%222020-12-05T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-12-06T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%225m%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** ETH 2.0 Total Staked Amount: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22balance_per_owner%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20selector%3A%20%7B%0A%20%20%20%20%20%20%20%20slug%3A%20%22ethereum%22%0A%20%20%20%20%20%20%20%20label%3A%20%22eth2stakingcontract%22%0A%20%20%20%20%20%20%20%20owner%3A%20%22eth2stakingcontract%22%0A%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20from%3A%20%222020-12-05T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-12-06T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%225m%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Staked amount per label: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 [**Run in Explorer**](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22eth2_staked_amount_per_label%22)%20%7B%0A%20%20%20%20histogramData(%0A%20%20%20%20%20%20selector%3A%20%7Bslug%3A%20%22ethereum%22%7D%0A%20%20%20%20%20%20from%3A%20%22utc_now-70d%22%0A%20%20%20%20%20%20to%3A%22utc_now%22%0A%20%20%20%20)%7B%0A%20%20%20%20%20%20values%7B%0A%20%20%20%20%20%20%20%20__typename%0A%20%20%20%20%20%20%20%20...%20on%20StringLabelFloatValueList%7B%0A%20%20%20%20%20%20%20%20data%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20label%0A%20%20%20%20%20%20%20%20%20%20%20%20value%0A%20%20%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20%09%7D%0A%20%20%20%20%20%20%7D%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D) Count of addresses that staked: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 [**Run in Explorer**](https://api.santiment.net/graphiql?query=%7B%0A%09getMetric(metric%3A%20%22eth2_staked_address_count_per_label%22)%7B%0A%20%20%20%20%20%20%20%20%20%20histogramData(%0A%20%20%20%20%20%20%20%20%20%20%20%20selector%3A%20%7Bslug%3A%20%22ethereum%22%7D%0A%20%20%20%20%20%20%20%20%20%20%20%20from%3A%20%22utc_now-10d%22%0A%20%20%20%20%20%20%20%20%20%20%20%20to%3A%20%22utc_now%22%0A%20%20%20%20%20%20%20%20%20%20)%7B%0A%09%09%09values%7B%0A%20%20%20%20%20%20%20%20%20%0A%20%20%20%20%20%20%20%20...%20on%20StringLabelFloatValueList%7B%0A%20%20%20%20%20%20%20%20%20%20data%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20label%0A%20%20%20%20%20%20%20%20%20%20%20%20value%0A%20%20%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20%7D%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D) Top stakers: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 [**Run in Explorer**](https://api.santiment.net/graphiql?query=%7B%0A%09getMetric(metric%3A%20%22eth2_top_stakers%22)%7B%0A%20%20%20%20histogramData(%0A%20%20%20%20%20%20selector%3A%20%7Bslug%3A%20%22ethereum%22%7D%0A%20%20%20%20%20%20from%3A%20%22utc_now-10d%22%0A%20%20%20%20%20%20to%3A%20%22utc_now%22%0A%20%20%20%20%20%20limit%3A%202%0A%20%20%20%20)%7B%0A%09%09%09values%7B%0A%20%20%20%20%20%20%20%20%20%0A%20%20%20%20%20%20%20%20...%20on%20StringAddressStringLabelFloatValueList%7B%0A%20%20%20%20%20%20%20%20%20%20data%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20address%0A%20%20%20%20%20%20%20%20%20%20%20%20label%0A%20%20%20%20%20%20%20%20%20%20%20%20value%0A%20%20%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20%7D%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D) Available under the `eth2_stakers_realized_value_usd_` and `eth2_stakers_mvrv_usd_` names. 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22eth2_stakers_realized_value_usd_365d%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22ethereum%22%0A%20%20%20%20%20%20from%3A%20%222023-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222023-01-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Available under the `eth_beacon_deposits`, `eth_beacon_validator_withdrawals` and `eth_beacon_reward_withdrawals` names. 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22eth_beacon_deposits%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22ethereum%22%0A%20%20%20%20%20%20from%3A%20%222023-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222023-01-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** [](https://academy.santiment.net/metrics/eth-2/#full-list-of-metrics) Full list of metrics ------------------------------------------------------------------------------------------ ETH 2.0 histogram metrics * eth2\_top\_stakers * eth2\_staked\_amount\_per\_label * eth2\_staked\_address\_count\_per\_label ETH 2.0 metrics * eth\_beacon\_deposits * eth\_beacon\_validator\_withdrawals * eth\_beacon\_reward\_withdrawals * eth2\_stakers\_count * eth2\_roi * eth2\_stakers\_realized\_value\_usd\_365d * eth2\_stakers\_realized\_value\_usd\_2y * eth2\_stakers\_realized\_value\_usd\_3y * eth2\_stakers\_realized\_value\_usd\_5y * eth2\_stakers\_realized\_value\_usd\_10y * eth2\_stakers\_mvrv\_usd\_365d * eth2\_stakers\_mvrv\_usd\_2y * eth2\_stakers\_mvrv\_usd\_3y * eth2\_stakers\_mvrv\_usd\_5y * eth2\_stakers\_mvrv\_usd\_10y Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Network Growth | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/network-growth/#network-growth) Network Growth ======================================================================================= [](https://academy.santiment.net/metrics/network-growth/#definition) Definition ------------------------------------------------------------------------------- The amount of new addresses that transfered a given coin/token for the first time. Essentially, this chart illustrates user adoption over time, and can be used to identify when the project is gaining - or losing - traction. ![tether network growth](https://academy.santiment.net/metrics/network-growth/aragon-network-growth.png) Here's a Network Growth graph for [Aragon](https://app.santiment.net/projects/aragon) , which lets anyone create and manage a decentralized organization on Ethereum. UP until December of 2017, the Aragon network grew by 85-750 new addresses each day, and the price loyally followed. Then, right around the start of 2018, the network growth slowly began to throttle. It indicated that the Aragon user base was already quite deep, and wouldn't be able to sustain future price growth. What happened since speaks for itself. * * * [](https://academy.santiment.net/metrics/network-growth/#access) Access ----------------------------------------------------------------------- [Restricted Access](https://academy.santiment.net/metrics/details/access#restricted-access) * * * [](https://academy.santiment.net/metrics/network-growth/#measuring-unit) Measuring Unit --------------------------------------------------------------------------------------- Number of addresses * * * [](https://academy.santiment.net/metrics/network-growth/#data-type) Data Type ----------------------------------------------------------------------------- [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/network-growth/#change-metrics) Change Metrics --------------------------------------------------------------------------------------- [Change Metrics](https://academy.santiment.net/metrics/details/change_metrics/) * * * [](https://academy.santiment.net/metrics/network-growth/#frequency) Frequency ----------------------------------------------------------------------------- [Daily Intervals](https://academy.santiment.net/metrics/details/frequency#daily-frequency) * * * [](https://academy.santiment.net/metrics/network-growth/#latency) Latency ------------------------------------------------------------------------- [On-Chain Latency](https://academy.santiment.net/metrics/details/latency#on-chain-latency) * * * [](https://academy.santiment.net/metrics/network-growth/#available-assets) Available Assets ------------------------------------------------------------------------------------------- Available for [these assets](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22network_growth%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) * * * [](https://academy.santiment.net/metrics/network-growth/#sanapi) SanAPI ----------------------------------------------------------------------- Available under the `network_growth` name. 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22network_growth%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22santiment%22%0A%20%20%20%20%20%20from%3A%20%222019-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222019-09-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%227d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** [](https://academy.santiment.net/metrics/network-growth/#full-list-of-metrics) Full list of metrics --------------------------------------------------------------------------------------------------- The full list of Network Growth metrics is: Open Metrics List * network\_growth * network\_growth\_change\_1d * network\_growth\_change\_30d * network\_growth\_change\_7d Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # MakerDAO DAI Savings Rate | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/makerdao-dai-savings-rate/#makerdao-dai-savings-rate) MakerDAO DAI Savings Rate ======================================================================================================================== [](https://academy.santiment.net/metrics/makerdao-dai-savings-rate/#description) Description -------------------------------------------------------------------------------------------- The MakerDAO DAI Savings Rate (DSR) is an interest rate paid to holders of the DAI stablecoin for locking their DAI into smart contracts. It was introduced as a way to incentivize users to hold DAI, thereby helping to maintain its stability and peg to the US dollar. The interest rate is determined by the MakerDAO community through governance votes and is paid out from the stability fees collected from borrowers who generate DAI by locking up collateral. MakerDAO DSR metrics: * `makerdao_dsr_deposits` - Amount of DAI deposited into the smart contract * `makerdao_dsr_withdrawals` - Amount of DAI withdrawn from the smart contract * `makerdao_dsr_total_supplied` - Total supply of DAI in the smart contract * `mcd_dsr` - Interest rate paid to DAI deposited in the DSR contract * * * [](https://academy.santiment.net/metrics/makerdao-dai-savings-rate/#access) Access ---------------------------------------------------------------------------------- [Restricted Access](https://academy.santiment.net/metrics/details/access#restricted-access) * * * [](https://academy.santiment.net/metrics/makerdao-dai-savings-rate/#measuring-unit) Measuring Unit -------------------------------------------------------------------------------------------------- Amount of DAI `mcd_dsr` - percentage * * * [](https://academy.santiment.net/metrics/makerdao-dai-savings-rate/#data-type) Data Type ---------------------------------------------------------------------------------------- [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/makerdao-dai-savings-rate/#frequency) Frequency ---------------------------------------------------------------------------------------- [Five-minute Intervals](https://academy.santiment.net/metrics/details/frequency#five-minute-frequency) * * * [](https://academy.santiment.net/metrics/makerdao-dai-savings-rate/#latency) Latency ------------------------------------------------------------------------------------ [On-Chain Latency](https://academy.santiment.net/metrics/details/latency#on-chain-latency) * * * [](https://academy.santiment.net/metrics/makerdao-dai-savings-rate/#available-assets) Available Assets ------------------------------------------------------------------------------------------------------ Available for `multi-collateral-dai` * * * ### [](https://academy.santiment.net/metrics/makerdao-dai-savings-rate/#sanapi) SanAPI Deposit and withdraw metrics: `makerdao_dsr_deposits` and `makerdao_dsr_withdrawals` 1 2 3 4 5 6 7 8 9 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22makerdao_dsr_deposits%22)%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22multi-collateral-dai%22%0A%20%20%20%20%20%20from%3A%20%222024-03-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222024-03-03T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%225m%22)%0A%20%20%7D%0A%7D) ** Total supplied metric: `makerdao_dsr_total_supplied` 1 2 3 4 5 6 7 8 9 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22makerdao_dsr_total_supplied%22)%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22multi-collateral-dai%22%0A%20%20%20%20%20%20from%3A%20%222024-03-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222024-03-03T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%225m%22)%0A%20%20%7D%0A%7D) ** MakerDAO DAI savings rate metric: `mcd_dsr` 1 2 3 4 5 6 7 8 9 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22mcd_dsr%22)%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22multi-collateral-dai%22%0A%20%20%20%20%20%20from%3A%20%222024-03-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222024-03-03T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22)%0A%20%20%7D%0A%7D) ** Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Dormant Circulation | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/dormant-circulation/#dormant-circulation) Dormant Circulation ====================================================================================================== [](https://academy.santiment.net/metrics/dormant-circulation/#definition) Definition ------------------------------------------------------------------------------------ Dormant Circulation shows number of unique coins/tokens transacted on a given day that have not been moved for big amount of time. Examples: * `dormant_circulation_10y` - Shows how many coins/tokens that have not been moved for more than 10 years were transacted during a day. This is useful for spotting when really old Bitcoins move. * `dormant_circulation_90d` - Shows how many coins/tokens that have not been moved for more than 90 days were transacted during a day. This is the smallest interval supported for that metric. There are also dormant circulation metrics `dormant_circulation_usd_*` that represent the USD value of all unique coins or tokens that were transacted within a single day that have not been moved for some time. * * * [](https://academy.santiment.net/metrics/dormant-circulation/#access) Access ---------------------------------------------------------------------------- [Restricted Access](https://academy.santiment.net/metrics/details/access#restricted-access) * * * [](https://academy.santiment.net/metrics/dormant-circulation/#measuring-unit) Measuring Unit -------------------------------------------------------------------------------------------- Token/Coin amount * * * [](https://academy.santiment.net/metrics/dormant-circulation/#data-type) Data Type ---------------------------------------------------------------------------------- [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/dormant-circulation/#timebound) Timebound ---------------------------------------------------------------------------------- [Timebound Metrics](https://academy.santiment.net/metrics/details/timebound/) * * * [](https://academy.santiment.net/metrics/dormant-circulation/#change-metrics) Change Metrics -------------------------------------------------------------------------------------------- [Change Metrics](https://academy.santiment.net/metrics/details/change_metrics/) * * * [](https://academy.santiment.net/metrics/dormant-circulation/#frequency) Frequency ---------------------------------------------------------------------------------- [Daily Intervals](https://academy.santiment.net/metrics/details/frequency#daily-frequency) * * * [](https://academy.santiment.net/metrics/dormant-circulation/#latency) Latency ------------------------------------------------------------------------------ [On-Chain Latency](https://academy.santiment.net/metrics/details/latency#on-chain-latency) * * * [](https://academy.santiment.net/metrics/dormant-circulation/#available-assets) Available Assets ------------------------------------------------------------------------------------------------ Available for [these assets](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22dormant_circulation_90d%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) > **Note:** All dormant circulation metrics are available for the same set of assets. * * * [](https://academy.santiment.net/metrics/dormant-circulation/#sanapi) SanAPI ---------------------------------------------------------------------------- Available under the `dormant_circulation_` names. The smallest supported interval is 90 days. The biggest supported interval is 10 years. 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22dormant_circulation_90d%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22santiment%22%0A%20%20%20%20%20%20from%3A%20%222020-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-01-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** [](https://academy.santiment.net/metrics/dormant-circulation/#full-list-of-metrics) Full list of metrics -------------------------------------------------------------------------------------------------------- The full list of Dormant Circulation metrics is: Open Metrics List * dormant\_circulation\_10y * dormant\_circulation\_180d * dormant\_circulation\_2y * dormant\_circulation\_365d * dormant\_circulation\_365d\_change\_1d * dormant\_circulation\_365d\_change\_30d * dormant\_circulation\_365d\_change\_7d * dormant\_circulation\_3y * dormant\_circulation\_5y * dormant\_circulation\_90d * dormant\_circulation\_usd\_180d * dormant\_circulation\_usd\_180d\_change\_1d * dormant\_circulation\_usd\_180d\_change\_30d * dormant\_circulation\_usd\_180d\_change\_7d Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Exchange Inflow/Outflow | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/exchange-funds-flow/#exchange-inflow-outflow) Exchange Inflow/Outflow ============================================================================================================== [](https://academy.santiment.net/metrics/exchange-funds-flow/#definition) Definition ------------------------------------------------------------------------------------ There are three separate metrics regarding exchange funds flow: * `exchange_inflow` - How many coins/tokens are moved from non-exchange to exchange wallets. * `exchange_outflow` - How many coins/tokens are moved from exchange to non-exchange wallets. * `exchange_balance` - The difference inflow-outflow (inflow minus outflow). The usefulness of this metric comes from the fact that transactions from missing/unknown exchange wallets to missing/unknown exchange wallets cancel each other. Some of the metrics have a USD equivalent - the raw value is multiplied by the price of the coin/token at the given date. The available USD metrics are `exchange_inflow_usd` and `exchange_outflow_usd` ![bitcoin funds in/outflow](https://academy.santiment.net/metrics/exchange-funds-flow/bitcoin-funds-inflow-outflow.png) ![bitcoin funds balance](https://academy.santiment.net/metrics/exchange-funds-flow/bitcoin-funds-flow-balance.png) For an exchange-specific data please refer to [that page](https://academy.santiment.net/metrics/labeled-exchange/) * * * [](https://academy.santiment.net/metrics/exchange-funds-flow/#access) Access ---------------------------------------------------------------------------- [Restricted Access](https://academy.santiment.net/metrics/details/access#restricted-access) . * * * [](https://academy.santiment.net/metrics/exchange-funds-flow/#measuring-unit) Measuring Unit -------------------------------------------------------------------------------------------- Amount of coins/tokens * * * [](https://academy.santiment.net/metrics/exchange-funds-flow/#data-type) Data Type ---------------------------------------------------------------------------------- [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/exchange-funds-flow/#change-metrics) Change Metrics -------------------------------------------------------------------------------------------- [Change Metrics:](https://academy.santiment.net/metrics/details/change_metrics/) * `exchange_inflow_change_1d` * `exchange_inflow_change_7d` * `exchange_inflow_change_30d` * `exchange_outflow_change_1d` * `exchange_outflow_change_7d` * `exchange_outflow_change_30d` * `exchange_balance_change_1d` * `exchange_balance_change_7d` * `exchange_balance_change_30d` * `exchange_inflow_usd_change_1d` * `exchange_inflow_usd_change_7d` * `exchange_inflow_usd_change_30d` * `exchange_outflow_usd_change_1d` * `exchange_outflow_usd_change_7d` * `exchange_outflow_usd_change_30d` * * * [](https://academy.santiment.net/metrics/exchange-funds-flow/#frequency) Frequency ---------------------------------------------------------------------------------- [Five-Minute Intervals](https://academy.santiment.net/metrics/details/frequency#five-minute-frequency) * * * [](https://academy.santiment.net/metrics/exchange-funds-flow/#latency) Latency ------------------------------------------------------------------------------ [On-Chain Latency](https://academy.santiment.net/metrics/details/latency#on-chain-latency) * * * [](https://academy.santiment.net/metrics/exchange-funds-flow/#use-case) Use Case -------------------------------------------------------------------------------- It's not uncommon for large inflows of tokens to the exchange to precede rapid price growth. Here's that exact scenario in case of [aeternity](https://aeternity.com/) , a blockchain platform that enables scalable smart contracts: ![aeternity funds flow balance](https://academy.santiment.net/metrics/exchange-funds-flow/aeternity-funds-flow-balance.png) > Note: Aeternity moved from ERC20 to their own blockchain and Santiment does not have data for this new blockchain. When a large amount of tokens flow out of the exchange, on the other hand, the price is likely to fall soon thereafter. * * * [](https://academy.santiment.net/metrics/exchange-funds-flow/#available-assets) Available Assets ------------------------------------------------------------------------------------------------ Available for [these assets](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22exchange_balance%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) > Note: All of the metrics are available for the same set of assets. * * * [](https://academy.santiment.net/metrics/exchange-funds-flow/#sanapi) SanAPI ---------------------------------------------------------------------------- Available under the `exchange_balance`, `exchange_inflow` and `exchange_outflow` names. 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22exchange_balance%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22santiment%22%0A%20%20%20%20%20%20from%3A%20%222020-01-01T12%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-01-03T12%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** * * * 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22exchange_inflow%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22santiment%22%0A%20%20%20%20%20%20from%3A%20%222020-01-01T12%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-01-03T12%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** * * * 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22exchange_outflow%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22santiment%22%0A%20%20%20%20%20%20from%3A%20%222020-01-01T12%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-01-03T12%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Labeled Exchange | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/labeled-exchange/#labeled-exchange) Labeled Exchange ============================================================================================= [](https://academy.santiment.net/metrics/labeled-exchange/#description) Description ----------------------------------------------------------------------------------- Exchange-labeled metrics showcase exchange metrics from the perspective of a single exchange. For instance, instead of retrieving [active\_deposits](https://academy.santiment.net/metrics/active-deposits/) data for all exchanges, you can specifically query active deposits related to Binance only. [Full list of available exchange names](https://academy.santiment.net/labels/centralized-exchange/#see-also) * * * Supported\_metrics: * `active_deposits_per_exchange` - The number of unique deposit addresses that have been active on a particular day for a given asset within a specific exchange. Essentially, this metric serves as an indicator of how many users have deposited a given asset into the specified exchange. * `deposit_transactions_per_exchange` - The total number of all incoming and outgoing transactions involving deposit addresses on a specific day within a particular exchange. * * * * `active_withdrawals_per_exchange` - The number of unique withdrawal addresses that have withdrawn a particular asset from a given exchange. * `withdrawal_transactions_per_exchange` - The total number of withdrawal transactions for a given asset from a specified centralized exchange. * * * * `exchange_inflow_per_exchange` - The volume of coins/tokens transferred from non-exchange wallets to wallets associated with a specified exchange. * `exchange_outflow_per_exchange` - The volume of coins/tokens transferred from wallets associated with a given exchange to non-exchange wallets. * `exchange_balance_per_exchange` - The net balance resulting from the difference between inflow and outflow (inflow minus outflow) for a particular exchange. Please note that metrics may undergo changes in historical values due to automated recalculations triggered monthly. We constantly update our labels which helps us to keep labels as fresh as possible but result historical data changes. Any modifications to labels, social sources, or relevant jobs will prompt recalculation for the previous month's data. Within a 12 hour period, metric can be supplemented with new data. Additionally, adjustments to labels automatically trigger recalculation of labeled balances. * * * [](https://academy.santiment.net/metrics/labeled-exchange/#access) Access ------------------------------------------------------------------------- [Restricted Access](https://academy.santiment.net/metrics/details/access#restricted-access) . * * * [](https://academy.santiment.net/metrics/labeled-exchange/#measuring-unit) Measuring Unit ----------------------------------------------------------------------------------------- * `active_deposits_per_exchange`, `active_withdrawals_per_exchange` - Amount of addresses * `deposit_transactions_per_exchange`, `withdrawal_transactions_per_exchange` - Amount of transactions * `exchange_balance_per_exchange`, `exchange_inflow_per_exchange`, `exchange_outflow_per_exchange` - Amount of coins/tokens * * * [](https://academy.santiment.net/metrics/labeled-exchange/#data-type) Data Type ------------------------------------------------------------------------------- [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/labeled-exchange/#frequency) Frequency ------------------------------------------------------------------------------- [Daily Intervals](https://academy.santiment.net/metrics/details/frequency#daily-freqency) * * * [](https://academy.santiment.net/metrics/labeled-exchange/#latency) Latency --------------------------------------------------------------------------- [Price Latency](https://academy.santiment.net/metrics/details/latency#price-latency) * * * [](https://academy.santiment.net/metrics/labeled-exchange/#available-assets) Available Assets --------------------------------------------------------------------------------------------- Available for [these assets](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22active_deposits_per_exchange%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) * * * ### [](https://academy.santiment.net/metrics/labeled-exchange/#sanapi) SanAPI Binance Active Deposits: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22active_deposits_per_exchange%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20selector%3A%20%7B%0A%20%20%20%20%20%20%20%20slug%3A%20%22ethereum%22%0A%20%20%20%20%20%20%20%20owner%3A%20%22binance%22%0A%20%20%20%20%20%20%20%20label%3A%20%22centralized_exchange%22%0A%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20from%3A%20%222024-03-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222024-03-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Binance Withdrawals Transactions 1 2 3 4 5 6 7 8 9 10 11 12 13 14 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22withdrawal_transactions_per_exchange%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20selector%3A%20%7B%0A%20%20%20%20%20%20%20%20slug%3A%20%22ethereum%22%0A%20%20%20%20%20%20%20%20owner%3A%20%22binance%22%0A%20%20%20%20%20%20%20%20label%3A%20%22centralized_exchange%22%0A%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20from%3A%20%222020-03-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-03-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Binance Flow Balance 1 2 3 4 5 6 7 8 9 10 11 12 13 14 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22exchange_balance_per_exchange%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20selector%3A%20%7B%0A%20%20%20%20%20%20%20%20slug%3A%20%22ethereum%22%0A%20%20%20%20%20%20%20%20owner%3A%20%22binance%22%0A%20%20%20%20%20%20%20%20label%3A%20%22centralized_exchange%22%0A%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20from%3A%20%222020-03-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-03-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Spent Coins Age Band | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/spent-coins-age-band/#spent-coins-age-band) Spent Coins Age Band ========================================================================================================= [](https://academy.santiment.net/metrics/spent-coins-age-band/#definition) Definition ------------------------------------------------------------------------------------- Spent Coins Age Band is a set of metrics that represent the distribution of coins spent on a given day by the age of coins. In addition to absolute values, there is percentage type of this metric, which shows the relative share of coins in a given interval in relation to total amount of coins spent on a given day. Assigning age to coin/tokens is done according to the [coin-age model](https://academy.santiment.net/metrics/details/stack-coin-age-model/) . * * * [](https://academy.santiment.net/metrics/spent-coins-age-band/#access) Access ----------------------------------------------------------------------------- [Restricted Access](https://academy.santiment.net/metrics/details/access#restricted-access) . * * * [](https://academy.santiment.net/metrics/spent-coins-age-band/#timebound) Timebound ----------------------------------------------------------------------------------- [Interval Timebound Metrics](https://academy.santiment.net/metrics/details/interval_timebound/) available * * * [](https://academy.santiment.net/metrics/spent-coins-age-band/#measuring-unit) Measuring Unit --------------------------------------------------------------------------------------------- Token/Coin amount and % between 0 and 100 * * * [](https://academy.santiment.net/metrics/spent-coins-age-band/#data-type) Data Type ----------------------------------------------------------------------------------- [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/spent-coins-age-band/#frequency) Frequency ----------------------------------------------------------------------------------- [Daily Intervals](https://academy.santiment.net/metrics/details/frequency#daily-frequency) * * * [](https://academy.santiment.net/metrics/spent-coins-age-band/#latency) Latency ------------------------------------------------------------------------------- [On-Chain Latency](https://academy.santiment.net/metrics/details/latency#on-chain-latency) * * * [](https://academy.santiment.net/metrics/spent-coins-age-band/#available-assets) Available Assets ------------------------------------------------------------------------------------------------- Available for [these assets](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22spent_coins_age_band_0d_to_1d%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) * * * [](https://academy.santiment.net/metrics/spent-coins-age-band/#sanapi) SanAPI ----------------------------------------------------------------------------- Available under `spent_coins_age_band_` and `percent_of_spent_coins_age_band_` names. 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22spent_coins_age_band_0d_to_1d%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22santiment%22%0A%20%20%20%20%20%20from%3A%20%222022-05-25T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222022-06-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** [](https://academy.santiment.net/metrics/spent-coins-age-band/#full-list-of-metrics) Full list of metrics --------------------------------------------------------------------------------------------------------- Spent Coins Age Band Metrics * spent\_coins\_age\_band\_0d\_to\_1d * spent\_coins\_age\_band\_1d\_to\_7d * spent\_coins\_age\_band\_7d\_to\_30d * spent\_coins\_age\_band\_30d\_to\_60d * spent\_coins\_age\_band\_60d\_to\_90d * spent\_coins\_age\_band\_90d\_to\_180d * spent\_coins\_age\_band\_180d\_to\_365d * spent\_coins\_age\_band\_365d\_to\_2y * spent\_coins\_age\_band\_2y\_to\_3y * spent\_coins\_age\_band\_3y\_to\_5y * spent\_coins\_age\_band\_5y\_to\_7y * spent\_coins\_age\_band\_7y\_to\_10y * spent\_coins\_age\_band\_10y\_to\_inf Percent of Spent Coins Age Band Metrics * percent\_of\_spent\_coins\_age\_band\_0d\_to\_1d * percent\_of\_spent\_coins\_age\_band\_1d\_to\_7d * percent\_of\_spent\_coins\_age\_band\_7d\_to\_30d * percent\_of\_spent\_coins\_age\_band\_30d\_to\_60d * percent\_of\_spent\_coins\_age\_band\_60d\_to\_90d * percent\_of\_spent\_coins\_age\_band\_90d\_to\_180d * percent\_of\_spent\_coins\_age\_band\_180d\_to\_365d * percent\_of\_spent\_coins\_age\_band\_365d\_to\_2y * percent\_of\_spent\_coins\_age\_band\_2y\_to\_3y * percent\_of\_spent\_coins\_age\_band\_3y\_to\_5y * percent\_of\_spent\_coins\_age\_band\_5y\_to\_7y * percent\_of\_spent\_coins\_age\_band\_7y\_to\_10y * percent\_of\_spent\_coins\_age\_band\_10y\_to\_inf Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Labeled Balance | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/labeled-balance/#labeled-balance) Labeled Balance ========================================================================================== [](https://academy.santiment.net/metrics/labeled-balance/#description) Description ---------------------------------------------------------------------------------- Metrics that show labeled addresses inflow, outflow and balances * `inflow_per_label_and_owner` - inflow of a given owner * `outflow_per_label_and_owner` - outflow of a given owner * `balance_per_label_and_owner_delta` - balance change of a given owner * `balance_per_owner` - balance of a given owner Please note that metrics may undergo changes in historical values due to automated recalculations triggered monthly. We constantly update our labels which helps us to keep labels as fresh as possible but result historical data changes. Any modifications to labels, social sources, or relevant jobs will prompt recalculation for the previous month's data. Within a 12 hour period, metric can be supplemented with new data. Additionally, adjustments to labels automatically trigger recalculation of labeled balances. Available [labels](https://academy.santiment.net/labels/) : * `centralized_exchange` * `decentralized_exchange` * `defi` * `eth2stakingcontract` * `deposit` * * * [](https://academy.santiment.net/metrics/labeled-balance/#access) Access ------------------------------------------------------------------------ [Restricted Access](https://academy.santiment.net/metrics/details/access#restricted-access) * * * [](https://academy.santiment.net/metrics/labeled-balance/#measuring-unit) Measuring Unit ---------------------------------------------------------------------------------------- Amount of tokens * * * [](https://academy.santiment.net/metrics/labeled-balance/#data-type) Data Type ------------------------------------------------------------------------------ [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/labeled-balance/#frequency) Frequency ------------------------------------------------------------------------------ [Five-minute Intervals](https://academy.santiment.net/metrics/details/frequency#five-minute-frequency) * * * [](https://academy.santiment.net/metrics/labeled-balance/#latency) Latency -------------------------------------------------------------------------- [Price Latency](https://academy.santiment.net/metrics/details/latency#price-latency) * * * [](https://academy.santiment.net/metrics/labeled-balance/#available-assets) Available Assets -------------------------------------------------------------------------------------------- * `ethereum` * For [these ERC20 assets](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22inflow_per_label_and_owner%22)%7B%0A%20%20%20%20metadata%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D) * * * ### [](https://academy.santiment.net/metrics/labeled-balance/#sanapi) SanAPI Inflow per label and owner (example DAI inflow to Compound): 1 2 3 4 5 6 7 8 9 10 11 12 13 14 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22inflow_per_label_and_owner%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20selector%3A%20%7B%0A%20%20%20%20%20%20%20%20slug%3A%20%22uniswap%22%0A%20%20%20%20%20%20%09owner%3A%20%221inch%22%0A%20%20%20%20%20%20%09label%3A%20%22decentralized_exchange%22%0A%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20from%3A%20%222023-12-10T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222023-12-11T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221h%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Inflow per label (example DAI inflow to all DeFi protocols): 1 2 3 4 5 6 7 8 9 10 11 12 13 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22inflow_per_label_and_owner%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20selector%3A%20%7B%0A%20%20%20%20%20%20%20%20slug%3A%20%22lido-dao%22%0A%20%20%20%20%20%20%09label%3A%20%22defi%22%0A%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20from%3A%20%222023-12-10T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222023-12-11T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221h%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Outflow per label and owner (example DAI outflow to Compound): 1 2 3 4 5 6 7 8 9 10 11 12 13 14 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22outflow_per_label_and_owner%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20selector%3A%20%7B%0A%20%20%20%20%20%20%20%20slug%3A%20%22uniswap%22%0A%20%20%20%20%20%20%09owner%3A%20%221inch%22%0A%20%20%20%20%20%20%09label%3A%20%22decentralized_exchange%22%0A%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20from%3A%20%222023-12-10T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222023-12-11T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221h%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Outflow per label: 1 2 3 4 5 6 7 8 9 10 11 12 13 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22outflow_per_label_and_owner%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20selector%3A%20%7B%0A%20%20%20%20%20%20%20%20slug%3A%20%22lido-dao%22%0A%20%20%20%20%20%20%09label%3A%20%22defi%22%0A%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20from%3A%20%222023-12-10T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222023-12-11T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221h%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Balance delta per label and owner (example DAI balance delta of Aave): 1 2 3 4 5 6 7 8 9 10 11 12 13 14 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22balance_per_label_and_owner_delta%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20selector%3A%20%7B%0A%20%20%20%20%20%20%20%20slug%3A%20%22uniswap%22%0A%20%20%20%20%20%20%09owner%3A%20%221inch%22%0A%20%20%20%20%20%20%09label%3A%20%22decentralized_exchange%22%0A%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20from%3A%20%222023-12-10T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222023-12-11T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221h%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Balance per label and owner (example DAI balance of Aave): 1 2 3 4 5 6 7 8 9 10 11 12 13 14 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22balance_per_owner%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20selector%3A%20%7B%0A%20%20%20%20%20%20%20%20slug%3A%20%22multi-collateral-dai%22%0A%20%20%20%20%20%20%09owner%3A%20%22aave%22%0A%20%20%20%20%20%20%09label%3A%20%22defi%22%0A%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20from%3A%20%222020-04-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-04-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221h%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Stock To Flow Ratio (S2F): How It's Used and Calculated ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/stock-to-flow/#stock-to-flow-ratio) Stock To Flow ratio ================================================================================================ [](https://academy.santiment.net/metrics/stock-to-flow/#definition) Definition ------------------------------------------------------------------------------ The Stock To Flow (S2F) ratio is a vital indicator provided by Santiment. Defined in the simplest terms, it's a measure of the scarcity or abundance of a specific asset. The stock-to-flow ratio is fundamentally a relationship between the total supply of an asset (the stock) and its production rate (the flow). We measure the stock-to-flow ratio for a given asset as the ratio between the [Total Circulation](https://academy.santiment.net/metrics/circulation/) of the asset and the daily minted coins multiplied by days in one year. The 'stock' aspect relates to the existing supply of the asset in circulation, while the 'flow' portion refers to the newly produced assets, usually measured annually. ![Stock to Flow](https://github.com/santiment/academy/assets/24714957/29871977-a860-4fa6-a2e0-a691058a83ff) Source: [https://app.santiment.net/charts/stock-to-flow-ratio-btc-22307](https://app.santiment.net/charts/stock-to-flow-ratio-btc-22307) [](https://academy.santiment.net/metrics/stock-to-flow/#applying-the-stock-to-flow-ratio-to-trading) Applying the Stock to Flow Ratio to Trading ------------------------------------------------------------------------------------------------------------------------------------------------ In the trading world, how does the stock-to-flow ratio come into play? A high S2F ratio implies scarcity, meaning there's less production compared to the existing supply. This scarcity could signify a potential price increase due to the limited new supply making its way to the market. On the opposite end, a low stock-to-flow ratio indicates a larger new supply but a smaller demand, possibly leading to a depreciation in the asset's value. [](https://academy.santiment.net/metrics/stock-to-flow/#making-informed-trading-decisions-with-the-s2f-ratio) Making Informed Trading Decisions with the S2F Ratio ------------------------------------------------------------------------------------------------------------------------------------------------------------------ As a trader, a high stock-to-flow ratio could be viewed as a buying signal, as the high scarcity could mean potential price appreciation. However, a low S2F might be a selling cue to prevent potential losses from the predicted oversupply. However, the stock-to-flow ratio shouldn't be the only tool you use when deciding to buy or sell. It should be used alongside other indicators and market analysis methods. Remember to assess overall market sentiment, global economic trends, and particular news or events that could affect price changes of your chosen asset. In essence, the stock-to-flow should be one tool in a collection used to formulate a comprehensive and robust trading strategy. * * * [](https://academy.santiment.net/metrics/stock-to-flow/#access) Access ---------------------------------------------------------------------- Stock To Flow ratio metric is available only in `Custom` plans. [Restricted Access](https://academy.santiment.net/metrics/details/access#restricted-access) . * * * [](https://academy.santiment.net/metrics/stock-to-flow/#timebound) Timebound ---------------------------------------------------------------------------- [Timebound Metrics](https://academy.santiment.net/metrics/details/timebound/) available * * * [](https://academy.santiment.net/metrics/stock-to-flow/#measuring-unit) Measuring Unit -------------------------------------------------------------------------------------- Token/Coin amount * * * [](https://academy.santiment.net/metrics/stock-to-flow/#data-type) Data Type ---------------------------------------------------------------------------- [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/stock-to-flow/#frequency) Frequency ---------------------------------------------------------------------------- [Daily Intervals](https://academy.santiment.net/metrics/details/frequency#daily-frequency) * * * [](https://academy.santiment.net/metrics/stock-to-flow/#latency) Latency ------------------------------------------------------------------------ [On-Chain Latency](https://academy.santiment.net/metrics/details/latency#on-chain-latency) * * * [](https://academy.santiment.net/metrics/stock-to-flow/#available-assets) Available Assets ------------------------------------------------------------------------------------------ Available for [these assets](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22stock_to_flow%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) > Note: `stock_to_flow` metric is available only for assets that mint new coins on a regular basis. * * * [](https://academy.santiment.net/metrics/stock-to-flow/#sanapi) SanAPI ---------------------------------------------------------------------- Available under the `stock_to_flow` name. 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22stock_to_flow%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22bitcoin%22%0A%20%20%20%20%20%20from%3A%20%222020-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-01-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Supply On/Outside Exchanges | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/supply-on-or-outside-exchanges/#supply-on-outside-exchanges) Supply On/Outside Exchanges ================================================================================================================================= [](https://academy.santiment.net/metrics/supply-on-or-outside-exchanges/#definition) Definition ----------------------------------------------------------------------------------------------- Supply on or outside exchanges is a measure of the amount of a certain token or cryptocurrency being held on centralized exchanges (CEX) or decentralized exchanges (DEX), and outside exchanges. This metric tracks each part of the token's total supply that is either being circulated or hoarded by the market participants. To do this, we need to monitor and record wallet addresses for each CEX and DEX that holds the token, as well as the rest of the addresses not associated with any exchange. This metric showcases the distribution of a specific token or cryptocurrency, indicating its demand as well as the overall market sentiment. It is useful for identifying significant events, like whale accumulation or an increase in the ratio of tokens held on exchanges – which could signal potential sell-offs. The following metrics are provided: * `Percent of total supply on exchange` - What percent of the coin/token total supply is stored in known centralized exchange (CEX) and decentralized exchange (DEX) wallets * `Supply on exchanges` - What amount of coins/tokens are stored in known CEX and DEX wallets * `Supply outside exchange` - What amount of coins/tokens are stored outside known CEX and DEX wallets > **Note:** The metrics are computed on the set of publicly known exchange wallets and the exchange wallets that Santiment has found by doing analysis. * * * [](https://academy.santiment.net/metrics/supply-on-or-outside-exchanges/#access) Access --------------------------------------------------------------------------------------- [Restricted Access](https://academy.santiment.net/metrics/details/access#restricted-access) . * * * [](https://academy.santiment.net/metrics/supply-on-or-outside-exchanges/#measuring-unit) Measuring Unit ------------------------------------------------------------------------------------------------------- * Percent of total supply on exchanges is measured in `percentage between 0 and 100` * Supply On/Outside Exchanges is measured in `amount of coins/tokens` * * * [](https://academy.santiment.net/metrics/supply-on-or-outside-exchanges/#data-type) Data Type --------------------------------------------------------------------------------------------- [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/supply-on-or-outside-exchanges/#change-metrics) Change Metrics ------------------------------------------------------------------------------------------------------- [Change Metrics:](https://academy.santiment.net/metrics/details/change_metrics/) * `percent_of_total_supply_on_exchanges_change_1d` * `percent_of_total_supply_on_exchanges_change_7d` * `percent_of_total_supply_on_exchanges_change_30d` * * * [](https://academy.santiment.net/metrics/supply-on-or-outside-exchanges/#frequency) Frequency --------------------------------------------------------------------------------------------- [Daily Intervals](https://academy.santiment.net/metrics/details/frequency#daily-frequency) * * * [](https://academy.santiment.net/metrics/supply-on-or-outside-exchanges/#latency) Latency ----------------------------------------------------------------------------------------- [On-Chain Latency](https://academy.santiment.net/metrics/details/latency#on-chain-latency) * * * [](https://academy.santiment.net/metrics/supply-on-or-outside-exchanges/#available-assets) Available Assets ----------------------------------------------------------------------------------------------------------- * Percent of total supply on exchange is available for [these assets](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22percent_of_total_supply_on_exchanges%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) * Supply on exchanges is available for [these assets](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22supply_on_exchanges%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) * Supply outside exchanges is available for [these assets](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22supply_outside_exchanges%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) * * * [](https://academy.santiment.net/metrics/supply-on-or-outside-exchanges/#sanapi) SanAPI --------------------------------------------------------------------------------------- Available under the names: * `percent_of_total_supply_on_exchanges` * `supply_on_exchanges` * `supply_outside_exchanges` 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22percent_of_total_supply_on_exchanges%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22santiment%22%0A%20%20%20%20%20%20from%3A%20%222019-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222019-09-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%227d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** * * * 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22supply_on_exchanges%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22santiment%22%0A%20%20%20%20%20%20from%3A%20%222019-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222019-09-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%227d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** * * * 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22supply_outside_exchanges%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22santiment%22%0A%20%20%20%20%20%20from%3A%20%222019-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222019-09-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%227d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Supply Distribution | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/supply-distribution/#supply-distribution) Supply Distribution ====================================================================================================== [](https://academy.santiment.net/metrics/supply-distribution/#our-supply-distribution-metrics) Our Supply Distribution Metrics ------------------------------------------------------------------------------------------------------------------------------ * [Amount of Holders](https://academy.santiment.net/metrics/supply-distribution/amount-of-holders/) The number of unique addresses holding tokens within predefined balance intervals * [Combined Balance of Holders](https://academy.santiment.net/metrics/supply-distribution/combined-balance-of-holders/) The sum of tokens held across all addresses within a specified balance interval * [Amount of Labeled Holders](https://academy.santiment.net/metrics/supply-distribution/amount-of-labeled-holders/) The number of unique addresses with a specific label, holding tokens within predefined balance intervals * [Combined Balance of Labeled Holders](https://academy.santiment.net/metrics/supply-distribution/combined-balance-of-labeled-holders/) The sum of tokens held across all addresses with a specific label within a specified balance interval [](https://academy.santiment.net/metrics/supply-distribution/#description) Description -------------------------------------------------------------------------------------- The supply distribution metric offers a comprehensive view of how the holdings of a particular token are distributed among its user base across different balance intervals. These intervals represent predefined ranges of token balances held by individual users. By examining this metric, observers can identify trends such as whether a significant portion of the supply is concentrated among a small number of large holders or if the distribution is more evenly spread across a wider user base. Such insights are valuable for stakeholders, as they provide crucial information about the level of decentralization within the cryptocurrency network, potential market liquidity dynamics, and overall ecosystem health. Moreover, understanding supply distribution aids in assessing the potential impact of large holders on price volatility and market sentiment, offering valuable insights for investors and analysts. Updated 1 year ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Transaction Volume | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/transaction-volume/#transaction-volume) Transaction Volume =================================================================================================== [](https://academy.santiment.net/metrics/transaction-volume/#description) Description ------------------------------------------------------------------------------------- The `transaction_volume` metric shows total on-chain amount of coins/tokens transacted for a given asset in a given time interval. The `transaction_volume_usd` metric shows the total on-chain amount of coins/tokens in USD transacted for a given asset in a given time interval. To compute it, the amount of coins/tokens in each transaction is multiplied by the price in USD of the asset at that moment. * * * [](https://academy.santiment.net/metrics/transaction-volume/#access) Access --------------------------------------------------------------------------- [Restricted Access](https://academy.santiment.net/metrics/details/access#restricted-access) . * * * [](https://academy.santiment.net/metrics/transaction-volume/#measuring-unit) Measuring Unit ------------------------------------------------------------------------------------------- Amount of coins/tokens * * * [](https://academy.santiment.net/metrics/transaction-volume/#data-type) Data Type --------------------------------------------------------------------------------- [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/transaction-volume/#change-metrics) Change Metrics ------------------------------------------------------------------------------------------- [Change Metrics](https://academy.santiment.net/metrics/details/change_metrics/) * * * [](https://academy.santiment.net/metrics/transaction-volume/#frequency) Frequency --------------------------------------------------------------------------------- * transaction\_volume - [Five-Minute Intervals](https://academy.santiment.net/metrics/details/frequency#five-minute-frequency) * transaction\_volume\_usd - [Daily Intervals](https://academy.santiment.net/metrics/details/frequency#daily-frequency) * * * [](https://academy.santiment.net/metrics/transaction-volume/#latency) Latency ----------------------------------------------------------------------------- [On-Chain Latency](https://academy.santiment.net/metrics/details/latency#on-chain-latency) * * * [](https://academy.santiment.net/metrics/transaction-volume/#available-assets) Available Assets ----------------------------------------------------------------------------------------------- Available for [these assets](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22transaction_volume%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) * * * [](https://academy.santiment.net/metrics/transaction-volume/#sanapi) SanAPI --------------------------------------------------------------------------- Available under the `transaction_volume` name. 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22transaction_volume%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22bitcoin%22%0A%20%20%20%20%20%20from%3A%20%222025-04-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222025-04-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221h%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** [](https://academy.santiment.net/metrics/transaction-volume/#full-list-of-metrics) Full list of metrics ------------------------------------------------------------------------------------------------------- The full list of Transaction Volume metrics is: Open Metrics List * transaction\_volume * transaction\_volume\_usd * transaction\_volume\_change\_1d * transaction\_volume\_change\_30d * transaction\_volume\_change\_7d * transaction\_volume\_usd\_change\_1d * transaction\_volume\_usd\_change\_30d * transaction\_volume\_usd\_change\_7d Updated 5 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # DeFi Lending and Borrowing Protocols | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/lending-and-borrowing-protocols/#defi-lending-and-borrowing-protocols) DeFi Lending and Borrowing Protocols ==================================================================================================================================================== Decentralized Finance (DeFi) lending and borrowing protocols are blockchain-based platforms that allow individuals to lend and borrow digital assets without the need for traditional financial intermediaries, such as banks. These protocols utilize smart contracts, which are self-executing code on a blockchain, to automate the lending and borrowing process and enforce the terms of the agreement between parties. On these DeFi platforms, users can lend their digital assets to other users and earn interest on their deposits. Conversely, borrowers can use these digital assets as collateral to obtain loans in the form of stablecoins or other cryptocurrencies. DeFi lending and borrowing protocols typically offer more flexibility, accessibility, and transparency than traditional finance and allow users to participate in the global financial system without the need for intermediaries or extensive paperwork. However, they also carry additional risks such as smart contract vulnerabilities and market volatility. * [Aave V2](https://academy.santiment.net/metrics/lending-and-borrowing-protocols/aave-v2/) * [Aave V3](https://academy.santiment.net/metrics/lending-and-borrowing-protocols/aave-v3/) * [Aave Safety Module](https://academy.santiment.net/metrics/lending-and-borrowing-protocols/aave-safety-module/) * [Compound](https://academy.santiment.net/metrics/lending-and-borrowing-protocols/compound/) * [Compound V3](https://academy.santiment.net/metrics/lending-and-borrowing-protocols/compound-v3/) * [MakerDAO](https://academy.santiment.net/metrics/lending-and-borrowing-protocols/makerdao/) * [Morpho](https://academy.santiment.net/metrics/lending-and-borrowing-protocols/morpho/) * [Spark](https://academy.santiment.net/metrics/lending-and-borrowing-protocols/spark/) * [Fluid](https://academy.santiment.net/metrics/lending-and-borrowing-protocols/fluid/) * [Liquity](https://academy.santiment.net/metrics/lending-and-borrowing-protocols/liquity/) * [Fraxlend](https://academy.santiment.net/metrics/lending-and-borrowing-protocols/fraxlend/) Updated 8 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Total Supply | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/total-supply/#total-supply) Total Supply ================================================================================= [](https://academy.santiment.net/metrics/total-supply/#definition) Definition ----------------------------------------------------------------------------- Total Supply is the total amount of coins or tokens belonging to a particular cryptocurrency that have been created or mined, and are currently in circulation, including those that may be locked or reserved. Supply in Profit metric is computed by summing all token amounts that were last transferred when the price of token was less then the current price. Percent of Supply in Profit represents the ratio between Supply in Profit and [Circulation Supply](https://academy.santiment.net/metrics/circulation/) . This metric measures weather the market is in depression or euphoria stage. If token is breaking all time highs every holder is in profit, so the metric value is 100%. On the other side, in the bear markets there are usually more then half of tokens are in loss, so the metric value drops below 50%. * * * [](https://academy.santiment.net/metrics/total-supply/#access) Access --------------------------------------------------------------------- [Restricted Access](https://academy.santiment.net/metrics/details/access#restricted-access) * * * [](https://academy.santiment.net/metrics/total-supply/#measuring-unit) Measuring Unit ------------------------------------------------------------------------------------- * `total_supply` and `total_supply_in_profit` - Token/Coin amount * `percent_of_total_supply_in_profit` - Percentage * * * [](https://academy.santiment.net/metrics/total-supply/#data-type) Data Type --------------------------------------------------------------------------- [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/total-supply/#frequency) Frequency --------------------------------------------------------------------------- [Daily Intervals](https://academy.santiment.net/metrics/details/frequency#daily-frequency) * * * [](https://academy.santiment.net/metrics/total-supply/#latency) Latency ----------------------------------------------------------------------- [On-Chain Latency](https://academy.santiment.net/metrics/details/latency#on-chain-latency) * * * [](https://academy.santiment.net/metrics/total-supply/#available-assets) Available Assets ----------------------------------------------------------------------------------------- Available for for [these assets](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22total_supply%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) > Note: All metrics are available for the same set of assets. * * * [](https://academy.santiment.net/metrics/total-supply/#sanapi) SanAPI --------------------------------------------------------------------- Total Supply is available under the `total_supply` name. 1 2 3 4 5 6 7 8 9 10 11 12 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22total_supply%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20selector%3A%20%7B%0A%20%20%20%20%20%20%20%20slug%3A%20%22ethereum%22%0A%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20from%3A%20%222023-11-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222023-12-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Supply in Profit is available under the `total_supply_in_profit` name. 1 2 3 4 5 6 7 8 9 10 11 12 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22total_supply_in_profit%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20selector%3A%20%7B%0A%20%20%20%20%20%20%20%20slug%3A%20%22ethereum%22%0A%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20from%3A%20%222023-11-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222023-12-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Percent of Supply in Profit is available for `percent_of_total_supply_in_profit` name. 1 2 3 4 5 6 7 8 9 10 11 12 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22percent_of_total_supply_in_profit%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20selector%3A%20%7B%0A%20%20%20%20%20%20%20%20slug%3A%20%22ethereum%22%0A%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20from%3A%20%222023-11-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222023-12-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** [](https://academy.santiment.net/metrics/total-supply/#full-list-of-metrics) Full list of metrics ------------------------------------------------------------------------------------------------- The full list of Total Supply metrics is: Open Metrics List * percent\_of\_whale\_stablecoin\_total\_supply Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Transaction Volume In Profit Or Loss | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/transaction-volume-in-profit-or-loss/#transaction-volume-in-profit-or-loss) Transaction Volume In Profit Or Loss ========================================================================================================================================================= [](https://academy.santiment.net/metrics/transaction-volume-in-profit-or-loss/#description) Description ------------------------------------------------------------------------------------------------------- Those metrics show the aggregate amount of coins/tokens across all transactions on the network that moved in profit or loss for a given asset in an interval. There is also a metric which shows the ratio between transaction volume in profit and transaction volume in loss. * * * [](https://academy.santiment.net/metrics/transaction-volume-in-profit-or-loss/#access) Access --------------------------------------------------------------------------------------------- [Restricted Access](https://academy.santiment.net/metrics/details/access#restricted-access) . * * * [](https://academy.santiment.net/metrics/transaction-volume-in-profit-or-loss/#measuring-unit) Measuring Unit ------------------------------------------------------------------------------------------------------------- Amount of coins/tokens * * * [](https://academy.santiment.net/metrics/transaction-volume-in-profit-or-loss/#data-type) Data Type --------------------------------------------------------------------------------------------------- [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/transaction-volume-in-profit-or-loss/#frequency) Frequency --------------------------------------------------------------------------------------------------- [Daily Intervals](https://academy.santiment.net/metrics/details/frequency#daily-frequency) * * * [](https://academy.santiment.net/metrics/transaction-volume-in-profit-or-loss/#latency) Latency ----------------------------------------------------------------------------------------------- [On-Chain Latency](https://academy.santiment.net/metrics/details/latency#on-chain-latency) * * * [](https://academy.santiment.net/metrics/transaction-volume-in-profit-or-loss/#available-assets) Available Assets ----------------------------------------------------------------------------------------------------------------- Available for [these assets](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22transaction_volume%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) * * * [](https://academy.santiment.net/metrics/transaction-volume-in-profit-or-loss/#sanapi) SanAPI --------------------------------------------------------------------------------------------- Available under the `transaction_volume_in_profit` name. 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22transaction_volume_in_profit%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22bitcoin%22%0A%20%20%20%20%20%20from%3A%20%222025-03-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222025-03-30T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Available under the `transaction_volume_in_loss` name. 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22transaction_volume_in_loss%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22bitcoin%22%0A%20%20%20%20%20%20from%3A%20%222025-03-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222025-03-30T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Available under the `transaction_volume_profit_loss_ratio` name. 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22transaction_volume_profit_loss_ratio%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22bitcoin%22%0A%20%20%20%20%20%20from%3A%20%222025-03-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222025-03-30T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Updated 5 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Whale Transaction Count | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/whale-transaction-count/#whale-transaction-count) Whale Transaction Count ================================================================================================================== [](https://academy.santiment.net/metrics/whale-transaction-count/#description) Description ------------------------------------------------------------------------------------------ This metric shows the number of transactions whose value in USD is above a given threhsold. There are two metrics available: * `whale_transaction_count_100k_usd_to_inf` - The count of all transactions whose USD value is above $100,000 * `whale_transaction_count_1m_usd_to_inf` - The count of all transactions whose USD value is above $1,000,000 * * * [](https://academy.santiment.net/metrics/whale-transaction-count/#access) Access -------------------------------------------------------------------------------- [Restricted Access](https://academy.santiment.net/metrics/details/access#restricted-access) . * * * [](https://academy.santiment.net/metrics/whale-transaction-count/#measuring-unit) Measuring Unit ------------------------------------------------------------------------------------------------ Count of transactions * * * [](https://academy.santiment.net/metrics/whale-transaction-count/#data-type) Data Type -------------------------------------------------------------------------------------- [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/whale-transaction-count/#change-metrics) Change Metrics ------------------------------------------------------------------------------------------------ [Change Metrics](https://academy.santiment.net/metrics/details/change_metrics/) * * * [](https://academy.santiment.net/metrics/whale-transaction-count/#frequency) Frequency -------------------------------------------------------------------------------------- [Five-Minute Intervals](https://academy.santiment.net/metrics/details/frequency#five-minute-frequency) * * * [](https://academy.santiment.net/metrics/whale-transaction-count/#latency) Latency ---------------------------------------------------------------------------------- [On-Chain Latency](https://academy.santiment.net/metrics/details/latency#on-chain-latency) * * * [](https://academy.santiment.net/metrics/whale-transaction-count/#available-assets) Available Assets ---------------------------------------------------------------------------------------------------- Available for [these assets](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22whale_transaction_count_100k_usd_to_inf%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) * * * [](https://academy.santiment.net/metrics/whale-transaction-count/#sanapi) SanAPI -------------------------------------------------------------------------------- The metrics are available under the following names: * `whale_transaction_count_100k_usd_to_inf` * `whale_transaction_count_1m_usd_to_inf` In addition, there following change metrics are available: * `whale_transaction_count_100k_usd_to_inf_change_1d` * `whale_transaction_count_100k_usd_to_inf_change_7d` * `whale_transaction_count_100k_usd_to_inf_change_30d` * `whale_transaction_count_1m_usd_to_inf_change_1d` * `whale_transaction_count_1m_usd_to_inf_change_7d` * `whale_transaction_count_1m_usd_to_inf_change_30d` 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22whale_transaction_count_100k_usd_to_inf%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22santiment%22%0A%20%20%20%20%20%20from%3A%20%222020-04-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-04-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Velocity | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/velocity/#velocity) Velocity ===================================================================== > For a more in-depth explanation of `Velocity`, please click [here](https://academy.santiment.net/metrics/velocity/velocity-technical/) > . * * * [](https://academy.santiment.net/metrics/velocity/#definition) Definition ------------------------------------------------------------------------- The metric shows the average number of times that a coin/token changes wallets each day. Simply put, a higher velocity means that a coin/token is used in transactions more often within a set time frame. Velocity can be used to explain various noteworthy events in the life of a project. For example, here's Ethereum: ![ethereum-velocity](https://academy.santiment.net/metrics/velocity/ethereum-velocity.png) Notice the steep drop off? The increased activity (and subsequent dip) correlates squarely to a huge ETH mixer that operated between March 2017 and March 2018. During that time, coins were moved a lot between addresses which lead to big velocity spikes. Once the mixer was liquidated, token velocity toppled back to 'normal' levels, where it's remained ever since. * * * [](https://academy.santiment.net/metrics/velocity/#access) Access ----------------------------------------------------------------- [Restricted Access](https://academy.santiment.net/metrics/details/access#restricted-access) . * * * [](https://academy.santiment.net/metrics/velocity/#measuring-unit) Measuring Unit --------------------------------------------------------------------------------- A non-negative number of times coin/token changes wallet * * * [](https://academy.santiment.net/metrics/velocity/#data-type) Data Type ----------------------------------------------------------------------- [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/velocity/#frequency) Frequency ----------------------------------------------------------------------- [Daily Intervals](https://academy.santiment.net/metrics/details/frequency#daily-frequency) * * * [](https://academy.santiment.net/metrics/velocity/#latency) Latency ------------------------------------------------------------------- [On-Chain Latency](https://academy.santiment.net/metrics/details/latency#on-chain-latency) * * * [](https://academy.santiment.net/metrics/velocity/#available-assets) Available Assets ------------------------------------------------------------------------------------- Available for [these assets](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22velocity%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) * * * [](https://academy.santiment.net/metrics/velocity/#sanapi) SanAPI ----------------------------------------------------------------- Available under the `velocity` name. 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22velocity%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22santiment%22%0A%20%20%20%20%20%20from%3A%20%222020-04-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-04-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Transaction count | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/transaction-count/#transaction-count) Transaction count ================================================================================================ [](https://academy.santiment.net/metrics/transaction-count/#description) Description ------------------------------------------------------------------------------------ The Transaction Count metric indicates the number of unique transactions occurring on the network within a specific day. As an alternative to the transaction count metric, there's the Payments Count metric, which reflects the number of individual payments made on the network within a specific day. The difference between Transaction Count and Payments Count lies in the scenario where a single transaction includes multiple transfers. In such cases, the Transaction Count registers this as a single transaction, while the Payments Count registers each individual transfer within that transaction. * * * [](https://academy.santiment.net/metrics/transaction-count/#access) Access -------------------------------------------------------------------------- [Free Access](https://academy.santiment.net/metrics/details/access#free-access) * * * [](https://academy.santiment.net/metrics/transaction-count/#measuring-unit) Measuring Unit ------------------------------------------------------------------------------------------ Amount of transactions * * * [](https://academy.santiment.net/metrics/transaction-count/#data-type) Data Type -------------------------------------------------------------------------------- [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/transaction-count/#frequency) Frequency -------------------------------------------------------------------------------- [Daily Interval](https://academy.santiment.net/metrics/details/frequency#daily-frequency) * * * [](https://academy.santiment.net/metrics/transaction-count/#latency) Latency ---------------------------------------------------------------------------- [On-Chain Latency](https://academy.santiment.net/metrics/details/latency#on-chain-latency) * * * [](https://academy.santiment.net/metrics/transaction-count/#available-assets) Available Assets ---------------------------------------------------------------------------------------------- Available for [these assets](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22transactions_count%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) > Note: All metrics are available for the same set of assets * * * ### [](https://academy.santiment.net/metrics/transaction-count/#sanapi) SanAPI Available under the `transactions_count` name. 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22transactions_count%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22santiment%22%0A%20%20%20%20%20%20from%3A%20%222020-04-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-04-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Available under the `payments_count` name. 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22payments_count%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22santiment%22%0A%20%20%20%20%20%20from%3A%20%222020-04-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-04-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Transaction Size | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/transaction-size/#transaction-size) Transaction Size ============================================================================================= [](https://academy.santiment.net/metrics/transaction-size/#description) Description ----------------------------------------------------------------------------------- The Transaction Size Metric calculates the average size and the median size of transactions over a specific time period. If the average transfer size is increasing, it could suggest that whales are beginning to move their tokens, either buying or selling. Transaction Size Metrics: * `average_transfer_5m`: Average transaction size over five-minute intervals * `median_transfer_5m`: Median transaction size over five-minute intervals * * * [](https://academy.santiment.net/metrics/transaction-size/#access) Access ------------------------------------------------------------------------- [Free Access](https://academy.santiment.net/metrics/details/access#free-access) * * * [](https://academy.santiment.net/metrics/transaction-size/#measuring-unit) Measuring Unit ----------------------------------------------------------------------------------------- Token/Coin amount * * * [](https://academy.santiment.net/metrics/transaction-size/#data-type) Data Type ------------------------------------------------------------------------------- [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/transaction-size/#frequency) Frequency ------------------------------------------------------------------------------- [Five-minute Intervals](https://academy.santiment.net/metrics/details/frequency#five-minute-frequency) * * * [](https://academy.santiment.net/metrics/transaction-size/#latency) Latency --------------------------------------------------------------------------- [On-Chain Latency](https://academy.santiment.net/metrics/details/latency#on-chain-latency) * * * [](https://academy.santiment.net/metrics/transaction-size/#available-assets) Available Assets --------------------------------------------------------------------------------------------- Available for [these assets](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22average_transfer_5m%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) > Note: All metrics are available for the same set of assets * * * ### [](https://academy.santiment.net/metrics/transaction-size/#sanapi) SanAPI Available under names: `average_transfer_5m` and `median_transfer_5m` 1 2 3 4 5 6 7 8 9 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22average_transfer_5m%22)%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22ethereum%22%0A%20%20%20%20%20%20from%3A%20%222024-03-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222024-03-03T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%225m%22)%0A%20%20%7D%0A%7D) ** Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Funding Rates Aggregated | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/funding-rates-aggregated/#funding-rates-aggregated) Funding Rates Aggregated ===================================================================================================================== [](https://academy.santiment.net/metrics/funding-rates-aggregated/#definition) Definition ----------------------------------------------------------------------------------------- The funding rate is a recurring fee that long positions pay to short positions, or vice versa, at predetermined intervals (usually every 8 hours). The goal is to ensure that the price of the perpetual contract stays close to the spot price of the underlying asset. Perpetual futures contracts are a type of derivative that tracks the price of an underlying asset and is designed to closely mimic the spot market. Funding rates aggregated metrics use [Open Interest](https://academy.santiment.net/metrics/open-interest/) for aggregation. Meaning the contract with the biggest open interest will have the biggest impact on the final funding rate aggregated value. There are three types of funding rates aggregated metrics: * Funding rates aggregated by exchange - represents the aggregation of all funding rates by open interest on given exchange for a given asset * Funding rates aggregated by settlement currency - represents the aggregation of all funding rates by open interest per settlement currency for a given asset * Total funding rates aggregated by asset - represents the aggregation of all funding rates by open interest for a given asset * * * [](https://academy.santiment.net/metrics/funding-rates-aggregated/#access) Access --------------------------------------------------------------------------------- [Restricted Access](https://academy.santiment.net/metrics/details/access#restricted-access) * * * [](https://academy.santiment.net/metrics/funding-rates-aggregated/#measuring-unit) Measuring Unit ------------------------------------------------------------------------------------------------- Decimal percentage * * * [](https://academy.santiment.net/metrics/funding-rates-aggregated/#data-type) Data Type --------------------------------------------------------------------------------------- [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/funding-rates-aggregated/#frequency) Frequency --------------------------------------------------------------------------------------- [Five-minute Intervals](https://academy.santiment.net/metrics/details/frequency#five-minute-freqency) * * * [](https://academy.santiment.net/metrics/funding-rates-aggregated/#latency) Latency ----------------------------------------------------------------------------------- [On-Chain Latency](https://academy.santiment.net/metrics/details/latency#funding-rates-latency) * * * [](https://academy.santiment.net/metrics/funding-rates-aggregated/#available-assets) Available Assets ----------------------------------------------------------------------------------------------------- * Funding rates aggregated by exchange is available for [these assets](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22funding_rates_aggregated_by_exchange%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) * Funding rates aggregated by settlement currency is available for [these assets](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22funding_rates_aggregated_by_settlement_currency%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) * Total funding rates aggregated by asset is available for [these assets](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22total_funding_rates_aggregated_per_asset%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) * * * [](https://academy.santiment.net/metrics/funding-rates-aggregated/#available-exchanges) Available Exchanges ----------------------------------------------------------------------------------------------------------- `Binance`, `Bitfinex`, `Bitget`, `Bitmex`, `Btcex`, `Bybit`, `Crosstower`, `Cryptodotcom`, `Deribit`, `Kraken`, `Okex` * * * [](https://academy.santiment.net/metrics/funding-rates-aggregated/#sanapi) SanAPI --------------------------------------------------------------------------------- * Funding rates aggregated by exchange available under the `funding_rates_aggregated_by_exchange` name. * Funding rates aggregated by settlement currency is available for `funding_rates_aggregated_by_settlement_currency` name. * Total funding rates aggregated by asset is available for `total_funding_rates_aggregated_per_asset` name. 1 2 3 4 5 6 7 8 9 10 11 12 13 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22funding_rates_aggregated_by_exchange%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20selector%3A%20%7B%0A%20%20%20%20%20%20%20%20slug%3A%20%22ethereum%22%0A%20%20%20%20%20%20%20%20owner%3A%20%22binance%22%0A%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20from%3A%20%222023-11-27T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222023-11-28T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%225m%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** * * * 1 2 3 4 5 6 7 8 9 10 11 12 13 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22funding_rates_aggregated_by_settlement_currency%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20selector%3A%20%7B%0A%20%20%20%20%20%20%20%20slug%3A%20%22ethereum%22%0A%20%20%20%20%20%20%20%20owner%3A%20%22USDT%22%0A%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20from%3A%20%222023-11-27T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222023-11-28T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%225m%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** * * * 1 2 3 4 5 6 7 8 9 10 11 12 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22total_funding_rates_aggregated_per_asset%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20selector%3A%20%7B%0A%20%20%20%20%20%20%20%20slug%3A%20%22ethereum%22%0A%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20from%3A%20%222023-11-27T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222023-11-28T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%225m%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Updated 5 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Open Interest | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/open-interest/#open-interest) Open Interest ==================================================================================== [](https://academy.santiment.net/metrics/open-interest/#definition) Definition ------------------------------------------------------------------------------ Open interest represents the total number of outstanding contracts that have not been settled by an offsetting trade. For example, if trader A buys a futures contract from trader B, and neither has closed out their position, the open interest is one. Traders can close out their positions by taking an opposing position (sell if they were long or buy if they were short). Changes in open interest can reflect whether traders are initiating new positions or closing existing ones. There are three types of open interest metrics: * Open interest per exchange - represents the sum of open interests of all contracts on given exchange for a given asset * Open interest per settlement currency - represents the sum of open interests of all contracts for given settlement currency and asset * Total open interest - represents the sum of open interests of all contracts for a given asset * * * [](https://academy.santiment.net/metrics/open-interest/#access) Access ---------------------------------------------------------------------- [Restricted Access](https://academy.santiment.net/metrics/details/access#restricted-access) * * * [](https://academy.santiment.net/metrics/open-interest/#measuring-unit) Measuring Unit -------------------------------------------------------------------------------------- Dollars * * * [](https://academy.santiment.net/metrics/open-interest/#data-type) Data Type ---------------------------------------------------------------------------- [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/open-interest/#frequency) Frequency ---------------------------------------------------------------------------- [Five-minute Intervals](https://academy.santiment.net/metrics/details/frequency#five-minute-freqency) * * * [](https://academy.santiment.net/metrics/open-interest/#latency) Latency ------------------------------------------------------------------------ [On-Chain Latency](https://academy.santiment.net/metrics/details/latency#funding-rates-latency) * * * [](https://academy.santiment.net/metrics/open-interest/#available-assets) Available Assets ------------------------------------------------------------------------------------------ * Open interest per exchange is available for [these assets](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22exchange_open_interest%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) * Open interest per settlement currency is available for [these assets](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22open_interest_per_settlement_currency%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) * Total open interest is available for [these assets](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22total_open_interest%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) * * * [](https://academy.santiment.net/metrics/open-interest/#available-exchanges) Available Exchanges ------------------------------------------------------------------------------------------------ `Binance`, `Bitfinex`, `Bitget`, `Bitmex`, `Btcex`, `Bybit`, `Crosstower`, `Cryptodotcom`, `Deribit`, `Kraken`, `Okex` * * * [](https://academy.santiment.net/metrics/open-interest/#sanapi) SanAPI ---------------------------------------------------------------------- * Open interest per exchange is available under the `exchange_open_interest` name. * Open interest per settlement currency is available under the `open_interest_per_settlement_currency` name. * Total open interest is available under the `total_open_interest` name. 1 2 3 4 5 6 7 8 9 10 11 12 13 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22exchange_open_interest%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20selector%3A%20%7B%0A%20%20%20%20%20%20%20%20slug%3A%20%22ethereum%22%0A%20%20%20%20%20%20%20%20owner%3A%20%22binance%22%0A%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20from%3A%20%222023-11-27T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222023-11-28T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%225m%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** * * * 1 2 3 4 5 6 7 8 9 10 11 12 13 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22open_interest_per_settlement_currency%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20selector%3A%20%7B%0A%20%20%20%20%20%20%20%20slug%3A%20%22ethereum%22%0A%20%20%20%20%20%20%20%20owner%3A%20%22USDT%22%0A%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20from%3A%20%222023-11-27T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222023-11-28T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%225m%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** * * * 1 2 3 4 5 6 7 8 9 10 11 12 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22total_open_interest%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20selector%3A%20%7B%0A%20%20%20%20%20%20%20%20slug%3A%20%22ethereum%22%0A%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20from%3A%20%222023-11-27T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222023-11-28T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%225m%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Updated 5 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # 404: Not found Looks like you got lost ======================= The page you're looking for is missing or your link is incorrect. [Back to home page](https://academy.santiment.net/) --- # Bitfinex Derivatives | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/bitfinex-derivatives/#bitfinex-derivatives) Bitfinex Derivatives ========================================================================================================= [Bitfinex](https://www.bitfinex.com/) is a digital asset trading platform offering state-of-the-art services for digital currency traders and global liquidity providers. * [Bitfinex Perpetual Contract Funding Rate](https://academy.santiment.net/metrics/bitfinex-derivatives/bitfinex-perpetual-funding-rate/) Updated 1 year ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # NFT Collection Holders Balance | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/nft-collection-holders-balance/#nft-collection-holders-balance) NFT Collection Holders Balance ======================================================================================================================================= [](https://academy.santiment.net/metrics/nft-collection-holders-balance/#definition) Definition ----------------------------------------------------------------------------------------------- This metric represents average balance of collection holders (e.g. average balance of `bored apes` holders is $10M). Balance of holders is calculated based on their ownership of NFTs (sum of values (in eth and usd) of all NFTs they have). [](https://academy.santiment.net/metrics/nft-collection-holders-balance/#access) Access --------------------------------------------------------------------------------------- [Restricted Access](https://academy.santiment.net/metrics/details/access#restricted-access) . * * * [](https://academy.santiment.net/metrics/nft-collection-holders-balance/#measuring-unit) Measuring Unit ------------------------------------------------------------------------------------------------------- Amount in USD * * * [](https://academy.santiment.net/metrics/nft-collection-holders-balance/#data-type) Data Type --------------------------------------------------------------------------------------------- [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/nft-collection-holders-balance/#frequency) Frequency --------------------------------------------------------------------------------------------- [Daily Intervals](https://academy.santiment.net/metrics/details/frequency#daily-frequency) * * * [](https://academy.santiment.net/metrics/nft-collection-holders-balance/#latency) Latency ----------------------------------------------------------------------------------------- [On-Chain Latency](https://academy.santiment.net/metrics/details/latency#on-chain-latency) * * * [](https://academy.santiment.net/metrics/nft-collection-holders-balance/#available-assets) Available Assets ----------------------------------------------------------------------------------------------------------- `ethereum` * * * [](https://academy.santiment.net/metrics/nft-collection-holders-balance/#sanapi) SanAPI --------------------------------------------------------------------------------------- `nft_collection_holders_balance`: 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22nft_collection_holders_balance%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20selector%3A%20%7B%20address%3A%20%220xed5af388653567af2f388e6224dc7c4b3241c544%22%20%7D%0A%20%20%20%20%20%20from%3A%20%222022-05-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222022-05-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # NFT Market Volume/Count | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/nft-market-volume/#nft-market-volume-count) NFT Market Volume/Count ============================================================================================================ [](https://academy.santiment.net/metrics/nft-market-volume/#definition) Definition ---------------------------------------------------------------------------------- NFT Market Volume/Count is metric which calculates market count and the market volume in ETH for NFT collections. Assumption is that when the majority of the volume is buying NFTs, the market is in a euphoric state. On the other hand, when NFT owners accept many orders, the market is depressed. [](https://academy.santiment.net/metrics/nft-market-volume/#access) Access -------------------------------------------------------------------------- [Restricted Access](https://academy.santiment.net/metrics/details/access#restricted-access) . * * * [](https://academy.santiment.net/metrics/nft-market-volume/#measuring-unit) Measuring Unit ------------------------------------------------------------------------------------------ * Volume metric - amount in ETH * Count metric - amount of trades * * * [](https://academy.santiment.net/metrics/nft-market-volume/#data-type) Data Type -------------------------------------------------------------------------------- [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/nft-market-volume/#frequency) Frequency -------------------------------------------------------------------------------- * NFT collection: [Daily Intervals](https://academy.santiment.net/metrics/details/frequency#daily-frequency) * * * [](https://academy.santiment.net/metrics/nft-market-volume/#latency) Latency ---------------------------------------------------------------------------- [On-Chain Latency](https://academy.santiment.net/metrics/details/latency#on-chain-latency) * * * [](https://academy.santiment.net/metrics/nft-market-volume/#available-assets) Available Assets ---------------------------------------------------------------------------------------------- `ethereum` and `weth` * * * [](https://academy.santiment.net/metrics/nft-market-volume/#sanapi) SanAPI -------------------------------------------------------------------------- NFT collection buy/sell market volume (count) - `nft_market_volume` (`nft_market_count`): 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22nft_market_volume%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20selector%3A%20%7B%20address%3A%20%220xed5af388653567af2f388e6224dc7c4b3241c544%22%20%7D%0A%20%20%20%20%20%20from%3A%20%222022-05-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222022-05-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # dYdX Derivatives | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/dydx-derivatives/#dydx-derivatives) dYdX Derivatives ============================================================================================= [dYdX](https://dydx.exchange/) is a leading decentralized exchange that currently supports perpetual trading. dYdX runs on smart contracts on the Ethereum blockchain, and allows users to trade with no intermediaries. * [dYdX Perpetual Contract Funding Rate](https://academy.santiment.net/metrics/dydx-derivatives/dydx-perpetual-funding-rate/) Updated 1 year ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # FTX Derivatives | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/ftx-derivatives/#ftx-derivatives) FTX Derivatives ========================================================================================== FTX is a cryptocurrency exchange built by traders, for traders. FTX offers innovative products including industry-first derivatives, options, volatility products and leveraged tokens. We strive to develop a platform robust enough for professional trading firms and intuitive enough for first-time users. * [FTX Perpetual Contract Funding Rate](https://academy.santiment.net/metrics/ftx-derivatives/ftx-perpetual-funding-rate/) Updated 3 years ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Huobi Derivatives | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/huobi-derivatives/#huobi-derivatives) Huobi Derivatives ================================================================================================ [Huobi](https://huobi.com/) is a world-leading Bitcoin (BTC) exchange. They offer clients digital currency announcements including USDT, BTC, ETH, EOS, XPR, LTC, etc. They're more authoritative in Bitcoin price and markets than other exchanges. Huobi Trading Platform offers the most trading and investment information on digital assets. * [Huobi Perpetual Contract Funding Rate](https://academy.santiment.net/metrics/huobi-derivatives/huobi-perpetual-funding-rate/) Updated 1 year ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # NFT Collection Price | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/nft-collection-price/#nft-collection-price) NFT Collection Price ========================================================================================================= [](https://academy.santiment.net/metrics/nft-collection-price/#definition) Definition ------------------------------------------------------------------------------------- NFT Collection price is a set of metrics that represent prices and number of trades for NFT collections and tokens. Based on the collection address and interval, users can fetch data for minimum, maximum and average prices in ETH and USD for NFT collection with that address. Also, they can fetch number of trades for some NFT collection. Based on the collection address and token ID, users can fetch all the prices for that NFT token. [](https://academy.santiment.net/metrics/nft-collection-price/#access) Access ----------------------------------------------------------------------------- [Restricted Access](https://academy.santiment.net/metrics/details/access#restricted-access) . * * * [](https://academy.santiment.net/metrics/nft-collection-price/#measuring-unit) Measuring Unit --------------------------------------------------------------------------------------------- * Price metrics - amount USD and ETH * Trade count metrics - amount of trades * * * [](https://academy.santiment.net/metrics/nft-collection-price/#data-type) Data Type ----------------------------------------------------------------------------------- [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/nft-collection-price/#frequency) Frequency ----------------------------------------------------------------------------------- * NFT collection: [Daily Intervals](https://academy.santiment.net/metrics/details/frequency#daily-frequency) * NFT tokens: [Five-minute Intervals](https://academy.santiment.net/metrics/details/frequency#five-minute-frequency) * * * [](https://academy.santiment.net/metrics/nft-collection-price/#latency) Latency ------------------------------------------------------------------------------- [On-Chain Latency](https://academy.santiment.net/metrics/details/latency#on-chain-latency) * * * [](https://academy.santiment.net/metrics/nft-collection-price/#available-assets) Available Assets ------------------------------------------------------------------------------------------------- `ethereum` and `weth` * * * [](https://academy.santiment.net/metrics/nft-collection-price/#sanapi) SanAPI ----------------------------------------------------------------------------- The following metrics are available: * nft\_collection\_min\_price * nft\_collection\_max\_price * nft\_collection\_avg\_price * nft\_collection\_min\_price\_usd * nft\_collection\_max\_price\_usd * nft\_collection\_avg\_price\_usd * nft\_collection\_trades\_count 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22nft_collection_min_price%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20selector%3A%20%7B%20address%3A%20%220xed5af388653567af2f388e6224dc7c4b3241c544%22%20%7D%0A%20%20%20%20%20%20from%3A%20%222022-05-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222022-05-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** NFT collection trade count - `nft_collection_trades_count`: 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22nft_collection_trades_count%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20selector%3A%20%7B%20address%3A%20%220xed5af388653567af2f388e6224dc7c4b3241c544%22%20%7D%0A%20%20%20%20%20%20from%3A%20%222022-05-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222022-05-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Deribit Derivatives | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/deribit-derivatives/#deribit-derivatives) Deribit Derivatives ====================================================================================================== [Deribit](https://www.deribit.com/) is a derivatives platform for traders of all backgrounds and trading styles. * [Deribit Perpetual Contract Funding Rate](https://academy.santiment.net/metrics/deribit-derivatives/deribit-perpetual-funding-rate/) Updated 1 year ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # NFT Network Profit Loss | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/nft-network-profit-loss/#nft-network-profit-loss) NFT Network Profit Loss ================================================================================================================== [](https://academy.santiment.net/metrics/nft-network-profit-loss/#definition) Definition ---------------------------------------------------------------------------------------- NFT Network Profit/Loss computes the average profit or loss of all NFTs that change addresses. This metric represents the average profit or loss of each NFT collection that is being transacted on a given day. [](https://academy.santiment.net/metrics/nft-network-profit-loss/#access) Access -------------------------------------------------------------------------------- [Restricted Access](https://academy.santiment.net/metrics/details/access#restricted-access) . * * * [](https://academy.santiment.net/metrics/nft-network-profit-loss/#measuring-unit) Measuring Unit ------------------------------------------------------------------------------------------------ Amount in USD or ETH * * * [](https://academy.santiment.net/metrics/nft-network-profit-loss/#data-type) Data Type -------------------------------------------------------------------------------------- [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/nft-network-profit-loss/#frequency) Frequency -------------------------------------------------------------------------------------- * NFT network: [Five-minute Intervals](https://academy.santiment.net/metrics/details/frequency#five-minute-frequency) * NFT collection: [Daily Intervals](https://academy.santiment.net/metrics/details/frequency#daily-frequency) * * * [](https://academy.santiment.net/metrics/nft-network-profit-loss/#latency) Latency ---------------------------------------------------------------------------------- [On-Chain Latency](https://academy.santiment.net/metrics/details/latency#on-chain-latency) * * * [](https://academy.santiment.net/metrics/nft-network-profit-loss/#available-assets) Available Assets ---------------------------------------------------------------------------------------------------- `ethereum` * * * [](https://academy.santiment.net/metrics/nft-network-profit-loss/#sanapi) SanAPI -------------------------------------------------------------------------------- NFT Network Profit Loss - `nft_network_profit_loss<_usd>`: 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22nft_network_profit_loss%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22ethereum%22%0A%20%20%20%20%20%20from%3A%20%222022-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222022-01-10T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** NFT Collection Profit Loss - `nft_collection_profit_loss_usd`: 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22nft_collection_profit_loss_usd%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20selector%3A%20%7B%20address%3A%20%220xed5af388653567af2f388e6224dc7c4b3241c544%22%20%7D%0A%20%20%20%20%20%20from%3A%20%222022-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222022-01-10T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Supported Blockchains | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources * [Go to Sanapi](https://api.santiment.net/) [](https://academy.santiment.net/sanapi/supported-blockchains/#supported-blockchains) Supported Blockchains =========================================================================================================== When Santiment designates a blockchain as supported, it signifies that on-chain transactions (including events, receipts, and other pertinent data) are exported, and metrics are constructed based on these data. Please note that not all supported blockchains have metrics related to exchanges, labels, or miners. For more information on the types of metrics available for each blockchain, please check [here](https://api.santiment.net/graphiql?variables=&query=%7B%0A++getAvailableBlockchains+%7B%0A++++blockchain%0A++++slug%0A++++infrastructure%0A++++createdOn%0A++++hasLabelMetrics%0A++++hasMinersMetrics%0A++++hasExchangeMetrics%0A++++hasTopHoldersMetrics%0A++++hasPureOnchainMetrics%0A++++hasOnchainFinancialMetrics%0A++%7D%0A%7D%0A) . Price data may be available for blockchains not listed here. | Bitcoin | Ethereum | XRPL | | --- | --- | --- | | | | | | BNB Chain | Bitcoin Cash | Litecoin | | --- | --- | --- | | | | | | Cardano | Dogecoin | Polygon | | --- | --- | --- | | | | | | Avalanche | Optimism | Arbitrum | | --- | --- | --- | | | | | | ICP | | --- | | | Updated 2 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Binance Derivatives | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/binance-derivatives/#binance-derivatives) Binance Derivatives ====================================================================================================== [Binance](https://www.binance.com/) is a cryptocurrency exchange which is the largest exchange in the world in terms of daily trading volume of cryptocurrencies. The Binance Derivative metrics available are: * [Binance Perpetual Contract Funding Rate (USDT)](https://academy.santiment.net/metrics/binance-derivatives/usdt-binance-funding-rate/) * [Binance Perpetual Contract Funding Rate (BUSD)](https://academy.santiment.net/metrics/binance-derivatives/busd-binance-funding-rate/) * [Binance Perpetual Contracts Open Interest/Value (USDT)](https://academy.santiment.net/metrics/binance-derivatives/usdt-binance-perpetual-open-interest-value/) * [Binance Perpetual Contracts Open Interest/Value (BUSD)](https://academy.santiment.net/metrics/binance-derivatives/busd-binance-perpetual-open-interest-value/) Updated 1 year ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # NFT Trade Volume USD | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/nft-trade-volume-usd/#nft-trade-volume-usd) NFT Trade Volume USD ========================================================================================================= [](https://academy.santiment.net/metrics/nft-trade-volume-usd/#definition) Definition ------------------------------------------------------------------------------------- NFT volume is represented through several metrics: * **NFT trade volume USD** denotes the total value of transactions in US dollars involving non-fungible tokens (NFTs) within a specific marketplace (owner) during the measurement period. This metric is calculated based on the value of the base assets transferred for acquiring or trading NFTs. * **NFT whale trade volume USD** quantifies the total value of trades executed by significant investors, commonly referred to as "whales," within the NFT market, measured in US dollars. This metric highlights the impact of large-scale investors on the overall trading volume and market dynamics of NFTs. * **NFT retail trade volume USD** represents the total value of transactions conducted by individual retail investors, as opposed to institutional or large-scale investors, within the NFT market, measured in US dollars. It offers insight into the participation and spending behavior of individual, non-professional traders in the NFT ecosystem. [](https://academy.santiment.net/metrics/nft-trade-volume-usd/#access) Access ----------------------------------------------------------------------------- [Restricted Access](https://academy.santiment.net/metrics/details/access#restricted-access) . * * * [](https://academy.santiment.net/metrics/nft-trade-volume-usd/#measuring-unit) Measuring Unit --------------------------------------------------------------------------------------------- Amount of USD * * * [](https://academy.santiment.net/metrics/nft-trade-volume-usd/#data-type) Data Type ----------------------------------------------------------------------------------- [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/nft-trade-volume-usd/#frequency) Frequency ----------------------------------------------------------------------------------- [Daily Intervals](https://academy.santiment.net/metrics/details/frequency#daily-frequency) * * * [](https://academy.santiment.net/metrics/nft-trade-volume-usd/#latency) Latency ------------------------------------------------------------------------------- [On-Chain Latency](https://academy.santiment.net/metrics/details/latency#on-chain-latency) * * * [](https://academy.santiment.net/metrics/nft-trade-volume-usd/#available-assets) Available Assets ------------------------------------------------------------------------------------------------- * `nft_trade_volume_usd` : [available assets](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22nft_trade_volume_usd%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) * `nft_retail_trade_volume_usd`: [available assets](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22nft_retail_trade_volume_usd%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) * `nft_whale_trade_volume_usd`: [available assets](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22nft_whale_trade_volume_usd%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) * * * [](https://academy.santiment.net/metrics/nft-trade-volume-usd/#available-owners) Available Owners ------------------------------------------------------------------------------------------------- `blur` `cryptopunks` `foundation` `looksrare` `opensea` `rarible` `superrare` `x2y2` ⚠️ The Polygon chain has been deprecated as of October 28th 2024 and is no longer supported. [](https://academy.santiment.net/metrics/nft-trade-volume-usd/#sanapi) SanAPI ----------------------------------------------------------------------------- The following metrics are available: * nft\_trade\_volume\_usd * nft\_retail\_trade\_volume\_usd * nft\_whale\_trade\_volume\_usd Example query: NFT trades volume on Opensea 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22nft_trade_volume_usd%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20selector%3A%20%7Bslug%3A%20%22weth%22%2C%20owner%3A%20%22opensea%22%7D%0A%20%20%20%20%20%20from%3A%20%222024-03-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222024-03-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Historical Balance | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/historical-balance/#historical-balance) Historical Balance =================================================================================================== [](https://academy.santiment.net/metrics/historical-balance/#definition) Definition ----------------------------------------------------------------------------------- Metric returns historical balance for a chain address / contract [Example of usage Historical Balance on Sanbase](https://app.santiment.net/labs/balance?address=0x876eabf441b2ee5b5b0554fd502a8e0600950cfa&assets[]=shiba-inu&from=2021-10-20T19%3A00%3A00.000Z&isLog=false&priceMetrics[]=shiba-inu&to=2022-04-21T18%3A59%3A59.999Z) * * * [](https://academy.santiment.net/metrics/historical-balance/#access) Access --------------------------------------------------------------------------- [Free Access](https://academy.santiment.net/metrics/details/access#free-access) * * * [](https://academy.santiment.net/metrics/historical-balance/#measuring-unit) Measuring Unit ------------------------------------------------------------------------------------------- Number of tokens * * * [](https://academy.santiment.net/metrics/historical-balance/#data-type) Data Type --------------------------------------------------------------------------------- [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/historical-balance/#frequency) Frequency --------------------------------------------------------------------------------- [Five-Minute Intervals](https://academy.santiment.net/metrics/details/frequency#five-minute-frequency) * * * [](https://academy.santiment.net/metrics/historical-balance/#api) API --------------------------------------------------------------------- Available under the `historicalBalance` name: 1 2 3 4 5 6 7 8 9 10 11 12 Query variables: 1 2 3 4 5 6 7 8 [**Run in explorer**](https://api.santiment.net/graphiql?query=query%20historicalBalance(%24from%3A%20DateTime!%2C%20%24to%3A%20DateTime!%2C%20%24address%3A%20String!%2C%20%24interval%3A%20interval!%2C%20%24slug%3A%20String!%2C%20%24infrastructure%3A%20String)%20%7B%0A%20%20historicalBalance(%0A%20%20%20%20address%3A%20%24address%0A%20%20%20%20interval%3A%20%24interval%0A%20%20%20%20from%3A%20%24from%0A%20%20%20%20to%3A%20%24to%0A%20%20%20%20selector%3A%20%7Bslug%3A%20%24slug%2C%20infrastructure%3A%20%24infrastructure%7D%0A%20%20)%20%7B%0A%20%20%20%20datetime%0A%20%20%20%20balance%0A%20%20%7D%0A%7D%0A&variables=%20%7B%0A%09%09%22address%22%3A%20%220xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d%22%2C%0A%09%09%22from%22%3A%20%222021-10-17T21%3A00%3A00.000Z%22%2C%0A%09%09%22interval%22%3A%20%224h%22%2C%0A%09%09%22metric%22%3A%20%22historicalBalance%22%2C%0A%09%09%22slug%22%3A%20%22weth%22%2C%0A%09%09%22to%22%3A%20%222022-04-18T20%3A59%3A59.999Z%22%0A%09%7D) Updated 3 years ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # NFT Trades Count | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/nft-trades-count/#nft-trades-count) NFT Trades Count ============================================================================================= [](https://academy.santiment.net/metrics/nft-trades-count/#definition) Definition --------------------------------------------------------------------------------- NFT trades count is represented through the following metrics: * **NFT trades count** refers to the total number of trades involving non-fungible tokens (NFTs) within a specific marketplace (owner) during a given period. * **NFT whale trades count** represents the count of trades conducted by significant investors, often referred to as "whales," within the NFT market. These traders typically possess substantial holdings and can significantly influence market trends due to the scale of their transactions. * **NFT retail trades count** represents the total number of trades executed by individual retail investors, as opposed to institutional or large-scale investors, within the NFT market. It provides insights into the level of participation and trading activity among non-professional traders in the NFT ecosystem. [](https://academy.santiment.net/metrics/nft-trades-count/#access) Access ------------------------------------------------------------------------- [Restricted Access](https://academy.santiment.net/metrics/details/access#restricted-access) . * * * [](https://academy.santiment.net/metrics/nft-trades-count/#measuring-unit) Measuring Unit ----------------------------------------------------------------------------------------- Amount of trades * * * [](https://academy.santiment.net/metrics/nft-trades-count/#data-type) Data Type ------------------------------------------------------------------------------- [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/nft-trades-count/#frequency) Frequency ------------------------------------------------------------------------------- [Daily Intervals](https://academy.santiment.net/metrics/details/frequency#daily-frequency) * * * [](https://academy.santiment.net/metrics/nft-trades-count/#latency) Latency --------------------------------------------------------------------------- [On-Chain Latency](https://academy.santiment.net/metrics/details/latency#on-chain-latency) * * * [](https://academy.santiment.net/metrics/nft-trades-count/#available-assets) Available Assets --------------------------------------------------------------------------------------------- * `nft_trades_count` : [available assets](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22nft_trades_count%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) * `nft_whale_trades_count` : [available assets](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22nft_whale_trades_count%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) * `nft_retail_trades_count` : [available assets](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22nft_retail_trades_count%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) * * * [](https://academy.santiment.net/metrics/nft-trades-count/#available-owners) Available Owners --------------------------------------------------------------------------------------------- `blur` `cryptopunks` `foundation` `looksrare` `opensea` `rarible` `superrare` `x2y2` ⚠️ The Polygon chain has been deprecated as of October 28th 2024 and is no longer supported. [](https://academy.santiment.net/metrics/nft-trades-count/#sanapi) SanAPI ------------------------------------------------------------------------- The following metrics are available: * nft\_trades\_count * nft\_whale\_trades\_count * nft\_retail\_trades\_count Example query: Amount of NFT trades on Opensea 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22nft_trades_count%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20selector%3A%20%7Bslug%3A%20%22ethereum%22%2C%20owner%3A%20%22opensea%22%7D%0A%20%20%20%20%20%20from%3A%20%222024-03-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222024-03-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # BitMEX Derivatives | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/bitmex-derivatives/#bitmex-derivatives) BitMEX Derivatives =================================================================================================== [BitMEX](https://www.bitmex.com/) is a P2P crypto-products trading platform. Metrics build on top of BitMEX trading contracts. * [BitMEX Perpetual Contract Funding Rate](https://academy.santiment.net/metrics/bitmex-derivatives/perpetual-contract-funding-rate/) * [BitMEX Perpetual Contract Price](https://academy.santiment.net/metrics/bitmex-derivatives/perpetual-contract-price/) * [BitMEX Price Index](https://academy.santiment.net/metrics/bitmex-derivatives/price-index/) * [BitMEX Perpetual Contract Basis](https://academy.santiment.net/metrics/bitmex-derivatives/perpetual-contract-basis/) * [BitMEX Perpetual Contracts Open Interest/Value](https://academy.santiment.net/metrics/bitmex-derivatives/perpetual-contracts-open-interest-value/) Updated 1 year ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Labelled Historical Balance | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/labelled-historical-balance/#labelled-historical-balance) Labelled Historical Balance ============================================================================================================================== [](https://academy.santiment.net/metrics/labelled-historical-balance/#definition) Definition -------------------------------------------------------------------------------------------- `labelled_historical_balance` shows a historical balance for a provided [label FQN](https://academy.santiment.net/labels/label-fqn/) . I.e. it shows a total combined balance for all addresses labelled with a given label FQN. For instance, all centralized exchange addresses or all miner addresses. `labelled_historical_balance_changes` shows a change in the historical balance. You can find available labels along with [label FQNs](https://academy.santiment.net/labels/label-fqn/) at [labels academy section](https://academy.santiment.net/labels/#domains) . Here are some label FQN examples: * `santiment/centralized_exchange:v1` * `santiment/fund:v1` * `santiment/miner:v1` * `santiment/owner->binance:v1` * `santiment/whale_usd_balance(ethereum):v1` * * * [](https://academy.santiment.net/metrics/labelled-historical-balance/#access) Access ------------------------------------------------------------------------------------ [Restricted Access](https://academy.santiment.net/metrics/details/access#restricted-access) * * * [](https://academy.santiment.net/metrics/labelled-historical-balance/#measuring-unit) Measuring Unit ---------------------------------------------------------------------------------------------------- Number of tokens * * * [](https://academy.santiment.net/metrics/labelled-historical-balance/#data-type) Data Type ------------------------------------------------------------------------------------------ [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/labelled-historical-balance/#frequency) Frequency ------------------------------------------------------------------------------------------ [Five-Minute Intervals](https://academy.santiment.net/metrics/details/frequency#five-minute-frequency) * * * [](https://academy.santiment.net/metrics/labelled-historical-balance/#available-assets) Available Assets -------------------------------------------------------------------------------------------------------- Available for [these assets](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22labelled_historical_balance%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) * * * [](https://academy.santiment.net/metrics/labelled-historical-balance/#api) API ------------------------------------------------------------------------------ Available under `labelled_historical_balance`. The query below fetches a total `ethereum` balance of all `centralized_exchange` addresses. 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22labelled_historical_balance%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20from%3A%20%222024-03-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222024-03-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20%20%20selector%3A%20%7BlabelFqn%3A%20%22santiment%2Fcentralized_exchange%3Av1%22%2C%20slug%3A%20%22ethereum%22%7D%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** `labelled_historical_balance_changes` 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22labelled_historical_balance_changes%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20from%3A%20%222024-03-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222024-03-07T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20%20%20selector%3A%20%7BlabelFqn%3A%20%22santiment%2Fcentralized_exchange%3Av1%22%2C%20slug%3A%20%22ethereum%22%7D%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Interacting Address Count | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/contract-interacting-address-count/#interacting-address-count) Interacting Address Count ================================================================================================================================= [](https://academy.santiment.net/metrics/contract-interacting-address-count/#definition) Definition --------------------------------------------------------------------------------------------------- Get interacting address count for a chain address / contract ![Example of usage **interacting address count** on Sanbase](https://academy.santiment.net/metrics/contract-interacting-address-count/conract_interacting_address.png) * * * [](https://academy.santiment.net/metrics/contract-interacting-address-count/#access) Access ------------------------------------------------------------------------------------------- [Free Access](https://academy.santiment.net/metrics/details/access#free-access) * * * [](https://academy.santiment.net/metrics/contract-interacting-address-count/#api) API ------------------------------------------------------------------------------------- Available under the `contract_interacting_addresses_count` name: 1 2 3 4 5 6 7 8 9 10 11 12 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22contract_interacting_addresses_count%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20selector%3A%20%7B%0A%20%20%20%20%20%20%20%20contractAddress%3A%20%220x857086e5e3dc7bbc98edb1639b4ffd96a667d75a%22%0A%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20from%3A%20%22utc_now-90d%22%0A%20%20%20%20%20%20to%3A%20%22utc_now-60d%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Latest Transactions | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/latest-transactions/#latest-transactions) Latest Transactions ====================================================================================================== [](https://academy.santiment.net/metrics/latest-transactions/#definition) Definition ------------------------------------------------------------------------------------ Get latest transactions for a chain address [Example of usage **latest transactions** on Sanbase](https://app.santiment.net/labs/balance?address=0x876eabf441b2ee5b5b0554fd502a8e0600950cfa&assets[]=shiba-inu&from=2021-10-20T19%3A00%3A00.000Z&isLog=false&priceMetrics[]=shiba-inu&to=2022-04-21T18%3A59%3A59.999Z) * * * [](https://academy.santiment.net/metrics/latest-transactions/#access) Access ---------------------------------------------------------------------------- [Free Access](https://academy.santiment.net/metrics/details/access#free-access) * * * [](https://academy.santiment.net/metrics/latest-transactions/#api) API ---------------------------------------------------------------------- Available under the `recentTransactions` name: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 Query variables: 1 2 3 4 5 6 [**Run in explorer**](https://api.santiment.net/graphiql?query=query%20recentTransactions(%24address%3A%20String!%2C%20%24page%3A%20Int%2C%20%24pageSize%3A%20Int%20%3D%2020)%20%7B%0A%20%20transactions%3A%20recentTransactions(%0A%20%20%20%20address%3A%20%24address%0A%20%20%20%20page%3A%20%24page%0A%20%20%20%20pageSize%3A%20%24pageSize%0A%20%20%20%20type%3A%20ERC20%0A%20%20%20%20onlySender%3A%20false%0A%20%20)%20%7B%0A%20%20%20%20datetime%0A%20%20%20%20fromAddress%20%7B%0A%20%20%20%20%20%20address%0A%20%20%20%20%20%20labels%20%7B%0A%20%20%20%20%20%20%20%20name%0A%20%20%20%20%20%20%20%20origin%0A%20%20%20%20%20%20%7D%0A%20%20%20%20%7D%0A%20%20%20%20toAddress%20%7B%0A%20%20%20%20%20%20address%0A%20%20%20%20%20%20labels%20%7B%0A%20%20%20%20%20%20%20%20name%0A%20%20%20%20%20%20%20%20origin%0A%20%20%20%20%20%20%7D%0A%20%20%20%20%7D%0A%20%20%20%20trxValue%0A%20%20%20%20trxHash%0A%20%20%20%20project%20%7B%0A%20%20%20%20%20%20id%0A%20%20%20%20%20%20ticker%0A%20%20%20%20%20%20logoUrl%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A&variables=%7B%0A%09%09%22address%22%3A%20%220xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d%22%2C%0A%09%09%22infrastructure%22%3A%20%22ETH%22%2C%0A%09%09%22page%22%3A%201%2C%0A%09%09%22pageSize%22%3A%2020%0A%09%7D) Updated 3 years ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Transactions Count | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/contract-transactions-count/#transactions-count) Transactions Count ============================================================================================================ [](https://academy.santiment.net/metrics/contract-transactions-count/#definition) Definition -------------------------------------------------------------------------------------------- Get transactions count for a chain address / contract ![Example of usage **transactions count** on Sanbase](https://academy.santiment.net/metrics/contract-transactions-count/conract_interacting_address.png) * * * [](https://academy.santiment.net/metrics/contract-transactions-count/#access) Access ------------------------------------------------------------------------------------ [Free Access](https://academy.santiment.net/metrics/details/access#free-access) * * * [](https://academy.santiment.net/metrics/contract-transactions-count/#api) API ------------------------------------------------------------------------------ Available under the `contract_transactions_count` name: 1 2 3 4 5 6 7 8 9 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22contract_transactions_count%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20selector%3A%20%7BcontractAddress%3A%20%220x857086e5e3dc7bbc98edb1639b4ffd96a667d75a%22%7D%0A%20%20%20%20%20%20from%3A%20%22utc_now-90d%22%0A%20%20%20%20%20%20to%3A%20%22utc_now-60d%22%2C%0A%20%20%20%20%20%20interval%3A%20%221d%22)%0A%20%20%7D%0A%7D) ** Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # 404: Not found Looks like you got lost ======================= The page you're looking for is missing or your link is incorrect. [Back to home page](https://academy.santiment.net/) --- # 404: Not found Looks like you got lost ======================= The page you're looking for is missing or your link is incorrect. [Back to home page](https://academy.santiment.net/) --- # 404: Not found Looks like you got lost ======================= The page you're looking for is missing or your link is incorrect. [Back to home page](https://academy.santiment.net/) --- # 404: Not found Looks like you got lost ======================= The page you're looking for is missing or your link is incorrect. [Back to home page](https://academy.santiment.net/) --- # 404: Not found Looks like you got lost ======================= The page you're looking for is missing or your link is incorrect. [Back to home page](https://academy.santiment.net/) --- # 404: Not found Looks like you got lost ======================= The page you're looking for is missing or your link is incorrect. [Back to home page](https://academy.santiment.net/) --- # DEX volume | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/xrpl-metrics/dex-volume/#dex-volume) DEX volume ======================================================================================== [](https://academy.santiment.net/metrics/xrpl-metrics/dex-volume/#description) Description ------------------------------------------------------------------------------------------ DEX volume tracks the exchange volume at the XRPL Decentralized Exchange. The volume includes all trades where at least one of the assets in the pair have recently traded against XRP. `dex_volume_in_usd_5m` measures CLOB volume in USD equivalent. `dex_volume_in_xrp_5m` measures CLOB volume in XRP coins. `dex_amm_volume_in_xrp_5min` measures AMM volume in XRP coins. `dex_amm_volume_in_usd_5min` measures AMM volume in USD coins. All four metrics are available only for the `xrp` asset. * * * [](https://academy.santiment.net/metrics/xrpl-metrics/dex-volume/#access) Access -------------------------------------------------------------------------------- [Free Access](https://academy.santiment.net/metrics/details/access#free-access) * * * [](https://academy.santiment.net/metrics/xrpl-metrics/dex-volume/#measuring-unit) Measuring Unit ------------------------------------------------------------------------------------------------ XRP tokens and USD * * * [](https://academy.santiment.net/metrics/xrpl-metrics/dex-volume/#data-type) Data Type -------------------------------------------------------------------------------------- [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/xrpl-metrics/dex-volume/#frequency) Frequency -------------------------------------------------------------------------------------- [Five-Minute Intervals](https://academy.santiment.net/metrics/details/frequency#five-minute-frequency) * * * [](https://academy.santiment.net/metrics/xrpl-metrics/dex-volume/#latency) Latency ---------------------------------------------------------------------------------- [On-Chain Latency](https://academy.santiment.net/metrics/details/latency#on-chain-latency) * * * [](https://academy.santiment.net/metrics/xrpl-metrics/dex-volume/#available-assets) Available Assets ---------------------------------------------------------------------------------------------------- Available for [xrp only](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22dex_volume_in_usd_5m%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) * * * ### [](https://academy.santiment.net/metrics/xrpl-metrics/dex-volume/#sanapi) SanAPI Available under the `dex_volume_in_usd_5m`, `dex_volume_in_xrp_5m`, `dex_amm_volume_in_xrp_5min` and `dex_amm_volume_in_usd_5min` names. 1 2 3 4 5 6 7 8 9 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22dex_volume_in_usd_5m%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22xrp%22%0A%20%20%20%20%20%20from%3A%20%222024-07-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222024-07-07T00%3A00%3A00Z%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Number of accounts | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/xrpl-metrics/number-of-accounts/#number-of-accounts) Number of accounts ================================================================================================================ [](https://academy.santiment.net/metrics/xrpl-metrics/number-of-accounts/#description) Description -------------------------------------------------------------------------------------------------- * **Total number of accounts** - Counts all addresses which hold XRP token across time. It is computed by summing all holder distribution metrics. Holder distribution metrics are computed on top of balances table. * **Number of active accounts** - Tracks the number of addresses which have either sent or received XRP token in a previous 30, 60 or 90 days. It is computed on top of balances table. * **Number of accounts with minimum reserves** - computed by summing all holder distribution metrics except the following groups: * 0-0.001 * 0.001-0.01 * 0.01-0.1 * 0.1-1 * 1-10 * * * [](https://academy.santiment.net/metrics/xrpl-metrics/number-of-accounts/#access) Access ---------------------------------------------------------------------------------------- [Free Access](https://academy.santiment.net/metrics/details/access#free-access) * * * [](https://academy.santiment.net/metrics/xrpl-metrics/number-of-accounts/#measuring-unit) Measuring Unit -------------------------------------------------------------------------------------------------------- Amount of accounts * * * [](https://academy.santiment.net/metrics/xrpl-metrics/number-of-accounts/#data-type) Data Type ---------------------------------------------------------------------------------------------- [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/xrpl-metrics/number-of-accounts/#frequency) Frequency ---------------------------------------------------------------------------------------------- * **Total number of accounts** - [Daily frequency](https://academy.santiment.net/metrics/details/frequency/#daily-frequency) * **Number of active accounts** - [Five-Minute Intervals](https://academy.santiment.net/metrics/details/frequency#five-minute-frequency) * **Number of accounts with minimum reserves** - [Daily frequency](https://academy.santiment.net/metrics/details/frequency/#daily-frequency) * * * [](https://academy.santiment.net/metrics/xrpl-metrics/number-of-accounts/#latency) Latency ------------------------------------------------------------------------------------------ [On-Chain Latency](https://academy.santiment.net/metrics/details/latency#on-chain-latency) * * * [](https://academy.santiment.net/metrics/xrpl-metrics/number-of-accounts/#available-assets) Available Assets ------------------------------------------------------------------------------------------------------------ Available for: * `holders_distribution_total` - [these assets](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric:%20%22holders_distribution_total%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) * `active_addresses_30d` - [these assets](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric:%20%22active_addresses_30d%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) * `active_addresses_60d` - [these assets](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22active_addresses_60d%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) * `active_addresses_90d` - [these assets](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22active_addresses_90d%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) * * * ### [](https://academy.santiment.net/metrics/xrpl-metrics/number-of-accounts/#sanapi) SanAPI Available under the `holders_distribution_total` name. 1 2 3 4 5 6 7 8 9 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22holders_distribution_total%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22xrp%22%0A%20%20%20%20%20%20from%3A%20%222020-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-01-07T00%3A00%3A00Z%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Available under the `active_addresses_30d` name. 1 2 3 4 5 6 7 8 9 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22active_addresses_30d%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22xrp%22%0A%20%20%20%20%20%20from%3A%20%222020-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-01-07T00%3A00%3A00Z%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Available under the `active_addresses_60d` name. 1 2 3 4 5 6 7 8 9 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22active_addresses_60d%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22xrp%22%0A%20%20%20%20%20%20from%3A%20%222020-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-01-07T00%3A00%3A00Z%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Available under the `active_addresses_90d` name. 1 2 3 4 5 6 7 8 9 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22active_addresses_90d%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22xrp%22%0A%20%20%20%20%20%20from%3A%20%222020-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-01-07T00%3A00%3A00Z%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Assets Issued Metrics | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/xrpl-metrics/assets-issued/#assets-issued-metrics) Assets Issued Metrics ================================================================================================================= [](https://academy.santiment.net/metrics/xrpl-metrics/assets-issued/#description) Description --------------------------------------------------------------------------------------------- We track the issued assets under two metrics: * **Total assets issued** - total number of issued assets through time * **Number of new assets issued** - tracks only the new assets issued per day We would count an asset as part of this metric only if the issuer has more than 100 active trustlines at the time the asset is issued. * * * [](https://academy.santiment.net/metrics/xrpl-metrics/assets-issued/#access) Access ----------------------------------------------------------------------------------- [Free Access](https://academy.santiment.net/metrics/details/access#free-access) * * * [](https://academy.santiment.net/metrics/xrpl-metrics/assets-issued/#measuring-unit) Measuring Unit --------------------------------------------------------------------------------------------------- Amount of assets * * * [](https://academy.santiment.net/metrics/xrpl-metrics/assets-issued/#data-type) Data Type ----------------------------------------------------------------------------------------- [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/xrpl-metrics/assets-issued/#frequency) Frequency ----------------------------------------------------------------------------------------- [Daily frequency](https://academy.santiment.net/metrics/details/frequency/#daily-frequency) * * * [](https://academy.santiment.net/metrics/xrpl-metrics/assets-issued/#latency) Latency ------------------------------------------------------------------------------------- [On-Chain Latency](https://academy.santiment.net/metrics/details/latency#on-chain-latency) * * * [](https://academy.santiment.net/metrics/xrpl-metrics/assets-issued/#available-assets) Available Assets ------------------------------------------------------------------------------------------------------- Available for: * `total_assets_issued` - [these assets](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22total_assets_issued%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) * `daily_assets_issued` - [these assets](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22daily_assets_issued%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) * * * ### [](https://academy.santiment.net/metrics/xrpl-metrics/assets-issued/#sanapi) SanAPI Available under the `total_assets_issued` name. 1 2 3 4 5 6 7 8 9 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22total_assets_issued%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22xrp%22%0A%20%20%20%20%20%20from%3A%20%222020-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-01-07T00%3A00%3A00Z%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Available under the `daily_assets_issued` name. 1 2 3 4 5 6 7 8 9 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22daily_assets_issued%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22xrp%22%0A%20%20%20%20%20%20from%3A%20%222020-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-01-07T00%3A00%3A00Z%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Trading and Transaction Volume | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/education-and-use-cases/trading-and-transaction-volume/#trading-and-transaction-volume) Trading and Transaction Volume ======================================================================================================================================================= ### [](https://academy.santiment.net/education-and-use-cases/trading-and-transaction-volume/#trading-volume) Trading Volume * Includes only transactions related to trading. Consists of data from decentralized exchanges (DEX) and centralized exchanges (CEX). ### [](https://academy.santiment.net/education-and-use-cases/trading-and-transaction-volume/#transaction-volume) Transaction Volume * Includes all movements of tokens on the blockchain * Covers transfers between wallets (e.g., for securing funds or managing investment portfolios) * Includes payments for goods and services (real-world utility of cryptocurrencies) * Includes interactions with smart contracts (DeFi activities such as staking, lending, and swapping tokens) ### [](https://academy.santiment.net/education-and-use-cases/trading-and-transaction-volume/#what-is-the-difference-between-trading-volume-and-transaction-volume) What is the difference between Trading Volume and Transaction Volume? In short, transaction volume represents all on-chain movements of a token, while trading volume represents only the trading-related transactions (on-chain and off-chain). ![](https://academy.santiment.net/education-and-use-cases/trading-and-transaction-volume/difference.png) The transaction volume metric is quite expansive and includes a variety of on-chain activities that go beyond just trading-related transactions. It captures transfers between wallets, which could be for reasons like securing funds or managing different investment portfolios. Additionally, it includes payments for goods and services, showcasing the real-world utility of cryptocurrencies. On top of these, the metric also encompasses interactions with smart contracts, which are pivotal in decentralized finance (DeFi) activities like staking, lending, and swapping tokens. Another difference to note is that transaction volume is purely on-chain data, while trading volume is combination of on-chain data (from DEXs) and off-chain data (which is self-reported from CEXs). **Both metrics are crucial but serve different analytical purposes:** transaction volume offers a peek into the actual use and movement of the currency within its network, while trading volume helps understand the market sentiment and liquidity. ### [](https://academy.santiment.net/education-and-use-cases/trading-and-transaction-volume/#how-to-interpret-volume-metrics) How to interpret Volume metrics Both volume metrics act in relatively similar ways, hence in the examples we will refer only to trading volume. An increase in trading volume is generally considered a precursor to a big price move. For example, if Bitcoin's trading volume dramatically increases without a corresponding price change, it might suggest that something significant is happening beneath the surface that hasn't yet affected the price. **Savvy traders might interpret this as an early warning signal of a potential price movement and adjust their strategies accordingly**, either by securing their current positions or preparing to capitalize on the anticipated movement. ![](https://academy.santiment.net/education-and-use-cases/trading-and-transaction-volume/bearish_bullish.png) When both the price of a token and the trading volume are moving in the same direction, it generally suggests a strong market consensus regarding the value of the token. If they're both increasing, this is often seen as a bullish sign, indicating strong buying interest and potentially sustainable price growth. **This scenario typically reflects a positive sentiment among investors, as they are actively participating and driving the price up with their trades.** Conversely, if both the price and trading volume are decreasing, it might indicate a bearish market sentiment. This suggests that selling pressure is high, and many holders are trying to offload their tokens, which can lead to a decrease in price. **This kind of alignment between price and volume can signal a consensus on value that is either very positive or very negative, depending on the direction.** ![](https://academy.santiment.net/education-and-use-cases/trading-and-transaction-volume/bearish_bullish_two_charts.png) ❗ Context is crucial, so we strongly suggest not to make trading decisions based solely on this metric. Use a combination of metrics that will help you make a more informed decision. ### [](https://academy.santiment.net/education-and-use-cases/trading-and-transaction-volume/#how-to-monitor-volume-metrics-with-sanbase) How to monitor Volume metrics with Sanbase Here is a ready-to-be-copied Layout with Trading and Transaction volume for your convenience: [link here](https://app.santiment.net/charts/YM8Zi2X6__sCl) ![](https://academy.santiment.net/education-and-use-cases/trading-and-transaction-volume/sanbase_chart.png) As soon as you have adjusted the Chart based on your preferences (time intervals, colors, etc.) you can save it as a new private Layout. Then, using the Master selector (the bigger one on the top) you can change the currently analysed token to another while your visual preferences and metrics remain the same. ![](https://academy.santiment.net/education-and-use-cases/trading-and-transaction-volume/selector.png) Or you can use the smaller selector to build on top of your chart and insert more metrics, even for multiple tokens at once. See what others in crypto can’t! ###### More technical documentation about the metrics can be found here * [Trading Volume in USD | Santiment Academy](https://academy.santiment.net/metrics/trading-volume/) * [Transaction Volume | Santiment Academy](https://academy.santiment.net/metrics/transaction-volume/) Updated 1 year ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Trustline Count Metrics | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/metrics/xrpl-metrics/trustline-count/#trustline-count-metrics) Trustline Count Metrics ======================================================================================================================= [](https://academy.santiment.net/metrics/xrpl-metrics/trustline-count/#description) Description ----------------------------------------------------------------------------------------------- We track two metrics related to trustline count: * **Total number of trustlines** - the total amount of active trustline through time. * **Net trustlines created** - change in number of active trustlines on a daily basis. * * * [](https://academy.santiment.net/metrics/xrpl-metrics/trustline-count/#access) Access ------------------------------------------------------------------------------------- [Free Access](https://academy.santiment.net/metrics/details/access#free-access) * * * [](https://academy.santiment.net/metrics/xrpl-metrics/trustline-count/#measuring-unit) Measuring Unit ----------------------------------------------------------------------------------------------------- Amount of trustlines * * * [](https://academy.santiment.net/metrics/xrpl-metrics/trustline-count/#data-type) Data Type ------------------------------------------------------------------------------------------- [Timeseries Data](https://academy.santiment.net/metrics/details/data-type#timeseries-data) * * * [](https://academy.santiment.net/metrics/xrpl-metrics/trustline-count/#frequency) Frequency ------------------------------------------------------------------------------------------- [Daily frequency](https://academy.santiment.net/metrics/details/frequency/#daily-frequency) * * * [](https://academy.santiment.net/metrics/xrpl-metrics/trustline-count/#latency) Latency --------------------------------------------------------------------------------------- [On-Chain Latency](https://academy.santiment.net/metrics/details/latency#on-chain-latency) * * * [](https://academy.santiment.net/metrics/xrpl-metrics/trustline-count/#available-assets) Available Assets --------------------------------------------------------------------------------------------------------- Available for: * `total_trustlines_count` - [these assets](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22total_trustlines_count%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) * `daily_trustlines_count_change` - [these assets](https://api.santiment.net/graphiql?variables=&query=%7B%0A%20%20getMetric(metric%3A%20%22daily_trustlines_count_change%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D%0A) * * * ### [](https://academy.santiment.net/metrics/xrpl-metrics/trustline-count/#sanapi) SanAPI Available under the `total_trustlines_count` name. 1 2 3 4 5 6 7 8 9 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22total_trustlines_count%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22xrp%22%0A%20%20%20%20%20%20from%3A%20%222020-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-01-07T00%3A00%3A00Z%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Available under the `daily_trustlines_count_change` name. 1 2 3 4 5 6 7 8 9 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22daily_trustlines_count_change%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22xrp%22%0A%20%20%20%20%20%20from%3A%20%222020-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-01-07T00%3A00%3A00Z%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Timing Market Volatility with Token Age Consumed | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/education-and-use-cases/timing-market-volatility-with-token-age-consumed/#timing-market-volatility-with-token-age-consumed) Timing Market Volatility with Token Age Consumed ============================================================================================================================================================================================================= [**Age Consumed**](https://academy.santiment.net/metrics/age-consumed/) or Token Age Consumed(TAC) is a reliable on-chain indicator that signals changes in market conditions. This metric assigns higher value to coins that have been held for a longer duration, compared to those recently acquired. Spikes in the TAC chart indicate the movement of tokens that have been dormant for a considerable period. The underlying assumption is that long-term holders and experienced traders usually make well-informed decisions. Therefore, it can be very beneficial to monitor when these parties begin to transfer their holdings. Such events can introduce volatility to the token’s short-term price action. The direction of this volatility, whether upward or downward, is unique to each situation. However, a spike in TAC is always a prompt to pay closer attention. Consider Bitcoin's TAC chart for the past six months; Almost every significant peak either signaled an impending correction (red), or occurred at the lowest point of the rally (green): ![](https://academy.santiment.net/education-and-use-cases/timing-market-volatility-with-token-age-consumed/image3.png) The same pattern can be observed with an altcoin. For instance, all pictured spikes in Bancor's TAC either correlated with increasing downward pressure (red) or signaled a rebound (green): ![](https://academy.santiment.net/education-and-use-cases/timing-market-volatility-with-token-age-consumed/image2.png) For further illustration, here's Aragon's TAC chart, which aligns closely with major changes in price action: ![](https://academy.santiment.net/education-and-use-cases/timing-market-volatility-with-token-age-consumed/image1.png) From a fundamental standpoint, spikes in Token Age Consumed are among the most reliable indicators of volatility in the crypto market. When a substantial amount of 'old money' starts to move, there's almost always a significant reason behind it. Being aware of these movements as they occur is crucial. Updated 2 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Assets Overview page | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources * [Go to Sanbase](https://app.santiment.net/) [](https://academy.santiment.net/sanbase/assets-page/#assets-overview-page) Assets Overview page ================================================================================================ [](https://academy.santiment.net/sanbase/assets-page/#structure) Structure -------------------------------------------------------------------------- This page is divided into two main sections: 1. **`Categories`** These are specific asset lists curated by the Santiment Team based on various aspects of the assets, such as `Stablecoins`. If you have any feedback or believe we might be missing tokens in any of these categories, please feel free to get in touch with us. 2. **`Watchlists`** These are similar to **Categories**, but the key difference is that they can be created by any user. ![](https://academy.santiment.net/sanbase/assets-page/assets.png) [](https://academy.santiment.net/sanbase/assets-page/#available-categories) Available Categories ------------------------------------------------------------------------------------------------ * **`All Assets`**: This category contains all tokens we track across various blockchains. * **`ERC 20`**: This category exclusively displays Ethereum-based ERC20 tokens. * **`Top 50 ERC20`**: This is a dynamic category that showcases the 50 most prominent ERC20 projects we track. * **`Stablecoins`**: This is a curated list of assets that are intended to maintain a fixed value. * **`Decentralized Exchanges`**: This category contains a curated list of decentralized exchanges and their utility tokens. * **`Centralized Exchanges`**: This category features a curated list of regular exchanges and their utility tokens. * **`Emerging Trending Assets`**: This is a dynamic category with assets that are currently trending in our [**_Emerging Trends_**](https://academy.santiment.net/sanbase/emerging-trends-page/) . Each category page contains a table similar to the one found on the **_Watchlist page_**, but the list of assets cannot be modified. [](https://academy.santiment.net/sanbase/assets-page/#how-to-create-a-watchlist) How to Create a Watchlist ---------------------------------------------------------------------------------------------------------- Updated 2 years ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Sanbase Insights | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources * [Go to Sanbase](https://app.santiment.net/) [](https://academy.santiment.net/sanbase/insights/#sanbase-insights) Sanbase Insights ===================================================================================== Begin your journey with **Sanbase Insights** here: [https://insights.santiment.net/](https://insights.santiment.net/) Sanbase Insights enables you to create your own note-like posts, share them with the Santiment community, or browse through existing insights. ![](https://academy.santiment.net/sanbase/insights/page.png) [](https://academy.santiment.net/sanbase/insights/#creating-a-new-insight) Creating a New Insight ------------------------------------------------------------------------------------------------- To begin creating a new insight, click on `New Insight` located in the profile dropdown menu. During the creation process, you will be asked to provide a title and body for your insight: ![](https://academy.santiment.net/sanbase/insights/new.png) Once you've filled in the title and body, Sanbase will automatically begin saving your progress as a draft. You also have the option to add tags to your insight. Each insight can have up to five tags, which should correspond to the tickers of the crypto assets your insight is discussing. ![](https://academy.santiment.net/sanbase/insights/prepublish.png) Additionally, you have the option to immediately share your insight with the public. [](https://academy.santiment.net/sanbase/insights/#publishing-or-deleting-draft-insights) Publishing or Deleting Draft Insights ------------------------------------------------------------------------------------------------------------------------------- Under the `My drafts` section, you will find insights that you have initiated but have not yet published for other users. These drafts can be deleted or edited. Once edited, they can be shared using the buttons located on the right side of the screen. Updated 2 years ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Keyboard Shortcuts | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources * [Go to Sanbase](https://app.santiment.net/) [](https://academy.santiment.net/sanbase/keyboard-shortcuts/#keyboard-shortcuts) Keyboard Shortcuts =================================================================================================== ### [](https://academy.santiment.net/sanbase/keyboard-shortcuts/#site-wide-shortcuts) Site Wide Shortcuts | Keyboard shortcut | Description | | --- | --- | | **/** | Select the Sanbase search bar | | **esc** | Close pop-up modals like alerts, and return to the parent element | [](https://academy.santiment.net/sanbase/keyboard-shortcuts/#charts) Charts --------------------------------------------------------------------------- ### [](https://academy.santiment.net/sanbase/keyboard-shortcuts/#general-shortcuts) General Shortcuts | Keyboard Shortcut | Description | | --- | --- | | **CMD(CTRL) + CLICK** | Hover over any metric on the left-side menu to add it to the first chart | | **CMD(CTRL) + SHIFT + CLICK** | Hover over any metric on the left-side menu to create a new chart with this metric selected | | **CMD(CTRL) + CLICK** | For Holder Distribution metrics - select only a single group of holders (deselect all others) | | \*\*CMD(CTRL) + \*\* | Collapse the tree of metrics (left-side menu) | | **CMD(CTRL) + M** | Open Mapview | | **CMD(CTRL) + L** | Open Chart layout explorer | | **CMD(CTRL) + S** | Save Chart layout | ### [](https://academy.santiment.net/sanbase/keyboard-shortcuts/#drawing-tools) Drawing Tools | Keyboard Shortcut | Description | | --- | --- | | **SHIFT + CLICK** | Draw straight lines on the chart by holding the "Shift" key while using the draw tool. | [](https://academy.santiment.net/sanbase/keyboard-shortcuts/#social-tool-shortcuts) Social Tool Shortcuts --------------------------------------------------------------------------------------------------------- | Keyboard Shortcut | Description | | --- | --- | | **CMD(CTRL) + CLICK** | Add trending word to compare input | [](https://academy.santiment.net/sanbase/keyboard-shortcuts/#tables) Tables --------------------------------------------------------------------------- | Keyboard Shortcut | Description | | --- | --- | | **SHIFT + CLICK** | Apply multiple sorting by holding the "Shift" key and clicking on the sortable column header. | Updated 2 years ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Alerts Page | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources * [Go to Sanbase](https://app.santiment.net/) [](https://academy.santiment.net/sanbase/alerts-page/#alerts-page) Alerts Page ============================================================================== To start using the **Alerts** feature on Sanbase, click here: [https://app.santiment.net/alerts](https://app.santiment.net/alerts) . [](https://academy.santiment.net/sanbase/alerts-page/#introduction) Introduction -------------------------------------------------------------------------------- [](https://academy.santiment.net/sanbase/alerts-page/#how-to-create-an-alert) How to Create an Alert ---------------------------------------------------------------------------------------------------- [](https://academy.santiment.net/sanbase/alerts-page/#use-cases-for-alerts) Use Cases for Alerts ------------------------------------------------------------------------------------------------ * [Example of Age Consumed Alert on Sanbase](https://academy.santiment.net/education-and-use-cases/alerts-on-sanbase/) * [Example of Social Trends/Trending Words Alert on Sanbase](https://academy.santiment.net/education-and-use-cases/social-trends-alerts/) * [Example of Whale Alert on Sanbase](https://academy.santiment.net/education-and-use-cases/whale-alert/) Updated 2 years ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Santiment Pro Report Samples | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/education-and-use-cases/santiment-pro-reports-samples/#santiment-pro-report-samples) Santiment Pro Report Samples ================================================================================================================================================== ### [](https://academy.santiment.net/education-and-use-cases/santiment-pro-reports-samples/#exploring-recent-btc-fundamentals-and-the-push-to-14k) Exploring Recent BTC Fundamentals and the Push to $14k _As the U.S. election approaches and the third wave of Covid-19 impacts the globe, we've decided to take a deep look at the recent activities of key Bitcoin stakeholders. We aim to assess the leading coin's on-chain and social potential following the $13k surge._ [Weekly Pro Report 2020-10-30.pdf](https://production-sanbase-images.s3.amazonaws.com/uploads/7cfcd1dc75a6e37a197961f19a042b95225b167828cab4857b70ddd3e7906281_1604134004866_Bitcoin%20Weekly%20Pro%20Report%20.pdf) ### [](https://academy.santiment.net/education-and-use-cases/santiment-pro-reports-samples/#trading-crypto-in-2020-do-token-fundamentals-really-matter) Trading Crypto in 2020: Do Token Fundamentals Really Matter? In this week's Pro report, we put our backtesting skills to the test to answer a simple yet crucial question: Does a portfolio of 'fundamentally sound' projects outperform the market benchmark (holding BTC)? [Weekly Pro Report 2020-10-16.pdf](https://production-sanbase-images.s3.amazonaws.com/uploads/5d555b3f0236814ca7d1bd7c744aed2ceca4db8aeec86e813f3fb07cd6f9dd4b_1602866186890_Weekly_report_2020-10-16.pdf) ### [](https://academy.santiment.net/education-and-use-cases/santiment-pro-reports-samples/#charting-the-unicorn-an-analysis-of-uni-s-on-chain-activity-sell-side-pressure-and-short-term-price-potential) Charting the Unicorn: An Analysis of $UNI's On-Chain Activity, Sell-Side Pressure, and Short-Term Price Potential _In just a week, Uniswap's new token, UNI, has provided a wealth of on-chain and social data for analysis. This data allows us to speculate and make informed predictions about the coin's short-term potential. In this week's Pro report, we delve into UNI's fundamentals during its initial 10 days. We also examine the on-chain activity that led to its price correction and discuss the potential future direction of this latest DeFi phenomenon._ [Weekly Pro Report 2020-09-25.pdf](https://production-sanbase-images.s3.amazonaws.com/uploads/22981475ffba0533410117afad88377a1d20aea58574bf0e2313a7a72420b2f6_1601049941906_UNI_report.pdf) ### [](https://academy.santiment.net/education-and-use-cases/santiment-pro-reports-samples/#eth-vs-erc-20-a-tale-of-two-market-caps) ETH vs ERC-20: A Tale Of Two Market Caps While the market capitalization of Ether has been extensively analyzed, the market cap of ERC-20 tokens often goes unnoticed. Until now, there has been a lack of comprehensive research and focus on the ERC-20 market as a whole. In this Santiment report, we take a closer look at the size of the ERC-20 market, its independent evolution over time, and its potential correlation with the parent market cap of Ethereum. [Weekly Pro Report 2020-09-04.pdf](https://production-sanbase-images.s3.amazonaws.com/uploads/3e75f3b0d37899c7f8266da53d24d3ee2e644f68d478efbc190b4ee6ce9f03b9_1599222238461_Weekly_Sanbase_PRO_market_report_3.pdf) Updated 2 years ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # How to Log in Sanbase | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources * [Go to Sanbase](https://app.santiment.net/) [](https://academy.santiment.net/sanbase/logging-into-sanbase/#how-to-log-in-sanbase) How to Log in Sanbase =========================================================================================================== There are two methods to log into Sanbase: through [**MetaMask**](https://metamask.io/) and via **email**. For convenience, both methods can and should be linked to the same account. [](https://academy.santiment.net/sanbase/logging-into-sanbase/#logging-in-to-sanbase-using-metamask) Logging in to Sanbase Using MetaMask ----------------------------------------------------------------------------------------------------------------------------------------- When you first visit Sanbase at [https://app.santiment.net](https://app.santiment.net/) , you can find the login option in the upper right corner of the screen. Simply hover your mouse over the last symbol to see it: ![](https://academy.santiment.net/sanbase/logging-into-sanbase/13_login.png) Click on `Log in`. This will present you with two options for logging in: using MetaMask or your email. For this guide, choose the MetaMask option. ![](https://academy.santiment.net/sanbase/logging-into-sanbase/25_login_choice.png) At this point, the MetaMask plugin will request permission to display your currently selected account's public data on the Sanbase website. Click `Connect` to allow the plugin and the website to communicate. ![](https://academy.santiment.net/sanbase/logging-into-sanbase/26_metamask_seperate.png) If you don't see this window, look for the MetaMask icon in the upper right corner of the screen. It should display a small message indicator: ![](https://academy.santiment.net/sanbase/logging-into-sanbase/14_mm.png) Clicking the MetaMask icon will bring the missing window to the front. Once MetaMask and Sanbase are connected, you should see the following screen: ![](https://academy.santiment.net/sanbase/logging-into-sanbase/28_metamask_connected.png) Click `Sign in with Metamask`. Another prompt will appear: ![](https://academy.santiment.net/sanbase/logging-into-sanbase/29_metamask_signin.png) Click `SIGN` to securely sign a message with your private key. This action verifies that you are the owner of the connected account. Congratulations, you are now logged into Sanbase. #### [](https://academy.santiment.net/sanbase/logging-into-sanbase/#adding-your-email) Adding Your Email To add your email, hover over the account icon located at the top right corner of the screen. This action will reveal additional options, including 'Account Settings'. ![](https://academy.santiment.net/sanbase/logging-into-sanbase/09_account_menu.png) In the 'Account Settings', enter your email address. Once this is done, you can log in using either MetaMask or your email. Regardless of the method you choose, you will be directed to the same account. For more information about the 'Account Settings' page, please refer to [this article](https://academy.santiment.net/sanbase/account-settings/) . [](https://academy.santiment.net/sanbase/logging-into-sanbase/#logging-in-via-email) Logging in via Email --------------------------------------------------------------------------------------------------------- Logging into Sanbase via email is a straightforward process. Simply enter your email address, and you will receive a link that directs you to a logged-in Sanbase session. If this is your first time logging in via email, you have the option to add an Ethereum (ETH) address. This can be done using MetaMask through the Account Settings page, as mentioned above. ### [](https://academy.santiment.net/sanbase/logging-into-sanbase/#purchasing-and-staking-san-tokens) Purchasing and Staking SAN Tokens You are now prepared to stake SAN tokens in order to avail discounts on your access plan. To learn how to stake SAN tokens, please refer to [this article](https://academy.santiment.net/san-tokens/connect-a-wallet-to-the-sanbase-account/) . If you need assistance on how to purchase SAN tokens initially, you can find guidance in [this article](https://academy.santiment.net/san-tokens/how-to-buy-san/) . Updated 2 years ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Account Settings | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources * [Go to Sanbase](https://app.santiment.net/) [](https://academy.santiment.net/sanbase/account-settings/#account-settings) Account Settings ============================================================================================= To customize your profile, please visit [Account Settings](https://app.santiment.net/account) on the Santiment website. [](https://academy.santiment.net/sanbase/account-settings/#overview) Overview ----------------------------------------------------------------------------- Depending on your method of logging into Sanbase, you may already see some information displayed in the Account Settings upon your first visit. ![](https://academy.santiment.net/sanbase/account-settings/primary.png) [](https://academy.santiment.net/sanbase/account-settings/#connections-and-notifications) Connections and Notifications ----------------------------------------------------------------------------------------------------------------------- If you initially logged in using your email, this section will display your email address, as shown in the screenshot below. You can use the `Connect with Metamask` option to associate an Ethereum address with your active account. If you logged in using MetaMask, your ETH address will be displayed, and you can now add an email address and username. ![](https://academy.santiment.net/sanbase/account-settings/connections.png) The Notifications section allows you to choose the channels through which you want to receive notifications from Sanbase, such as triggered signals. Once you've connected an account, you can activate it. Please note that currently, you need Telegram Desktop to connect a Telegram account. [](https://academy.santiment.net/sanbase/account-settings/#get-tokens) Get tokens --------------------------------------------------------------------------------- If your login wallet contains any SAN tokens, they will be displayed in the `Get tokens` section located in the center of the page. In case you wish to purchase SAN tokens, we provide links to exchanges that offer trading pairs with SAN. Alternatively, you can utilize the `Convert` button to leverage our Bancor integration. For more information on how to use this feature, please refer to [this article](https://academy.santiment.net/san-tokens/buy-san-tokens-using-bancor/) . ![](https://academy.santiment.net/sanbase/account-settings/tokens.png) [](https://academy.santiment.net/sanbase/account-settings/#creating-an-api-key) Creating an API Key --------------------------------------------------------------------------------------------------- At the bottom of the page, you'll find options to create new API keys and view existing ones. You also have the ability to revoke any previously created keys from this location. For more information on API usage, consider starting with [this article](https://academy.santiment.net/products-and-plans/create-an-api-key/) . ![](https://academy.santiment.net/sanbase/account-settings/api.png) [](https://academy.santiment.net/sanbase/account-settings/#subscription) Subscription ------------------------------------------------------------------------------------- From this section, you can upgrade your current plan, modify your billing cycle, or cancel your subscription as needed. ![](https://academy.santiment.net/sanbase/account-settings/subscriptions.png) Updated 2 years ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # 404: Not found Looks like you got lost ======================= The page you're looking for is missing or your link is incorrect. [Back to home page](https://academy.santiment.net/) --- # 404: Not found Looks like you got lost ======================= The page you're looking for is missing or your link is incorrect. [Back to home page](https://academy.santiment.net/) --- # Sanbase Plans | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/products-and-plans/sanbase-plans/#sanbase-plans) Sanbase Plans =============================================================================================== [](https://academy.santiment.net/products-and-plans/sanbase-plans/#overview) Overview ------------------------------------------------------------------------------------- Sanbase Plans provide access to various metrics through the [Sanbase website](https://app.santiment.net/) . [](https://academy.santiment.net/products-and-plans/sanbase-plans/#free-plan) Free Plan --------------------------------------------------------------------------------------- ### [](https://academy.santiment.net/products-and-plans/sanbase-plans/#sanbase-access) Sanbase access: * Full access to free metrics * Partial access to restricted metrics on the Sanbase website: * 2 years of historical data * Last 30 days of data are cut-off * Allowed number of alerts: 3 * Limited access to insights ### [](https://academy.santiment.net/products-and-plans/sanbase-plans/#api-access) API access: * Full access to free metrics * Partial access to restricted metrics via Graphql API: * 1 year of historical data * Last 30 days of data are cut-off * Rate limits: * 1000 API calls per month * 500 API calls per hour * 100 API calls per minute * Detailed metrics access restrictions can be found [here](https://api.santiment.net/graphiql?query=%7B%0A%20%20getAccessRestrictions(plan%3A%20FREE%2C%20product%3A%20SANBASE)%20%7B%0A%20%20%20%20name%0A%20%20%20%20type%0A%20%20%20%20isAccessible%0A%20%20%20%20isRestricted%0A%20%20%20%20restrictedFrom%0A%20%20%20%20restrictedTo%0A%20%20%7D%0A%7D%0A) ### [](https://academy.santiment.net/products-and-plans/sanbase-plans/#santiment-queries-access) Santiment Queries access: * Credits: 500 credits per month * Rate limits: * 500 queries per day * 200 queries per hour * 20 queries per minute [](https://academy.santiment.net/products-and-plans/sanbase-plans/#pro-plan) Pro Plan ------------------------------------------------------------------------------------- The Pro Plan includes everything in the Free Plan, plus: ### [](https://academy.santiment.net/products-and-plans/sanbase-plans/#sanbase-access) Sanbase access: * Full access to all metrics on the Sanbase website * Allowed number of alerts: 20 * Full access to PRO insights * Full access to [Google Sheets plugin](https://sheets.santiment.net/) ### [](https://academy.santiment.net/products-and-plans/sanbase-plans/#api-access) API access: * Partial access to restricted metrics via Graphql API: * 1 year of historical data * The last 30 days of data are cut-off * Rate limits: * 5000 API calls per month * 1000 API calls per hour * 100 API calls per minute * Detailed metrics access restrictions can be found [here](https://api.santiment.net/graphiql?query=%7B%0A%20%20getAccessRestrictions(plan%3A%20PRO%2C%20product%3A%20SANBASE)%20%7B%0A%20%20%20%20name%0A%20%20%20%20type%0A%20%20%20%20isAccessible%0A%20%20%20%20isRestricted%0A%20%20%20%20restrictedFrom%0A%20%20%20%20restrictedTo%0A%20%20%7D%0A%7D%0A) ### [](https://academy.santiment.net/products-and-plans/sanbase-plans/#santiment-queries-access) Santiment Queries access: * Credits: 10,000 credits per month * Rate limits: * 5000 queries per day * 1000 queries per hour * 50 queries per minute [](https://academy.santiment.net/products-and-plans/sanbase-plans/#max-plan) Max Plan ------------------------------------------------------------------------------------- The Max Plan includes everything in the Pro Plan, plus: ### [](https://academy.santiment.net/products-and-plans/sanbase-plans/#sanbase-access) Sanbase access: * Allowed number of alerts: 50 ### [](https://academy.santiment.net/products-and-plans/sanbase-plans/#api-access) API access: * Partial access to restricted metrics via the Graphql API: * 2 years of historical data * No realtime restriction * Rate limits: * 80K API calls per month * 4K API calls per hour * 100 API calls per minute ### [](https://academy.santiment.net/products-and-plans/sanbase-plans/#santiment-queries-access) Santiment Queries access: * Credits: 20,000 credits per month * Rate limits: * 10K queries per day * 2K queries per hour * 50 queries per minute Updated 1 year ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Santiment API Plans | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/products-and-plans/sanapi-plans/#santiment-api-plans) Santiment API Plans ========================================================================================================== [](https://academy.santiment.net/products-and-plans/sanapi-plans/#overview) Overview ------------------------------------------------------------------------------------ Santiment API Plans provide access to various metrics through the API endpoint: [https://api.santiment.net](https://api.santiment.net/) . Check the [pricing page](https://app.santiment.net/pricing) for the latest plans and pricing. [](https://academy.santiment.net/products-and-plans/sanapi-plans/#plans-for-individuals) Plans for Individuals -------------------------------------------------------------------------------------------------------------- | Feature | **Free Plan** | **Sanbase Pro Plan** | **Sanbase Max Plan** | | --- | --- | --- | --- | | **API Access** | | | | | Free Metrics | Full access | Full access | Full access | | Restricted Metrics | Partial access:
• 1 years of historical data
• 30 days lag | Partial access:
• 1 years of historical data
• 30 days lag | Partial access:
• 1 years of historical data
• No realtime restriction | | **Rate Limits** | | | | | Monthly Limit | 1,000 API calls | 5,000 API calls | 80,000 API calls | | Hourly Limit | 500 API calls | 1,000 API calls | 4,000 API calls | | Per Minute Limit | 100 API calls | 100 API calls | 100 API calls | | **Sanbase Access** | | | | | Free Metrics | Full access | Full access | Full access | | Restricted Metrics | Partial access:
• 1 years of historical data
• 30 days lag | Partial access:
• 1 years of historical data
• 30 days lag | Partial access:
• 1 years of historical data
• Realtime data | | Alerts Limit | 3 alerts allowed | 20 alerts allowed | 20 alerts allowed | | Insights Access | Limited access | Full access | Full access | [](https://academy.santiment.net/products-and-plans/sanapi-plans/#plans-for-business) Plans for Business -------------------------------------------------------------------------------------------------------- | Feature | **Business Pro Plan** | **Business Max Plan** | **Enterprise Plan** | | --- | --- | --- | --- | | **API Access** | | | | | Free Metrics | Full access | Full access | Full access | | Restricted Metrics | Partial access:
• 2 years of historical data
• No realtime restriction | Full access | Full access | | **Rate Limits** | | | | | Monthly Limit | 600,000 API calls | 1,200,000 API calls | custom | | Hourly Limit | 30,000 API calls | 60,000 API calls | custom | | Per Minute Limit | 600 API calls | 1,200 API calls | custom | | **Sanbase Access** | Full access to [Sanbase](https://app.santiment.net/) | Full access to [Sanbase](https://app.santiment.net/) | Full access to [Sanbase](https://app.santiment.net/) | Updated 2 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # How to Request New Projects and Tokens for Display on Sanbase | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources * [Go to Sanbase](https://app.santiment.net/) [](https://academy.santiment.net/sanbase/requesting-display-new-project/#how-to-request-new-projects-and-tokens-for-display-on-sanbase) How to Request New Projects and Tokens for Display on Sanbase ===================================================================================================================================================================================================== At Santiment, we work directly with Ethereum on-chain data, which allows us to display information about any token whose contract address is known. However, due to the high volume of tokens available, we have chosen to only make a curated and continuously expanding list of tokens searchable on Sanbase. To request the addition of a new token to Sanbase, or to add a known team wallet containing significant assets held by the team, please use the form provided below: Loading… While we appreciate token holders requesting their favorite tokens, we prioritize direct requests from a project's team, especially those that provide information about their funding. Updated 2 years ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Introducing Santiment Queries | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/santiment-queries/introduction/#introducing-santiment-queries) Introducing Santiment Queries ============================================================================================================================= [](https://academy.santiment.net/santiment-queries/introduction/#overview) Overview ----------------------------------------------------------------------------------- At Santiment, we make extensive use of [Clickhouse](https://clickhouse.com/) , a high-performance column-oriented database, to store on-chain, financial, social, and development activity data. In addition to storing data, Clickhouse is capable of performing complex calculations and aggregations on millions of rows of data, making it an ideal tool to power your research. Santiment Queries is an online web tool that provides access to a Clickhouse cluster containing our datasets. Basic SQL knowledge is required to use the tool. If you have no experience, you can follow brief Clickhouse Tutorial [here](https://clickhouse.com/docs/en/guides/writing-queries) or [here](https://clickhouse.com/docs/en/tutorial#3-analyze-the-data) to get started. [](https://academy.santiment.net/santiment-queries/introduction/#accessing-santiment-queries) Accessing Santiment Queries ------------------------------------------------------------------------------------------------------------------------- Santiment Queries can be found at [https://app.santiment.net/queries](https://app.santiment.net/queries) . Anonymous users can browse the public dashboards, while logged-in users can create both public and private dashboards. [](https://academy.santiment.net/santiment-queries/introduction/#exploration) Exploration ----------------------------------------------------------------------------------------- The [Exploration](https://academy.santiment.net/santiment-queries/exploration/) page guides users on how to explore the contents of the database, understand the available tables, and learn about their structure. [](https://academy.santiment.net/santiment-queries/introduction/#writing-your-first-sql-query) Writing Your First SQL Query --------------------------------------------------------------------------------------------------------------------------- The [Writing SQL Queries](https://academy.santiment.net/santiment-queries/writing-sql-queries/) page guides you through the process of writing your first SQL query. Updated 2 years ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Fetching Metrics | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources * [Go to Sanapi](https://api.santiment.net/) [](https://academy.santiment.net/sanapi/fetching-metrics/#fetching-metrics) Fetching Metrics ============================================================================================ * [Overview](https://academy.santiment.net/sanapi/fetching-metrics/#overview) * [Available Metrics](https://academy.santiment.net/sanapi/fetching-metrics/#available-metrics) * [Metrics Restrictions Per Plan](https://academy.santiment.net/sanapi/fetching-metrics/#metrics-restrictions-per-plan) * [Metrics Documentation](https://academy.santiment.net/sanapi/fetching-metrics/#metrics-documentation) * [Available Assets](https://academy.santiment.net/sanapi/fetching-metrics/#available-assets) * [Available Metrics Per Project](https://academy.santiment.net/sanapi/fetching-metrics/#available-metrics-per-project) * [Available Projects Per Metric](https://academy.santiment.net/sanapi/fetching-metrics/#available-projects-per-metric) * [Minimal Interval](https://academy.santiment.net/sanapi/fetching-metrics/#minimal-interval) * [Aggregation](https://academy.santiment.net/sanapi/fetching-metrics/#aggregation) * [Queryable Fields](https://academy.santiment.net/sanapi/fetching-metrics/#queryable-fields) * [timeseriesDataJson](https://academy.santiment.net/sanapi/fetching-metrics/#timeseriesdatajson) * [timeseriesDataPerSlugJson](https://academy.santiment.net/sanapi/fetching-metrics/#timeseriesdataperslugjson) * [aggregatedTimeseriesData](https://academy.santiment.net/sanapi/fetching-metrics/#aggregatedtimeseriesdata) * [histogramData](https://academy.santiment.net/sanapi/fetching-metrics/#histogramdata) * [metadata](https://academy.santiment.net/sanapi/fetching-metrics/#metadata) * [availableSince](https://academy.santiment.net/sanapi/fetching-metrics/#availablesince) * [lastDatetimeComputedAt](https://academy.santiment.net/sanapi/fetching-metrics/#lastdatetimecomputedat) * [Examples](https://academy.santiment.net/sanapi/fetching-metrics/#examples) [](https://academy.santiment.net/sanapi/fetching-metrics/#overview) Overview ---------------------------------------------------------------------------- The `getMetric` GraphQL query provides a unified method for accessing a variety of metrics for all supported assets. This query enables you to retrieve metadata, datetime availability, assets availability, and various metric representations, including timeseries data, histogram data, and aggregated timeseries data. Here is an example of a GraphQL `getMetric` query: 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22active_addresses_24h%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22bitcoin%22%0A%20%20%20%20%20%20from%3A%20%222023-05-01T08%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222023-05-02T08%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%2230m%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** This query retrieves the timeseries data for the metric "active\_addresses\_24h" for Bitcoin, from 8:00 on May 1, 2023, to 8:00 on May 2, 2023, with a 30-minute interval between data points. [](https://academy.santiment.net/sanapi/fetching-metrics/#available-metrics) Available Metrics ---------------------------------------------------------------------------------------------- You can fetch the list of all available metrics using the following [query](https://api.santiment.net/graphiql?query=%7B%0A++getAvailableMetrics%0A%7D%0A) : 1 2 3 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getAvailableMetrics%0A%7D) ** To fetch the list of available metrics for a specific plan and product, provide the `plan` and `product` arguments in the [query](https://api.santiment.net/graphiql?query=%7B%0A++getAvailableMetrics%28product%3A+SANAPI+plan%3A+BUSINESS_PRO%29%0A%7D) : 1 2 3 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getAvailableMetrics(product%3A%20SANAPI%2C%20plan%3A%20BUSINESS_PRO)%0A%7D) ** [](https://academy.santiment.net/sanapi/fetching-metrics/#metrics-restrictions-per-plan) Metrics restrictions per plan ---------------------------------------------------------------------------------------------------------------------- Access to certain metrics may be limited in various ways based on your subscription plan: * Some metrics may not be accessible to users on lower-tier subscription plans. * Lower-tier subscription plans may have limited access to certain metrics, excluding access to historical and real-time data, or no access at all. You can obtain detailed information about the restrictions on all metrics for a specific subscription plan using this query: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getAccessRestrictions(product%3A%20SANAPI%2C%20plan%3A%20BUSINESS_PRO%2C%20filter%3A%20METRIC)%20%7B%0A%20%20%20%20name%0A%20%20%20%20minInterval%0A%20%20%20%20isAccessible%0A%20%20%20%20isRestricted%0A%20%20%20%20isDeprecated%0A%20%20%20%20restrictedFrom%0A%20%20%20%20restrictedTo%0A%20%20%20%20docs%20%7B%0A%20%20%20%20%20%20link%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D) ** The following fields are selected: * `name` - the name of the metric * `minInterval` - what is the minimal interval between two data points (5 minutes or 1 day in most cases) * `isDeprecated` - is the deprecated. If true, you must stop using this metric as it will be removed in the future. * `isAccessible` - is the metric accessible with the selected subscription plan. * `restrictedFrom` - what is the earliest date for which this subscription plan can fetch data. If `null`, then no restrictions apply. * `restrictedTo` - what is the latest date for which this subscription plan can fetch data. If `null`, then no restrictions apply. * `docs` - link to the documentation of the metric. [](https://academy.santiment.net/sanapi/fetching-metrics/#metrics-documentation) Metrics Documentation ------------------------------------------------------------------------------------------------------ You can find the documentation for most of the metrics on [this page](https://academy.santiment.net/metrics/) . [](https://academy.santiment.net/sanapi/fetching-metrics/#available-assets) Available Assets -------------------------------------------------------------------------------------------- Each metric is retrieved for a specific asset, which is identified by its `slug`. You can obtain a list of all slugs using this query: 1 2 3 4 5 6 7 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20allProjects%20%7B%0A%20%20%20%20slug%0A%20%20%20%20name%0A%20%20%20%20ticker%0A%20%20%7D%0A%7D) ** [](https://academy.santiment.net/sanapi/fetching-metrics/#available-metrics-per-project) Available metrics per project ---------------------------------------------------------------------------------------------------------------------- The range of available metrics varies for each asset. The query below demonstrates three distinct lists: * All accessible metrics * A subset of all accessible metrics that are timeseries metrics * A subset of all accessible metrics that are histogram metrics You can retrieve these lists of metrics using this query: 1 2 3 4 5 6 7 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20projectBySlug(slug%3A%20%22ethereum%22)%20%7B%0A%20%20%20%20availableMetrics%0A%20%20%20%20availableTimeseriesMetrics%0A%20%20%20%20availableHistogramMetrics%0A%20%20%7D%0A%7D) ** [](https://academy.santiment.net/sanapi/fetching-metrics/#available-projects-per-metric) Available projects per metric ---------------------------------------------------------------------------------------------------------------------- To fetch the list of available slugs for a specific metric, use this query: 1 2 3 4 5 6 7 8 9 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22mvrv_usd%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableProjects%20%7B%0A%20%20%20%20%20%20%20%20slug%0A%20%20%20%20%20%20%7D%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D) ** [](https://academy.santiment.net/sanapi/fetching-metrics/#minimal-interval) Minimal Interval -------------------------------------------------------------------------------------------- Metrics are stored as pairs of datetime and value. The term `minInterval` refers to the time interval between two consecutive data points. It signifies the smallest interval that can be utilized when querying the metric. The most frequently used `minInterval`s include: * 1 day (`1d`): Metrics with this interval are typically referred to as "daily" metrics. * 5 minutes (`5m`): Metrics with this interval are often called "intraday" metrics. When querying data, the `interval` argument is used to determine the resolution of the data. This interval can be significantly larger than the `minInterval`. In such instances, all the values within that larger interval must be aggregated into a single value. The `aggregation` parameter controls how this data is aggregated. [](https://academy.santiment.net/sanapi/fetching-metrics/#aggregation) Aggregation ---------------------------------------------------------------------------------- Fields that return timeseries data accept an `aggregation` parameter. When an `interval` larger than `minInterval` is provided for a specific metric, multiple data point values will be consolidated into a single data point. > **Note**: Each metric has a manually selected default aggregation that is used if the `aggregation` parameter is not specified. The default aggregation is chosen to be the most logical one. The types of aggregations are: * `SUM` - The sum of all values. * `AVG` - The average of the values. * `MEDIAN` - The median of all values. * `FIRST` - The earliest value (with the smallest datetime). * `LAST` - The most recent value (with the latest datetime). * `MAX` - The largest value. * `MIN` - The smallest value. * `ANY` - Any value within the interval. This is typically used when all values are expected to be the same, and you just want to select one of them. No metrics use this as their default aggregation. This type of aggregation is more commonly used when users write their own SQL queries using the [Santiment Queries](https://academy.santiment.net/santiment-queries/) product. > **Note:** The aggregation is of the [GraphQL enum type](https://graphql.org/learn/schema/#enumeration-types) > and should be provided in uppercase without quotes, like this: `aggregation: MAX`. The following query retrieves the default aggregation and all available aggregations for each metric: 1 2 3 4 5 6 7 8 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22daily_active_addresses%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20defaultAggregation%0A%20%20%20%20%20%20availableAggregations%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D) ** [](https://academy.santiment.net/sanapi/fetching-metrics/#queryable-fields) Queryable fields -------------------------------------------------------------------------------------------- In the `getMetric` function, you can query the following fields: * `timeseriesDataJson` * `timeseriesDataPerSlugJson` * `aggregatedTimeseriesData` * `histogramData` * `metadata` * `availableSince` * `lastDatetimeComputedAt` ### [](https://academy.santiment.net/sanapi/fetching-metrics/#timeseriesdatajson) timeseriesDataJson Timeseries data is a sequence of data points collected at consistent intervals over time. Each data point provided by the API includes a `datetime` and a `value` field. To retrieve the values for a specific metric, slug, and time range, you can use the `timeseriesDataJson` field of the `getMetric` API. #### [](https://academy.santiment.net/sanapi/fetching-metrics/#parameters) Parameters: | Parameter | Description | | --- | --- | | slug | The slug of the project | | from | The starting date for the values to be returned, in ISO8601 format | | to | The ending date for the values to be returned, in ISO8601 format | | interval | The intervals to be returned. The default is `1d`. This is optional | | aggregation | The aggregation to be used when fetching data for longer intervals. This is optional | | includeIncompleteData | Exclude the last incomplete day (today) if it could lead to misleading data. Default is `false`. This is optional | | fields | Optionally give aliases the returned fields `datetime` and `value` | | transform | Apply a transformation to the result. Default is `none`. This is optional | * `aggregation`: This parameter is optional. If not provided, each metric has a default aggregation that is most suitable. You can view the default aggregation function using the [metadata](https://academy.santiment.net/sanapi/fetching-metrics/#metadata) query. * `includeIncompleteData`: In some cases, if the day is not yet complete, the current value can be misleading. For instance, fetching daily active addresses at 12pm would include only half a day's data, potentially making the data for that day appear too low. * `fields`: If the returned fields name should be something other than `datetime` or `value`, aliases can be given. In case of `aggregation: OHLC`, the fields that can be overriden are `valueOhlc`, `open`, `high`, `close` and `low` * `{datetime: "dt", value: "v"}` * `transform`: Apply a transformation to the timeseries data result. Available transformations include: * `{type: "none"}`: Do not apply any transformation * `{type: "moving_average", moving_average_base: base}`: Apply a simple moving average. Each data point value is calculated as the average of the last `base` intervals. To compute this, it fetches enough data before `from` so it can be computed. * `{type: "changes"}`: For each data point, change the value to the difference between the value and the previous value. 1 2 3 4 5 6 7 8 9 10 11 12 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22dev_activity%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22santiment%22%0A%20%20%20%20%20%20from%3A%20%22utc_now-60d%22%0A%20%20%20%20%20%20to%3A%20%22utc_now-50d%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20%20%20aggregation%3A%20SUM%0A%20%20%20%20%20%20transform%3A%20%7B%20type%3A%20%22moving_average%22%2C%20moving_average_base%3A%203%20%7D%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** ### [](https://academy.santiment.net/sanapi/fetching-metrics/#timeseriesdataperslugjson) timeseriesDataPerSlugJson This API acts similar to timeseriesDataJson, but it can return data for more than one asset at a time. The differences in parameters compared to timeseriesDataJson are as follows: * Instead of `slug` it can accept the `selector` parameters where multiple assets can be provided at once: `selector: {slugs: ["bitcoin", "ethereum"]}` * It does not support the `transform` parameter 1 2 3 4 5 6 7 8 9 10 11 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22price_usd%22)%20%7B%0A%20%20%20%20timeseriesDataPerSlugJson(%0A%20%20%20%20%20%20selector%3A%20%7B%20slugs%3A%20%5B%22bitcoin%22%2C%20%22ethereum%22%5D%20%7D%0A%20%20%20%20%20%20from%3A%20%22utc_now-60d%22%0A%20%20%20%20%20%20to%3A%20%22utc_now-50d%22%0A%20%20%20%20%20%20includeIncompleteData%3A%20true%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** ### [](https://academy.santiment.net/sanapi/fetching-metrics/#aggregatedtimeseriesdata) aggregatedTimeseriesData Aggregated timeseries data is useful when you require a single value instead of multiple values separated by an even interval. This can be utilized to fetch the All-Time High (ATH) price or the highest number of daily active addresses, among other examples. #### [](https://academy.santiment.net/sanapi/fetching-metrics/#parameters) Parameters: | Parameter | Description | | --- | --- | | slug | The slug of the project | | from | The start date for the returned values in ISO8601 format | | to | The end date for the returned values in ISO8601 format | | aggregation | The aggregation to be used when fetching data for longer intervals (Optional) | * `aggregation`: This parameter is optional. If not provided, each metric has a default aggregation function that is most suitable. The default aggregation function can be viewed using the [metadata](https://academy.santiment.net/sanapi/fetching-metrics/#metadata) query. The following query fetches the all-time highest price for Santiment: 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22price_usd%22)%20%7B%0A%20%20%20%20highest_price%3A%20aggregatedTimeseriesData(%0A%20%20%20%20%20%20slug%3A%20%22santiment%22%0A%20%20%20%20%20%20from%3A%20%222017-07-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-04-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20aggregation%3A%20MAX%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** ### [](https://academy.santiment.net/sanapi/fetching-metrics/#aggregatedtimeseriesdata-on-the-project-type) aggregatedTimeseriesData on the project type Queries like `allProject` or `projectBySlug` also have `aggregatedTimeseriesData` field that works the same way. The only difference is that when using `getMetric` the `metric` is already pinned and the `slug` needs to be provided, while for `allProjects` and `projectBySlug` it is vice versa. Using aliases, the `aggregatedTimeseriesData` can be selected multiple times. 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20allProjects(page%3A%201%2C%20pageSize%3A%2020)%20%7B%0A%20%20%20%20slug%0A%20%20%20%20devActivity%3A%20aggregatedTimeseriesData(%0A%20%20%20%20%20%20metric%3A%20%22dev_activity_1d%22%0A%20%20%20%20%20%20from%3A%20%22utc_now-30d%22%0A%20%20%20%20%20%20to%3A%20%22utc_now%22%0A%20%20%20%20%20%20aggregation%3A%20SUM%0A%20%20%20%20)%0A%20%20%20%20priceUsd%3A%20aggregatedTimeseriesData(%0A%20%20%20%20%20%20metric%3A%20%22price_usd%22%0A%20%20%20%20%20%20from%3A%20%22utc_now-1d%22%0A%20%20%20%20%20%20to%3A%20%22utc_now%22%0A%20%20%20%20%20%20aggregation%3A%20LAST%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** ### [](https://academy.santiment.net/sanapi/fetching-metrics/#histogramdata) histogramData A histogram is a graphical representation that organizes a group of data points into a specified range. For instance, if we consider the period from January 2018 to January 2019, we can fetch the amount of Ether that was bought in every 100-dollar price range: $0-$100, $100-$200, ..., $1300-$1400. To fetch the values for a given histogram metric, slug, and time interval, you can use the `histogramData` subquery of the `getMetric` API. #### [](https://academy.santiment.net/sanapi/fetching-metrics/#parameters) Parameters: | Parameter | Description | | --- | --- | | slug | The slug of the project | | from | The start date for the values in ISO 8601 format | | to | The end date for the values in ISO 8601 format | | interval | The intervals to be returned. Default is `1d` | | limit | The number of results to be returned. Optional | Different histogram metrics may have different response types or formats. 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22age_distribution%22)%20%7B%0A%20%20%20%20histogramData(%0A%20%20%20%20%20%20slug%3A%20%22ethereum%22%0A%20%20%20%20%20%20from%3A%20%22utc_now-90d%22%0A%20%20%20%20%20%20to%3A%20%22utc_now-80d%22%0A%20%20%20%20%20%20limit%3A%2020)%7B%0A%20%20%20%20%20%20%20%20labels%0A%20%20%20%20%20%20%20%20values%7B%0A%20%20%20%20%20%20%20%20%20%20...%20on%20FloatList%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20data%0A%20%20%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D) ** ### [](https://academy.santiment.net/sanapi/fetching-metrics/#metadata) metadata Each metric is accompanied by metadata that describes the following: * The minimum interval for which it can be fetched. Different metrics are available at varying granularities. * The default aggregation that will be used when retrieving the metric at a higher resolution. * The supported aggregations for the metric. * The existing selectors for the metric. * The projects for which the metric is available. * The type of the metric, which can be either a timeseries or a histogram. 1 2 3 4 5 6 7 8 9 10 11 12 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22daily_active_addresses%22)%20%7B%0A%20%20%20%20metadata%20%7B%0A%20%20%20%20%20%20availableAggregations%0A%20%20%20%20%20%20availableSelectors%0A%20%20%20%20%20%20availableSlugs%0A%20%20%20%20%20%20dataType%0A%20%20%20%20%20%20defaultAggregation%0A%20%20%20%20%20%20minInterval%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D) ** ### [](https://academy.santiment.net/sanapi/fetching-metrics/#availablesince) availableSince You can fetch the date from which a specific metric is available for an asset using the following query: 1 2 3 4 5 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22transaction_volume%22)%20%7B%0A%20%20%20%20availableSince(slug%3A%20%22bitcoin%22)%0A%20%20%7D%0A%7D) ** Typically, a metric is available for a given asset from the moment the contract or blockchain is created. However, there are exceptions. For instance, if the calculation of a metric requires pricing data that is not available, the metric will only be available from the date the pricing data becomes available. For example, Bitcoin has been operational since early 2009, but there were no exchanges or markets for over a year. Therefore, the pricing data only starts from July 2010. As a result, the MVRV metric, which requires market capitalization, is also only available since July 2010. ### [](https://academy.santiment.net/sanapi/fetching-metrics/#lastdatetimecomputedat) lastDatetimeComputedAt > **Note:** This field may be complex to understand. However, in the general case, this field is not used. The `lastDatetimeComputedAt` shows the when the latest data point was computed. 1 2 3 4 5 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22daily_active_addresses%22)%20%7B%0A%20%20%20%20lastDatetimeComputedAt(slug%3A%20%22santiment%22)%0A%20%20%7D%0A%7D) ** [](https://academy.santiment.net/sanapi/fetching-metrics/#examples) Examples ---------------------------------------------------------------------------- **Timeseries Data Example** 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22active_addresses_24h%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22bitcoin%22%0A%20%20%20%20%20%20from%3A%20%222023-05-01T08%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222023-05-02T08%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%2230m%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** This example query retrieves the `development_activity` metric for the Ethereum project over the last 60 days, with a 1-day interval. **Timeseries Data Example** 1 2 3 4 5 6 7 8 9 10 11 12 13 14 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22twitter_followers%22)%20%7B%0A%20%20%20%20timeseriesData(%0A%20%20%20%20%20%20slug%3A%20%22maker%22%0A%20%20%20%20%20%20from%3A%20%222023-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222023-02-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%227d%22%0A%20%20%20%20%20%20transform%3A%20%7B%20type%3A%20%22consecutive_differences%22%20%7D%0A%20%20%20%20)%20%7B%0A%20%20%20%20%20%20datetime%0A%20%20%20%20%20%20value%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D) ** **Aggregated Timeseries Data Example** 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22daily_active_addresses%22)%20%7B%0A%20%20%20%20highest_daa%3A%20aggregatedTimeseriesData(%0A%20%20%20%20%20%20slug%3A%20%22ethereum%22%0A%20%20%20%20%20%20from%3A%20%222022-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222023-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20aggregation%3A%20MAX%0A%20%20%20%20)%0A%20%20%20%20lowest_daa%3A%20aggregatedTimeseriesData(%0A%20%20%20%20%20%20slug%3A%20%22ethereum%22%0A%20%20%20%20%20%20from%3A%20%222022-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222023-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20aggregation%3A%20MIN%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** **Histogram Metric Example I** 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22age_distribution%22)%20%7B%0A%20%20%20%20histogramData(%0A%20%20%20%20%20%20slug%3A%20%22santiment%22%0A%20%20%20%20%20%20from%3A%20%222020-02-10T07%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-03-30T07%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%20%7B%0A%20%20%20%20%20%20values%20%7B%0A%20%20%20%20%20%20%20%20...%20on%20DatetimeRangeFloatValueList%20%7B%0A%20%20%20%20%20%20%20%20%20%20data%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20range%0A%20%20%20%20%20%20%20%20%20%20%20%20value%0A%20%20%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20%7D%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D) ** The response result is a list that contains a 2-element range of datetimes and a float value. **Histogram Metric Example** 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22price_histogram%22)%20%7B%0A%20%20%20%20histogramData(%0A%20%20%20%20%20%20slug%3A%20%22santiment%22%0A%20%20%20%20%20%20from%3A%20%222020-02-10T07%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222020-03-30T07%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%20%7B%0A%20%20%20%20%20%20values%20%7B%0A%20%20%20%20%20%20%20%20...%20on%20FloatRangeFloatValueList%20%7B%0A%20%20%20%20%20%20%20%20%20%20data%20%7B%0A%20%20%20%20%20%20%20%20%20%20%20%20range%0A%20%20%20%20%20%20%20%20%20%20%20%20value%0A%20%20%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20%20%20%7D%0A%20%20%20%20%20%20%7D%0A%20%20%20%20%7D%0A%20%20%7D%0A%7D) ** The response is a list that contains a 2-element range of float (prices) and a float value. **Read next: [Common GraphQL Queries](https://academy.santiment.net/sanapi/common-queries/) ** Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Rate Limits, Restrictions and Credits Cost | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/santiment-queries/rate-limits-and-credits-cost/#rate-limits-restrictions-and-credits-cost) Rate Limits, Restrictions and Credits Cost ====================================================================================================================================================================== [](https://academy.santiment.net/santiment-queries/rate-limits-and-credits-cost/#overview) Overview --------------------------------------------------------------------------------------------------- Santiment Queries is a powerful tool that provides users with access to a Clickhouse database, enabling them to execute SQL queries and obtain relevant metrics. These queries are executed as GraphQL API calls. The queries executed can vastly differ in their resource consumption. Because of that, there is an additional credits model that restricts the queries. [](https://academy.santiment.net/santiment-queries/rate-limits-and-credits-cost/#api-calls-rate-limits) API Calls Rate Limits ----------------------------------------------------------------------------------------------------------------------------- The queries are executed as ordinary GraphQL API calls. The same [rate limits](https://academy.santiment.net/sanapi/rate-limits/) apply to these SQL queries as well. [](https://academy.santiment.net/santiment-queries/rate-limits-and-credits-cost/#execution-restrictions) Execution Restrictions ------------------------------------------------------------------------------------------------------------------------------- When executing a query there are two main restrictions that are applied which, if exceeded, will stop the execution of the query and return an error. **Timeout**: The query execution must finish in 60 seconds **RAM memory consumption**: If the query needs more than 10GB of RAM memory to run, it will be terminated. [](https://academy.santiment.net/santiment-queries/rate-limits-and-credits-cost/#credits-cost) Credits Cost ----------------------------------------------------------------------------------------------------------- The execution of a query spends RAM, CPU and IO (disk) resources. The combination of all resources spent with the size of the result is used to compute the cost of the query. The bigger the result and the more resources are spent, the higher the cost of the query. The available credits per month are determined by the subscription plan. Check the plans and restrictions for **Sanbase** subscriptions on the: * [Sanbase pricing page](https://app.santiment.net/pricing?plans=individual) * [Sanbase plans academy page](https://academy.santiment.net/products-and-plans/sanbase-plans/) Check the plans and restrictions for **API** subscriptions on the: * [API pricing page](https://app.santiment.net/pricing?plans=business) * [API plans academy page](https://academy.santiment.net/products-and-plans/sanapi-plans/) ### [](https://academy.santiment.net/santiment-queries/rate-limits-and-credits-cost/#example) Example The example below shows how you can check the credits cost of your query. 1 2 3 4 5 6 7 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 In order to check the credits cost, the `clickhouseQueryId` needs to be taken and provided to another query. It is important to note that the credit cost is not immediately available after the execution of the query. 1 2 3 4 5 6 7 8 9 10 11 12 13 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 In the same query if 100 thousand rows are returned instead of just 5, the credit cost jumps to 109. Updated 9 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Fetching Prices, Volume, and Market Cap using Santiment Queries | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/santiment-queries/prices-tables/#fetching-prices-volume-and-market-cap-using-santiment-queries) Fetching Prices, Volume, and Market Cap using Santiment Queries ================================================================================================================================================================================================ [](https://academy.santiment.net/santiment-queries/prices-tables/#overview) Overview ------------------------------------------------------------------------------------ Santiment Queries' `asset_prices_v3` table serves as a critical tool for procuring accurate and detailed information about cryptocurrency asset prices, volume, and market capitalization at any given timestamp. This guide aims to introduce you to the table's structure and its versatile applications. Data for the `asset_prices_v3` table is sourced from two primary platforms - Coinmarketcap and Cryptocompare. [](https://academy.santiment.net/santiment-queries/prices-tables/#table-structure) Table Structure -------------------------------------------------------------------------------------------------- The `asset_prices_v3` table offers extensive information about cryptocurrency asset prices at various timestamps. Here are the key columns you should be familiar with: * **dt** (_DateTime_): This column signifies the timestamp of the data. * **source** (_LowCardinality(String)_): Specifies the data's origin, either `coinmarketcap` or `cryptocompare`. * **slug** (_LowCardinality(String)_): The name of the cryptocurrency project (e.g., 'bitcoin', 'ethereum'). * **price\_usd** (_Float64_): The price of the asset in USD. * **price\_btc** (_Float64_): The price of the asset in Bitcoin. * **marketcap\_usd** (_Float64_): The market capitalization of the asset in USD. * **volume\_usd** (_Float64_): The rolling total trading volume of the asset in USD for last 24 hours [](https://academy.santiment.net/santiment-queries/prices-tables/#sample-queries) Sample Queries ------------------------------------------------------------------------------------------------ ### [](https://academy.santiment.net/santiment-queries/prices-tables/#query-1-fetch-the-daily-closing-price-of-bitcoin-for-the-past-week) Query 1: Fetch the Daily Closing Price of Bitcoin for the Past Week The following SQL query allows you to extract the daily closing price of Bitcoin for the last seven days. 1 2 3 4 5 6 7 8 9 10 11 12 Test in [Queries](https://queries.santiment.net/query/fetch-the-daily-closing-price-of-bitcoin-for-the-past-week-406) ### [](https://academy.santiment.net/santiment-queries/prices-tables/#query-2-identify-the-top-projects-by-usd-trading-volume-in-the-past-24-hours) Query 2: Identify the Top Projects by USD Trading Volume in the Past 24 Hours To retrieve the top 20 cryptocurrency projects ranked by their average trading volume in USD over the last 24 hours, use the following SQL query. 1 2 3 4 5 6 7 8 9 10 11 12 Test in [Queries](https://queries.santiment.net/query/identify-the-top-projects-by-usd-trading-volume-in-the-past-24-hours-407) Updated 1 year ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # How to Create a Correlation Matrix like Cryptowatch.io | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources * [Go to Sansheets](https://sheets.santiment.net/) [](https://academy.santiment.net/sansheets/assets-correlation-matrix-google-sheets/#how-to-create-a-correlation-matrix-like-cryptowatch-io) How to Create a Correlation Matrix like Cryptowatch.io ================================================================================================================================================================================================== In this article, we will demonstrate the power and ease of using Google Sheets Integration with Santiment data. You will learn how to create a correlation matrix similar to the one on Cryptowatch.io, with the added bonus of being able to create a correlation matrix for not only the top 20 assets but for any crypto assets. > In the world of finance, correlation is a statistical measure of how two assets move in relation to each other. > > Simply put, correlation tells us whether two cryptocurrencies move in the same or the opposite direction, or even behave entirely independent of each other. > > If used properly, coin correlation can elevate your trading in more ways than one. Investing in uncorrelated assets, for example, will help hedge your portfolio and mitigate risk. If you’re not sure where Bitcoin’s headed next and want to protect yourself against losses, taking a position in uncorrelated coins can (in theory) diversify your exposure in case of market correction. > > On the other hand, trading highly correlated assets is more of a risk-on strategy that some may use to amplify their returns. Even during a bull run, Bitcoin rarely does more than +15% in a week. However, mid-cap alts that tend to mirror BTC’s price action could well explode within the same time frame. To create your own correlation matrix, you need to complete 3 steps: 1. Fetch pricing data for the last 7 days (if you want to see the correlation for the last 7 days) 2. Calculate the correlation coefficient 3. Organize a clear visualization for the resulting matrix [You can view the full sample here](https://docs.google.com/spreadsheets/d/1UcgTvueFeDtv9k2xb2zwFLXtsAnUzy1JsN0KIHvC40I/edit?usp=sharing) [](https://academy.santiment.net/sansheets/assets-correlation-matrix-google-sheets/#how-to-fetch-pricing-data) How to Fetch Pricing Data ---------------------------------------------------------------------------------------------------------------------------------------- Fetching pricing data is simple using SAN functions in the formula field. Enter the following formula: 1 This function will automatically populate the last 7 days of Bitcoin's USD price and trading volume, as shown below: ![](https://academy.santiment.net/sansheets/assets-correlation-matrix-google-sheets/how-to-fetch-financial-data.png) [](https://academy.santiment.net/sansheets/assets-correlation-matrix-google-sheets/#how-to-calculate-correlations) How to Calculate Correlations ------------------------------------------------------------------------------------------------------------------------------------------------ Google Sheets has a built-in function for calculating the Pearson Correlation: `=CORREL()` To calculate the Pearson Coefficient for Bitcoin and Ethereum, simply select the cells with BTC price data (in our case, C7:C13) and the cells with Ethereum price data (G7:G13) within the `=CORREL()` function, as shown below: ![](https://academy.santiment.net/sansheets/assets-correlation-matrix-google-sheets/how-to-calculate-correl.png) [](https://academy.santiment.net/sansheets/assets-correlation-matrix-google-sheets/#create-an-effective-visualization) Create an Effective Visualization -------------------------------------------------------------------------------------------------------------------------------------------------------- We recommend using the following matrix structure for better visualization. You can refer to the image below. ![](https://academy.santiment.net/sansheets/assets-correlation-matrix-google-sheets/make-a-nice-matrix.png) > To create a more visually appealing correlation result, consider rounding the numbers to two decimal places. For example, change 0.034343434 to 0.03. > > You can achieve this by using the built-in feature shown in the image below. > > ![](https://academy.santiment.net/sansheets/assets-correlation-matrix-google-sheets/how-to-increase-decimals.png) * * * Using Sansheets (Google Sheets Integration of Santiment data) is a convenient and flexible way to conduct your own research based on on-chain, social, and financial data without the need for Python or Julia code. The sample for this article was created in just 10 minutes. [View the final sample here](https://docs.google.com/spreadsheets/d/1UcgTvueFeDtv9k2xb2zwFLXtsAnUzy1JsN0KIHvC40I/edit?usp=sharing) Updated 2 years ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Lending Pools Overview | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/santiment-queries/lending-pools/#lending-pools-overview) Lending Pools Overview ================================================================================================================ [](https://academy.santiment.net/santiment-queries/lending-pools/#overview) Overview ------------------------------------------------------------------------------------ A lending pool is a collective source of funds or assets that individuals deposit into for lending purposes, typically facilitated by decentralized finance (DeFi) platforms. It allows lenders to earn interest on their deposited funds while borrowers can access these funds by providing collateral or meeting specific requirements set by the lending protocol. Lending Pools is a project that aims to track deposits, borrows, repayments, withdrawals, and liquidation actions occurring on lending protocols. In **Santiment Queries**, we record the platform from which the liquidation data was recorded under the `project_name` column. The platforms we collect data from are: * AAVE-v2/v3 * Compound/v3 * Liquity * MakerDAO [](https://academy.santiment.net/santiment-queries/lending-pools/#usage) Usage ------------------------------------------------------------------------------ The Lending Pools project can be used for the following purposes: * Monitor the inflow and outflow of lending protocols * Observe liquidation actions occurring on each protocol * Track the Total Value Locked (TVL) in various protocols * Determine the total amount borrowed for a specific asset [](https://academy.santiment.net/santiment-queries/lending-pools/#exploration-of-the-tables) Exploration of the Tables ---------------------------------------------------------------------------------------------------------------------- We can inspect the table with the commands we learned in [Exploration](https://academy.santiment.net/santiment-queries/exploration/) . Below, we have listed the table containing the lending pools data with its columns, brief descriptions, and some example queries that you can use to explore the table. ### [](https://academy.santiment.net/santiment-queries/lending-pools/#lending-pools-events) lending\_pools\_events * **tx\_hash** (_String_): Hash of the transaction in which the event has been included * **log\_index** (_UInt32_): Log index of the event * **dt** (_DateTime_): Date and time of the event * **chain** (_String_): The chain that the pool is deployed on * **pool\_address** (_String_): Address of the pool * **on\_behalf\_of** (_String_): Address holding the debt or collateral * **action** (_Enum8_): Type of action recorded. _borrow_ = 0, _deposit_ = 1, _withdraw_ = 2, _liquidate_ = 3, _repay_ = 4 * **token\_in** (_Nullable(String)_): Address of token received by the pool (in case of deposit/repay/liquidate actions) * **token\_out** (_Nullable(String)_): Address of token leaving the pool (in case of borrow/withdraw/liquidate actions) * **amount\_in** (_UInt256_): The amount of the token received by the pool. 0 in case of borrow/withdraw * **amount\_out** (_UInt256_): The amount of the token leaving the pool. 0 in case of deposit/repay * **project\_name** (_String_): Name of the project, such as aave\_v2, aave\_v3, compound, compound\_v3, liquity and makerdao. * **user** (_String_): Address performing the action * **computed\_at** (_DateTime_): The timestamp when the event was inserted into the table. [](https://academy.santiment.net/santiment-queries/lending-pools/#sample-queries) Sample Queries ------------------------------------------------------------------------------------------------ ### [](https://academy.santiment.net/santiment-queries/lending-pools/#total-deposits-for-a-certain-platform) Total Deposits for a Certain Platform To find the total deposits for AAVE-v2 in the last 30 days for a specific token, use the following SQL query: 1 2 3 4 5 6 Test in [Queries](https://queries.santiment.net/query/total-deposits-for-a-certain-platform-394) * * * ### [](https://academy.santiment.net/santiment-queries/lending-pools/#number-of-liquidations-for-a-certain-platform) Number of Liquidations for a Certain Platform To find the number of liquidations that occurred in the past 30 days on MakerDAO, use the following SQL query: 1 2 3 4 5 Test in [Queries](https://queries.santiment.net/query/number-of-liquidations-for-a-certain-platform-395) * * * ### [](https://academy.santiment.net/santiment-queries/lending-pools/#unique-borrowers-for-a-certain-platform-unique-borrowers-on-compound-in-the-past-30-days) Unique Borrowers for a Certain Platform - Unique Borrowers on Compound in the Past 30 Days 1 2 3 4 5 Test in [Queries](https://queries.santiment.net/query/unique-borrowers-for-a-certain-platform-unique-borrowers-on-compound-in-the-past-30-days-396) Updated 1 year ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # API Complexity | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources * [Go to Sanapi](https://api.santiment.net/) [](https://academy.santiment.net/sanapi/complexity/#api-complexity) API Complexity ================================================================================== [](https://academy.santiment.net/sanapi/complexity/#overview) Overview ---------------------------------------------------------------------- API queries for metrics, such as [this NVT example](https://academy.santiment.net/metrics/nvt#sanapi) , can potentially yield extensive results (ranging from thousands to hundreds of thousands of data points). They may also generate queries that scan the entire database, thereby consuming substantial resources. This could potentially expose the system to DoS attacks. To prevent such scenarios, every GraphQL request is analyzed before execution. The **complexity** of each query is calculated, and if it exceeds a certain threshold, the API server rejects it and returns an error without executing the query. Generally, the complexity is proportional to the number of data points and the size of the time interval included in the result. The complexity calculation considers the following factors: * Number of data points returned - **N**. For instance, fetching 30 days of data at daily intervals results in 30 data points. * Number of fields in a data point - **F**. Most metrics include two fields: **datetime** and **value**. * Years time range span - **Y**. If the request uses a large interval (like 30 days), the number of data points is small. However, the time range spans several years. The query still needs to read and aggregate a lot of data in the database. * Metric weight - **W**. Most metrics are stored in specialized fast data storage, so they have a smaller weight (0.3). The remaining metrics have a weight of 1. * Weighted number of assets - **A**. In case of returning data for many assets (timeseriesDataPerSlugJson API), the number of assets multiplied by a weight of 0.1, minimum of 1. In case of returning data for a single asset, the weight is 1. * Subscription plan tier - **S**. The higher the user's plan, the larger the complexity limit (3 for Basic, 5 for Pro, 7 for Premium). As the complexity threshold is constant, the computed complexity is divided by **S**. This means that the same query executed by a Pro user will have a complexity five times smaller than the same query executed by a Free user. Given the above-defined values, the complexity is calculated using the following formula: In this formula, Q represents the query being analyzed, and N(Q)...S(Q) are the described values computed for that query. [](https://academy.santiment.net/sanapi/complexity/#example) Example -------------------------------------------------------------------- Let's examine how to calculate the complexity when a Business PRO subscription user executes the following query: 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22price_usd%22)%20%7B%0A%20%20%20%20timeseriesDataPerSlugJson(%0A%20%20%20%20%20%20selector%3A%20%7B%20slugs%3A%20%5B%22bitcoin%22%2C%20%22ethereum%22%2C%20%22xrp%22%5D%20%7D%0A%20%20%20%20%20%20from%3A%20%22utc_now-1500d%22%0A%20%20%20%20%20%20to%3A%20%22utc_now%22%0A%20%20%20%20%20%20interval%3A%20%2230m%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** * `N(Q) = 1500 * 24 * 2 = 72000` - The time range spans 3650 days and the interval is set to 1 hour. * `F(Q) = 2` - The data points count in practice is 4, but it is explicitly set to 2, so it mimics the behavior of `timeseriesDataJson` which returns just a list of `datetime` and `value`. * `Y(Q) = 2` - Computed as: `max(diff(2025-04-24, 2021-03-16, "years"), 2) / 2`, where `/` is integer division * `S(Q) = 5` - The SanAPI PRO plan offers complexity limits that are 5 times higher than those of the SanAPI Free plan. * `A(Q) = 1` - The API call returns data for 3 assets, so the value is `max(1, 3\*0.1) = 1` * if the number of assets was 50, then the weight would be `max(1, 50*0.1) = max(1, 5) = 5` The complexity of the query, Q, is calculated as follows: The complexity threshold is 50000, so this query is valid and the API server will execute it. If a SanAPI Free user attempts to execute this query, S(Q) will equal 1 and the complexity will be 86400. This will trigger the following error: 1 2 **Read next: [Supported Blockchains](https://academy.santiment.net/sanapi/supported-blockchains/) ** Updated 4 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Adding an API Key to Sansheets | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources * [Go to Sansheets](https://sheets.santiment.net/) [](https://academy.santiment.net/sansheets/adding-an-api-key/#adding-an-api-key-to-sansheets) Adding an API Key to Sansheets ============================================================================================================================ Adding an API key to Sansheets is very simple. Before you begin, make sure you have completed the following steps: * [Setting up Sansheets](https://academy.santiment.net/sansheets/setting-up/) * [Creating an API key](https://sheets.santiment.net/account#api-keys) If you have already completed these steps, you can proceed with adding the API key to Sansheets. You will find the option to add an API key in the **`Add-ons`** menu under **`Santiment Data`**: ![](https://academy.santiment.net/sansheets/adding-an-api-key/11_add_api_key.png) A popup will appear, prompting you to enter your API key: ![](https://academy.santiment.net/sansheets/adding-an-api-key/12_add_api_key2.png) Copy the API key from your Sanbase account settings, paste it into the popup, and click `Ok`. Sansheets will confirm that you have entered a valid API key: ![](https://academy.santiment.net/sansheets/adding-an-api-key/13_add_api_key_confirmation.png) You will now have access to more data, depending on your stake of SAN tokens. Updated 2 years ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Exploration | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/santiment-queries/exploration/#exploration) Exploration ======================================================================================== [](https://academy.santiment.net/santiment-queries/exploration/#overview) Overview ---------------------------------------------------------------------------------- This document aims to enhance the reader's ability to navigate through Clickhouse using SQL and explore the available tables and their structures. [](https://academy.santiment.net/santiment-queries/exploration/#list-of-tables) List of Tables ---------------------------------------------------------------------------------------------- To get a list of all available tables, execute the following query: 1 You can filter the list of tables using a regex. For example, to get the list of all tables containing `price` in their name: 1 Test in [Queries](https://queries.santiment.net/query/list-of-tables-390) Example output: 1 2 3 4 The `%` at the beginning means that there could be other characters to the left. The `%` at the end means that there could be other characters to the right. [](https://academy.santiment.net/santiment-queries/exploration/#get-information-about-a-table) Get Information About a Table ---------------------------------------------------------------------------------------------------------------------------- To inspect the structure of a given table, execute the `DESCRIBE` statement: 1 Test in [Queries](https://queries.santiment.net/query/describe-table-392) 1 2 3 4 5 6 7 8 9 10 11 To see how a table was created, execute the `SHOW CREATE TABLE` statement. This includes information about partitioning, ordering, table engine, and other settings. Knowing the `ORDER BY` helps create better and faster queries. 1 Test in [Queries](https://queries.santiment.net/query/show-create-table-391) 1 2 3 4 5 6 7 8 9 10 11 12 13 14 [](https://academy.santiment.net/santiment-queries/exploration/#get-data-from-a-table) Get data from a table ------------------------------------------------------------------------------------------------------------ After inspecting the structure of a given table, you can execute a few simple queries to obtain some data from the table to see how it looks. Most of the time, it makes more sense to select more recent data instead of data starting from the beginning, as it will be more relevant. To improve readability, you can apply functions for transforming the `metric_id` and `asset_id` to their names. The `, *` syntax allows you to select all fields but also add something else to the result. 1 2 3 4 5 6 7 Test in [Queries](https://queries.santiment.net/query/get-data-from-a-table-393) 1 2 3 4 5 6 7 8 9 10 11 12 [](https://academy.santiment.net/santiment-queries/exploration/#how-to-interpret-the-table-structure) How to Interpret the Table Structure ------------------------------------------------------------------------------------------------------------------------------------------ When looking at a table structure, there are several important things that the reader needs to pay attention to. Let's take a look at the following table structure: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 ### [](https://academy.santiment.net/santiment-queries/exploration/#table-name) Table Name The complete table name is `default.intraday_metrics`, where `default` refers to the database and `intraday_metrics` is the table name. Since queries are executed in the `default` database, you can omit `default` when referencing the table. ### [](https://academy.santiment.net/santiment-queries/exploration/#columns) Columns The columns are represented by their names and corresponding data types. Data types may have modifiers that determine how the data is stored on disk (e.g., `CODEC(DoubleDelta, LZ4)`). These modifiers can be disregarded when examining a table. ### [](https://academy.santiment.net/santiment-queries/exploration/#order-by) ORDER BY This should not be confused with `ORDER BY` clause used when you write an SQL query, which controls how the records in the result set are sorted. The `ORDER BY` examined here is a property of the database table and controls how the data is sorted on disk, acting like an index. This is a crucial field to understand and consider when writing a query. ClickHouse is a column-oriented database, meaning that the data for columns is stored continuously on-disk. This makes it more challenging and less efficient to use multiple indexes, so the column order in `ORDER BY` is essential for writing performant queries. If filters for the columns at the beginning of the list are present, the query will run faster. ### [](https://academy.santiment.net/santiment-queries/exploration/#engine) Engine The [Table Engine](https://clickhouse.com/docs/en/engines/table-engines/) controls how data is stored, updated, and accessed. If the engine is \*MergeTree, then the `FINAL` keyword needs to be used. See the [Writing SQL Queries](https://academy.santiment.net/santiment-queries/writing-sql-queries/) page for more detailed examples and reasoning. ### [](https://academy.santiment.net/santiment-queries/exploration/#partition) Partition The partitioning has little to no effect on performance, making it safe to ignore. Updated 1 year ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Setting up Sansheets | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources * [Go to Sansheets](https://sheets.santiment.net/) [](https://academy.santiment.net/sansheets/setting-up/#setting-up-sansheets) Setting up Sansheets ================================================================================================= [](https://academy.santiment.net/sansheets/setting-up/#install-sansheets) Install Sansheets ------------------------------------------------------------------------------------------- To add Sansheets to your Google Sheets, first open a spreadsheet. It can be a new one. You will find the option **`Get add-ons...`** in the top navigation under: ![](https://academy.santiment.net/sansheets/setting-up/01_add_addon.png) This will open a store-like interface for add-ons. Enter **`Santiment`** into the search bar in the upper right and hit return: ![](https://academy.santiment.net/sansheets/setting-up/04_add_addon2.png) You will get **`Santiment Data`** as a result. Click on the **`+FREE`** button to install it: ![](https://academy.santiment.net/sansheets/setting-up/05_add_addon3.png) You will now be asked to select the Google account you want to use. As you should be logged in already, the appropriate one should be listed. Click it to continue: ![](https://academy.santiment.net/sansheets/setting-up/06_add_addon_confirm_account.png) In the next step, you are asked to confirm that the Sansheets plugin is allowed to do its work: ![](https://academy.santiment.net/sansheets/setting-up/07_add_addon_confirm_account2.png) Sansheets is now installed, which will be highlighted by an introductory tooltip: ![](https://academy.santiment.net/sansheets/setting-up/08_add_addon_confirmation.png) [](https://academy.santiment.net/sansheets/setting-up/#enabling-sansheets-for-the-spreadsheet) Enabling Sansheets for the Spreadsheet ------------------------------------------------------------------------------------------------------------------------------------- To activate Sansheets in the currently opened document, select it in the **`Add-ons`** menu, where you will find **`Enable`**: ![](https://academy.santiment.net/sansheets/setting-up/09_enable.png) Sansheets will take a moment to activate and will notify you as soon as it's ready: ![](https://academy.santiment.net/sansheets/setting-up/10_enable_confirmation.png) [](https://academy.santiment.net/sansheets/setting-up/#accessing-more-data-with-sansheets) Accessing More Data with Sansheets ----------------------------------------------------------------------------------------------------------------------------- To fully utilize Sansheets, you will eventually need to use an API key. Learn [how to create an API key](https://academy.santiment.net/products-and-plans/create-an-api-key/) and [how to add it to Sansheets](https://academy.santiment.net/sansheets/adding-an-api-key/) by following these guides. Updated 2 years ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Bridge Transactions Table Overview | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/santiment-queries/bridges/#bridge-transactions-table-overview) Bridge Transactions Table Overview ================================================================================================================================== [](https://academy.santiment.net/santiment-queries/bridges/#overview) Overview ------------------------------------------------------------------------------ A crypto bridge is a platform or protocol that facilitates the exchange of cryptocurrencies between different blockchain networks, promoting interoperability and liquidity within the cryptocurrency ecosystem. In **Santiment Queries**, we collect data from platforms or protocols which are trading cryptocurrencies across diverse blockchain networks: * Across * Arbitrum\_bridge * Avalanche * Manta\_pacific * Multichain * Op\_bridge * Polygon\_bridge * Squid * Stargate * Wbtc * Zksync\_era\_bridge * Zksync\_lite [](https://academy.santiment.net/santiment-queries/bridges/#usage) Usage ------------------------------------------------------------------------ Data Analysis and Reporting: This repository facilitates the analysis and reporting of transactions across various types of bridges, offering valuable insights into their utilization and acceptance. Monitoring and Alert Systems: Utilizing transaction data from bridges, teams can establish monitoring and alert systems to detect irregular or questionable activities across diverse bridge networks. Integration with Santiment Products: The exported data can seamlessly integrate with other Santiment products, like Sanbase, enhancing the overall understanding of the cryptocurrency landscape. [](https://academy.santiment.net/santiment-queries/bridges/#exploring-the-tables) Exploring the Tables ------------------------------------------------------------------------------------------------------ We can inspect the table using the commands we learned in [Exploration](https://academy.santiment.net/santiment-queries/exploration/) . Here, we've provided the Bridge Transactions table along with its columns, concise descriptions, and a few sample queries for you to delve into the data. ### [](https://academy.santiment.net/santiment-queries/bridges/#bridge-transactions) bridge\_transactions The `bridge_transactions` table is designed to capture and store detailed information about transactions occurring on a bridge between different blockchain networks. Each row in this table represents a single transaction, and the table includes various attributes to provide comprehensive insights into the transaction process. It has the following columns: * **tx\_hash** (_String_): Hash of the transaction. * **log\_index** (_UInt32_): Log index of the event. * **dt** (_DateTime_): Date and time of the transaction * **chain\_in** (_String_): The target blockchain to recieve the funds. * **chain\_out** (_String_): The Blockchain from where the transaction was initiated * **contract\_addr** (_String_): Address of the involved smart contract. * **token\_in** (_Nullable(String)_): Type of token received from the bridge. * **token\_out** (_Nullable(String)_): Type of token sent into the bridge. * **amount\_in** (_UInt256_): Quantity of token\_in. * **amount\_out** (_UInt256_): Quantity of token\_out. * **project\_name** (_String_): Name or identifier of the associated project. * **user** (_String_): Identifier of the transaction initiator. * **args** (_String_): Additional transaction parameters or data * **asset\_in\_ref\_id** (_UInt64_): Reference ID of the currency contract that can be used to retrieve additional information about the asset from the `asset_metadata` table. * **asset\_out\_ref\_id** (_UInt64_): Reference ID of the currency contract that can be used to retrieve additional information about the asset from the `asset_metadata` table. * **computed\_at** (_DateTime_): Timestamp indicating when the transaction details were recorded in the database. [](https://academy.santiment.net/santiment-queries/bridges/#sample-queries) Sample Queries ------------------------------------------------------------------------------------------ We've put together a dashboard with several queries to assist you in monitoring transaction volume and count, as well as the top 10 transactions or bridge flows. You can utilize our queries for a quick data check, or dive deeper by clicking on each query's name within the dashboard to customize them to your preferences. [Bridge Dashboard](https://queries.santiment.net/dashboard/bridges-710) Updated 1 year ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # DEX Pools Tables Overview | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/santiment-queries/dex-pools/#dex-pools-tables-overview) DEX Pools Tables Overview ================================================================================================================== [](https://academy.santiment.net/santiment-queries/dex-pools/#overview) Overview -------------------------------------------------------------------------------- A DEX, short for decentralized exchange, is a type of peer-to-peer marketplace where cryptocurrency traders can conduct transactions directly with one another. By eliminating the need for intermediaries such as banks and brokers, DEXs facilitate the core promise of cryptocurrency, which is to enable financial transactions without centralized control. In **Santiment Queries**, we collect data from protocols that provide liquidity pools (aggregators are not included): * Balancer * Bamboodefi * Bancor-v3 * ChickenSwap * Clipper * Curve * DefiPlaza * DefiSwap * DoDo * Elk * EmpireDex * KwikSwap * KyberSwap * MooniSwap * RadioShack * Saddle * ShibaSwap * StandardTech * Sum Swap * SushiSwap * Swapr * Synapse * Uniswap v2/v3 * YouSwap This information gives you the ability to check: * the DEX market activity * the smart money movement on certain tokens * information about liquidity pools * the most active tokens, addresses, and DEX protocols * different DEX protocols and to compare them [](https://academy.santiment.net/santiment-queries/dex-pools/#list-of-dex-tables) List of DEX Tables ---------------------------------------------------------------------------------------------------- All our tables that contain DEX-related data have the string 'dex' in their name. You can easily find them by running the following query: 1 1 2 3 4 [](https://academy.santiment.net/santiment-queries/dex-pools/#exploring-the-tables) Exploring the Tables -------------------------------------------------------------------------------------------------------- We can inspect the tables using the commands we learned in [Exploration](https://academy.santiment.net/santiment-queries/exploration/) . Below, we have listed all the DEX pools tables with their columns, brief descriptions, and some example queries that you can use to explore the tables. ### [](https://academy.santiment.net/santiment-queries/dex-pools/#dex-pools) dex\_pools The `dex_pools` table is designed to store information about liquidity pool creation events on DEX protocols. It has the following columns: * **dt** (_DateTime_): Date and time of the pool deployment. * **chain** (_String_): The chain that the pool is deployed on. * **tx\_hash** (_String_): Hash of the transaction. * **log\_index** (_UInt32_): Log index of the pool event. * **project\_name** (_String_): Name of the DEX or projects, such as uniswap\_v3, curve, dydx, etc. * **factory\_address** (_Nullable(String)_): Address of the factory that created the pool; NULL if there is no factory (e.g., clipper.exchange). * **pool\_address** (_String_): Address of the pool. * **token\_address** (_Array(Nullable(String))_): Array of token addresses used in the pool. * **fee** (_Nullable(Float64)_): Fee of the pool in percentage; NULL if not available or variable. * **computed\_at** (_DateTime_): The timestamp when the pool was inserted into the table. ### [](https://academy.santiment.net/santiment-queries/dex-pools/#dex-pools-trades) dex\_pools\_trades The `dex_pools_trades` is a table designed to store trading events on DEX protocols. It has the following columns: * **dt** (_DateTime_): Date and time of trade * **chain** (_String_): The chain that the pool is deployed on * **tx\_hash** (_String_): Hash of the transaction in which the trade has been included * **log\_index** (_UInt32_): Log index of trade event * **trade\_index** (_UInt32_): The sequence order of the trade in the transaction. For example, if there are 5 trades in a transaction, the trade index should be 0 to 4 accordingly. * **pool\_address** (_String_): Address of the pool * **router\_address** (_String_): Address of the router used in this transaction. A router routes trade orders to the most appropriate pool of liquidity for efficient execution and optimal pricing based on available liquidity.\* * **from** (_String_): Sender address of the transaction.\*\* * **to** (_String_): Receiver address of the transaction * **token\_in** (_Nullable(String)_): Address of token sent, NoneType if it's ETH * **token\_out** (_Nullable(String)_): Address of token received * **amount\_in** (_UInt256_): The amount of the token sent * **amount\_out** (_UInt256_): The amount of the token received * **asset\_in\_ref\_id** (_UInt64_): Reference ID of the currency contract that was sent which can be used to retrieve additional information about the asset from the `asset_metadata` table. * **asset\_out\_ref\_id** (_UInt64_): Reference ID of the currency contract that was received. * **computed\_at** (_DateTime_): The timestamp when the trade was inserted into the table. \* In decentralized exchanges (DEXs), a router is used to direct transactions between different blockchain networks or between different liquidity pools within the same network. When a user wants to make a trade on a DEX, the router identifies the best path for the trade to take in order to get the best possible price. The router can also split the trade into smaller orders and route them through multiple liquidity pools in order to find the best overall price. Additionally, the router can be used to manage liquidity and minimize the impact of large trades on the market by routing the trade through multiple liquidity pools. By doing so, the router ensures that the trade does not cause significant price movements in any single pool, which could adversely affect the price of the traded asset. **Note about** from **and** to**: They can be equal when there is an internal router transaction, then the address in** from **will be the same as** to **and also the** router\_address\*\*. However, it is also possible to have routed transactions in which they are not equal, such as when the transaction is to or from the router or when a router is used for a normal trade between addresses. [](https://academy.santiment.net/santiment-queries/dex-pools/#sample-queries) Sample Queries -------------------------------------------------------------------------------------------- ### [](https://academy.santiment.net/santiment-queries/dex-pools/#volume-of-a-specific-token-on-a-specific-exchange-for-the-last-30-days) Volume of a specific token on a specific exchange for the last 30 days 1 2 3 4 5 6 7 8 9 10 Test in [Queries](https://queries.santiment.net/query/volume-of-a-specific-token-on-a-specific-exchange-for-the-last-30-days-383) ### [](https://academy.santiment.net/santiment-queries/dex-pools/#number-of-trades-that-occurred-in-the-past-30-days-on-a-specific-exchange) Number of trades that occurred in the past 30 days on a specific exchange 1 2 3 4 5 6 7 8 9 Test in [Queries](https://queries.santiment.net/query/number-of-trades-that-occurred-in-the-past-30-days-on-a-specific-exchange-385) ### [](https://academy.santiment.net/santiment-queries/dex-pools/#unique-traders-in-the-past-30-days-on-dodo-exchange) Unique Traders in the Past 30 Days on DODO Exchange 1 2 3 4 5 6 7 8 9 Test in [Queries](https://queries.santiment.net/query/unique-traders-in-the-past-30-days-on-dodo-exchange-386) ### [](https://academy.santiment.net/santiment-queries/dex-pools/#number-of-pools-on-a-specific-exchange) Number of Pools on a Specific Exchange 1 2 3 4 5 6 Test in [Queries](https://queries.santiment.net/query/number-of-pools-on-a-specific-exchange-387) * * * ### [](https://academy.santiment.net/santiment-queries/dex-pools/#pool-fees-ranked-descending) Pool Fees Ranked Descending 1 2 3 4 5 6 Test in [Queries](https://queries.santiment.net/query/pool-fees-ranked-descending-388) ### [](https://academy.santiment.net/santiment-queries/dex-pools/#projects-ranked-by-number-of-pools) Projects Ranked by Number of Pools 1 2 3 4 5 6 7 8 Test in [Queries](https://queries.santiment.net/query/projects-ranked-by-number-of-pools-389) Updated 1 year ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Sansheets Pro Templates | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources * [Go to Sansheets](https://sheets.santiment.net/) [](https://academy.santiment.net/sansheets/pro-templates/#sansheets-pro-templates) Sansheets Pro Templates ========================================================================================================== [](https://academy.santiment.net/sansheets/pro-templates/#the-perks-of-being-a-pro-subscriber-on-sanbase) The Perks of Being a Pro Subscriber on Sanbase -------------------------------------------------------------------------------------------------------------------------------------------------------- As many of you know, Sanbase is a free-to-use platform for researching and studying on-chain and behavioral analytics in the crypto markets. However, there is a paid version called "Pro" that unlocks numerous features and models unavailable to our free users. Check out the [list of perks we offer to our Pro subscribers](https://app.santiment.net/pricing) and discover all the benefits that come with being an insider on our platform! One of these perks is access to our Sansheets plugin and the various templates we have built with it. This article will provide an overview of these templates. _In case you are already a Sanbase Pro subscriber and want to copy these templates for yourself, please [get in touch](https://academy.santiment.net/cdn-cgi/l/email-protection#6d1e181d1d021f192d1e0c0319040008031943030819) ._ [](https://academy.santiment.net/sansheets/pro-templates/#maximal-mean-dollar-age-template) Maximal Mean Dollar Age Template ---------------------------------------------------------------------------------------------------------------------------- This template visualizes the [Mean Dollar Age](https://insights.santiment.net/read/%F0%9F%93%A2-mean-age-653/) of Bitcoin, Ethereum, and various ERC20 coins in comparison to one another. Developed by Santiment, Mean Dollar Age calculates the average age of all dollars invested in acquiring a particular coin. This metric identifies accumulation and sell cycles for any coin, and identifying dips in Mean Dollar Age can serve as a novel bullish indicator. [](https://academy.santiment.net/sansheets/pro-templates/#top-holders-template) Top Holders Template ---------------------------------------------------------------------------------------------------- Crypto is still a whale's playground. [This template](https://insights.santiment.net/read/top-token-holders-and-their-role-as-leading-indicators-5618) monitors the behavior of the largest addresses holding Ethereum and various ERC-20 coins. The template includes a dozen views of top whales' behavior, such as balance changes, significant accumulation/sell-off events, and week-to-week adjustments to the total supply held. [](https://academy.santiment.net/sansheets/pro-templates/#nvt-template) NVT Template ------------------------------------------------------------------------------------ This template calculates the NVT for BTC, ETH, and several ERC-20 coins, and assigns a bullish or bearish value to their historical and present-day performance. The idea behind the NVT is simple - if the value transferred on the network (token circulation) is too low relative to the network's valuation (market cap), the asset should be considered overvalued and due for a correction. Conversely, if the value transferred on the network is too high compared to its current valuation, the NVT would deem the asset undervalued and ripe for a breakout. [](https://academy.santiment.net/sansheets/pro-templates/#price-daa-divergence-template) Price-DAA Divergence Template ---------------------------------------------------------------------------------------------------------------------- We [have found](https://insights.santiment.net/read/price---daily-addresses-divergence%3A-%0Aa-primer-on-on-chain-trading-strategies-2222) that major differences in the coin's price and network activity trends can present opportune times to buy OR sell, depending on the trend's direction. This template triggers BUY and SELL signals for Bitcoin and Ethereum based on major divergences in price and the amount of daily addresses interacting with the coin. [](https://academy.santiment.net/sansheets/pro-templates/#network-growth-daily-active-addresses-template) Network Growth & Daily Active Addresses Template ---------------------------------------------------------------------------------------------------------------------------------------------------------- This template compares the network growth and daily active address percentage changes of Bitcoin, Ethereum, and other projects over time. Generally, many projects create new addresses at a similar percentage rate to one another as markets ebb and flow. Identifying which projects are creating new addresses and growing their network at a faster rate than their price is an excellent strategy to find buy-low opportunities. [](https://academy.santiment.net/sansheets/pro-templates/#mvrv-and-mvrv-long-short-difference-ratio-template) MVRV and MVRV Long/Short Difference Ratio Template ---------------------------------------------------------------------------------------------------------------------------------------------------------------- The MVRV ratio is calculated by dividing the market cap (market value or MV) by the realized cap (total realized value or RV). This ratio provides a reliable estimate of how overvalued or undervalued the current market cap is. In addition, we offer the MVRV Long/Short Difference comparison in this template to help visualize which projects are above or below their average line of profitable traders. If the ratio is above 0%, then on average, Ethereum holders will profit if they sell their coins now. If it is below 0%, then the average holder will realize a loss if they sell. [](https://academy.santiment.net/sansheets/pro-templates/#velocity-vs-price-template) Velocity vs. Price Template ----------------------------------------------------------------------------------------------------------------- Velocity is an underutilized method for researching the speed at which money circulates in the crypto economy. It is calculated by dividing a token's transaction volume (in USD) by its market cap (in USD). Similar to the Daily Active Addresses Template, this model helps visualize when tokens are being overbought or oversold based on the historical trends of its velocity metric. [](https://academy.santiment.net/sansheets/pro-templates/#thresholds-crossed-template) Thresholds Crossed Template ------------------------------------------------------------------------------------------------------------------ Understanding how many times the price of a project has moved above or below a round number USD value, or a psychological barrier, can provide valuable insights into the cyclical nature of the cryptocurrency markets. Those who believe that crossing above a certain level means "it will never fall back below again" can be shown just how often prices have reset time and time again. This template is excellent for understanding support levels and identifying price points where there is a significant push and pull, along with psychological polarization among traders. Utilizing this information can be advantageous in your trading strategy. [](https://academy.santiment.net/sansheets/pro-templates/#most-profitable-days-for-trading-cryptocurrency) Most Profitable Days for Trading Cryptocurrency ---------------------------------------------------------------------------------------------------------------------------------------------------------- As [we've tested in the past](https://insights.santiment.net/read/backtesting-the-week%3A-which-days-are-best-for-trading-crypto%3F-1139) , knowing which days have the best historical ROI can help reduce risk and craft effective market strategies. This template determines the best trading days (historically) for any coin in the Santiment database, with adjustable time ranges for Pro users. [](https://academy.santiment.net/sansheets/pro-templates/#distribution-index) Distribution Index ------------------------------------------------------------------------------------------------ [Our research](https://insights.santiment.net/read/314) has shown that distributed coins (supply dispersed among many addresses) tend to outperform concentrated coins (much of circulating supply held by 'whales'). This index calculates the top 10 most distributed and most concentrated ERC-20 coins (within the top 50) over the last month. [](https://academy.santiment.net/sansheets/pro-templates/#eth-erc20-correlation-index) ETH-ERC20 Correlation Index ------------------------------------------------------------------------------------------------------------------ [Our previous analysis](https://medium.com/santiment/eth-vs-erc-20-a-tale-of-two-market-caps-94b2aca58e5e) indicates that ERC-20 coins tend to be less correlated to Ethereum during bull markets and exhibit higher correlation during bear markets. This index charts the correlation of the ERC-20 market cap to the ETH market cap over the last 3 months. [](https://academy.santiment.net/sansheets/pro-templates/#stablecoin-volatility-index) Stablecoin Volatility Index ------------------------------------------------------------------------------------------------------------------ Stablecoins may be more volatile than you think. This presents an interesting market opportunity, as one could potentially invest in low-volatility stablecoins and trade during outbreaks in their more volatile counterparts. This Santiment Index ranks the 15 largest stablecoins from most to least volatile over the past 30 days. [](https://academy.santiment.net/sansheets/pro-templates/#least-correlated-coins-to-btc-eth) Least Correlated Coins to BTC & ETH -------------------------------------------------------------------------------------------------------------------------------- According to our research, a portfolio of coins that are least correlated to both Bitcoin and Ethereum tends to perform particularly well during bull cycles. This index calculates the 20 least correlated coins to BTC & ETH over the past 30 days. Updated 2 years ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Functions We Offer | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources * [Go to Sansheets](https://sheets.santiment.net/) [](https://academy.santiment.net/sansheets/functions/#functions-we-offer) Functions We Offer ============================================================================================ [](https://academy.santiment.net/sansheets/functions/#content) Content ====================================================================== [](https://academy.santiment.net/sansheets/functions/#on-chain-data-functions) [On-Chain Data Functions](https://academy.santiment.net/sansheets/functions/onchain/) --------------------------------------------------------------------------------------------------------------------------------------------------------------------- [](https://academy.santiment.net/sansheets/functions/#social-data-functions) [Social Data Functions](https://academy.santiment.net/sansheets/functions/social/) ---------------------------------------------------------------------------------------------------------------------------------------------------------------- [](https://academy.santiment.net/sansheets/functions/#xrpl-related-data-functions) [XRPL-related Data Functions](https://academy.santiment.net/sansheets/functions/xrp/) ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- Updated 2 years ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # API Rate Limits | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources * [Go to Sanapi](https://api.santiment.net/) [](https://academy.santiment.net/sanapi/rate-limits/#api-rate-limits) API Rate Limits ===================================================================================== [](https://academy.santiment.net/sanapi/rate-limits/#overview) Overview ----------------------------------------------------------------------- Santiment API Rate Limiting is a mechanism that restricts the number of requests a user can make within a specific time frame. This limitation is crucial for maintaining stability and optimal performance for a large number of clients. 1. **Maintaining Service Stability and Performance:** API Rate Limits prevent a single entity from excessively using the API service, which could potentially degrade the performance for other users. 2. **Fair Resource Allocation:** API Rate Limits ensure a more equitable distribution of API resources among users. They prevent individual users or applications from monopolizing the available resources, ensuring that all users have equal access and opportunity to use the API services. 3. **Protection Against Malicious Activities:** API Rate Limits serve as a basic security measure to protect against malicious activities such as DoS (Denial of Service) attacks. By limiting the number of requests from a single source, Santiment can mitigate potential harm. [](https://academy.santiment.net/sanapi/rate-limits/#how-are-api-calls-counted) How are API calls counted? ---------------------------------------------------------------------------------------------------------- Each [GraphQL Query](https://academy.santiment.net/glossary/#query) is counted as one API call. One GraphQL request can contain any number of GraphQL queries inside of it. This means that one GraphQL request can count as multiple API calls. In most cases, a single GraphQL request will contain only one GraphQL query. Executing the following GraphQL request will count as 1 API calls: 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22active_addresses_24h%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22ethereum%22%0A%20%20%20%20%20%20from%3A%20%222019-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222019-01-01T03%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%2230m%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Executing the following GraphQL request will count as 2 API calls: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20activeAddresses%3A%20getMetric(metric%3A%20%22active_addresses_24h%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22ethereum%22%0A%20%20%20%20%20%20from%3A%20%222019-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222019-01-01T03%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%2230m%22%0A%20%20%20%20)%0A%20%20%7D%0A%0A%20%20transactionVolume%3A%20getMetric(metric%3A%20%22transaction_volume%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22ethereum%22%0A%20%20%20%20%20%20from%3A%20%222019-01-01T00%3A00%3A00Z%22%0A%20%20%20%20%20%20to%3A%20%222019-01-01T03%3A00%3A00Z%22%0A%20%20%20%20%20%20interval%3A%20%2230m%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** [](https://academy.santiment.net/sanapi/rate-limits/#how-are-rate-limits-applied-and-refreshed) How are rate limits applied and refreshed? ------------------------------------------------------------------------------------------------------------------------------------------ API Rate Limits are applied on a **per account** basis. This means that all API keys associated with a single account share the same limits. It's important to note that API keys used for testing or development purposes can impact the rate limits of the API key used for production. The rate limits vary based on the subscription plan. You can find the details for each plan in [this article](https://academy.santiment.net/products-and-plans/sanapi-plans/) . Rate limits are applied on a **per minute**, **per hour** and **per month** basis, with all dates and times set to the UTC timezone. The refreshment of these limits occurs **at the start of the next minute, hour, or month**. This means that regardless of when the subscription was created, the count of API calls will reset at the start of the next month, specifically at 00:00:00 UTC on the 1st of the month. [](https://academy.santiment.net/sanapi/rate-limits/#how-to-determine-if-you-are-being-rate-limited) How to Determine If You Are Being Rate Limited? ---------------------------------------------------------------------------------------------------------------------------------------------------- When the rate limit is reached, an error response with HTTP code 429 is returned. The content of the response body includes a human-readable format of the error and the remaining time until you can make another request. The remaining time, measured in seconds, is also provided as the value of the `x-ratelimit-reset` HTTP header. Several other HTTP headers provide information about the rate limits: The following three HTTP headers indicate the limits of your current subscription plan. These values remain constant from request to request and only change when your subscription plan changes: * `x-ratelimit-limit-month` * `x-ratelimit-limit-hour` * `x-ratelimit-limit-minute` The next three HTTP headers change from request to request and show the number of API calls remaining before you reach the limit of allowed API calls: * `x-ratelimit-remaining-month` * `x-ratelimit-remaining-hour` * `x-ratelimit-remaining-minute` [](https://academy.santiment.net/sanapi/rate-limits/#what-to-do-if-the-rate-limits-are-reached) What to do if the rate limits are reached? ------------------------------------------------------------------------------------------------------------------------------------------ Rate limits can be reached for various different reasons: * Excessive usage of the API during a development phase; * Programming error that consumes many API calls; * Unexpected usage peak; * Need for more API calls in the long term. In case of a temporary issue or error, you can go to you [Account page](https://app.santiment.net/account#api-keys) and press the `Reset`. The self-reset of API rate limits is available once per 90 days: ![](https://academy.santiment.net/sanapi/rate-limits/reset_api_rate_limits.png) Contact Santiment support if additional issues are encountered. In case the need for more API calls is long-term, please consider upgrading to a higher subscription plan. If the highest subscription plan does not cover your needs, contact Santiment support. **Read next: [Historical and Realtime data restrictions](https://academy.santiment.net/sanapi/historical-and-realtime-data-restrictions/) ** Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # API Access to Sanqueries | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/santiment-queries/api-access/#api-access-to-sanqueries) API Access to Sanqueries ================================================================================================================= [](https://academy.santiment.net/santiment-queries/api-access/#overview) Overview --------------------------------------------------------------------------------- Before you start, make sure you acquaint yourself with the Sanqueries product and the SQL queries you can write by reading the `Introduction`, `Exploration` and `Writing SQL Queries` articles that can be found on the [Sanqueries Oveview](https://academy.santiment.net/santiment-queries/introduction/) page. The [Santiment Queries Web Interface](https://app.santiment.net/queries) is only one of the ways to execute queries and access the data. For those who want to automate the process of executing queries, we provide access access via our GraphQL API. You can query the API endpoint directly or use our [python library](https://github.com/santiment/sanpy) . [](https://academy.santiment.net/santiment-queries/api-access/#when-to-use-it) When to use it? ---------------------------------------------------------------------------------------------- If the data needs to be consumed by another system, that system can use the API to compute an SQL query and get the results as a JSON object. A few examples of when the API can be used: * When the data needs to be consumed by another system at a regular interval (e.g. every hour). * When the same query needs to be executed multiple times with different arguments. * Any use case that requires automation is a good candidate for using the API. [](https://academy.santiment.net/santiment-queries/api-access/#how-to-use-the-web-interface-to-write-queries-for-the-api) How to use the Web interface to write queries for the API? ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ The web interface is a powerful tool for exploring the data, writing queries, observing the results in real-time or explore prebuilt dashboards. Even when the data is consumed only through the API, it is recommended to use the web interface to write the SQL queries. The web interface facilitates the process of writing queries by providing syntax highlighting, auto-completion and a preview of the result in real-time, speeding up the development and debugging process. When the query is ready, it can be copied and used in the API. [](https://academy.santiment.net/santiment-queries/api-access/#api-endpoint) API Endpoint ----------------------------------------------------------------------------------------- On the [API Overview](https://academy.santiment.net/sanapi/#overview/) page one can find information how to access the API. There are two ways to execute queries using the API: * Directly execute the `runRawSqlQuery` GraphQL query against the API graphql endpoint; * Use the [sanpy execute\_sql function](https://github.com/santiment/sanpy#execute-sql-queries-and-get-the-result) to execute an SQL query and get the result as a Pandas DataFrame. The python library itself also uses the API, but provides functions that hide the details of the API. ### [](https://academy.santiment.net/santiment-queries/api-access/#the-query) The query The query that is used in the examples bellow is the following: 1 2 3 4 5 6 7 8 9 10 11 12 This query fetches one value per day of the `nvt` metric for the last 7 days. The examples below show how to parameterize the query in order to provide some of the arguments separately, instead of hardcoding them. The following parameters are used: * `slug` - A string representing the slug of a project; * `metric` - A string representing the name of a metric; * `last_n_day` - An integer representing the number of days to be fetched. ### [](https://academy.santiment.net/santiment-queries/api-access/#direct-api-call) Direct API call The direct API calls can be made using any HTTP client in any programming language. What you need to do is send a POST request and put the query in the body. The query looks like this: 1 2 3 4 5 6 7 8 9 10 **[Run in GraphiQL Live Explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20runRawSqlQuery(%0A%20%20%20%20sqlQueryText%3A%20%22SELECT%5Cn%20%20%20%20get_metric_name(metric_id)%20AS%20metric%2C%5Cn%20%20%20%20get_asset_name(asset_id)%20AS%20asset%2C%5Cn%20%20%20%20dt%2C%5Cn%20%20%20%20argMax(value%2C%20computed_at)%20AS%20value%5Cn%20%20FROM%20daily_metrics_v2%5Cn%20%20WHERE%5Cn%20%20%20%20asset_id%20%3D%20get_asset_id(%7B%7Bslug%7D%7D)%20AND%5Cn%20%20%20%20metric_id%20%3D%20get_metric_id(%7B%7Bmetric%7D%7D)%20AND%5Cn%20%20%20%20dt%20%3E%3D%20now()%20-%20INTERVAL%20%7B%7Blast_n_days%7D%7D%20DAY%5Cn%20%20GROUP%20BY%20dt%2C%20metric_id%2C%20asset_id%5Cn%20%20ORDER%20BY%20dt%20ASC%22%2C%0A%20%20%20%20sqlQueryParameters%3A%20%22%7B%5C%22slug%5C%22%3A%20%5C%22bitcoin%5C%22%2C%20%5C%22last_n_days%5C%22%3A%207%2C%20%5C%22metric%5C%22%3A%20%5C%22nvt%5C%22%7D%22%0A%20%20)%7B%0A%20%20%20%20columns%0A%20%20%20%20columnTypes%0A%20%20%20%20rows%0A%20%20%7D%0A%7D%0A) ** > **Note**: In order to be able to run the query in the GraphiQL Explorer you need to login on [Sanbase](https://app.santiment.net/) > on the same browser. ### [](https://academy.santiment.net/santiment-queries/api-access/#curl) curl You can execute the query in your terminal via the following curl command: 1 2 3 4 5 > **Note**: If you have the `jq` tool installed, you can pipe the result into it to pretty print the result. #### [](https://academy.santiment.net/santiment-queries/api-access/#result-example) Result Example The result of both the direct API call and the curl command is a JSON. The dates and values will differ when you execute the query. 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 #### [](https://academy.santiment.net/santiment-queries/api-access/#api-request-arguments-definition) API request arguments definition The `runRawSqlQuery` accepts two arguments: * `sqlQueryText` - The SQL query to execute. The query must be a valid SQL query that can be executed against the Clickhouse database. The article [Writing SQL Queries](https://academy.santiment.net/santiment-queries/writing-sql-queries/) is a recommended read. The query allows for parametrization by using named parameters. Each parameter has a key and a value. The query contains the parameter name surrounded in double curly braces: `{{key}}`. * `sqlQueryParameters` - A stringified JSON object that contains the key-value pairs. When the SQL query is executed, the `{{key}}` templates are replaced with the corresponding values from the `sqlQueryParameters` map. #### [](https://academy.santiment.net/santiment-queries/api-access/#api-result-fields-interpretation) API result fields interpretation The result of the GraphQL query contains the result of the executed SQL query. The selected fields in this example are: `columns`, `columnTypes` and `rows`. The meaning of the fields is: * `columns` is a list of the column names in the result. The order of the columns is specified in the SQL query itself. The name of the column is the name of the column in the database table or the alias specified with the `AS` keyword. If an aggregation function is used, it is highly recommended to specify the alias for the column, otherwise the name of the column will be the expression itself. * `columnTypes` is a list of the types of the columns in the result. The order of the * types is the same as in the `columns` field. The types are the raw Clickhouse type. Example types are `UInt64`, `Date`, `Float64`, `DateTime`, `String`, etc. These type are mapped to JSON types as JSON has a limited number of types. All integer and float types are mapped to the JSON number type but with specified meaning (size, type and sign of the number). A lot of the other types are transpored as JSON string - `String`, `Date`, `DateTime` and others are JSON strings with specified meaning. * `rows` is a list of lists, each inner list is a row in the result. The order of the rows is the same as in the result of the SQL query. The order of the columns in the inner list is the same as in the `columns` field. ### [](https://academy.santiment.net/santiment-queries/api-access/#using-the-python-library) Using the Python library The [sanpy](https://github.com/santiment/sanpy) provides the `execute_sql` function, which interacts with the above described `runRawSqlQuery` API. The function accepts two named parameters - `query` and `parameters`, runs the query and returns the result as a Pandas DataFrame. #### [](https://academy.santiment.net/santiment-queries/api-access/#sanpy-request-example) sanpy request example To run the code: * Install sanpy with `pip install sanpy`. * Replace `YOUR_OWN_API_KEY` with your API key. 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 #### [](https://academy.santiment.net/santiment-queries/api-access/#sanpy-result-example) sanpy result example The result is a Pandas DataFrame: 1 2 3 4 5 6 7 8 #### [](https://academy.santiment.net/santiment-queries/api-access/#sanpy-request-parameters-definition) sanpy request parameters definition The `execute_sql` function accepts three named parameters - one mandatory and two optinal: * `query` - The meaning is the same as in the `runRawSqlQuery` API described. This parameter is mandatory/ * `parameters` - The meaning is the same as in the `runRawSqlQuery` API described above. The format here is a Python dictionary that automatically gets converted to a JSON string when executing the request. If the query does not have any parameters, this parameter can be omitted. * `set_index` - The name of the column to use as the index of the returned DataFrame. If not specified, the index will be a range of integers. This parameter is optional. #### [](https://academy.santiment.net/santiment-queries/api-access/#sanpy-result-parameters-definition) sanpy result parameters definition The `execute_sql` function returns a Pandas DataFrame with the result of the query. The name of each column is the name of the column in the database table or the alias specified with the `AS` keyword. If an aggregation function is used, it is highly recommended to specify the alias for the column, otherwise the name of the column will be the expression itself. Updated 9 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # XRPL Tables Overview | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/santiment-queries/xrpl-tables/#xrpl-tables-overview) XRPL Tables Overview ========================================================================================================== [](https://academy.santiment.net/santiment-queries/xrpl-tables/#list-of-tables) List of Tables ---------------------------------------------------------------------------------------------- All our tables that contain XRPL-related data have the string 'xrp' in their name. To find them yourself, run the following query: 1 The result will display the list of tables: 1 2 3 4 5 6 7 8 [](https://academy.santiment.net/santiment-queries/xrpl-tables/#exploration-of-the-tables) Exploration of the Tables -------------------------------------------------------------------------------------------------------------------- We can inspect the tables with the commands we learned in [Exploration](https://academy.santiment.net/santiment-queries/exploration/) . Below, we have listed all the XRPL tables with their columns and a brief description of each. [](https://academy.santiment.net/santiment-queries/xrpl-tables/#xrp-balances) xrp\_balances ------------------------------------------------------------------------------------------- Represents balance changes per address per currency. * **dt** (_DateTime_): The date and time of the balance change * **blockNumber** (_UInt64_): Unique identifier for the block in which the transaction was processed * **balance** (_Float64_): The balance of the asset in the account after the transaction was completed * **oldDt** (_Nullable(DateTime)_): The date and time of the previous balance change * **oldBlockNumber** (_Nullable(UInt64)_): The block number of the previous balance change * **oldBalance** (_Float64_): The previous balance in this currency for this address * **address** (_String_): The owner of the funds * **currency** (_String_): Type of currency used in the transaction * **issuer** (_Nullable(String)_): The issuer of the currency * **issuerCurrency** (_String_): The type of the issued currency * **addressType** (_String_): Enum(NORMAL | SPECIAL) - Indicates if the address is a valid XRPL address or a meta address used for metric purposes * **transactionIndex** (_UInt64_): Position of the transaction that caused the balance change inside the XRPL block * **transactionHash** (_String_): Hash value identifying the transaction that caused the balance change [](https://academy.santiment.net/santiment-queries/xrpl-tables/#xrp-dex-volume) xrp\_dex\_volume ------------------------------------------------------------------------------------------------ Represents trades on the XRPL DEX. * **dt** (_DateTime_): The time when the transaction occurred. * **blockNumber** (_UInt64_): Unique identifier for the block in which the transaction was processed. * **offerAddress** (_String_): The owner of the funds. * **makerAddress** (_String_): The address of the account that owns the Offer, resulting in a DEX trade. * **offerSequence** (_UInt32_): The sequence number of the Offer transaction that resulted in a DEX trade. * **takerPaysIssuerCurrency** (_String_): The currency type offered by the taker. * **takerPaysAmount** (_Float64_): The amount of currency offered by the taker. * **takerGetsIssuerCurrency** (_String_): The currency type received by the taker. * **takerGetsAmount** (_Float64_): The amount of currency received by the taker. * **transactionIndex** (_UInt64_): Position of the transaction that caused the balance change inside the XRPL block. * **transactionHash** (_String_): Hash value identifying the transaction that caused the balance change. * **xrpAmount** (_Nullable(Float64)_): The amount of the trade measured in XRP. [](https://academy.santiment.net/santiment-queries/xrpl-tables/#xrp-ripple-state) xrp\_ripple\_state ---------------------------------------------------------------------------------------------------- Represents creation and destruction or XRPL trustlines. * **sign** (_Int8_): Indicates the creation or deletion of a trustline. '1' denotes creation, and '-1' denotes deletion. * **dt** (_DateTime_): The date and time when the transaction occurred. * **blockNumber** (_UInt64_): A unique identifier for the block in which the transaction was processed. * **transactionIndex** (_UInt32_): The position of the transaction that caused the balance change inside the XRPL block. * **transactionHash** (_String_): The hash value identifying the transaction that caused the balance change. * **currency** (_String_): The type of currency used in the trustline. * **balance** (_Float64_): The accumulated balance. * **highLimitIssuer** (_String_): The issuer of the high account. * **highLimitBalance** (_Float64_): The balance of the high account. * **lowLimitIssuer** (_String_): The issuer of the low account. * **lowLimitBalance** (_Float64_): The balance of the low account. [](https://academy.santiment.net/santiment-queries/xrpl-tables/#sample-queries) Sample Queries ---------------------------------------------------------------------------------------------- ### [](https://academy.santiment.net/santiment-queries/xrpl-tables/#dex-volume-per-asset-pair-measured-in-xrp) DEX Volume per Asset Pair, Measured in XRP DEX volume for a specific asset pair, per day, measured in XRP. 1 2 3 4 5 6 7 8 9 Test in [Queries](https://queries.santiment.net/query/dex-volume-per-asset-pair-measured-in-xrp-422) * * * ### [](https://academy.santiment.net/santiment-queries/xrpl-tables/#dex-volume-per-asset-pair-measured-in-usd) DEX Volume per Asset Pair, Measured in USD DEX volume for a specific asset pair, per day, measured in USD. To achieve the result, we need to join the on-chain XRPL data with prices. 1 2 3 4 5 6 7 8 9 10 11 12 Test in [Queries](https://queries.santiment.net/query/dex-volume-per-asset-pair-measured-in-usd-423) Updated 1 year ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Writing SQL Queries | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/santiment-queries/writing-sql-queries/#writing-sql-queries) Writing SQL Queries ================================================================================================================ [](https://academy.santiment.net/santiment-queries/writing-sql-queries/#overview) Overview ------------------------------------------------------------------------------------------ This document introduces the reader to the basics of Clickhouse SQL and Santiment's datasets. The available datasets contain two types of data: * Precomputed metrics: These are calculated and stored using raw data and preprocessing, such as `mvrv_usd` or `daily_active_addresses`. * Raw data: This includes information like transfers, balances, labels, events, and more. [](https://academy.santiment.net/santiment-queries/writing-sql-queries/#clickhouse-overview) Clickhouse Overview ---------------------------------------------------------------------------------------------------------------- [Clickhouse](https://clickhouse.com/) is a true Column-Oriented Database Management System that excels in storing and working with metrics and crypto-related data due to its exceptional speed. Clickhouse SQL is similar to ANSI SQL with some unique features. It supports `SELECT`, `GROUP BY`, `JOIN`, `ORDER BY`, subqueries in `FROM`, `IN` operator and subqueries in `IN` operator, window functions, numerous aggregate functions (avg, max, min, last, first, etc.), scalar subqueries, and more. To achieve the highest possible performance, some features are not present: * No support for foreign keys, but they are simulated in some existing tables (holding pre-computed metrics mostly). For example, there is an `asset_id` column in the `intraday_metrics` table, and an `asset_metadata` table to which the `asset_id` refers. The lack of foreign key support means that the database cannot guarantee referential integrity, so it is enforced by application-level code. * No full-fledged transactions. The SQL Editor has read-only access, and Clickhouse is used mainly as append-only storage, so the lack of transactions does not cause any issues for this use case. Official [Clickhouse SQL Reference](https://clickhouse.com/docs/en/sql-reference/) Some important pages containing useful information: * [Syntax](https://clickhouse.com/docs/en/sql-reference/syntax/) * [SELECT Statements](https://clickhouse.com/docs/en/sql-reference/statements/select/) * [Functions](https://clickhouse.com/docs/en/sql-reference/functions/) * [Operators](https://clickhouse.com/docs/en/sql-reference/operators/) * [Aggregate Functions](https://clickhouse.com/docs/en/sql-reference/aggregate-functions/) [](https://academy.santiment.net/santiment-queries/writing-sql-queries/#the-final-keyword) The FINAL keyword ------------------------------------------------------------------------------------------------------------ > Note: This part is more technical There are some keywords that can often be seen in Clickhouse SQL but are not seen in other known SQL variants. These keywords are explained here. Values in Clickhouse tables are not updated directly. Instead, in case there is a need to modify an existing row, the [MergeTree Table Engine](https://clickhouse.com/docs/en/engines/table-engines/mergetree-family/mergetree/) is used. In order to update an existing row, a new row with the same primary key is inserted. At some unspecified point in time, Clickhouse will merge all rows with the same primary key into one. Until that merge happens, all rows will exist and will appear in selects. Example: There is one value per day for an asset-metric pair in the `daily_metrics_v2` table. The value is recomputed every hour and a new row with the same primary key but different `value` and `computed_at` is inserted. In order to read the data as if it is already merged, you need to add the `FINAL` keyword after the table name: 1 2 3 4 5 Test in [Queries](https://queries.santiment.net/query/final-example-408) This `FINAL` keyword is not free - it slightly reduces the performance. In case performance is seeked, the same goal can be achieved with standard SQL by using `GROUP BY` the primary key and aggregate functions. This approach has smaller performance penalty at the cost of code readability and maintainability. 1 2 3 4 5 6 Test in [Queries](https://queries.santiment.net/query/without-final-example-409) [](https://academy.santiment.net/santiment-queries/writing-sql-queries/#the-prewhere-clause) The PREWHERE Clause ---------------------------------------------------------------------------------------------------------------- In addition to the standard [WHERE](https://clickhouse.com/docs/en/sql-reference/statements/select/where) clause, Clickhouse also supports the [PREWHERE](https://clickhouse.com/docs/en/sql-reference/statements/select/prewhere/) clause. This optimization allows for more efficient filtering by initially reading only the columns necessary for executing the filtering expression. When the `FINAL` keyword is not used, the `WHERE` clause is automatically transformed into a `PREWHERE` clause. However, when the `FINAL` keyword is used, the `WHERE` clause does not automatically transform into a `PREWHERE` clause. This transformation in the latter case can lead to different results if columns that are not part of the primary key are used in the filtering. It is recommended not to use the `PREWHERE` clause unless you are certain of its implications and effects on your query. [](https://academy.santiment.net/santiment-queries/writing-sql-queries/#using-pre-computed-metrics) Using Pre-computed Metrics ------------------------------------------------------------------------------------------------------------------------------ We store pre-computed metrics in tables that are described on [this page](https://academy.santiment.net/santiment-queries/metric-tables/) . Let's use `daily_metrics_v2` table as an example. Here's a schema for this table: * `dt` - A `DateTime` field storing the corresponding date and time. * `asset_id` - An `UInt64` unique identifier for an asset. The data for that ID is stored in the `asset_metadata` table. * `metric_id` - An `UInt64` unique identifier for a metric. The data for that ID is stored in the `metric_metadata` table. * `value` - A `Float` column holding the metric's value for the given asset/metric pair. * `computed_at` - A `DateTime` column storing the date and time when the given row was computed. ### [](https://academy.santiment.net/santiment-queries/writing-sql-queries/#fetch-data-for-asset-bitcoin-and-metric-daily-active-addresses) Fetch data for asset bitcoin and metric **daily\_active\_addresses** The following example shows how to fetch rows for Bitcoin's `daily_active_addresses` metric: 1 2 3 4 5 6 7 Test in [Queries](https://queries.santiment.net/query/fetch-data-for-asset-bitcoin-and-metric-daily-active-addresses-410) 1 2 3 4 The query is lengthy and contains parts that will be often used in queries - the `asset_id` and `metric_id` filtering. For this reason, predefined functions can be used to simplify fetching those ids. 1 2 3 4 5 6 7 Test in [Queries](https://queries.santiment.net/query/predef-example-411) The result still contains the integer representation of the asset and metric. To convert the `asset_id` to the asset name and the `metric_id` to the metric name there are a few options: * Join the result with the `asset_metadata` and `metric_metadata` tables. This works, but is highly verbose. * Use [dictionaries](https://clickhouse.com/docs/en/sql-reference/dictionaries/external-dictionaries/external-dicts) that store these mappings and can be used without JOIN. 1 2 3 4 5 6 7 8 9 10 11 Test in [Queries](https://queries.santiment.net/query/dict-example-412) 1 2 3 4 As with the `asset_id` and `metric_id` filtering, there are functions that simplify the dictionary access as well. 1 2 3 4 5 6 7 8 9 10 11 Test in [Queries](https://queries.santiment.net/query/dict-example-with-func-413) To obtain the average value per month, aggregation and grouping must be used. When grouping, all columns not part of the `GROUP BY` must have an aggregation applied. In this case, as there is data for a single asset and a single metric, their corresponding id columns can be aggregated with `any` as all these values are the same. 1 2 3 4 5 6 7 8 9 10 11 12 Test in [Queries](https://queries.santiment.net/query/group-by-example-414) 1 2 3 4 5 6 7 8 9 10 11 12 13 14 ### [](https://academy.santiment.net/santiment-queries/writing-sql-queries/#using-precomputed-metrics-to-build-new-metrics) Using precomputed metrics to build new metrics [This section was moved here](https://academy.santiment.net/santiment-queries/metric-tables/#using-precomputed-metrics-to-build-new-metrics) [](https://academy.santiment.net/santiment-queries/writing-sql-queries/#using-raw-data) Using Raw Data ------------------------------------------------------------------------------------------------------ ### [](https://academy.santiment.net/santiment-queries/writing-sql-queries/#example-top-transfers) Example: Top Transfers Find the 5 biggest ETH transactions to the graveyard address 0x0000000000000000000000000000000000000000. > Note: Some tables are duplicated with different `ORDER BY` clauses. In the case of transfer tables, there are tables with the `_to` suffix. This indicates that the `to` address is at the front of the `ORDER BY` key. This table has better performance when only filtering by the `to` address. 1 2 3 4 5 6 7 8 9 Test in [Queries](https://queries.santiment.net/query/example-top-transfers-418) 1 2 3 4 5 6 7 ### [](https://academy.santiment.net/santiment-queries/writing-sql-queries/#example-for-address-balance) Example for address balance Select the UNI balance of address at the beginning of each month. For performance reasons the table has a non-intuitive design. The balances of an address are stored in a single field of type `AggregateFunction(groupArray, Tuple(DateTime, Float64))`. When the `groupArrayMerge` function is called on that field, it essentially turns into `Array` The [arrayJoin](https://clickhouse.com/docs/en/sql-reference/functions/array-join/) is a Clickhouse-specific function that is useful in many scenarios. Normal functions do not change a set of rows, but just change the values in each row (map). Aggregate functions compress a set of rows (fold or reduce). The arrayJoin function takes each row and generates a set of rows (unfold). In this scenario `arrayJoin` is used to unfold the array of tuples into rows where each row has a datetime and value. 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 Test in [Queries](https://queries.santiment.net/query/example-for-address-balance-419) Note that not every month has a balance. This is because during these months no transfers happened and balance records are produced only when the balance changes. 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 ### [](https://academy.santiment.net/santiment-queries/writing-sql-queries/#example-for-development-activity) Example for Development Activity The `github_v2` table contains [Github Events](https://docs.github.com/en/developers/webhooks-and-events/events/github-event-types) data. Using these events one can compute better development activity metrics compared to using just commits counts, as described in [this article](https://medium.com/santiment/tracking-github-activity-of-crypto-projects-introducing-a-better-approach-9fb1af3f1c32) To compute the development activity of an organization: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 Test in [Queries](https://queries.santiment.net/query/example-for-development-activity-420) 1 2 3 4 5 6 7 8 9 10 11 12 13 14 To count all the people that have contributed to the development activity of an organization in a given time period: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 Test in [Queries](https://queries.santiment.net/query/example-2-for-development-activity-421) 1 2 3 4 5 6 7 8 9 10 11 12 13 14 Updated 1 year ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Accessing the API | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources * [Go to Sanapi](https://api.santiment.net/) [](https://academy.santiment.net/sanapi/accessing-the-api/#accessing-the-api) Accessing the API =============================================================================================== * [Overview](https://academy.santiment.net/sanapi/accessing-the-api/#overview) * [Access the API](https://academy.santiment.net/sanapi/accessing-the-api/#access-the-api) * [GraphiQL API Explorer](https://academy.santiment.net/sanapi/accessing-the-api/#graphiql-api-explorer) * [Python library](https://academy.santiment.net/sanapi/accessing-the-api/#python-library) * [Programming language of your choice](https://academy.santiment.net/sanapi/accessing-the-api/#programming-language-of-your-choice) * [curl](https://academy.santiment.net/sanapi/accessing-the-api/#curl) * [Authentication](https://academy.santiment.net/sanapi/accessing-the-api/#authentication) * [GraphiQL API Explorer](https://academy.santiment.net/sanapi/accessing-the-api/#authentication-with-graphiql-explorer) * [curl](https://academy.santiment.net/sanapi/accessing-the-api/#authentication-with-curl) * [Errors](https://academy.santiment.net/sanapi/accessing-the-api/#errors) [](https://academy.santiment.net/sanapi/accessing-the-api/#overview) Overview ----------------------------------------------------------------------------- Santiment API utilizes [GraphQL](https://graphql.org/) . The reasons for choosing GraphQL over REST include: * It allows for precise data requests and easy batching of requests. This effectively addresses the problems of underfetching and overfetching data. For instance, why fetch all 20+ fields of a project when only its name is required? * The request outlines the format of the response. This eliminates the need to guess what data the result contains and how to parse it. * It provides an easy, ready-to-use method to explore our API via our Live Explorer. [](https://academy.santiment.net/sanapi/accessing-the-api/#access-the-api) Access the API ----------------------------------------------------------------------------------------- Please note that some metrics may not be freely available or may have restrictions, such as limited historical and real-time data. To explore these metrics without restrictions, use the slug `santiment`. There are several methods to retrieve data from Santiment's API: ### [](https://academy.santiment.net/sanapi/accessing-the-api/#graphiql-api-explorer) GraphiQL API Explorer The Graph**i**QL (graphical interactive in-browser GraphQL IDE) allows you to run queries directly from your browser. You can access the explorer at the following link: [https://api.santiment.net/graphiql](https://api.santiment.net/graphiql) . Here's an example of how to run a query and view the results directly in your browser: [GraphQL Request fetching transaction volume](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22transaction_volume%22)%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22santiment%22%0A%20%20%20%20%20%20from%3A%20%22utc_now-90d%22%0A%20%20%20%20%20%20to%3A%20%22utc_now-60d%22%0A%20%20%20%20%20%20interval%3A%20%221d%22)%0A%20%20%7D%0A%7D&variables=) ### [](https://academy.santiment.net/sanapi/accessing-the-api/#python-library) Python library Santiment offers a Python wrapper for the GraphQL API, known as `sanpy`. You can find the documentation and installation instructions for this library [here](https://github.com/santiment/sanpy) . You can install `sanpy` using `pip` with the following command: 1 To fetch Ethereum development activity data using this library, use the following code: 1 2 3 4 5 6 The result will be a pandas dataframe, as shown below: 1 2 3 4 5 6 7 ### [](https://academy.santiment.net/sanapi/accessing-the-api/#programming-language-of-your-choice) Programming language of your choice In the [san-sdk](https://github.com/santiment/san-sdk) repository, you can find examples of how to query the API using various programming languages. Here are some examples: * [R](https://github.com/santiment/san-sdk/tree/master/R-graphql) * [Ruby](https://github.com/santiment/san-sdk/blob/master/ruby-graphql/example.rb) * [Elixir](https://github.com/santiment/san-sdk/blob/master/elixir-graphql/san_graphql_ex/lib/san_graphql_ex.ex) ### [](https://academy.santiment.net/sanapi/accessing-the-api/#curl) curl The following GraphQL request will be executed with curl: 1 2 3 4 5 6 7 8 9 10 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20getMetric(metric%3A%20%22dev_activity%22)%20%7B%0A%20%20%20%20timeseriesDataJson(%0A%20%20%20%20%20%20slug%3A%20%22ethereum%22%0A%20%20%20%20%20%20from%3A%20%22utc_now-60d%22%0A%20%20%20%20%20%20to%3A%20%22utc_now-50d%22%0A%20%20%20%20%20%20interval%3A%20%221d%22%0A%20%20%20%20)%0A%20%20%7D%0A%7D) ** Copy and paste the following curl request into your console: 1 2 3 4 5 The response should look similar to this: 1 If you have the `jq` tool installed, you can use it to visualize the response more effectively: 1 2 3 4 5 6 The output should look like this: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 [](https://academy.santiment.net/sanapi/accessing-the-api/#authentication) Authentication ----------------------------------------------------------------------------------------- Certain APIs necessitate a valid API key, which must be linked to an account with a paid subscription to access additional data. You can generate your API key on your [Account Settings](https://app.santiment.net/account#api-keys) page. After generating your API key, you need to include it as an additional HTTP header in the format `Authorization: Apikey `. ### [](https://academy.santiment.net/sanapi/accessing-the-api/#authentication-with-graphiql-explorer) Authentication with GraphiQL Explorer Santiment also offers an advanced version of GraphiQL that is particularly useful!\[\] for API users: [https://api.santiment.net/graphiql\_advanced](https://api.santiment.net/graphiql_advanced) . This version allows users to add HTTP headers, which can be used to include an API key and authenticate your requests. To do this, simply add the following header: `Authorization: Apikey YOUR_OWN_API_KEY`. ![](https://academy.santiment.net/sanapi/accessing-the-api/graphiql_header.png) ### [](https://academy.santiment.net/sanapi/accessing-the-api/#authentication-with-curl) Authentication with curl Include the `Authorization: Apikey ` header using the `-H` option: 1 2 3 4 5 6 [](https://academy.santiment.net/sanapi/accessing-the-api/#errors) Errors ------------------------------------------------------------------------- GraphQL errors are returned with HTTP status code 200. To check for errors, you need to check for the presence of the `errors` key in the JSON response. If the query does not return a status code of `200`, it indicates a different issue. Here are some possibilities: * `429` - You're being rate-limited. Reduce the number of requests you're making. Check the [Rate limits](https://academy.santiment.net/sanapi/rate-limits/) page for more information. * `5xx` - An internal server error has occurred. Please let us know in the support channel on our [Discord server](https://santiment.net/discord) . ### [](https://academy.santiment.net/sanapi/accessing-the-api/#error-example-syntax-error) Error example - syntax error For instance, if an invalid query is passed to the API, the following will occur: 1 2 3 4 5 1 2 3 4 5 6 7 8 9 10 11 12 13 ### [](https://academy.santiment.net/sanapi/accessing-the-api/#error-example-missing-parameter) Error example - missing parameter If your query is missing an argument, the error response will describe this: 1 2 3 4 5 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 ### [](https://academy.santiment.net/sanapi/accessing-the-api/#error-example-historical-and-realtime-data-restriction) Error example - historical and realtime data restriction If the `from` and/or `to` parameters are outside of the allowed interval for the subscription plan and [Historical and Realtime data restrictions](https://academy.santiment.net/sanapi/historical-and-realtime-data-restrictions/) are applied, the error will look like this: 1 2 3 4 5 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 **Read next: [Fetching Metrics](https://academy.santiment.net/sanapi/fetching-metrics/) ** Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # How to Pay with Crypto | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/products-and-plans/how-to-pay-with-crypto/#how-to-pay-with-crypto) How to Pay with Crypto ========================================================================================================================== > **Note:** Payment in crypto is only available for yearly subscriptions, not for monthly ones. [](https://academy.santiment.net/products-and-plans/how-to-pay-with-crypto/#pay-with-eth-or-dai) Pay With ETH or DAI -------------------------------------------------------------------------------------------------------------------- When it comes to cryptocurrency tools and services, having convenient and alternative methods to exchange them outside of traditional fiat options is essential for working toward mass adoption. This is why we offer our users the ability to pay with different cryptocurrencies to conveniently exchange quickly and easily for access to our services. To make a payment with crypto, you can choose to use `Ethereum (ETH)`, `Dai (DAI)`, or other Ethereum-based stablecoins for any of our services. _To make use of your SAN tokens while also getting a hefty discount, please check [further below](https://academy.santiment.net/products-and-plans/how-to-pay-with-crypto/#burning-san-tokens-to-make-payments) ._ To make a payment with ETH or DAI, simply send either form of crypto to this address: **0x1F3dF0b8390BB8e9e322972C5e75583E87608Ec2** You can input: `pay.santiment.eth` in the send address as an alias to this respective payment address (see below screenshot). ![](https://academy.santiment.net/products-and-plans/how-to-pay-with-crypto/PaySan.jpg) For any assistance on making a payment, you can contact our team at [\[email protected\]](https://academy.santiment.net/cdn-cgi/l/email-protection#8dfef8fdfde2fff9cdfeece3f9e4e0e8e3f9a3e3e8f9) and it will auto-forward your conversation to our Intercom system for quick help. > **Note:** If you opt to pay with ETH or DAI, any service is available to pay with this method. [](https://academy.santiment.net/products-and-plans/how-to-pay-with-crypto/#burning-san-tokens-for-subscription-payments) Burning SAN Tokens for Subscription Payments ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- SAN token holders can utilize a token burning method to make use of their SAN holdings for subscription payments, instead of paying the regular way. If you're unfamiliar with token burning, it's the act of intentionally sending tokens to an invalid address to permanently remove them from the available circulating supply. Burning SAN tokens provides a substantial discount incentive for our users who choose to take advantage of this opportunity. It allows you to burn SAN tokens at a rate of twice the current market rate, which equates to a 50% discount compared to regular payments. Additionally, the total supply of SAN shrinks with every burn, benefiting all SAN holders. Please be aware of the following restrictions: > * Paying via SAN burn is limited to Sanbase subscriptions and is not available for SanAPI subscriptions. > * SAN burn is not available for residents of the Swiss Confederation due to tax regulations. > * SAN burn can only be applied to yearly base subscription prices. No other discounts are applicable when using SAN burn. Thank you for your understanding. If you are ready to burn SAN for a yearly Sanbase Pro subscription, please contact us at [\[email protected\]](https://academy.santiment.net/cdn-cgi/l/email-protection#5b282e2b2b34292f1b283a352f32363e352f75353e2f) and we will be happy to guide you through the process. [](https://academy.santiment.net/products-and-plans/how-to-pay-with-crypto/#providing-san-uniswap-liquidity) Providing SAN Uniswap Liquidity -------------------------------------------------------------------------------------------------------------------------------------------- Another way to gain Pro access to Sanbase is by providing liquidity for the SAN/ETH trading pair on Uniswap V2! As long as you provide 3000+ SAN to our Uniswap V2 pool (and the corresponding amount of ETH), you will receive FREE access to Sanbase Pro, including all our metrics, new templates, and daily market insights! You can add liquidity to the SAN<->ETH pool here: [https://app.uniswap.org/#/add/v2/ETH/0x7C5A0CE9267ED19B22F8cae653F198e3E8daf098](https://app.uniswap.org/#/add/v2/ETH/0x7C5A0CE9267ED19B22F8cae653F198e3E8daf098) . As soon as you hold the LP tokens in your wallet and connect it to your account or log in with it, you will automatically receive a Pro subscription within one hour. 💗 * [How to sign up/sign in with Metamask](https://academy.santiment.net/sanbase/logging-into-sanbase/#first-login-using-metamask) * [How to connect your wallet to an existing account](https://academy.santiment.net/san-tokens/how-to-stake-san/#connecting-a-wallet-to-an-already-existing-account) _Please make sure to do your own due diligence regarding the Uniswap protocol and the risks involved in providing liquidity. Santiment has no control over the Uniswap protocol and cannot be held accountable for any potential losses of any kind._ Updated 2 years ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Metrics Datasets | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/santiment-queries/metric-tables/#metrics-datasets) Metrics Datasets ==================================================================================================== [](https://academy.santiment.net/santiment-queries/metric-tables/#overview) Overview ------------------------------------------------------------------------------------ This document introduces Santiment's precomputed metrics datasets. You can filter all metric tables as: 1 Test in [Queries](https://queries.santiment.net/query/metrics-tables-example-494) Usually, tables storing pre-computed data have a common set of columns: * `dt` - A `DateTime` field storing the corresponding date and time. * `asset_id` - An `UInt64` unique identifier for an asset. The data for that ID is stored in the `asset_metadata` table. * `metric_id` - An `UInt64` unique identifier for a metric. The data for that ID is stored in the `metric_metadata` table. * `value` - A `Float` column holding the metric's value for the given asset/metric pair. * `computed_at` - A `DateTime` column storing the date and time when the given row was computed. Metrics are located in different tables, depending on some different parameters. All tables are similar to each other and described below. [](https://academy.santiment.net/santiment-queries/metric-tables/#tables) Tables -------------------------------------------------------------------------------- * * * ### [](https://academy.santiment.net/santiment-queries/metric-tables/#daily-metrics-v2) daily\_metrics\_v2 The `daily_metrics_v2` table stores a single metric value for each asset for each day. I.e. in that tables stored metrics that have exactly 1 value per day. Here's an example how to fetch `daily_active_addresses` for `bitcoin` using `daily_metrics_v2` 1 2 3 4 5 6 7 8 9 10 11 Test in [Queries](https://queries.santiment.net/query/dict-example-with-func-413) * * * ### [](https://academy.santiment.net/santiment-queries/metric-tables/#intraday-metrics) intraday\_metrics Table `intraday_metrics` is very similar to `daily_metrics_v2` but stores metrics with more than one value per day. In most cases, these metrics have a new value every 5 minutes. Here's an example how to get 5-minute prices for ethereum: 1 2 3 4 5 6 7 8 9 10 11 12 Test in [Queries](https://queries.santiment.net/query/price-example-478) * * * ### [](https://academy.santiment.net/santiment-queries/metric-tables/#labeled-intraday-metrics-v2) labeled\_intraday\_metrics\_v2 Table `labeled_intraday_metrics_v2` stores metrics for a given `blockchain` and `label_id`. Each `label_id` corresponds to a certain [label FQN.](https://academy.santiment.net/labels/label-fqn/) The data for that ID is stored in the `label_metadata` table. Blockchain column contains the string for blockchain name, e.g. `bictoin`, `ethereum`, etc. For instance, you can retrieve ethereum balance of all centralized exchange addresses with the query: 1 2 3 4 5 6 7 8 9 10 11 12 Test in [Queries](https://queries.santiment.net/query/cex-balance-example-479) * * * ### [](https://academy.santiment.net/santiment-queries/metric-tables/#daily-label-based-metrics) daily\_label\_based\_metrics Table `intraday_metrics` also has `label` and `owner` columns so that metrics stored in that table correspond to a particular label and owner. > Note that this table uses old way to filter labels (plain label/owner instead of label\_fqn). This table could be used to retrieve [labelled exchange](https://academy.santiment.net/metrics/labeled-exchange/) metrics under names: * `labelled_active_deposits` * `labelled_deposit_transactions` * `labelled_active_withdrawals` * `labelled_withdrawal_transactions` or NFT [trading volume](https://academy.santiment.net/metrics/nft-trade-volume-usd/) and [trades count](https://academy.santiment.net/metrics/nft-trades-count/) metrics. Here's an example to get Binance active deposits: 1 2 3 4 5 6 7 8 9 10 11 12 13 Test in [Queries](https://queries.santiment.net/query/labelled-active-deposits-example-481) * * * ### [](https://academy.santiment.net/santiment-queries/metric-tables/#ecosystem-aggregated-metrics) ecosystem\_aggregated\_metrics `ecosystem_aggregated_metrics` is a table similar to the `daily_metrics_v2` table. The only distinction is that it doesn't contain asset\_id column; instead, it includes the ecosystem column. This adjustment was made to accommodate the requirements for development and github activity metrics, allowing us to monitor the activity of the entire ecosystem. `ecosystem` is a string, you can get available ecosystems as: 1 2 3 Test in [Queries](https://queries.santiment.net/query/ecosystem-example-482) > In that table you can find dev activity metrics like > > * `ecosystem_github_activity` > * `ecosystem_dev_activity` > * `ecosystem_github_activity_contributors_count` > * `ecosystem_dev_activity_contributors_count`, etc. Here's an example how to get ecosystem\_github\_activity\_contributors\_count for ethereum: 1 2 3 4 5 6 7 8 9 10 11 Test in [Queries](https://queries.santiment.net/query/ecosystem-aggregated-metrics-example-483) * * * ### [](https://academy.santiment.net/santiment-queries/metric-tables/#intraday-nft-metrics) intraday\_nft\_metrics A table `intraday_nft_metrics` was created to store intraday nft metrics which are related to whole nft collection or to specific tokens within nft collection. Here's an example how to get floor price for boredapeyachtclub collection: 1 2 3 4 5 6 7 8 9 Test in [Queries](https://queries.santiment.net/query/intraday-nft-metrics-example-485) * * * [](https://academy.santiment.net/santiment-queries/metric-tables/#use-cases-and-other-tables) Use Cases and Other tables ------------------------------------------------------------------------------------------------------------------------ ### [](https://academy.santiment.net/santiment-queries/metric-tables/#metadata-tables) Metadata tables There are few metadata tables storing data about metrics, assets and label\_fqns: * `metric_metadata` stores metric name, ID, metric version, etc. * `asset_metadata` stores asset name, ID, decimals, contract\_addresses, ticker and slug, etc. * `label_metadata` stores label fqn, ID and other label related info. Using these table you can navigate through a wide range of Santiment datasets. For instance, you're able to find all price-related metrics with a simple query: 1 2 3 Test in [Queries](https://queries.santiment.net/query/price-related-metrics-example-488) Also you're able to find deciamals and contract addresses for a particular asset, e.g. uniswap: 1 2 3 1 2 3 ### [](https://academy.santiment.net/santiment-queries/metric-tables/#using-precomputed-metrics-to-build-new-metrics) Using precomputed metrics to build new metrics Not all metrics are build from the raw data only. Some of the metrics are computed by combining a set of pre-computed metrics. The MVRV is defined as the ratio between the Market Value and Realized Value. The total supply is part of the numerator and the denominator, so it can be eliminated. The result is that the numerator is just `price_usd` and the denominator is `realized_price_usd`. There are precomputed metrics for both, so we can use them to compute the MVRV (and that's how we do it for the official MVRV metric!). Depending on the load on the database, the query duration can vary. At the moment of writing this, running the query takes 0.13 seconds. In the query `anyIf` is used as there is filtering by `asset_id` and `metric_id`, so there is only one value per metric for each `dt`. The example after that discusses how to handle more complex `GROUP BY` clauses. 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 Test in [Queries](https://queries.santiment.net/query/usage-of-precomputed-metrics-example-415) 1 2 3 4 5 6 7 8 9 10 11 12 To return only some of the columns, the query can be provided as a FROM subquery. This does not induce any performence degradation. This example also shows how the [WITH Clause](https://clickhouse.com/docs/en/sql-reference/statements/select/with/) can be used to avoid string literals repetition. 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 Test in [Queries](https://queries.santiment.net/query/with-example-416) The next query demonstrates what needs to be done if there is a need to aggregate the datetime instead of getting a value for each `dt`: 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 Test in [Queries](https://queries.santiment.net/query/with-example-with-aggregated-dt-417) The following row needs some explanation: 1 This function call has three parameters: * `value` - This is the column that is returned * `dt` - This is the column that `max` is performed upon. Of all columns matching the filter, the one with the max `dt` is returned. * `metric_id=get_metric_id('price_usd')` - This a boolean expression. Look only at the rows for which the expression evaluates to true. If the `FINAL` keyword is not used, taking the row with biggest `computed_at` among those with the same `dt` can be achieved by using a tuple as a second argument: 1 Updated 1 year ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Access Plans | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/products-and-plans/access-plans/#access-plans) Access Plans ============================================================================================ Here are the access plans for the different Santiment products. [](https://academy.santiment.net/products-and-plans/access-plans/#sanbase-plans) Sanbase Plans ---------------------------------------------------------------------------------------------- Sanbase plans provide access to both [Sanbase](https://academy.santiment.net/sanbase/) and [Sansheets](https://academy.santiment.net/sansheets/) . To purchase a plan, visit the [Sanbase pricing page](https://app.santiment.net/pricing) . For a detailed description of the plans, check out our [Sanbase Access Plans](https://academy.santiment.net/products-and-plans/sanbase-plans/) page. [](https://academy.santiment.net/products-and-plans/access-plans/#sanapi) SanAPI -------------------------------------------------------------------------------- SanAPI plans provide access to the [API](https://academy.santiment.net/sanapi/) . To purchase a plan, visit the [SanAPI pricing page](https://api.santiment.net/#pricing) . For a detailed description of the available plans, check out our [SanAPI access plans](https://academy.santiment.net/products-and-plans/sanapi-plans/) page. Updated 2 years ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # NFT Tables Overview | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/santiment-queries/nft-tables/#nft-tables-overview) NFT Tables Overview ======================================================================================================= [](https://academy.santiment.net/santiment-queries/nft-tables/#overview) Overview --------------------------------------------------------------------------------- NFT stands for Non-Fungible Token, which is a digital asset that represents ownership of a unique item or piece of content, such as art, music, video, or tweets. NFTs differ from cryptocurrencies because each NFT is unique and cannot be exchanged one-to-one, while cryptocurrencies are interchangeable. NFTs are created using blockchain technology, which provides a secure and transparent record of ownership and transfer. This allows creators and owners to prove ownership, authenticity, and rarity, potentially increasing the value of their digital assets over time. In **Santiment Queries**, we collect data for all NFTs from exchanges on: ### [](https://academy.santiment.net/santiment-queries/nft-tables/#ethereum) Ethereum: * CryptoPunks * Foundation * LooksRare * OpenSea * Rarible * SuperRare ⚠️ The Polygon chain has been deprecated as of October 28th 2024 and is no longer supported. This information allows you to effortlessly track a specific NFT or an entire collection, as well as investigate past prices and owners. [](https://academy.santiment.net/santiment-queries/nft-tables/#list-of-nft-tables) List of NFT Tables ----------------------------------------------------------------------------------------------------- All our tables that contain NFT-related data have the string 'nft' in their name. To find them yourself, run the following query: 1 The result will display the NFT-related tables: 1 2 3 4 5 [](https://academy.santiment.net/santiment-queries/nft-tables/#exploring-the-tables) Exploring the Tables --------------------------------------------------------------------------------------------------------- We can inspect the tables using the commands we learned in [Exploration](https://academy.santiment.net/santiment-queries/exploration/) . Below, we have listed all the NFT tables with their columns, brief descriptions, and some example queries that you can use to explore the tables. ### [](https://academy.santiment.net/santiment-queries/nft-tables/#nft-trades) nft\_trades The `nft_trades` table is designed to store information about the NFT trades that we have collected. It has the following columns: * **dt** (_DateTime_): When the transaction happened. * **blockchain** (_String_): The blockchain on which the transaction occurred. * **tx\_hash** (_String_): Unique identifier generated when the transaction was executed. * **log\_index** (_UInt32_): Log index of the trade event. * **platform** (_String_): Name of the platform where trades occurred, such as OpenSea, CryptoPunks, etc. * **seller\_address** (_String_): Address of the seller. * **buyer\_address** (_String_): Address of the buyer. * **nft\_contract\_address** (_String_): Address of the NFT's collection. * **currency\_contract\_address** (_Nullable(String)_): Identifier of the currency used in the trade. It is empty if the native coin was used (Ether or Matic), otherwise, it is the address of the ERC20 token's smart contract. * **asset\_ref\_id** (_UInt64_): Reference ID of the currency contract that can be used to retrieve additional information about the asset from the `asset_metadata` table. * **token\_ids** (_Array(String)_): Array of NFT token IDs in hex that were exchanged in the trade. Usually, only one is exchanged. * **amount\_tokens** (_Array(String)_): Array of amounts, which describes how many tokens were transferred. * **nft\_contract\_type** (_UInt8_): Type of NFT contract, 0 - ERC721, 1 - ERC1155. Based on the signature of the transfer. * **amount** (_String_): The amount of the transaction in the asset used in it. * **complete** (_UInt8_): State of the transaction (1 means it is completed). * **computed\_at** (_DateTime_): The timestamp when the trade was inserted into the table. ### [](https://academy.santiment.net/santiment-queries/nft-tables/#nft-tokens-metadata) nft\_tokens\_ metadata The `nft_tokens_metadata` is a table designed to store information about NFT tokens. It has the following columns: * **blockchain** (_String_): Refers to the decentralized platform on which the NFT exists, e.g. Ethereum, Binance Smart Chain, etc. * **address** (_String_): Represents the unique public address of the NFT owner. * **token\_id** (_String_): Unique identifier assigned to each NFT in decimal, used to distinguish it from others. * **uri** (_Nullable(String)_): Uniform Resource Identifier, a link that directs to additional information or media related to the NFT. * **data** (_Nullable(String)_): Contains the NFT's metadata, such as its name, image, and any other relevant information in JSON format. * **created\_at** (_DateTime_): The date and time when the NFT was created. * **error** (_Nullable(String)_): Any error message associated with the NFT, such as a transaction failure, if applicable. This column is used to track and monitor any issues that arise in the NFT creation process. ### [](https://academy.santiment.net/santiment-queries/nft-tables/#intraday-nft-metrics) intraday\_nft\_metrics The `intraday_nft_metrics` is a table designed to store intraday metrics for NFT assets. The table has the following columns: * **asset\_id** (_UInt64_): ID of the currency used in value calculation (ETH or WETH). * **metric\_id** (_UInt64_): Unique identifier assigned to the specific metric being recorded. * **address** (_String_): Represents the address of the NFT collection. * **collection\_name** (_String_): The name of the NFT collection that the asset belongs to. * **token\_id** (_Nullable(UInt64)_): Unique identifier assigned to each NFT, used to distinguish it from others. * **dt** (_DateTime_): The date and time when the metric was recorded. * **value** (_Float64_): The value of the metric recorded at the specified `dt`. * **computed\_at** (_DateTime_): The timestamp when the trade was inserted into the table. This is used to track the accuracy of the metric calculation and to ensure that the most up-to-date information is available. There are currently 16 metrics we track: | ID | Name | Additional Information | | --- | --- | --- | | 1279 | nft\_collection\_min\_price | [more information](https://academy.santiment.net/metrics/nft-collection-price/#nft-collection-price) | | 1280 | nft\_collection\_max\_price | [more information](https://academy.santiment.net/metrics/nft-collection-price/#nft-collection-price) | | 1281 | nft\_collection\_avg\_price | [more information](https://academy.santiment.net/metrics/nft-collection-price/#nft-collection-price) | | 1282 | nft\_collection\_trades\_count | [more information](https://academy.santiment.net/metrics/nft-collection-price/#nft-collection-price) | | 1283 | nft\_collection\_min\_price\_usd | [more information](https://academy.santiment.net/metrics/nft-collection-price/#nft-collection-price) | | 1284 | nft\_collection\_max\_price\_usd | [more information](https://academy.santiment.net/metrics/nft-collection-price/#nft-collection-price) | | 1285 | nft\_collection\_avg\_price\_usd | [more information](https://academy.santiment.net/metrics/nft-collection-price/#nft-collection-price) | | 1288 | nft\_market\_volume | [more information](https://academy.santiment.net/metrics/nft-market-volume/) | | 1289 | nft\_market\_count | [more information](https://academy.santiment.net/metrics/nft-market-volume/) | | 1290 | nft\_collection\_holders\_balance | [more information](https://academy.santiment.net/metrics/nft-collection-holders-balance/) | | 1291 | nft\_network\_profit\_loss | [more information](https://academy.santiment.net/metrics/nft-network-profit-loss/) | | 1292 | nft\_network\_profit\_loss\_usd | [more information](https://academy.santiment.net/metrics/nft-network-profit-loss/) | | 1293 | nft\_collection\_profit\_loss | [more information](https://academy.santiment.net/metrics/nft-network-profit-loss/) | | 1294 | nft\_collection\_profit\_loss\_usd | [more information](https://academy.santiment.net/metrics/nft-network-profit-loss/) | [](https://academy.santiment.net/santiment-queries/nft-tables/#sample-queries) Sample Queries --------------------------------------------------------------------------------------------- ### [](https://academy.santiment.net/santiment-queries/nft-tables/#number-of-unique-nft-owners) Number of Unique NFT Owners Check the number of unique wallets that have owned an NFT in the last 7 days. 1 2 3 Test in [Queries](https://queries.santiment.net/query/number-of-unique-nft-owners-397) ### [](https://academy.santiment.net/santiment-queries/nft-tables/#unique-nft-platforms-ordered-by-sales) Unique NFT Platforms Ordered by Sales Check the platforms ordered by sales for the last 7 days: 1 2 3 4 5 6 7 Test in [Queries](https://queries.santiment.net/query/unique-nft-platforms-ordered-by-sales-398) . * * * ### [](https://academy.santiment.net/santiment-queries/nft-tables/#number-of-unique-sales-for-a-platform) Number of Unique Sales for a Platform To find the number of unique sales for a platform (in this case, 'opensea') for the last 5 months, split by month, use the following SQL query: 1 2 3 4 5 6 Test in [Queries](https://queries.santiment.net/query/number-of-unique-sales-for-a-platform-399) * * * ### [](https://academy.santiment.net/santiment-queries/nft-tables/#top-10-buyers-by-completed-purchases) Top 10 Buyers by Completed Purchases To find the top 10 buyers ordered by the count of completed purchases in the last 5 days, use the following query. To find the top 10 sellers, simply swap `buyer_address` with `seller_address`. 1 2 3 4 5 6 7 8 9 10 11 Test in [Queries](https://queries.santiment.net/query/top-10-buyers-by-completed-purchases-400) * * * ### [](https://academy.santiment.net/santiment-queries/nft-tables/#summed-amounts-of-assets-for-a-platform) Summed Amounts of Assets for a Platform Get the unique assets for the last 7 days for a single platform with summed amounts. You can get similar information for buyers and sellers by swapping the platform in the `WHERE` clause with buyer/seller. 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 Test in [Queries](https://queries.santiment.net/query/summed-amounts-of-assets-for-a-platform-401) * * * ### [](https://academy.santiment.net/santiment-queries/nft-tables/#collections-ranked-by-traded-tokens) Collections Ranked by Traded Tokens This query ranks collections based on the number of traded tokens in the collection for the last 5 days. 1 2 3 4 5 6 7 8 9 10 11 Test in [Queries](https://queries.santiment.net/query/collections-ranked-by-traded-tokens-402) * * * ### [](https://academy.santiment.net/santiment-queries/nft-tables/#collections-ranked-by-recorded-tokens) Collections Ranked by Recorded Tokens This query ranks collections based on the number of recorded tokens in each collection. 1 2 3 4 5 6 7 8 9 10 11 12 Test in [Queries](https://queries.santiment.net/query/collections-ranked-by-recorded-tokens-403) . * * * ### [](https://academy.santiment.net/santiment-queries/nft-tables/#retrieve-all-tokens-with-additional-information-for-an-address) Retrieve All Tokens with Additional Information for an Address To get all the tokens and their related information for a given address, use the following SQL query: 1 2 3 4 5 6 7 8 Test in [Queries](https://queries.santiment.net/query/retrieve-all-tokens-with-additional-information-for-an-address-404) . * * * ### [](https://academy.santiment.net/santiment-queries/nft-tables/#nft-trades-in-usd-for-an-address) NFT trades in USD for an address Recent NFT trades volume of an address with amount calculated in USD 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 Test in [Queries](https://queries.santiment.net/query/nft-trades-in-usd-for-an-address-405) Updated 1 year ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Centralized exchange | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/labels/centralized-exchange/#centralized-exchange) Centralized exchange ======================================================================================================== [](https://academy.santiment.net/labels/centralized-exchange/#description) Description -------------------------------------------------------------------------------------- The centralized exchange label is used to identify wallet addresses that belong to centralized cryptocurrency exchanges (e.g. Binance, Coinbase, etc). Centralzied exchanges (CEX) are operated by a central authority or entity that manages the exchange, executes trades, and stores users' digital assets. CEXs typically have a user-friendly interface and offer high liquidity, faster transaction processing, and a wide range of trading pairs. [](https://academy.santiment.net/labels/centralized-exchange/#label-fqn) [Label fqn](https://academy.santiment.net/labels/label-fqn/) -------------------------------------------------------------------------------------------------------------------------------------- `santiment/centralized_exchange:v1` [](https://academy.santiment.net/labels/centralized-exchange/#limitations) Limitations -------------------------------------------------------------------------------------- Please note that there's no way to know whether you collected ALL addresses of the particular exchange. Although we constantly working on adding new labels it's safe to assume there are still exchange addresses we did not label yet. [](https://academy.santiment.net/labels/centralized-exchange/#label-examples) Label Examples -------------------------------------------------------------------------------------------- Binance centralized exchange address: [0x28c6c06298d514db089934071355e5743bf21d60](https://etherscan.io/address/0x28c6c06298d514db089934071355e5743bf21d60) Huobi centralized exchange address: [0x5c985e89dde482efe97ea9f1950ad149eb73829b](https://etherscan.io/address/0x5c985e89dde482efe97ea9f1950ad149eb73829b) [](https://academy.santiment.net/labels/centralized-exchange/#available-blockchains) Available Blockchains ---------------------------------------------------------------------------------------------------------- * bitcoin * ethereum [](https://academy.santiment.net/labels/centralized-exchange/#see-also) See Also -------------------------------------------------------------------------------- **List of centralized exchanges we label addresses for:** 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 Updated 9 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # How to Create an API Key | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/products-and-plans/create-an-api-key/#how-to-create-an-api-key) How to Create an API Key ========================================================================================================================= All of our current products use the [Sanbase](https://app.santiment.net/) account as reference. You cannot use Sanbase as a login option for the API or for Sansheets. This is where an API key comes in. When you create a Sanbase account, you have the ability to generate an API key that carries the same access rights for use with our other products. The access rights assigned to this key depend on your subscription plan. [](https://academy.santiment.net/products-and-plans/create-an-api-key/#creating-an-api-key) Creating an API Key --------------------------------------------------------------------------------------------------------------- To create an API key, visit the account settings of [Sanbase](https://app.santiment.net/account) , [SanAPI](https://api.santiment.net/account) , or [Sansheets](https://sheets.santiment.net/account) . In the account settings, click on the **`Generate`** button to create a new key. ![generate apikey button](https://academy.santiment.net/products-and-plans/create-an-api-key/generate-apikey-button.png) The key will be displayed as a string. You can copy it and use it wherever needed. ![revoke apikey button](https://academy.santiment.net/products-and-plans/create-an-api-key/revoke-apikey-button.png) You can revoke the key at any time from the same location. [](https://academy.santiment.net/products-and-plans/create-an-api-key/#using-an-api-key) Using an API Key --------------------------------------------------------------------------------------------------------- The [Authentication Section](https://academy.santiment.net/sanapi#authentication) demonstrates how to include an API key in your requests. Updated 2 years ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Current products of Santiment | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/products-and-plans/santiment-products/#current-products-of-santiment) Current products of Santiment ==================================================================================================================================== [](https://academy.santiment.net/products-and-plans/santiment-products/#sanbase) Sanbase ---------------------------------------------------------------------------------------- Sanbase is our primary blockchain-enabled web app, also accessible on mobile devices. It offers financial, development, on-chain, and social/sentiment data for the overall cryptocurrency market and over 1500 crypto assets across an expanding number of blockchains. A significant portion of the data is available anonymously and free of charge. Gain access to more in-depth features by simply logging in with your email. [https://app.santiment.net](https://app.santiment.net/) ![](https://academy.santiment.net/products-and-plans/santiment-products/sanbase.png) [](https://academy.santiment.net/products-and-plans/santiment-products/#sanapi) SanAPI -------------------------------------------------------------------------------------- SanAPI is the GraphQL API that powers Sanbase. Along with the API, we provide a Python library called [Sanpy](https://github.com/santiment/sanpy) , which offers easy access to the data for data scientists proficient in Python. [https://api.santiment.net](https://api.santiment.net/) ![](https://academy.santiment.net/products-and-plans/santiment-products/neuro.png) [](https://academy.santiment.net/products-and-plans/santiment-products/#sansheets) Sansheets -------------------------------------------------------------------------------------------- Sansheets is a Google Sheets plugin that provides access to our data using simple functions directly within your spreadsheet. [https://sheets.santiment.net/](https://sheets.santiment.net/) ![](https://academy.santiment.net/products-and-plans/santiment-products/sheets.png) ![](https://academy.santiment.net/products-and-plans/santiment-products/sheets2.png) Updated 2 years ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Sanbase PRO Features | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/products-and-plans/sanbase-pro-features/#sanbase-pro-features) Sanbase PRO Features ==================================================================================================================== Our crypto behavior analysis & monitoring platform is packed with custom tools and features to give you context and remove noise from the crypto markets. Here’s a rundown of everything you now have access to with Sanbase Pro: [](https://academy.santiment.net/products-and-plans/sanbase-pro-features/#full-historical-and-present-day-data-for-all-sanbase-metrics) Full Historical and Present-Day Data for All Sanbase Metrics ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- Here are a few examples of how to use our metrics: * [6 Different Ways](https://insights.santiment.net/read/6-ways-you-could-have-caught-ren%E2%80%99s-summer-tops-643) to use Sanbase to spot forming tops * [Using Token Age Consumed](https://insights.santiment.net/read/btc-%22coin-days-destroyed%22-spiked.-volatility-is-coming.-672) to predict volatility cycles * [Identifying Trend Reversals](https://insights.santiment.net/read/chainlink-hits-ath-following-coinbase-listing---perhaps-it's-time-to-chill-541) with a combination of on-chain and social indicators [](https://academy.santiment.net/products-and-plans/sanbase-pro-features/#access-to-our-private-sanbase-pro-discord-channel) Access to our private #sanbase-pro Discord channel ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- With Sanbase Pro, you also get access to our private Discord channel on the Santiment server, known as #sanbase-pro. This exclusive channel is for our paid members, where you can engage in discussions about the current state of the markets and the direction of our data with both our staff and top-tier traders who use our platform! Discussions include: * In-depth analysis of Santiment's key leading indicators, and whether they're pointing to buy, hold, or sell opportunities * Assistance with any aspect of the platform that is causing you trouble * Improvement suggestions for our staff, and how we can create a better experience for you as a VIP member of Santiment's community Enjoy discussing anything and everything beyond just the more generic content found in our #general channel on the Discord server. You'll be amazed by the high-level discussions we have there, and the insights uncovered from our most valued members! [](https://academy.santiment.net/products-and-plans/sanbase-pro-features/#exclusive-market-insights-with-sanbase-pro) Exclusive Market Insights with Sanbase Pro ---------------------------------------------------------------------------------------------------------------------------------------------------------------- Sanbase Pro grants you access to special market reports and daily analysis produced by the Santiment team. Pro Insights include: * Actionable market calls based on our in-house signals and indicators * Daily briefs on the behavior of whales, miners, traders, and other market stakeholders * Timely analysis of short-term market trends and top coins to watch Each Santiment Insight doubles as a crash course on exactly how to use on-chain, social, and development data to clarify the crypto markets and its biggest driving forces. Learn it today, apply it tomorrow. [](https://academy.santiment.net/products-and-plans/sanbase-pro-features/#full-access-to-sansheets) Full Access to Sansheets ---------------------------------------------------------------------------------------------------------------------------- Our plugin allows you to import Santiment data directly into Google Spreadsheets. To help you get started, we've provided a few pre-made Sansheets templates: * [Determine the most profitable trading days](https://docs.google.com/spreadsheets/d/1RD9AMy2hLWPix0DCupl-LaN5aloFkd_BQDvzJrgU0qI/edit?usp=sharing) for any coin * [Analyze any coin's risk-adjusted returns](https://docs.google.com/spreadsheets/d/1mHLRlP2H3hFvomO1fVDlxdmpWWZcQcUx-eT6WUDMgqs/edit?usp=sharing) (Sharpe and Sortino ratios) * [Backtest a 'moving average' strategy](https://docs.google.com/spreadsheets/d/1YEm8qdqJvkHCTUwEmOyQLfkZqtQ0ndwo0GWxGsCRnSQ/edit?usp=sharing) for any coin * Set up a [dynamic portfolio manager](https://docs.google.com/spreadsheets/d/1itY_q3KvC-KhOpY21wtmeAj5lL4qT8gbMvilgt8avZw/edit?usp=sharing) * [Track the NVT](https://docs.google.com/spreadsheets/d/1Sb8SjyvJYdRTvxZZtFRfLnLrEssF6Uq2feCmK8VSgF8/view) of any coin [](https://academy.santiment.net/products-and-plans/sanbase-pro-features/#unlimited-number-of-signals) Unlimited number of Signals ---------------------------------------------------------------------------------------------------------------------------------- and Access to All Future Signals Added to Sanbase (Coming Soon!) Here are a few pre-made Signals to get you started: * [15% spike in daily addresses transferring ETH](https://app.santiment.net/sonar/signal/789?title=Ethereum%20daily%20active%20addresses%20up%2015%25%20compared%20to%201%20day%28s%29%20earlier) (signaling elevated on-chain activity) * [5%+ dip in BTC’s price in 24 hours](https://app.santiment.net/sonar/signal/790?title=Bitcoin%20price%20goes%20down%205%25%20compared%20to%201%20day%28s%29%20earlier) (triggered at several bottoms in past 3 months) * [Chainlink’s (LINK) appearance on our daily Emerging Trends](https://app.santiment.net/sonar/signal/787?title=ChainLink%20in%20trending%20assets%2Fprojects) (indicating a potential top) * [Price/volume divergence for XMR](https://app.santiment.net/sonar/signal/788?title=Price%2Fvolume%20difference%20between%20an%20Monero%20price%20and%20trading%20volume) (previously triggered at Monero’s 1-year high) [](https://academy.santiment.net/products-and-plans/sanbase-pro-features/#weekly-performance-analytics-for-all-your-sanbase-watchlists) Weekly Performance Analytics for All Your Sanbase Watchlists ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- To activate them, click on "Weekly Report" in the upper right corner of your Watchlist's page. [](https://academy.santiment.net/products-and-plans/sanbase-pro-features/#special-end-of-month-reports-from-the-santiment-team) Special End-of-Month Reports from the Santiment Team ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ We cover the most important findings from our data and metrics. * * * If you have any questions, please let us know as soon as possible. [Join our Discord](https://santiment.net/discord) for even faster assistance! A message from Maksim Balashevich, our founder: > Excited to have you onboard - together we are crossing the sea from a centralized to a decentralized world, from uncertainty to clarity, from too much noise to "I get only what I need when I need it." > > This is a pretty long way to get to the final destination. But as is the case with every big journey, it starts with the first step. I’m excited we get to walk it together. Updated 3 years ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Connect a Wallet to Your Sanbase Account | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/san-tokens/connect-a-wallet-to-the-sanbase-account/#connect-a-wallet-to-your-sanbase-account) Connect a Wallet to Your Sanbase Account ======================================================================================================================================================================= 📌 This article describes how to stake SAN tokens that are already in your possession. Please refer to [this article](https://academy.santiment.net/san-tokens/how-to-buy-san-tokens/) to learn how to buy SAN tokens in the first place. There are two ways to connect an Ethereum address to a Sanbase account. You can use MetaMask as a first login (and add an email address later) or add it to an existing account. [](https://academy.santiment.net/san-tokens/connect-a-wallet-to-the-sanbase-account/#logging-into-sanbase-using-metamask) Logging into Sanbase using MetaMask ------------------------------------------------------------------------------------------------------------------------------------------------------------- This procedure is described in the article [Logging into Sanbase](https://academy.santiment.net/sanbase/logging-into-sanbase/) . Please refer to this resource as needed. [](https://academy.santiment.net/san-tokens/connect-a-wallet-to-the-sanbase-account/#connecting-a-wallet-to-an-existing-account) Connecting a Wallet to an Existing Account --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- After logging into Sanbase using your email address, open the account settings. These settings can be found in the upper right corner by hovering over your account icon: ![noborder](https://academy.santiment.net/san-tokens/connect-a-wallet-to-the-sanbase-account/41_account_settings_v4.png) In account settings, you will find the following option. Click it: ![noborder](https://academy.santiment.net/san-tokens/connect-a-wallet-to-the-sanbase-account/44_connect_wallet_with_mm_v2.png) If your MetaMask plugin is not logged in yet, please do so now as prompted. ⚠️ Please note that MetaMask can create a local wallet within the browser, import a wallet in multiple ways, or be connected to a hardware wallet like the Ledger Nano S. Make sure your tokens are safe! Please confirm the following steps to let Sanbase connect to MetaMask (and the selected wallet): ![noborder](https://academy.santiment.net/san-tokens/connect-a-wallet-to-the-sanbase-account/45_v2.png) You will now be asked to sign a message with your private key. Please note that this is not a transaction, no tokens are sent, and no changes are made to the blockchain. This step simply proves that the connected account is in your control, and hereby belongs to you. ![noborder](https://academy.santiment.net/san-tokens/connect-a-wallet-to-the-sanbase-account/46_connect_wallet_with_mm_sign_v2.png) After confirmation, you will see your address and SAN token balance in the account settings. ⚠️ Staking currently means that you are holding a certain number of tokens at an ETH address that Sanbase can check each time you visit. This is a lot like maintaining a minimum balance in a bank account. In the future, we plan to implement a more advanced staking mechanism. [](https://academy.santiment.net/san-tokens/connect-a-wallet-to-the-sanbase-account/#what-s-next) What's Next? -------------------------------------------------------------------------------------------------------------- Congratulations! You can now enjoy all the benefits provided to users holding SAN Tokens. ###### Here are a few articles you might be interested in: 💎 [SAN Tokens Holding Benefits](https://academy.santiment.net/san-tokens/san-tokens-holding-benefits/) 💰 [How to Buy SAN Tokens](https://academy.santiment.net/san-tokens/how-to-buy-san-tokens/) Updated 2 years ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Benefits of Holding SAN Tokens | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/san-tokens/san-tokens-holding-benefits/#benefits-of-holding-san-tokens) Benefits of Holding SAN Tokens ======================================================================================================================================= There are several benefits for our SAN token holders: * Sanbase Subscription Discount * Sanbase Payment with SAN Tokens * Sanbase Subscription in exchange for providing liquidity in the SAN/ETH Liquidity Pool on Uniswap [](https://academy.santiment.net/san-tokens/san-tokens-holding-benefits/#use-san-tokens-for-discounts) Use SAN Tokens for Discounts ----------------------------------------------------------------------------------------------------------------------------------- > 💡 You can now use SAN tokens for a discount. 👉 Holding more than 1,000 SAN tokens provides a 20% discount on all our plans. This discount will be automatically applied to your account if you log in with your crypto wallet or connect your wallet to your existing account. ![noborder](https://academy.santiment.net/san-tokens/san-tokens-holding-benefits/sanpricing_v3.png) [](https://academy.santiment.net/san-tokens/san-tokens-holding-benefits/#sanbase-payment-with-san-tokens) Sanbase Payment with SAN Tokens ----------------------------------------------------------------------------------------------------------------------------------------- You can burn your SAN Tokens to pay for a Sanbase subscription at 50% off the normal price. Once you burn your SAN tokens, we will credit your Sanbase account at a rate of twice the current market value. You can use your credits to pay for any available Sanbase plans. 📌 **Example:** If you burn 1000 SANs with an estimated value of $114.50 USD, we will credit your account with $229 USD in credit. If you're unfamiliar with what burning entails, it's simply the act of intentionally sending tokens to an invalid address to permanently remove them from the available circulating supply. You can pay for your subscription plan partially by using credits from SAN burning, and pay the remainder in USD. 👋 If you are ready to burn SAN for a yearly Sanbase Pro subscription, please let us know at [\[email protected\]](https://academy.santiment.net/cdn-cgi/l/email-protection#2f5c5a5f5f405d5b6f5c4e415b46424a415b01414a5b) and we will be happy to walk you through the process. [](https://academy.santiment.net/san-tokens/san-tokens-holding-benefits/#sanbase-access-for-providing-san-uniswap-liquidity) Sanbase Access for Providing SAN Uniswap Liquidity ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- By providing 3,000+ SAN to our Uniswap V2 pools (and the corresponding amount of ETH), you get FREE access to Sanbase Pro, including all our metrics, new templates, and daily market insights! ![noborder](https://academy.santiment.net/san-tokens/san-tokens-holding-benefits/liquidity.png) You can add liquidity to the SAN<->ETH pool here: [https://app.uniswap.org/#/add/v2/ETH/0x7C5A0CE9267ED19B22F8cae653F198e3E8daf098](https://app.uniswap.org/#/add/v2/ETH/0x7C5A0CE9267ED19B22F8cae653F198e3E8daf098) As soon as you hold the LP tokens in your wallet and connect it to your account or login with it, you will automatically receive a Pro subscription within one hour. 💗 ⚠️ Please make sure to do your own due diligence regarding the Uniswap protocol and understand the risks involved in providing liquidity. Santiment has no control over the Uniswap protocol and cannot be held accountable for any potential losses of any kind. Updated 2 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Asset | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/glossary/asset/#asset) Asset ============================================================= An **asset** refers to any cryptocurrency or crypto token that can be associated with a price. Examples of assets include Bitcoin, Ethereum, and Santiment. The terms 'asset' and 'project' are often used interchangeably in most contexts. [](https://academy.santiment.net/glossary/asset/#availability) Availability --------------------------------------------------------------------------- There are several methods to determine which assets are supported by the products within the Santiment platform. ### [](https://academy.santiment.net/glossary/asset/#sanpy) [Sanpy](https://github.com/santiment/sanpy) To use Sanpy, you need to import the `san` module. After importing the module, you can use the `get` method to retrieve data. Here's how you can do it: 1 2 ### [](https://academy.santiment.net/glossary/asset/#sanapi) [SanAPI](https://api.santiment.net/) The GraphQL request below retrieves a list of all assets: 1 2 3 4 5 6 **[Run in explorer](https://api.santiment.net/graphiql?query=%7B%0A%20%20allProjects%20%7B%0A%20%20%20%20name%0A%20%20%20%20slug%0A%20%20%7D%0A%7D) ** You can execute this query using `curl` as shown below: 1 2 3 4 5 ### [](https://academy.santiment.net/glossary/asset/#sansheets) [Sansheets](https://sheets.santiment.net/) After installing the plugin, you can utilize the `=SAN_ALL_PROJECTS()` function to retrieve a comprehensive list of all projects. Updated 6 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Youtube tutorials | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources * [Go to Youtube channel](https://www.youtube.com/c/santimentnetwork) [](https://academy.santiment.net/youtube-videos/tutorials/#youtube-tutorials) Youtube tutorials =============================================================================================== [](https://academy.santiment.net/youtube-videos/tutorials/#how-to-create-a-watchlist) How to create a Watchlist --------------------------------------------------------------------------------------------------------------- [](https://academy.santiment.net/youtube-videos/tutorials/#how-to-create-an-alert) How to create an Alert --------------------------------------------------------------------------------------------------------- [](https://academy.santiment.net/youtube-videos/tutorials/#tracking-the-social-trends) Tracking the Social Trends ----------------------------------------------------------------------------------------------------------------- [](https://academy.santiment.net/youtube-videos/tutorials/#santiment-screener) Santiment Screener ------------------------------------------------------------------------------------------------- [](https://academy.santiment.net/youtube-videos/tutorials/#combine-any-metrics-to-take-fundamental-analysis-to-the-next-level-charts) Combine any metrics to take fundamental analysis to the next level **Charts** ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- Updated 2 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Youtube webinars | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources * [Go to Youtube channel](https://www.youtube.com/c/santimentnetwork) [](https://academy.santiment.net/youtube-videos/webinars/#youtube-webinars) Youtube webinars ============================================================================================ [](https://academy.santiment.net/youtube-videos/webinars/#6-ways-you-could-have-caught-ren-s-summer-tops) 6 ways you could have caught REN’s summer tops -------------------------------------------------------------------------------------------------------------------------------------------------------- [](https://academy.santiment.net/youtube-videos/webinars/#top-on-chain-valuation-metrics-and-how-to-use-them-public-webinar) Top on-chain 'valuation' metrics and how to use them (Public Webinar) -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- [](https://academy.santiment.net/youtube-videos/webinars/#how-to-analyze-crowd-sentiment-with-sanbase-public-webinar) How to analyze crowd sentiment with Sanbase (Public Webinar) ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- [](https://academy.santiment.net/youtube-videos/webinars/#how-to-analyze-whale-behavior-with-sanbase-public-webinar) How to analyze 'whale' behavior with Sanbase (Public Webinar) ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- [](https://academy.santiment.net/youtube-videos/webinars/#how-to-analyze-whale-behavior-with-sanbase-pro-webinar) How to analyze 'whale' behavior with Sanbase (Pro Webinar) ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- [](https://academy.santiment.net/youtube-videos/webinars/#sansheets-webinar-using-santiment-api-for-price-prediction-models) Sansheets Webinar - Using Santiment API for Price Prediction Models ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ [](https://academy.santiment.net/youtube-videos/webinars/#how-to-analyze-speculative-demand-with-sanbase-pro-webinar) How to Analyze Speculative Demand with Sanbase (Pro Webinar) ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- Updated 2 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) --- # Derivatives Label | Santiment Academy ### Getting started * * [Santiment Introduction](https://academy.santiment.net/santiment-introduction/) * [For Traders](https://academy.santiment.net/for-traders/) * [For Developers](https://academy.santiment.net/for-developers/) ### Guides ### Resources [](https://academy.santiment.net/labels/derivatives/#derivatives-label) Derivatives Label ========================================================================================= [](https://academy.santiment.net/labels/derivatives/#description) Description ----------------------------------------------------------------------------- Label used for addresses that are used in derivatives projects. Crypto derivatives function similarly to traditional derivatives, where a buyer and a seller engage in a contractual agreement to trade an underlying asset. These assets are sold at a prearranged time and price. [](https://academy.santiment.net/labels/derivatives/#label-fqn) [Label fqn](https://academy.santiment.net/labels/label-fqn/) ----------------------------------------------------------------------------------------------------------------------------- `santiment/derivatives:v1` [](https://academy.santiment.net/labels/derivatives/#label-examples) Label Examples ----------------------------------------------------------------------------------- Synthetix Exchange State [0x545973f28950f50fc6c7f52aab4ad214a27c0564](https://etherscan.io/address/0x545973f28950f50fc6c7f52aab4ad214a27c0564) Synthetix Token State sEUR [0x6568d9e750fc44af00f857885dfb8281c00529c4](https://etherscan.io/address/0x6568d9e750fc44af00f857885dfb8281c00529c4) [](https://academy.santiment.net/labels/derivatives/#available-blockchains) Available Blockchains ------------------------------------------------------------------------------------------------- * ethereum Updated 9 months ago [#### Talk to us in Discord\ \ Still have some questions left? Join our Discord and get help from the Santiment team!\ \ Go to Discord](https://santiment.net/discord) ---