LogoLogo
  • Welcome to Alterscope
  • INTRODUCTION
    • What is DefAI?
    • What are AI Agents?
    • What is Alteron?
  • How to get started
    • Sign Up
    • Agent Framework
    • Agent Signals
      • APY Changes
      • Arbitrage Opportunities
      • Centralised Exchange Movements
      • Cyvers Security Alerts
      • DAO Proposals
      • Ecosystem In/Out-Flows
      • ERC20 Price Movements
      • Function Calls
      • Gas Fee Spikes
      • Protocol Health Alerts
      • Simple Moving Averages
      • Stablecoin Price Deviations
      • Token Transfers
      • Wallet Health Factors
      • Whale Activity
    • Agent Network
  • Data Feeds
    • API Endpoint
    • Authentication
    • API Reference
      • Development
      • Development Score
      • Security
      • Liquidity
        • Lending Protocols
        • Decentralized Exchange Protocols
        • Stablecoin Protocols
        • Derivative Protocols
        • Liquid Staking Protocols
      • Community
      • Governance
      • Governance Score
      • Blockchain
      • Oracles
      • Overall Score
      • Tokenomics
      • Tokenomics Score
      • Restaking
    • Swagger API Specification
    • Install & run cURL on Windows/MacOSX/Linux
  • Dashboard Functionalities
    • Market Insights
    • Custom API Creation (Nexus)
    • Custom Dashboards (Eagle Eye)
Powered by GitBook
On this page
  1. Data Feeds
  2. API Reference

Tokenomics

Tokenomics data provides information on token metrics, indicators and various subcategories

PreviousOverall ScoreNextTokenomics Score

Last updated 1 year ago

The sample request below retrieves tokenomics data of compound protocol for past 7 days.

curl https://api.alterscope.org/data/tokenomics/compound -H "Authorization: Bearer <your_access_token>"

For a comprehensive list of protocols whose tokenomics data can be requested please refer to page.

{
    "status": true,
    "data": [
        {
            "supply_metrics": {
                "market_cap": 4260388997.49919,
                "circulating_supply": 598736139.71,
                "total_supply": 598736139.71,
                "max_supply": 1000000000,
                "fully_diluted_valuation": 7115636947.46,
                "inflation_monthly": -20.564167649293903,
                "burn_rate_monthly": 20.564167649293903
            },
            "tokenomics_metrics": {
                "price": 7.115636947458565,
                "num_token_holders": 379935,
                "num_token_holders_change_24h": 2917,
                "largest_holder": 378182954,
                "largest_holder_usd": 2691012600.381423,
                "unique_active_wallets_24h": 1448,
                "gini_coeff": 0.9970044826872738,
                "gini_coeff_change": 0.000024464833404569397,
                "whale_holdings": {
                    "0": 4819188.354892701,
                    "1000": 22915425.272151764,
                    "100000": 973943213.3542905
                },
                "whale_ratio": 1.1040176364230776,
                "whale_movement_indicator": -0.00014977313669502896,
                "onchain_velocity": 0
            },
            "indicators": {
                "volatility": 3.344512101257857,
                "daily_correlation_eth": 0.9043185510073911,
                "daily_correlation_btc": 0.8690245381027185,
                "market_cap_dominance": 0.1739887868412911,
                "sharp_ratio": -0.31232728522491143,
                "top5_concentration": 75.38646787556095,
                "top10_concentration": 85.36696516354195
            },
            "allocation_metrics": {
                "allocation_map": {
                    "advisors": 0.69,
                    "community": 15,
                    "governance": 45,
                    "investors": 17.8,
                    "team": 21.51
                },
                "project_percentage": 22.200000000000003
            },
            "exchange_metrics": {
                "num_exchanges_listed": 69,
                "cex_volume": 467050924.35,
                "dex_volume": 18089248,
                "exchanges": [
                    {
                        "exchange_name": "Binance",
                        "exchange_type": "cex",
                        "market_cap_held_percentage": 3.942353625624258,
                        "market_cap_held_usd": 130087986,
                        "dominance": 3.942353625624258
                    },
                    {
                        "exchange_name": "OKX",
                        "exchange_type": "cex",
                        "market_cap_held_percentage": 1.395136750965455,
                        "market_cap_held_usd": 45952473,
                        "dominance": 1.395136750965455
                    },
                    {
                        "exchange_name": "WhiteBIT",
                        "exchange_type": "cex",
                        "market_cap_held_percentage": 1.0117577928506087,
                        "market_cap_held_usd": 34875211,
                        "dominance": 1.0117577928506087
                    },
                    {
                        "exchange_name": "BitVenus",
                        "exchange_type": "cex",
                        "market_cap_held_percentage": 0.839462246606509,
                        "market_cap_held_usd": 28716204,
                        "dominance": 0.839462246606509
                    },
                    {
                        "exchange_name": "HTX",
                        "exchange_type": "cex",
                        "market_cap_held_percentage": 0.6533786392761926,
                        "market_cap_held_usd": 22461066,
                        "dominance": 0.6533786392761926
                    }
                ]
            },
            "chain_tvl_breakdown": {
                "Arbitrum": 513744884.70237,
                "Binance-Smart-Chain": 29914726.45551,
                "Ethereum": 8575215975.359969,
                "Optimism": 150131193.23291
            },
            "timestamp": 1713102482
        },
        {
            "supply_metrics": {
                "market_cap": 4734347213.593747,
                "circulating_supply": 598736139.71,
                "total_supply": 598736139.71,
                "max_supply": 1000000000,
                "fully_diluted_valuation": 7907234756.01,
                "inflation_monthly": -20.52013710632485,
                "burn_rate_monthly": 20.52013710632485
            },
            "tokenomics_metrics": {
                "price": 7.907234756009291,
                "num_token_holders": 379767,
                "num_token_holders_change_24h": 2749,
                "largest_holder": 378182954,
                "largest_holder_usd": 2990381397.9990625,
                "unique_active_wallets_24h": 1491,
                "gini_coeff": 0.9970145365180632,
                "gini_coeff_change": 0.00003451866419390548,
                "whale_holdings": {
                    "0": 4601642.5514581315,
                    "1000": 22401516.624726325,
                    "100000": 974696431.0712699
                },
                "whale_ratio": 1.1041889815296098,
                "whale_movement_indicator": -0.000006289021756723641,
                "onchain_velocity": 0
            },
            "indicators": {
                "volatility": 2.8529831607544702,
                "daily_correlation_eth": 0.8453113070153077,
                "daily_correlation_btc": 0.7575088503039805,
                "market_cap_dominance": 0.1834676307390282,
                "sharp_ratio": -0.31206849508239604,
                "top5_concentration": 75.38646787556095,
                "top10_concentration": 85.38409967419518
            },
            "allocation_metrics": {
                "allocation_map": {
                    "advisors": 0.69,
                    "community": 15,
                    "governance": 45,
                    "investors": 17.8,
                    "team": 21.51
                },
                "project_percentage": 22.200000000000003
            },
            "exchange_metrics": {
                "num_exchanges_listed": 70,
                "cex_volume": 379996248.60999995,
                "dex_volume": 16247346,
                "exchanges": [
                    {
                        "exchange_name": "Binance",
                        "exchange_type": "cex",
                        "market_cap_held_percentage": 3.356964078395302,
                        "market_cap_held_usd": 106251963,
                        "dominance": 3.356964078395302
                    },
                    {
                        "exchange_name": "OKX",
                        "exchange_type": "cex",
                        "market_cap_held_percentage": 1.1961963945338137,
                        "market_cap_held_usd": 37654549,
                        "dominance": 1.1961963945338137
                    },
                    {
                        "exchange_name": "BitVenus",
                        "exchange_type": "cex",
                        "market_cap_held_percentage": 0.8991927815279518,
                        "market_cap_held_usd": 28679010,
                        "dominance": 0.8991927815279518
                    },
                    {
                        "exchange_name": "WhiteBIT",
                        "exchange_type": "cex",
                        "market_cap_held_percentage": 0.672355204283412,
                        "market_cap_held_usd": 21116719,
                        "dominance": 0.672355204283412
                    },
                    {
                        "exchange_name": "HTX",
                        "exchange_type": "cex",
                        "market_cap_held_percentage": 0.6379132297597357,
                        "market_cap_held_usd": 20187765,
                        "dominance": 0.6379132297597357
                    }
                ]
            },
            "chain_tvl_breakdown": {
                "Arbitrum": 539110366.11274,
                "Binance-Smart-Chain": 31102008.82546,
                "Ethereum": 9099950640.94134,
                "Optimism": 154794638.38157
            },
            "timestamp": 1713015481
        },
    ]
}

