Tokenomics

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

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.

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

GEThttps://api.alterscope.org/data/tokenomics/{protocol}

Authorization

BearerAuth

Path parameters

protocol*string

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

Response

200404505

OK

Body

application/json

supply_metricsSupplyData (object)

tokenomics_metricsTokenomics (object)

indicatorsIndicators (object)

allocation_metricsAllocations (object)

exchange_metricsExchangeMetrics (object)

chain_tvl_breakdownobject

tokenomics_scorenumber

timestampinteger (int64)

Request

JavaScriptCurl

const response = await fetch('https://api.alterscope.org/data/tokenomics/{protocol}', {
    method: 'GET',
    headers: {
      "Authorization": "Bearer JWT"
    },
});
const data = await response.json();

Response

{
  "supply_metrics": {
    "market_cap": 0,
    "circulating_supply": 0,
    "total_supply": 0,
    "max_supply": 0,
    "fully_diluted_valuation": 0,
    "inflation_monthly": 0,
    "burn_rate_monthly": 0
  },
  "tokenomics_metrics": {
    "price": 0,
    "largest_holder": 0,
    "largest_holder_usd": 0,
    "gini_coeff": 0,
    "gini_coeff_change": 0,
    "whale_ratio": 0,
    "whale_movement_indicator": 0,
    "onchain_velocity": 0
  },
  "indicators": {
    "volatility": 0,
    "daily_correlation_eth": 0,
    "daily_correlation_btc": 0,
    "market_cap_dominance": 0,
    "sharp_ratio": 0,
    "top5_concentration": 0,
    "top10_concentration": 0
  },
  "allocation_metrics": {
    "project_percentage": 0
  },
  "exchange_metrics": {
    "cex_volume": 0,
    "dex_volume": 0,
    "exchanges": [
      {
        "exchange_name": "text",
        "exchange_type": "text",
        "market_cap_held_percentage": 0,
        "market_cap_held_usd": 0,
        "dominance": 0
      }
    ]
  },
  "tokenomics_score": 0
}

Sample Request

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.

Sample Response

{
    "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
        },
    ]
}

Sample Response Description

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.

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

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

GEThttps://api.alterscope.org/data/tokenomics/supply/{protocol}

Authorization

BearerAuth

Path parameters

protocol*string

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

Response

200404505

OK

Body

application/json

market_capnumber

circulating_supplynumber

total_supplynumber

max_supplynumber

fully_diluted_valuationnumber

inflation_monthlynumber

burn_rate_monthlynumber

timestampinteger (int64)

Request

JavaScriptCurl

const response = await fetch('https://api.alterscope.org/data/tokenomics/supply/{protocol}', {
    method: 'GET',
    headers: {
      "Authorization": "Bearer JWT"
    },
});
const data = await response.json();

Response

{
  "market_cap": 0,
  "circulating_supply": 0,
  "total_supply": 0,
  "max_supply": 0,
  "fully_diluted_valuation": 0,
  "inflation_monthly": 0,
  "burn_rate_monthly": 0
}

Sample Request

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.

Sample Response

{
    "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
        }
    ]
}

Sample Response Description

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.

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

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

GEThttps://api.alterscope.org/data/tokenomics/allocations/{protocol}

Authorization

BearerAuth

Path parameters

protocol*string

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

Response

200404505

OK

Body

application/json

market_capnumber

circulating_supplynumber

total_supplynumber

max_supplynumber

fully_diluted_valuationnumber

inflation_monthlynumber

burn_rate_monthlynumber

timestampinteger (int64)

Request

JavaScriptCurl

const response = await fetch('https://api.alterscope.org/data/tokenomics/allocations/{protocol}', {
    method: 'GET',
    headers: {
      "Authorization": "Bearer JWT"
    },
});
const data = await response.json();

Response

{
  "market_cap": 0,
  "circulating_supply": 0,
  "total_supply": 0,
  "max_supply": 0,
  "fully_diluted_valuation": 0,
  "inflation_monthly": 0,
  "burn_rate_monthly": 0
}

Sample Request

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.

Sample Response

{
    "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
        }
    ]
}

Sample Response Description

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.

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

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

GEThttps://api.alterscope.org/data/tokenomics/indicators/{protocol}

Authorization

BearerAuth

Path parameters

protocol*string

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

Response

200404505

OK

Body

application/json

market_capnumber

circulating_supplynumber

total_supplynumber

max_supplynumber

fully_diluted_valuationnumber

inflation_monthlynumber

burn_rate_monthlynumber

timestampinteger (int64)

Request

JavaScriptCurl

const response = await fetch('https://api.alterscope.org/data/tokenomics/indicators/{protocol}', {
    method: 'GET',
    headers: {
      "Authorization": "Bearer JWT"
    },
});
const data = await response.json();

Response

{
  "market_cap": 0,
  "circulating_supply": 0,
  "total_supply": 0,
  "max_supply": 0,
  "fully_diluted_valuation": 0,
  "inflation_monthly": 0,
  "burn_rate_monthly": 0
}

Sample Request

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.

Sample Response

{
    "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
        }
    ]
}

Sample Response Description

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.

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

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

GEThttps://api.alterscope.org/data/tokenomics/metrics/{protocol}

Authorization

BearerAuth

Path parameters

protocol*string

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

Response

200404505

OK

Body

application/json

market_capnumber

circulating_supplynumber

total_supplynumber

max_supplynumber

fully_diluted_valuationnumber

inflation_monthlynumber

burn_rate_monthlynumber

timestampinteger (int64)

Request

JavaScriptCurl

const response = await fetch('https://api.alterscope.org/data/tokenomics/metrics/{protocol}', {
    method: 'GET',
    headers: {
      "Authorization": "Bearer JWT"
    },
});
const data = await response.json();

Response

{
  "market_cap": 0,
  "circulating_supply": 0,
  "total_supply": 0,
  "max_supply": 0,
  "fully_diluted_valuation": 0,
  "inflation_monthly": 0,
  "burn_rate_monthly": 0
}

Sample Request

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.

Sample Response

{
    "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

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.

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

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

GEThttps://api.alterscope.org/data/tokenomics/exchanges/{protocol}

Authorization

BearerAuth

Path parameters

protocol*string

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

Response

200404505

OK

Body

application/json

market_capnumber

circulating_supplynumber

total_supplynumber

max_supplynumber

fully_diluted_valuationnumber

inflation_monthlynumber

burn_rate_monthlynumber

timestampinteger (int64)

Request

JavaScriptCurl

const response = await fetch('https://api.alterscope.org/data/tokenomics/exchanges/{protocol}', {
    method: 'GET',
    headers: {
      "Authorization": "Bearer JWT"
    },
});
const data = await response.json();

Response

{
  "market_cap": 0,
  "circulating_supply": 0,
  "total_supply": 0,
  "max_supply": 0,
  "fully_diluted_valuation": 0,
  "inflation_monthly": 0,
  "burn_rate_monthly": 0
}

Sample Request

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.

Sample Response

{
    "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
        }
    ]
}

Sample Response Description

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.

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

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

GEThttps://api.alterscope.org/data/tokenomics/breakdown/{protocol}

Authorization

BearerAuth

Path parameters

protocol*string

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

Response

200404505

OK

Body

application/json

Other propertiesnumber

Request

JavaScriptCurl

const response = await fetch('https://api.alterscope.org/data/tokenomics/breakdown/{protocol}', {
    method: 'GET',
    headers: {
      "Authorization": "Bearer JWT"
    },
});
const data = await response.json();

Sample Request

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.

Sample Response

{
    "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
        }
    ]
}

Sample Response Description

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.