Stablecoin Protocols

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

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 supported stablecoin protocols 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>"

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

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

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

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.

Last updated 9 months ago