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
  3. Liquidity

Stablecoin Protocols

The Stablecoin data endpoints can be used to retrieve analytics data about key liquidity metrics.

PreviousDecentralized Exchange ProtocolsNextDerivative Protocols

Last updated 1 year ago

Data

Note: The sample request below retrieves weekly analytics data for makerdaoprotocol.

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

For a supported list of stablecoin protocols whose data can be requested please refer to page. Currently makerdao and liquity stablecoin protocol is supported.

{
   "status":true,
   "data":{
      "Name":"MakerDAO",
      "total_collateral_usd":4589976934.9680605,
      "total_debt_usd":1487285345.8479655,
      "total_debt_base":1487355674.1000168,
      "number_unique_wallets":989
   }
}
  • name: This field contains the name of the Stablecoin protocol.

  • total_collateral_usd: This field represents the value of the total collateral deposited in the respective stablecoin protocol measured in United States Dollars(USD).

  • total_debt_base: This field is the value of the total debt issued, i.e., minted stablecoins by the respective stablecoin protocol measured in its native unit.

  • total_debt_usd: This field is the value of the total debt issued, i.e., minted stablecoins by the respective stablecoin protocol measured in United States Dollars(USD).

  • number_unique_wallets: This field contains the number of tracked wallets that opened a collateral debt position with this stablecoin protocol.

Note: The sample request below retrieves analytics data on the collaterals for a makerdao protocol.

