Tokenomics
Tokenomics data provides information on token metrics, indicators and various subcategories
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 supported protocols 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>"
For a comprehensive list of protocols whose tokenomics data can be requested please refer to supported protocols page.
{
"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>"
For a comprehensive list of protocols whose tokenomics data can be requested please refer to supported protocols page.
{
"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>"
For a comprehensive list of protocols whose tokenomics data can be requested please refer to supported protocols page.
{
"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>"
For a comprehensive list of protocols whose tokenomics data can be requested please refer to supported protocols page.
{
"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>"
For a comprehensive list of protocols whose tokenomics data can be requested please refer to supported protocols page.
{
"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>"
For a comprehensive list of protocols whose tokenomics data can be requested please refer to supported protocols page.
{
"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
}
]
}