Supply Metrics

  • Market Cap: The market capitalization of the cryptocurrency, calculated as the current price multiplied by the circulating supply. It provides an estimate of the total market value of the circulating tokens.

  • Circulating Supply: The number of tokens that are publicly available and actively traded in the market.

  • Total Supply: The total amount of tokens that have been issued or created to date.

  • Max Supply: The maximum number of tokens that will ever exist for this cryptocurrency as defined by its protocol.

  • Fully Diluted Valuation: The theoretical market capitalization if all tokens, including those not yet in circulation, were issued and multiplied by the current token price.

  • Inflation Monthly: The rate at which the circulating supply of the token increases each month, expressed as a percentage.

  • Burn Rate Monthly: The percentage of the token's supply that is permanently removed or "burned" each month.

Tokenomics Metrics

  • Price: The current market price of the token.

  • Number of Token Holders: The total count of unique addresses that hold at least a fraction of the token.

  • Change in Token Holders (24h): The net change in the number of token holders over the last 24 hours.

  • Largest Holder: The number of tokens held by the single largest token holder.

  • Largest Holder Value (USD): The market value, in USD, of the tokens held by the largest holder.

  • Daily Unique Active Wallets: The number of unique wallet addresses that have engaged in transactions with this token over the last 24 hours.

  • Gini Coefficient: A statistical measure that expresses the wealth distribution among the token holders; a lower value indicates more equal distribution, while a higher value shows greater inequality.

  • Change in Gini Coefficient: The day-over-day change in the Gini Coefficient, indicating shifts in the distribution of token ownership.

  • Whale Holdings: A breakdown of token amounts held by the largest holders, categorized by ownership thresholds.

  • Whale Ratio: The proportion of total circulating supply controlled by whale accounts.

  • Whale Movement Indicator: A metric indicating the activity level of whale accounts relative to the overall transaction volume.

  • On-chain Velocity: A measure of the rate at which tokens are being transferred between addresses, indicative of token liquidity and activity.

Indicators

  • Volatility: A statistical measure that indicates the variation of token price within a given time frame.

  • Daily Correlation with ETH: Indicates how closely the token's price movements correlate with Ethereum's price movements on a daily basis.

  • Daily Correlation with BTC: Indicates how closely the token's price movements correlate with Bitcoin's price movements on a daily basis.

  • Market Cap Dominance: The token's share of the total cryptocurrency market cap.

  • Sharpe Ratio: A measure used to evaluate the risk-adjusted return of an investment; it considers both the expected returns and the volatility of the investment.

  • Top 5 Concentration: The percentage of the circulating supply that is held by the top five wallets.

  • Top 10 Concentration: The percentage of the circulating supply that is held by the top ten wallets.