curl https://api.alterscope.org/data/stablecoin/makerdao/collaterals -H "Authorization: Bearer <your_access_token>"
{
   "status":true,
   "data":{
      "token_address":"0x6b175474e89094c44da98b954eedeac495271d0f",
      "total_collateral_usd":4986938112.952093,
      "total_debt_base":1060894036.6684554,
      "total_debt_usd":1060864899.6319156,
      "collateral_assets":[
         {
            "collateral_address":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
            "collateral_name":"Wrapped Ether",
            "collateral_symbol":"WETH",
            "total_collateral_base":665727.3746489253,
            "total_collateral_usd":2456965479.516718,
            "collateral_backed_debt_base":1694472226.919732,
            "collateral_backed_debt_usd":1694458951.3908396,
            "number_of_cdps":619,
            "liquidation_threshold":0.6896551724137931
         },
         {
            "collateral_address":"0x0d8775f648430679a709e98d2b0cb6250d2887ef",
            "collateral_name":"Basic Attention Token",
            "collateral_symbol":"BAT",
            "total_collateral_base":1902.6915379740408,
            "total_collateral_usd":638.843108498849,
            "collateral_backed_debt_base":5.703991554246051,
            "collateral_backed_debt_usd":5.703956325882579,
            "number_of_cdps":21,
            "liquidation_threshold":0.008928571428571428
         },
         {
            "collateral_address":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
            "collateral_name":"USD Coin",
            "collateral_symbol":"USDC",
            "total_collateral_base":192.9477226936664,
            "total_collateral_usd":193.06338606401323,
            "collateral_backed_debt_base":12.870971895524992,
            "collateral_backed_debt_usd":12.870892404267549,
            "number_of_cdps":7,
            "liquidation_threshold":0.06666666666666667
         },
         {
            "collateral_address":"0x2260fac5e5542a773aa44fbcfedf7c193bc2c599",
            "collateral_name":"Wrapped BTC",
            "collateral_symbol":"WBTC",
            "total_collateral_base":8085.87528043652,
            "total_collateral_usd":548080393.3038312,
            "collateral_backed_debt_base":378003996.7192654,
            "collateral_backed_debt_usd":377986478.14057314,
            "number_of_cdps":237,
            "liquidation_threshold":0.6896551724137931
         },
         {
            "collateral_address":"0xe41d2489571d322189246dafa5ebde1f4699f498",
            "collateral_name":"0x Protocol Token",
            "collateral_symbol":"ZRX",
            "total_collateral_base":0.00192807206330498,
            "total_collateral_usd":0.0023318127827318424,
            "collateral_backed_debt_base":0.000042396857893108954,
            "collateral_backed_debt_usd":0.00004239659604966986,
            "number_of_cdps":2,
            "liquidation_threshold":0.01818181818181818
         },
         {
            "collateral_address":"0xdd974d5c2e2928dea5f71b9825b8b646686bd200",
            "collateral_name":"Kyber Network Crystal",
            "collateral_symbol":"KNC",
            "total_collateral_base":103.52017517545713,
            "total_collateral_usd":104.36518532715658,
            "collateral_backed_debt_base":2.0900484479589814,
            "collateral_backed_debt_usd":2.0900099711132505,
            "number_of_cdps":6,
            "liquidation_threshold":0.020025930721644727
         },
         {
            "collateral_address":"0x0f5d2fb29fb7d3cfee444a200298f468908cc942",
            "collateral_name":"Decentraland MANA",
            "collateral_symbol":"MANA",
            "total_collateral_base":6.18e-16,
            "total_collateral_usd":4.21047643e-16,
            "collateral_backed_debt_base":2.4060013909184003e-16,
            "collateral_backed_debt_usd":2.405986531428571e-16,
            "number_of_cdps":3,
            "liquidation_threshold":0.5714285714285714
         },
         {
            "collateral_address":"0xc00e94cb662c3520282e6f5717214004a7f26888",
            "collateral_name":"Compound",
            "collateral_symbol":"COMP",
            "total_collateral_base":0.000009659620362298,
            "total_collateral_usd":0.0007853271354548274,
            "collateral_backed_debt_base":0.000039273405563571924,
            "collateral_backed_debt_usd":0.000039266356772741375,
            "number_of_cdps":1,
            "liquidation_threshold":0.05
         },
         {
            "collateral_address":"0xbbbbca6a901c926f240b89eacb641d8aec7aeafd",
            "collateral_name":"LoopringCoin V2",
            "collateral_symbol":"LRC",
            "total_collateral_base":6.41e-16,
            "total_collateral_usd":3.1156143693967635e-16,
            "collateral_backed_debt_base":1.2821537496224825e-18,
            "collateral_backed_debt_usd":1.282145831027475e-18,
            "number_of_cdps":2,
            "liquidation_threshold":0.00411522633744856
         },
         {
            "collateral_address":"0x514910771af9ca656af840dff83e8264ecf986ca",
            "collateral_name":"ChainLink Token",
            "collateral_symbol":"LINK",
            "total_collateral_base":14148.128035278458,
            "total_collateral_usd":274119.9828029706,
            "collateral_backed_debt_base":2741.216758010396,
            "collateral_backed_debt_usd":2741.1998280297066,
            "number_of_cdps":10,
            "liquidation_threshold":0.01
         },
         {
            "collateral_address":"0xba100000625a3754423978a60c9317c58a424e3d",
            "collateral_name":"Balancer",
            "collateral_symbol":"BAL",
            "total_collateral_base":4.95638899e-10,
            "total_collateral_usd":2.6728880564373347e-9,
            "collateral_backed_debt_base":1.1621324192712882e-10,
            "collateral_backed_debt_usd":1.1621252419292759e-10,
            "number_of_cdps":1,
            "liquidation_threshold":0.043478260869565216
         },
         {
            "collateral_address":"0x0bc529c00c6401aef6d220be8c6ea1667f6ad93e",
            "collateral_name":"yearn.finance",
            "collateral_symbol":"YFI",
            "total_collateral_base":5.940458094676743,
            "total_collateral_usd":54997.846329895096,
            "collateral_backed_debt_base":549.9818599926875,
            "collateral_backed_debt_usd":549.978463298951,
            "number_of_cdps":2,
            "liquidation_threshold":0.01
         },
         {
            "collateral_address":"0x1f9840a85d5af5bf1d1762f925bdaddc4201f984",
            "collateral_name":"Uniswap",
            "collateral_symbol":"UNI",
            "total_collateral_base":152.02757806885538,
            "total_collateral_usd":1971.3415956632418,
            "collateral_backed_debt_base":151.64259775113922,
            "collateral_backed_debt_usd":151.6416612048648,
            "number_of_cdps":5,
            "liquidation_threshold":0.07692307692307693
         },
         {
            "collateral_address":"0xeb4c2781e4eba804ce9a9803c67d0893436bb27d",
            "collateral_name":"renBTC",
            "collateral_symbol":"renBTC",
            "total_collateral_base":0.000001266744095652,
            "total_collateral_usd":0.08600534003559127,
            "collateral_backed_debt_base":0.0017201176809100624,
            "collateral_backed_debt_usd":0.0017201068007118253,
            "number_of_cdps":4,
            "liquidation_threshold":0.02
         },
         {
            "collateral_address":"0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9",
            "collateral_name":"Aave Token",
            "collateral_symbol":"AAVE",
            "total_collateral_base":0.004472307164467653,
            "total_collateral_usd":0.5796110085150078,
            "collateral_backed_debt_base":0.027600029236654968,
            "collateral_backed_debt_usd":0.02760052421500037,
            "number_of_cdps":1,
            "liquidation_threshold":0.047619047619047616
         },
         {
            "collateral_address":"0xa478c2975ab1ea89e8196811f51a7b7ade33eb11",
            "collateral_name":"Uniswap V2",
            "collateral_symbol":"UNI-V2",
            "total_collateral_base":0.0058150000000000025,
            "total_collateral_usd":0,
            "collateral_backed_debt_base":0,
            "collateral_backed_debt_usd":0,
            "number_of_cdps":2,
            "liquidation_threshold":0.05
         },
         {
            "collateral_address":"0xbb2b8038a1640196fbe3e38816f3e67cba72d940",
            "collateral_name":"Uniswap V2",
            "collateral_symbol":"UNI-V2",
            "total_collateral_base":3.05509758e-10,
            "total_collateral_usd":0,
            "collateral_backed_debt_base":0,
            "collateral_backed_debt_usd":0,
            "number_of_cdps":1,
            "liquidation_threshold":0.041666666666666664
         },
         {
            "collateral_address":"0xae461ca67b15dc8dc81ce7615e0320da1a9ab8d5",
            "collateral_name":"Uniswap V2",
            "collateral_symbol":"UNI-V2",
            "total_collateral_base":0.003898250339616576,
            "total_collateral_usd":0,
            "collateral_backed_debt_base":0,
            "collateral_backed_debt_usd":0,
            "number_of_cdps":2,
            "liquidation_threshold":0.9803921568627451
         },
         {
            "collateral_address":"0xd3d2e2692501a5c9ca623199d38826e513033a17",
            "collateral_name":"Uniswap V2",
            "collateral_symbol":"UNI-V2",
            "total_collateral_base":0.016,
            "total_collateral_usd":0,
            "collateral_backed_debt_base":0,
            "collateral_backed_debt_usd":0,
            "number_of_cdps":1,
            "liquidation_threshold":0.625
         },
         {
            "collateral_address":"0x7d1afa7b718fb893db30a3abc0cfc608aacfebb0",
            "collateral_name":"Matic Token",
            "collateral_symbol":"MATIC",
            "total_collateral_base":21550,
            "total_collateral_usd":24543.295000000002,
            "collateral_backed_debt_base":245.43446580583546,
            "collateral_backed_debt_usd":245.43295000000003,
            "number_of_cdps":1,
            "liquidation_threshold":0.01
         },
         {
            "collateral_address":"0xabddafb225e10b90d798bb8a886238fb835e2053",
            "collateral_name":"Gelato Uniswap DAI/USDC LP",
            "collateral_symbol":"G-UNI",
            "total_collateral_base":24.050203486690403,
            "total_collateral_usd":0,
            "collateral_backed_debt_base":0,
            "collateral_backed_debt_usd":0,
            "number_of_cdps":1,
            "liquidation_threshold":0.9803921568627451
         },
         {
            "collateral_address":"0x7f39c581f595b53c5cb19bd0b3f8da6c935e2ca0",
            "collateral_name":"Wrapped liquid staked Ether 2.0",
            "collateral_symbol":"wstETH",
            "total_collateral_base":464050.6797219523,
            "total_collateral_usd":1981131090.170972,
            "collateral_backed_debt_base":1320771660.1759658,
            "collateral_backed_debt_usd":1320754060.1139817,
            "number_of_cdps":172,
            "liquidation_threshold":0.6666666666666666
         },
         {
            "collateral_address":"0x50379f632ca68d36e50cfbc8f78fe16bd1499d1e",
            "collateral_name":"Gelato Uniswap DAI/USDC LP",
            "collateral_symbol":"G-UNI",
            "total_collateral_base":36247.65929785322,
            "total_collateral_usd":0,
            "collateral_backed_debt_base":0,
            "collateral_backed_debt_usd":0,
            "number_of_cdps":2,
            "liquidation_threshold":0.9803921568627451
         },
         {
            "collateral_address":"0xae78736cd615f374d3085123a210448e74fc6393",
            "collateral_name":"Rocket Pool ETH",
            "collateral_symbol":"rETH",
            "total_collateral_base":99.61752943526507,
            "total_collateral_usd":404580.5544307252,
            "collateral_backed_debt_base":4046.4827683354456,
            "collateral_backed_debt_usd":4045.8055443072526,
            "number_of_cdps":3,
            "liquidation_threshold":0.01
         }
      ],
      "number_unique_wallets":989,
      "timestamp":1710482419
   }
}
  • token_address: This field contains the contract address of the stablecoin.

  • total_collateral_usd: This field represents the value of the total collateral deposited in the respective stablecoin protocol measured in United States Dollars.

  • total_debt_base: This field is the value of the total debt issued, i.e., minted stablecoins by the respective stablecoin protocol measured in its native unit.

  • total_debt_usd: This field is the value of the total debt issued, i.e., minted stablecoins by the respective stablecoin protocol measured in United States Dollars.

  • collateral_assets: This field contains a list of the accepted collateral assets used to mint the respective stablecoin.

    • collateral_address: The address of the collateral asset.

    • collateral_name: The name of the collateral asset.

    • collateral_symbol: The ticker symbol of the collateral asset.

    • total_collateral_base: This field represents the total value of this collateral type used in collateral debt positions for the respective stablecoin protocol, measured in the native unit of the collateral.

    • total_collateral_usd: This field represents the total value of this collateral type used in collateral debt positions for the respective stablecoin protocol, measured in United States Dollars.

    • collateral_backed_debt_base: The amount of debt, i.e. stablecoins, backed by this collateral, measured in the stablecoins native unit.

    • collateral_backed_debt_usd: The amount of debt, i.e. stablecoins, backed by this collateral, measured in United States Dollars.

    • number_of_cdps: The number of collateral debt positions that use this collateral type

    • liquidation_threshold: The liquidation rate. If the value of total_collateral_usd x liquidation_threshold < total_debt_usd, the position will be liquidated.

  • number_unique_wallets: This field contains the number of tracked wallets that opens a collateral debt position with the stablecoin protocol.

  • timestamp: The date and time of when the stablecoin data was recorded.