Allocation Metrics

  • Allocation Map: A distribution of token allocations categorized by stakeholder types such as advisors, community, governance, investors, and team.

  • Project Percentage: The percentage of total tokens held by the project's team or associated entities.

Exchange Metrics

  • Number of Exchanges Listed: The total number of trading platforms where the token is available for trading.

  • CEX Volume: The total volume of the token traded on centralized exchanges within a specific timeframe.

  • DEX Volume: The total volume of the token traded on decentralized exchanges within a specific timeframe.

  • Exchanges: Detailed metrics about each exchange where the token is listed, including exchange name, type, and the percentage of the token's market cap held on each platform.

Chain TVL Breakdown

  • Chain TVL Breakdown: The distribution of the Total Value Locked (TVL) of the token across different blockchain networks, showing where the token is being utilized in decentralized finance (DeFi) applications.

The sample request below retrieves tokenomics data of compound protocol for past 7 days.

curl https://api.alterscope.org/data/tokenomics/supply/compound -H "Authorization: Bearer <your_access_token>"
{
    "status": true,
    "data": [
        {
            "market_cap": 4656376629.746914,
            "circulating_supply": 598736139.71,
            "total_supply": 598736139.71,
            "max_supply": 1000000000,
            "fully_diluted_valuation": 7777009471.99,
            "inflation_monthly": -20.57590805863615,
            "burn_rate_monthly": 20.57590805863615,
            "timestamp": 1713188012
        },
        {
            "market_cap": 4260388997.49919,
            "circulating_supply": 598736139.71,
            "total_supply": 598736139.71,
            "max_supply": 1000000000,
            "fully_diluted_valuation": 7115636947.46,
            "inflation_monthly": -20.564167649293903,
            "burn_rate_monthly": 20.564167649293903,
            "timestamp": 1713102482
        },
        {
            "market_cap": 4734347213.593747,
            "circulating_supply": 598736139.71,
            "total_supply": 598736139.71,
            "max_supply": 1000000000,
            "fully_diluted_valuation": 7907234756.01,
            "inflation_monthly": -20.52013710632485,
            "burn_rate_monthly": 20.52013710632485,
            "timestamp": 1713015481
        },
        {
            "market_cap": 5340439182.556232,
            "circulating_supply": 598736139.71,
            "total_supply": 598736139.71,
            "max_supply": 1000000000,
            "fully_diluted_valuation": 8919520350.22,
            "inflation_monthly": -20.693803860882277,
            "burn_rate_monthly": 20.693803860882277,
            "timestamp": 1712928890
        },
        {
            "market_cap": 5556125661.356409,
            "circulating_supply": 598736139.71,
            "total_supply": 598736139.71,
            "max_supply": 1000000000,
            "fully_diluted_valuation": 9279756628.77,
            "inflation_monthly": -20.603637913157584,
            "burn_rate_monthly": 20.603637913157584,
            "timestamp": 1712842412
        },
        {
            "market_cap": 6513620716.505811,
            "circulating_supply": 598736139.71,
            "total_supply": 598736139.71,
            "max_supply": 1000000000,
            "fully_diluted_valuation": 10878950316.35,
            "inflation_monthly": -20.558697735222346,
            "burn_rate_monthly": 20.558697735222346,
            "timestamp": 1712756081
        },
        {
            "market_cap": 6884375690.762318,
            "circulating_supply": 598736139.71,
            "total_supply": 598736139.71,
            "max_supply": 1000000000,
            "fully_diluted_valuation": 11498179639.03,
            "inflation_monthly": -20.55207043544177,
            "burn_rate_monthly": 20.55207043544177,
            "timestamp": 1712669679
        }
    ]
}

This metric is already available in /data/tokenomics/{protocol} endpoint. If you're interested in only the listed fields, usage of this endpoint is encouraged

Supply Metrics

  • Market Cap: The market capitalization of the cryptocurrency, calculated as the current price multiplied by the circulating supply. It provides an estimate of the total market value of the circulating tokens.

  • Circulating Supply: The number of tokens that are publicly available and actively traded in the market.

  • Total Supply: The total amount of tokens that have been issued or created to date.

  • Max Supply: The maximum number of tokens that will ever exist for this cryptocurrency as defined by its protocol.

  • Fully Diluted Valuation: The theoretical market capitalization if all tokens, including those not yet in circulation, were issued and multiplied by the current token price.

  • Inflation Monthly: The rate at which the circulating supply of the token increases each month, expressed as a percentage.

  • Burn Rate Monthly: The percentage of the token's supply that is permanently removed or "burned" each month.

The sample request below retrieves tokenomics data of compound protocol for past 7 days.

curl https://api.alterscope.org/data/tokenomics/allocations/compound -H "Authorization: Bearer <your_access_token>"
{
    "status": true,
    "data": [
        {
            "allocation_map": {
                "advisors": 0.69,
                "community": 15,
                "governance": 45,
                "investors": 17.8,
                "team": 21.51
            },
            "project_percentage": 22.200000000000003,
            "timestamp": 1713188012
        },
        {
            "allocation_map": {
                "advisors": 0.69,
                "community": 15,
                "governance": 45,
                "investors": 17.8,
                "team": 21.51
            },
            "project_percentage": 22.200000000000003,
            "timestamp": 1713102482
        },
        {
            "allocation_map": {
                "advisors": 0.69,
                "community": 15,
                "governance": 45,
                "investors": 17.8,
                "team": 21.51
            },
            "project_percentage": 22.200000000000003,
            "timestamp": 1713015481
        },
        {
            "allocation_map": {
                "advisors": 0.69,
                "community": 15,
                "governance": 45,
                "investors": 17.8,
                "team": 21.51
            },
            "project_percentage": 22.200000000000003,
            "timestamp": 1712928890
        },
        {
            "allocation_map": {
                "advisors": 0.69,
                "community": 15,
                "governance": 45,
                "investors": 17.8,
                "team": 21.51
            },
            "project_percentage": 22.200000000000003,
            "timestamp": 1712842412
        },
        {
            "allocation_map": {
                "advisors": 0.69,
                "community": 15,
                "governance": 45,
                "investors": 17.8,
                "team": 21.51
            },
            "project_percentage": 22.200000000000003,
            "timestamp": 1712756081
        },
        {
            "allocation_map": {
                "advisors": 0.69,
                "community": 15,
                "governance": 45,
                "investors": 17.8,
                "team": 21.51
            },
            "project_percentage": 22.200000000000003,
            "timestamp": 1712669679
        }
    ]
}

This metric is already available in /data/tokenomics/{protocol} endpoint. If you're interested in only the listed fields, usage of this endpoint is encouraged

Allocation Metrics

  • Allocation Map: A distribution of token allocations categorized by stakeholder types such as advisors, community, governance, investors, and team.

  • Project Percentage: The percentage of total tokens held by the project's team or associated entities.

The sample request below retrieves tokenomics data of compound protocol for past 7 days.

curl https://api.alterscope.org/data/tokenomics/indicators/compound -H "Authorization: Bearer <your_access_token>"
{
    "status": true,
    "data": [
        {
            "volatility": 1.2635598800628138,
            "daily_correlation_eth": 0.9307415117840468,
            "daily_correlation_btc": 0.8117468815806548,
            "market_cap_dominance": 0.18385965020891362,
            "sharp_ratio": -0.210456260776552,
            "top5_concentration": 75.26378393078824,
            "top10_concentration": 85.17300852998241,
            "timestamp": 1713188012
        },
        {
            "volatility": 3.344512101257857,
            "daily_correlation_eth": 0.9043185510073911,
            "daily_correlation_btc": 0.8690245381027185,
            "market_cap_dominance": 0.1739887868412911,
            "sharp_ratio": -0.31232728522491143,
            "top5_concentration": 75.38646787556095,
            "top10_concentration": 85.36696516354195,
            "timestamp": 1713102482
        },
        {
            "volatility": 2.8529831607544702,
            "daily_correlation_eth": 0.8453113070153077,
            "daily_correlation_btc": 0.7575088503039805,
            "market_cap_dominance": 0.1834676307390282,
            "sharp_ratio": -0.31206849508239604,
            "top5_concentration": 75.38646787556095,
            "top10_concentration": 85.38409967419518,
            "timestamp": 1713015481
        },
        {
            "volatility": 0.7310844181341797,
            "daily_correlation_eth": 0.5466751471583642,
            "daily_correlation_btc": 0.43025672677841287,
            "market_cap_dominance": 0.19523037788368025,
            "sharp_ratio": -0.2846551100226357,
            "top5_concentration": 75.38646787556095,
            "top10_concentration": 85.38490297829443,
            "timestamp": 1712928890
        },
        {
            "volatility": 2.190427193453514,
            "daily_correlation_eth": 0.5834054410105862,
            "daily_correlation_btc": 0.4252265915641269,
            "market_cap_dominance": 0.20135271909978578,
            "sharp_ratio": -0.24620106057126503,
            "top5_concentration": 75.2640571627491,
            "top10_concentration": 84.58429381336245,
            "timestamp": 1712842412
        },
        {
            "volatility": 0.9274881513068128,
            "daily_correlation_eth": 0.8635530530901037,
            "daily_correlation_btc": 0.8248877136849478,
            "market_cap_dominance": 0.24452672100852427,
            "sharp_ratio": -0.1822233119698992,
            "top5_concentration": 75.26425758492515,
            "top10_concentration": 84.23150847483907,
            "timestamp": 1712756081
        },
        {
            "volatility": 0.34121769604876373,
            "daily_correlation_eth": 0.5166207539792576,
            "daily_correlation_btc": 0.5328329822115133,
            "market_cap_dominance": 0.24670287712692787,
            "sharp_ratio": -0.13571403979669927,
            "top5_concentration": 75.26459162188523,
            "top10_concentration": 84.23039924850684,
            "timestamp": 1712669679
        }
    ]
}

This metric is already available in /data/tokenomics/{protocol} endpoint. If you're interested in only the listed fields, usage of this endpoint is encouraged

Indicators

  • Volatility: A statistical measure that indicates the variation of token price within a given time frame.

  • Daily Correlation with ETH: Indicates how closely the token's price movements correlate with Ethereum's price movements on a daily basis.

  • Daily Correlation with BTC: Indicates how closely the token's price movements correlate with Bitcoin's price movements on a daily basis.

  • Market Cap Dominance: The token's share of the total cryptocurrency market cap.

  • Sharpe Ratio: A measure used to evaluate the risk-adjusted return of an investment; it considers both the expected returns and the volatility of the investment.

  • Top 5 Concentration: The percentage of the circulating supply that is held by the top five wallets.

  • Top 10 Concentration: The percentage of the circulating supply that is held by the top ten wallets.

The sample request below retrieves tokenomics data of compound protocol for past 7 days.