Scores

Note: The sample request below retrieves score data for a specificed stable coin protocol and chain.

curl https://api.alterscope.org/scores/liquidity-stablecoin/ethereum/liquity -H "Authorization: Bearer <your_access_token>"

The sample response below will display stablecoin score data of a specified protocol for last 7 days.

{
   "status":true,
   "data":[
      {
         "chain":"ethereum",
         "protocol":"liquity",
         "stablecoin_symbol":"LUSD",
         "health_factor":1.8428889631239296,
         "health_score":0.9479546044664564,
         "timestamp":"01-01-2024"
      },
      {
         "chain":"ethereum",
         "protocol":"liquity",
         "stablecoin_symbol":"LUSD",
         "health_factor":1.7569501698636152,
         "health_score":0.9296512030163063,
         "timestamp":"31-12-2023"
      },
      {
         "chain":"ethereum",
         "protocol":"liquity",
         "stablecoin_symbol":"LUSD",
         "health_factor":1.7535343125809177,
         "health_score":0.9288035053829082,
         "timestamp":"30-12-2023"
      },
      {
         "chain":"ethereum",
         "protocol":"liquity",
         "stablecoin_symbol":"LUSD",
         "health_factor":1.7674702402008913,
         "health_score":0.9321990336870866,
         "timestamp":"29-12-2023"
      },
      {
         "chain":"ethereum",
         "protocol":"liquity",
         "stablecoin_symbol":"LUSD",
         "health_factor":1.8602988171911417,
         "health_score":0.9510368650250379,
         "timestamp":"28-12-2023"
      },
      {
         "chain":"ethereum",
         "protocol":"liquity",
         "stablecoin_symbol":"LUSD",
         "health_factor":1.8846563114809585,
         "health_score":0.9550452376266522,
         "timestamp":"27-12-2023"
      },
      {
         "chain":"ethereum",
         "protocol":"liquity",
         "stablecoin_symbol":"LUSD",
         "health_factor":1.7505525264553823,
         "health_score":0.9280551833320896,
         "timestamp":"26-12-2023"
      }
   ]
}
  • Chain: This heading refers to the blockchain network on which the described information is based. In this case, its the Ethereum blockchain.

  • Protocol: This heading indicates the specific stablecoin protocol within the Ethereum blockchain that is being discussed. In this case, its the Liquity protocol.

  • Stablecoin Symbol: This heading provides information about the stablecoin associated with the given data. In this case, the stablecoin symbol is "LUSD,"

  • Health Factor: The health factor of a protocol is a weighted average of all wallets. Given a protocol the weighted average is computed using the wallets that have any debt and the coefficients are based on the debt of the wallet.

  • Health Score: Similar to the health factor, the health score is a numerical representation of the overall health or stability of a stablecoin protocol.

  • Timestamp: Indicates the date and time associated with the specified information.

curl https://api.alterscope.org/scores/liquidity-stablecoin-all-markets -H "Authorization: Bearer <your_access_token>"
{
   "status":true,
   "data":[
      {
         "chain":"ethereum",
         "protocol":"makerdao",
         "stablecoin_symbol":"DAI",
         "health_factor":1.5083912963912889,
         "health_score":0.8318171528082828,
         "timestamp":"14-03-2024"
      },
      {
         "chain":"ethereum",
         "protocol":"reflexer",
         "stablecoin_symbol":"Reflexer",
         "health_factor":3.4212672213547544,
         "health_score":0.9997945511985772,
         "timestamp":"14-03-2024"
      },
      {
         "chain":"ethereum",
         "protocol":"liquity",
         "stablecoin_symbol":"LUSD",
         "health_factor":3.307700937274117,
         "health_score":0.9996940494120233,
         "timestamp":"14-03-2024"
      },
      {
         "chain":"ethereum",
         "protocol":"makerdao",
         "stablecoin_symbol":"DAI",
         "health_factor":1.6150821802087763,
         "health_score":0.8843077090342522,
         "timestamp":"13-03-2024"
      },
      {
         "chain":"ethereum",
         "protocol":"liquity",
         "stablecoin_symbol":"LUSD",
         "health_factor":3.5533009061653162,
         "health_score":0.9998706899380724,
         "timestamp":"13-03-2024"
      },
      {
         "chain":"ethereum",
         "protocol":"reflexer",
         "stablecoin_symbol":"Reflexer",
         "health_factor":3.6741076686161613,
         "health_score":0.9999153438977243,
         "timestamp":"13-03-2024"
      },
      {
         "chain":"ethereum",
         "protocol":"liquity",
         "stablecoin_symbol":"LUSD",
         "health_factor":3.6093200272530517,
         "health_score":0.9998937516997781,
         "timestamp":"12-03-2024"
      },
      {
         "chain":"ethereum",
         "protocol":"makerdao",
         "stablecoin_symbol":"DAI",
         "health_factor":1.6124472147152382,
         "health_score":0.8832337980642719,
         "timestamp":"12-03-2024"
      },
      {
         "chain":"ethereum",
         "protocol":"reflexer",
         "stablecoin_symbol":"Reflexer",
         "health_factor":3.755010729660487,
         "health_score":0.9999362540325296,
         "timestamp":"12-03-2024"
      },
      {
         "chain":"ethereum",
         "protocol":"liquity",
         "stablecoin_symbol":"LUSD",
         "health_factor":3.6259948345817694,
         "health_score":0.9998997860267581,
         "timestamp":"11-03-2024"
      },
      {
         "chain":"ethereum",
         "protocol":"makerdao",
         "stablecoin_symbol":"DAI",
         "health_factor":1.6890940795824299,
         "health_score":0.9107530726848247,
         "timestamp":"11-03-2024"
      },
      {
         "chain":"ethereum",
         "protocol":"reflexer",
         "stablecoin_symbol":"Reflexer",
         "health_factor":3.750420265628558,
         "health_score":0.9999352196281078,
         "timestamp":"11-03-2024"
      },
      {
         "chain":"ethereum",
         "protocol":"makerdao",
         "stablecoin_symbol":"DAI",
         "health_factor":1.6809563974583932,
         "health_score":0.9081697057653347,
         "timestamp":"10-03-2024"
      },
      {
         "chain":"ethereum",
         "protocol":"liquity",
         "stablecoin_symbol":"LUSD",
         "health_factor":3.445431864294772,
         "health_score":0.9998112426850909,
         "timestamp":"10-03-2024"
      },
      {
         "chain":"ethereum",
         "protocol":"reflexer",
         "stablecoin_symbol":"Reflexer",
         "health_factor":3.6370818835378573,
         "health_score":0.9999036073211334,
         "timestamp":"10-03-2024"
      },
      {
         "chain":"ethereum",
         "protocol":"liquity",
         "stablecoin_symbol":"LUSD",
         "health_factor":3.4130424219634574,
         "health_score":0.9997885396317726,
         "timestamp":"09-03-2024"
      },
      {
         "chain":"ethereum",
         "protocol":"makerdao",
         "stablecoin_symbol":"DAI",
         "health_factor":1.5292575484018476,
         "health_score":0.8436834617270091,
         "timestamp":"09-03-2024"
      },
      {
         "chain":"ethereum",
         "protocol":"reflexer",
         "stablecoin_symbol":"Reflexer",
         "health_factor":3.7241701268436644,
         "health_score":0.99992897369609,
         "timestamp":"09-03-2024"
      },
      {
         "chain":"ethereum",
         "protocol":"liquity",
         "stablecoin_symbol":"LUSD",
         "health_factor":3.5366863949785334,
         "health_score":0.9998629325902716,
         "timestamp":"08-03-2024"
      },
      {
         "chain":"ethereum",
         "protocol":"reflexer",
         "stablecoin_symbol":"Reflexer",
         "health_factor":3.6984065578232923,
         "health_score":0.9999222583047034,
         "timestamp":"08-03-2024"
      },
      {
         "chain":"ethereum",
         "protocol":"makerdao",
         "stablecoin_symbol":"DAI",
         "health_factor":1.519641485839675,
         "health_score":0.838322708126928,
         "timestamp":"08-03-2024"
      }
   ]
}
  • Chain: Ethereum

    • This heading indicates the blockchain network on which the described system or project operates. In this case, it is Ethereum, one of the major blockchain platforms known for supporting smart contracts.

  • Protocol: Liquity

    • This heading specifies the protocol or system being referred to. In this context, it is Liquity, which is likely a decentralized finance (DeFi) protocol built on the Ethereum blockchain. Liquity may provide services related to lending, borrowing, or other financial activities.

  • Stablecoin Symbol: LUSD

    • This heading provides information about the stablecoin associated with the protocol. Stablecoins are cryptocurrencies designed to maintain a stable value, often pegged to a fiat currency. In this case, the stablecoin symbol is LUSD.

  • Health Factor

    • The health factor of a protocol in our product means the weighted average of all wallets given a protocol. This weighted average is computed using the wallets that have any debt and the coefficients are based on the debt of the wallet.

  • Health Score

    • Similar to the health factor, the health score is a metric used to evaluate the robustness or risk associated with a user's position in a protocol.

  • Timestamp

    • This heading provides the timestamp or date associated with the information.