curl https://api.alterscope.org/data/tokenomics/metrics/compound -H "Authorization: Bearer <your_access_token>"
{
    "status": true,
    "data": [
        {
            "price": 7.7770094719891905,
            "num_token_holders": 380081,
            "num_token_holders_change_24h": 3063,
            "largest_holder": 378182954,
            "largest_holder_usd": 2941132415.4028525,
            "unique_active_wallets_24h": 1167,
            "gini_coeff": 0.9969975717323798,
            "gini_coeff_change": 0.000017553878510545573,
            "whale_holdings": {
                "0": 4637915.909564858,
                "1000": 22739685.45326177,
                "100000": 974279862.3525118
            },
            "whale_ratio": 1.102078070087482,
            "whale_movement_indicator": -0.0017551970471597258,
            "onchain_velocity": 0,
            "timestamp": 1713188012
        },
        {
            "price": 7.115636947458565,
            "num_token_holders": 379935,
            "num_token_holders_change_24h": 2917,
            "largest_holder": 378182954,
            "largest_holder_usd": 2691012600.381423,
            "unique_active_wallets_24h": 1448,
            "gini_coeff": 0.9970044826872738,
            "gini_coeff_change": 0.000024464833404569397,
            "whale_holdings": {
                "0": 4819188.354892701,
                "1000": 22915425.272151764,
                "100000": 973943213.3542905
            },
            "whale_ratio": 1.1040176364230776,
            "whale_movement_indicator": -0.00014977313669502896,
            "onchain_velocity": 0,
            "timestamp": 1713102482
        },
        {
            "price": 7.907234756009291,
            "num_token_holders": 379767,
            "num_token_holders_change_24h": 2749,
            "largest_holder": 378182954,
            "largest_holder_usd": 2990381397.9990625,
            "unique_active_wallets_24h": 1491,
            "gini_coeff": 0.9970145365180632,
            "gini_coeff_change": 0.00003451866419390548,
            "whale_holdings": {
                "0": 4601642.5514581315,
                "1000": 22401516.624726325,
                "100000": 974696431.0712699
            },
            "whale_ratio": 1.1041889815296098,
            "whale_movement_indicator": -0.000006289021756723641,
            "onchain_velocity": 0,
            "timestamp": 1713015481
        },
        {
            "price": 8.919520350221205,
            "num_token_holders": 379601,
            "num_token_holders_change_24h": 2583,
            "largest_holder": 378182954,
            "largest_holder_usd": 3373210554.30977,
            "unique_active_wallets_24h": 1880,
            "gini_coeff": 0.9970185567974739,
            "gini_coeff_change": 0.00003853894360461574,
            "whale_holdings": {
                "0": 4359718.226894854,
                "1000": 21968100.600048974,
                "100000": 975372472.2193795
            },
            "whale_ratio": 1.1041970145706024,
            "whale_movement_indicator": 0.0004016895099966778,
            "onchain_velocity": 0,
            "timestamp": 1712928890
        },
        {
            "price": 9.279756628767286,
            "num_token_holders": 379634,
            "num_token_holders_change_24h": 2616,
            "largest_holder": 378182954,
            "largest_holder_usd": 3509445774.268294,
            "unique_active_wallets_24h": 2583,
            "gini_coeff": 0.996971145263677,
            "gini_coeff_change": -0.00000887259019222153,
            "whale_holdings": {
                "0": 4278848.6776027065,
                "1000": 21833855.332273453,
                "100000": 960572641.4058701
            },
            "whale_ratio": 1.0806416279030955,
            "whale_movement_indicator": 0.0032826188619659185,
            "onchain_velocity": 0,
            "timestamp": 1712842412
        },
        {
            "price": 10.878950316345872,
            "num_token_holders": 379784,
            "num_token_holders_change_24h": 2766,
            "largest_holder": 378182954,
            "largest_holder_usd": 4114233567.0549164,
            "unique_active_wallets_24h": 815,
            "gini_coeff": 0.9969484758532269,
            "gini_coeff_change": -0.00003154200064237056,
            "whale_holdings": {
                "0": 3782531.6511276346,
                "1000": 21264879.044299867,
                "100000": 961523391.2114459
            },
            "whale_ratio": 1.0771137745178614,
            "whale_movement_indicator": 0.000009828401230697392,
            "onchain_velocity": 0,
            "timestamp": 1712756081
        },
        {
            "price": 11.498179639025613,
            "num_token_holders": 379704,
            "num_token_holders_change_24h": 2686,
            "largest_holder": 378182954,
            "largest_holder_usd": 4348415541.50936,
            "unique_active_wallets_24h": 832,
            "gini_coeff": 0.9969469520314552,
            "gini_coeff_change": -0.00003306582241402456,
            "whale_holdings": {
                "0": 3697529.6183968578,
                "1000": 21043245.77336322,
                "100000": 961868822.669656
            },
            "whale_ratio": 1.077102682254539,
            "whale_movement_indicator": -0.000043465629185575404,
            "onchain_velocity": 0,
            "timestamp": 1712669679
        }
    ]
}

Sample Response Description

Tokenomics Metrics

  • Price: The current market price of the token.

  • Number of Token Holders: The total count of unique addresses that hold at least a fraction of the token.

  • Change in Token Holders (24h): The net change in the number of token holders over the last 24 hours.

  • Largest Holder: The number of tokens held by the single largest token holder.

  • Largest Holder Value (USD): The market value, in USD, of the tokens held by the largest holder.

  • Daily Unique Active Wallets: The number of unique wallet addresses that have engaged in transactions with this token over the last 24 hours.

  • Gini Coefficient: A statistical measure that expresses the wealth distribution among the token holders; a lower value indicates more equal distribution, while a higher value shows greater inequality.

  • Change in Gini Coefficient: The day-over-day change in the Gini Coefficient, indicating shifts in the distribution of token ownership.

  • Whale Holdings: A breakdown of token amounts held by the largest holders, categorized by ownership thresholds.

  • Whale Ratio: The proportion of total circulating supply controlled by whale accounts.

  • Whale Movement Indicator: A metric indicating the activity level of whale accounts relative to the overall transaction volume.

  • On-chain Velocity: A measure of the rate at which tokens are being transferred between addresses, indicative of token liquidity and activity.

The sample request below retrieves tokenomics data of compound protocol for past 7 days.

curl https://api.alterscope.org/data/tokenomics/exchanges/compound -H "Authorization: Bearer <your_access_token>"
{
    "status": true,
    "data": [
        {
            "num_exchanges_listed": 70,
            "cex_volume": 224013820.94,
            "dex_volume": 5823740.2,
            "exchanges": [
                {
                    "exchange_name": "Binance",
                    "exchange_type": "cex",
                    "market_cap_held_percentage": 3.2862843442718237,
                    "market_cap_held_usd": 55955541,
                    "dominance": 3.2862843442718237
                },
                {
                    "exchange_name": "BitVenus",
                    "exchange_type": "cex",
                    "market_cap_held_percentage": 1.43275887268667,
                    "market_cap_held_usd": 24354115,
                    "dominance": 1.43275887268667
                },
                {
                    "exchange_name": "HTX",
                    "exchange_type": "cex",
                    "market_cap_held_percentage": 1.1294373754994238,
                    "market_cap_held_usd": 19240154,
                    "dominance": 1.1294373754994238
                },
                {
                    "exchange_name": "OKX",
                    "exchange_type": "cex",
                    "market_cap_held_percentage": 1.043722606039919,
                    "market_cap_held_usd": 17829789,
                    "dominance": 1.043722606039919
                },
                {
                    "exchange_name": "WhiteBIT",
                    "exchange_type": "cex",
                    "market_cap_held_percentage": 0.8691099183667574,
                    "market_cap_held_usd": 15539743,
                    "dominance": 0.8691099183667574
                },
                {
                    "exchange_name": "Coinbase Exchange",
                    "exchange_type": "cex",
                    "market_cap_held_percentage": 0.6331067694107887,
                    "market_cap_held_usd": 11350805,
                    "dominance": 0.6331067694107887
                },
                {
                    "exchange_name": "Bybit",
                    "exchange_type": "cex",
                    "market_cap_held_percentage": 0.6583557224044428,
                    "market_cap_held_usd": 11230203,
                    "dominance": 0.6583557224044428
                },
                {
                    "exchange_name": "Gate.io",
                    "exchange_type": "cex",
                    "market_cap_held_percentage": 0.5109983750584778,
                    "market_cap_held_usd": 8734531,
                    "dominance": 0.5109983750584778
                },
                {
                    "exchange_name": "DigiFinex",
                    "exchange_type": "cex",
                    "market_cap_held_percentage": 0.381305025015547,
                    "market_cap_held_usd": 6820151,
                    "dominance": 0.381305025015547
                },
                {
                    "exchange_name": "PointPay",
                    "exchange_type": "cex",
                    "market_cap_held_percentage": 0.29677934194512656,
                    "market_cap_held_usd": 5062037,
                    "dominance": 0.29677934194512656
                },
                {
                    "exchange_name": "Uniswap V3 (Ethereum)",
                    "exchange_type": "dex",
                    "market_cap_held_percentage": 0.26912974868671136,
                    "market_cap_held_usd": 4755729.31,
                    "dominance": 0.26912974868671136
                },
                {
                    "exchange_name": "Azbit",
                    "exchange_type": "cex",
                    "market_cap_held_percentage": 0.24855562213872526,
                    "market_cap_held_usd": 4265601.95,
                    "dominance": 0.24855562213872526
                },
                {
                    "exchange_name": "Hotcoin Global",
                    "exchange_type": "cex",
                    "market_cap_held_percentage": 0.20062378303741515,
                    "market_cap_held_usd": 3587172,
                    "dominance": 0.20062378303741515
                },
                {
                    "exchange_name": "KuCoin",
                    "exchange_type": "cex",
                    "market_cap_held_percentage": 0.16351169005447447,
                    "market_cap_held_usd": 2913345,
                    "dominance": 0.16351169005447447
                },
                {
                    "exchange_name": "BingX",
                    "exchange_type": "cex",
                    "market_cap_held_percentage": 0.17107166575505894,
                    "market_cap_held_usd": 2905236,
                    "dominance": 0.17107166575505894
                },
                {
                    "exchange_name": "Biconomy",
                    "exchange_type": "cex",
                    "market_cap_held_percentage": 0.1580515826909283,
                    "market_cap_held_usd": 2720163,
                    "dominance": 0.1580515826909283
                },
                {
                    "exchange_name": "Phemex",
                    "exchange_type": "cex",
                    "market_cap_held_percentage": 0.1403404636736131,
                    "market_cap_held_usd": 2498978,
                    "dominance": 0.1403404636736131
                }
            ],
            "timestamp": 1713102482
        }
    ]
}

This metric is already available in /data/tokenomics/{protocol} endpoint. If you're interested in only the listed fields, usage of this endpoint is encouraged

Exchange Metrics

  • Number of Exchanges Listed: The total number of trading platforms where the token is available for trading.

  • CEX Volume: The total volume of the token traded on centralized exchanges within a specific timeframe.

  • DEX Volume: The total volume of the token traded on decentralized exchanges within a specific timeframe.

  • Exchanges: Detailed metrics about each exchange where the token is listed, including exchange name, type, and the percentage of the token's market cap held on each platform.