For a supported list of stablecoin protocols please refer to page. Currently makerdao and liquity stablecoin protocol is supported.

For a supported list of stablecoin protocols and chains please refer to and page. Currently ethereum liquityand ethereum makerdao chain protocol combinations are supported.

supported stablecoin protocols
supported protocols
chains
supported stablecoin protocols

Retrieves analytical data on the collaterals for the specified protocol.

get

This endpoint returns the latest analytical data on collateral usage for protocol.

Authorizations
Path parameters
protocolstringRequired

The name of the stablecoin protocol in lowercase

Example: makerdao
Responses
200
OK
application/json
404
There is no data for the provided `layer2`
505
Internal Server Error
get
GET /data/stablecoin/{protocol}/collaterals HTTP/1.1
Host: api.alterscope.org
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
  "token_address": "0x6b175474e89094c44da98b954eedeac495271d0f",
  "total_collateral_usd": 428920.0833265932,
  "total_debt_base": 106328.05916195828,
  "total_debt_usd": 107439.23948094973,
  "collateral_assets": [
    {
      "collateral_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2 Rollups",
      "collateral_name": "Wrapped Ether",
      "collateral_symbol": "WETH",
      "total_collateral_base": 100,
      "total_collateral_usd": 230000,
      "collateral_backed_debt_base": 120000,
      "collateral_backed_debt_usd": 120000,
      "number_of_cdps": 100,
      "liquidation_threshold": 0.6896551724137931
    },
    {
      "collateral_address": "0x2260fac5e5542a773aa44fbcfedf7c193bc2c599 Rollups",
      "collateral_name": "Wrapped BTC",
      "collateral_symbol": "WBTC",
      "total_collateral_base": 10,
      "total_collateral_usd": 420000,
      "collateral_backed_debt_base": 180000,
      "collateral_backed_debt_usd": 180000,
      "number_of_cdps": 87,
      "liquidation_threshold": 0.6896551724137931
    }
  ],
  "number_unique_wallets": 9,
  "timestamp": 1705298411
}