The sample request below retrieves tokenomics data of compound protocol for past 7 days.

curl https://api.alterscope.org/data/tokenomics/breakdown/compound -H "Authorization: Bearer <your_access_token>"
{
    "status": true,
    "data": [
        {
            "chain_tvl_breakdown": {
                "Arbitrum": 544338246.68198,
                "Binance-Smart-Chain": 30973240.06498,
                "Ethereum": 8971242496.04708,
                "Optimism": 154183305.28861
            },
            "timestamp": 1713188012
        },
        {
            "chain_tvl_breakdown": {
                "Arbitrum": 513744884.70237,
                "Binance-Smart-Chain": 29914726.45551,
                "Ethereum": 8575215975.359969,
                "Optimism": 150131193.23291
            },
            "timestamp": 1713102482
        },
        {
            "chain_tvl_breakdown": {
                "Arbitrum": 539110366.11274,
                "Binance-Smart-Chain": 31102008.82546,
                "Ethereum": 9099950640.94134,
                "Optimism": 154794638.38157
            },
            "timestamp": 1713015481
        },
        {
            "chain_tvl_breakdown": {
                "Arbitrum": 572259518.8358,
                "Binance-Smart-Chain": 33692594.77838,
                "Ethereum": 9773101094.855402,
                "Optimism": 166392401.13124
            },
            "timestamp": 1712928890
        },
        {
            "chain_tvl_breakdown": {
                "Arbitrum": 571458225.60714,
                "Binance-Smart-Chain": 32566685.31074,
                "Ethereum": 9680727815.30139,
                "Optimism": 166432337.67318
            },
            "timestamp": 1712842412
        },
        {
            "chain_tvl_breakdown": {
                "Arbitrum": 560499736.40005,
                "Binance-Smart-Chain": 33980358.56458,
                "Ethereum": 9509542263.58072,
                "Optimism": 162563648.84499
            },
            "timestamp": 1712756081
        },
        {
            "chain_tvl_breakdown": {
                "Arbitrum": 579270340.3781,
                "Binance-Smart-Chain": 34706786.48682,
                "Ethereum": 9899082104.86201,
                "Optimism": 172603337.49951
            },
            "timestamp": 1712669679
        }
    ]
}

This metric is already available in /data/tokenomics/{protocol} endpoint. If you're interested in only the listed fields, usage of this endpoint is encouraged

Chain TVL Breakdown

  • Chain TVL Breakdown: The distribution of the Total Value Locked (TVL) of the token across different blockchain networks, showing where the token is being utilized in decentralized finance (DeFi) applications.

For a comprehensive list of protocols whose tokenomics data can be requested please refer to page.

For a comprehensive list of protocols whose tokenomics data can be requested please refer to page.

For a comprehensive list of protocols whose tokenomics data can be requested please refer to page.

For a comprehensive list of protocols whose tokenomics data can be requested please refer to page.

For a comprehensive list of protocols whose tokenomics data can be requested please refer to page.

For a comprehensive list of protocols whose tokenomics data can be requested please refer to page.

supported protocols
supported protocols
supported protocols
supported protocols
supported protocols
supported protocols
supported protocols

Retrieves the weekly tokenomics parameters tracked for specified protocol. This is the aggregated structure in which all collected data categories (supply, indicator, token metrics and so no) are present.

get

This endpoint returns daily tokenomics aggregated data of the specified protocol from the last 7 days in descending order

Authorizations
Path parameters
protocolstringRequired

Name of the Protocol , e.g. "uniswap"

Responses
200
OK
application/json
404
There is no data for the provided `protocol`
505
Internal Server Error
get
GET /data/tokenomics/{protocol} HTTP/1.1
Host: api.alterscope.org
Authorization: Bearer JWT
Accept: */*
{
  "supply_metrics": {
    "market_cap": 1,
    "circulating_supply": 1,
    "total_supply": 1,
    "max_supply": 1,
    "fully_diluted_valuation": 1,
    "inflation_monthly": 1,
    "burn_rate_monthly": 1
  },
  "tokenomics_metrics": {
    "price": 1,
    "num_token_holders": 1,
    "num_token_holders_change_24h": 1,
    "largest_holder": 1,
    "largest_holder_usd": 1,
    "unique_active_wallets_24h": 1,
    "gini_coeff": 1,
    "gini_coeff_change": 1,
    "whale_holdings": {
      "ANY_ADDITIONAL_PROPERTY": 1
    },
    "whale_ratio": 1,
    "whale_movement_indicator": 1,
    "onchain_velocity": 1
  },
  "indicators": {
    "volatility": 1,
    "daily_correlation_eth": 1,
    "daily_correlation_btc": 1,
    "market_cap_dominance": 1,
    "sharp_ratio": 1,
    "top5_concentration": 1,
    "top10_concentration": 1
  },
  "allocation_metrics": {
    "allocation_map": {
      "ANY_ADDITIONAL_PROPERTY": 1
    },
    "project_percentage": 1
  },
  "exchange_metrics": {
    "num_exchanges_listed": 1,
    "cex_volume": 1,
    "dex_volume": 1,
    "exchanges": [
      {
        "exchange_name": "text",
        "exchange_type": "text",
        "market_cap_held_percentage": 1,
        "market_cap_held_usd": 1,
        "dominance": 1
      }
    ]
  },
  "chain_tvl_breakdown": {
    "ANY_ADDITIONAL_PROPERTY": 1
  },
  "tokenomics_score": 1,
  "timestamp": 1
}

Retrieves the weekly supply parameters tracked for specified protocol like market cap, valuations and supplies.

get

This endpoint returns daily supply data points gathered for tokenomics of the specified protocol from the last 7 days in descending order

Authorizations
Path parameters
protocolstringRequired

Name of the Protocol , e.g. "uniswap"

Responses
200
OK
application/json
404
There is no data for the provided `protocol`
505
Internal Server Error
get
GET /data/tokenomics/supply/{protocol} HTTP/1.1
Host: api.alterscope.org
Authorization: Bearer JWT
Accept: */*
{
  "market_cap": 1,
  "circulating_supply": 1,
  "total_supply": 1,
  "max_supply": 1,
  "fully_diluted_valuation": 1,
  "inflation_monthly": 1,
  "burn_rate_monthly": 1,
  "timestamp": 1
}

Retrieves the weekly supply parameters tracked for specified protocol like market cap, valuations and supplies.

get

This endpoint returns daily supply data points gathered for tokenomics of the specified protocol from the last 7 days in descending order

Authorizations
Path parameters
protocolstringRequired

Name of the Protocol , e.g. "uniswap"

Responses
200
OK
application/json
404
There is no data for the provided `protocol`
505
Internal Server Error
get
GET /data/tokenomics/allocations/{protocol} HTTP/1.1
Host: api.alterscope.org
Authorization: Bearer JWT
Accept: */*
{
  "market_cap": 1,
  "circulating_supply": 1,
  "total_supply": 1,
  "max_supply": 1,
  "fully_diluted_valuation": 1,
  "inflation_monthly": 1,
  "burn_rate_monthly": 1,
  "timestamp": 1
}

Retrieves the weekly supply parameters tracked for specified protocol like market cap, valuations and supplies.

get

This endpoint returns daily supply data points gathered for tokenomics of the specified protocol from the last 7 days in descending order

Authorizations
Path parameters
protocolstringRequired

Name of the Protocol , e.g. "uniswap"

Responses
200
OK
application/json
404
There is no data for the provided `protocol`
505
Internal Server Error
get
GET /data/tokenomics/indicators/{protocol} HTTP/1.1
Host: api.alterscope.org
Authorization: Bearer JWT
Accept: */*
{
  "market_cap": 1,
  "circulating_supply": 1,
  "total_supply": 1,
  "max_supply": 1,
  "fully_diluted_valuation": 1,
  "inflation_monthly": 1,
  "burn_rate_monthly": 1,
  "timestamp": 1
}

Retrieves the weekly supply parameters tracked for specified protocol like market cap, valuations and supplies.

get

This endpoint returns daily supply data points gathered for tokenomics of the specified protocol from the last 7 days in descending order

Authorizations
Path parameters
protocolstringRequired

Name of the Protocol , e.g. "uniswap"

Responses
200
OK
application/json
404
There is no data for the provided `protocol`
505
Internal Server Error
get
GET /data/tokenomics/metrics/{protocol} HTTP/1.1
Host: api.alterscope.org
Authorization: Bearer JWT
Accept: */*
{
  "market_cap": 1,
  "circulating_supply": 1,
  "total_supply": 1,
  "max_supply": 1,
  "fully_diluted_valuation": 1,
  "inflation_monthly": 1,
  "burn_rate_monthly": 1,
  "timestamp": 1
}

Retrieves the weekly supply parameters tracked for specified protocol like market cap, valuations and supplies.

get

This endpoint returns daily supply data points gathered for tokenomics of the specified protocol from the last 7 days in descending order

Authorizations
Path parameters
protocolstringRequired

Name of the Protocol , e.g. "uniswap"

Responses
200
OK
application/json
404
There is no data for the provided `protocol`
505
Internal Server Error
get
GET /data/tokenomics/exchanges/{protocol} HTTP/1.1
Host: api.alterscope.org
Authorization: Bearer JWT
Accept: */*
{
  "market_cap": 1,
  "circulating_supply": 1,
  "total_supply": 1,
  "max_supply": 1,
  "fully_diluted_valuation": 1,
  "inflation_monthly": 1,
  "burn_rate_monthly": 1,
  "timestamp": 1
}

Retrieves the weekly supply parameters tracked for specified protocol like market cap, valuations and supplies.

get

This endpoint returns daily supply data points gathered for tokenomics of the specified protocol from the last 7 days in descending order

Authorizations
Path parameters
protocolstringRequired

Name of the Protocol , e.g. "uniswap"

Responses
200
OK
application/json
404
There is no data for the provided `protocol`
505
Internal Server Error
get
GET /data/tokenomics/breakdown/{protocol} HTTP/1.1
Host: api.alterscope.org
Authorization: Bearer JWT
Accept: */*
{
  "ANY_ADDITIONAL_PROPERTY": 1
}
  • GETRetrieves the weekly tokenomics parameters tracked for specified protocol. This is the aggregated structure in which all collected data categories (supply, indicator, token metrics and so no) are present.
  • GETRetrieves the weekly supply parameters tracked for specified protocol like market cap, valuations and supplies.
  • GETRetrieves the weekly supply parameters tracked for specified protocol like market cap, valuations and supplies.
  • GETRetrieves the weekly supply parameters tracked for specified protocol like market cap, valuations and supplies.
  • GETRetrieves the weekly supply parameters tracked for specified protocol like market cap, valuations and supplies.
  • GETRetrieves the weekly supply parameters tracked for specified protocol like market cap, valuations and supplies.
  • GETRetrieves the weekly supply parameters tracked for specified protocol like market cap, valuations and supplies.