Retrieves the weekly analytics data for the specified protocol

get

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

Authorizations
Path parameters
protocolstringRequired

Name of the Stablecoin protocol or ticker of their Stablecoin, e.g. "makerdao" or "dai"

Responses
200
OK
application/json
404
There is no data for the provided `protocol`
505
Internal Server Error
get
GET /data/stablecoin/{protocol} HTTP/1.1
Host: api.alterscope.org
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
  "num_unique_wallets": 1,
  "total_collateral_usd": 1,
  "total_debt_base": 1,
  "total_debt_usd": 1
}

Retrieves weekly stablecoin scores.

get

Returns an array of liquidity and health scores for all stablecoins of the past 7 days in descending order.

Authorizations
Responses
200
OK
application/json
404
There is no data for the last week
505
Internal Server Error
get
GET /scores/liquidity-stablecoin-all-markets HTTP/1.1
Host: api.alterscope.org
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
[
  {
    "chain": "text",
    "protocol": "text",
    "stablecoin_symbol": "text",
    "health_factor": 1,
    "health_score": 1,
    "timestamp": "text"
  }
]

Retrieves score data for the specified protocol

get

This endpoint returns the last 7 entries of liquidity and health score for the specified protocol.

Authorizations
Path parameters
chainstringRequired

Name of the Chain the stablecoin protocol is deployed to, e.g. "ethereum"

protocolstringRequired

Name of the Stablecoin protocol or ticker of their Stablecoin, e.g. "makerdao" or "dai"

Responses
200
OK
application/json
404
There is no data for the provided `protocol`
505
Internal Server Error
get
GET /scores/liquidity-stablecoin/{chain}/{protocol} HTTP/1.1
Host: api.alterscope.org
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
[
  {
    "chain": "text",
    "protocol": "text",
    "stablecoin_symbol": "text",
    "health_factor": 1,
    "health_score": 1,
    "timestamp": "text"
  }
]
  • Data
  • GETRetrieves the weekly analytics data for the specified protocol
  • GETRetrieves analytical data on the collaterals for the specified protocol.
  • Scores
  • GETRetrieves score data for the specified protocol
  • GETRetrieves weekly stablecoin scores.