Liquid Staking Protocols

The endpoints listed can be used to retrieve the liquidity exposure score analysis of Liquid Staking protocols into the other DeFi protocols.

Note: The sample request below retrieves available lending markets for lido exposure.

curl https://api.alterscope.org/data/liquidity/liquid-staking/available-lending-markets-exposure -H "Authorization: Bearer <your_access_token>"

{
   "status":true,
   "data":[
      {
         "chain":"ethereum",
         "protocol":"aave",
         "version":"V3",
         "base_asset_symbol":"USDC"
      },
      {
         "chain":"ethereum",
         "protocol":"compound",
         "version":"V3",
         "base_asset_symbol":"ETH"
      }
   ]
}

Chain: This indicates the blockchain network on which the financial protocol operates. In this case, it is Ethereum.

Protocol: Refers to the specific decentralized finance (DeFi) protocol in this case its AAVE or Compound.

Version: Denotes the version of the protocol being used.

Base Asset Symbol: Represents the symbol of the base asset involved in the protocol.

curl https://api.alterscope.org/data/liquidity/liquid-staking/available-dexes-exposure -H "Authorization: Bearer <your_access_token>"

{
   "status":true,
   "data":[
      {
         "chain":"ethereum",
         "protocol":"curve",
         "version":"V3",
         "pool_addresses":[
            "0xdc24316b9ae028f1497c275eb9192a3ea0f67022"
         ]
      }
   ]
}

Chain: This indicates the blockchain network on which the financial protocol operates. In this case, it is Ethereum.

Protocol: Refers to the specific decentralized finance (DeFi) protocol in this case its AAVE or Compound.

Version: Denotes the version of the protocol being used.

Base Asset Symbol: Represents the symbol of the base asset involved in the protocol. Pool Address: In the context of decentralized exchanges (DEX), a pool address typically refers to a liquidity pool's smart contract address.

Note: The sample request below requests asset analytics data for aave lending protocol on ethereum chain.

curl https://api.alterscope.org/data/liquidity/liquid-staking/asset-analytics-in-lending/ethereum/aave/V3/ETH/true -H "Authorization: Bearer <your_access_token>"

For a list of supported lending protocol versions and chains please check sample response for Retrieves the available lending protocol options for Lido exposure API endpoint.

The response is shortened for formatting purposes. The actual response will display data for a whole week.

{
   "status":true,
   "data":[
      {
         "chain":"ethereum",
         "protocol":"aave",
         "version":"V3",
         "base_asset_symbol":"ETH",
         "token_data":[
            {
               "token_address":"0x0b925ed163218f6662a35e0f0371ac234f9e9371",
               "token_symbol":"aEthwstETH",
               "token_decimal":18
            },
            {
               "token_address":"0xc96113eed8cab59cd8a66813bcb0ceb29f06d2e4",
               "token_symbol":"variableDebtEthwstETH",
               "token_decimal":18
            }
         ],
         "total_supply_base":62529.80335288431,
         "total_supply_usd":166803477.2101942,
         "total_borrow_token":210.38017458743823,
         "total_borrow_usd":561206.7010547178,
         "in_risk":true,
         "unique_wallet_num":131,
         "timestamp":"21-01-2024"
      },
      {
         "chain":"ethereum",
         "protocol":"aave",
         "version":"V3",
         "base_asset_symbol":"ETH",
         "token_data":[
            {
               "token_address":"0x0b925ed163218f6662a35e0f0371ac234f9e9371",
               "token_symbol":"aEthwstETH",
               "token_decimal":18
            },
            {
               "token_address":"0xc96113eed8cab59cd8a66813bcb0ceb29f06d2e4",
               "token_symbol":"variableDebtEthwstETH",
               "token_decimal":18
            }
         ],
         "total_supply_base":67149.0861399047,
         "total_supply_usd":180443729.18166983,
         "total_borrow_token":130.01454127157507,
         "total_borrow_usd":349376.4401500226,
         "in_risk":true,
         "unique_wallet_num":121,
         "timestamp":"21-01-2024"
      },
      {
         "chain":"ethereum",
         "protocol":"aave",
         "version":"V3",
         "base_asset_symbol":"ETH",
         "token_data":[
            {
               "token_address":"0x0b925ed163218f6662a35e0f0371ac234f9e9371",
               "token_symbol":"aEthwstETH",
               "token_decimal":18
            },
            {
               "token_address":"0xc96113eed8cab59cd8a66813bcb0ceb29f06d2e4",
               "token_symbol":"variableDebtEthwstETH",
               "token_decimal":18
            }
         ],
         "total_supply_base":74524.7145546395,
         "total_supply_usd":201723371.51253065,
         "total_borrow_token":204.68799171957352,
         "total_borrow_usd":554049.110346184,
         "in_risk":true,
         "unique_wallet_num":127,
         "timestamp":"21-01-2024"
      }

Chain: This field provides information related to the used blockchain in this case its ethereum.

Protocol: Refers to the specific decentralized finance (DeFi) protocol in this case it can be AAVE or Compound.

Version: Specifies the version of the protocol being used.

Base Asset Symbol: Represents the symbol of the base asset involved in the protocol.

Token Data: Provides details about specific tokens within the protocol.

Total Supply Base: Represents the total supply of the base asset.

Total Supply USD: Indicates the total value of the supplied assets in USD.

Total Borrow Token: Specifies the total amount of borrowed tokens within the protocol.

Total Borrow USD: Represents the total value of borrowed assets in USD.

In Risk: A boolean (true or false)when true will perform analysis of risky wallets within the protocol.

Unique Wallet Number: Denotes the number of unique wallets involved with the protocol.

Timestamp: Represents the date and time when the data was recorded.

Note: The sample request below retrieves data analytics for 0xdc24316b9ae028f1497c275eb9192a3ea0f67022 dex pool.

curl https://api.alterscope.org/data/liquidity/liquid-staking/pool-analytics-in-dex/0xdc24316b9ae028f1497c275eb9192a3ea0f67022 -H "Authorization: Bearer <your_access_token>"

For a list of supported dex protocols and pools please check sample response for Retrieves the available dex protocol options API endpoint.

The sample response is shortened for formatting purposes. The actual response will list data for a whole week.

{
   "status":true,
   "data":[
      {
         "chain":"ethereum",
         "protocol":"curve",
         "version":"V3",
         "pool_address":"0xdc24316b9ae028f1497c275eb9192a3ea0f67022",
         "token_amounts":[
            {
               "token_index":0,
               "token_amount":45825.051570790754,
               "token_amount_usd":107083088.0258394
            },
            {
               "token_index":1,
               "token_amount":46639.517868612966,
               "token_amount_usd":108953303.93172133
            }
         ],
         "token_amount_changes":[
            {
               "token_index":0,
               "token_exchange_amount":284.9471890490022,
               "token_exchange_usd":672211.0749278218
            },
            {
               "token_index":1,
               "token_exchange_amount":-284.3447827082491,
               "token_exchange_usd":-672073.139674915
            }
         ],
         "token_volumes":[
            {
               "token_index":0,
               "token_exchange_amount":7456.42691047269,
               "token_exchange_usd":17586712.729608826
            },
            {
               "token_index":1,
               "token_exchange_amount":7460.860423080255,
               "token_exchange_usd":17566542.10582555
            }
         ],
         "volume_usd":17576627.417717185,
         "fee_usd":1757.6627417717186,
         "tvl_usd":216036391.95756072,
         "num_unique_wallets":31,
         "num_transactions":153,
         "timestamp":"22-01-2024"
      }
   ]
}

Data:
- Chain: The blockchain network used.
- Protocol: The specific protocol used.
- Version: The version of the protocol.
- Pool Address: The address of the liquidity pool on the Ethereum blockchain.
- Token Amounts: Information about the amounts of tokens in the pool.
- Token Amount Changes: Changes in token amounts due to exchanges.
- Token Volumes: Information about token exchange volumes.
- Volume USD: Total exchange volume in USD.
- Fee USD: The total fees generated from transactions.
- TVL USD: Total Value Locked in the pool in USD.
- Num Unique Wallets: The number of unique wallets involved with the dex protocol.
- Num Transactions: The total number of transactions.
- Timestamp: The date and time of the data.

Note: The sample request below provides score data for aave lending protocol on ethereum chain with USDC base asset.

curl https://api.alterscope.org/scores/liquidity/liquid-staking/exposure-in-lending/ethereum/aave/V3/USDC/true -H "Authorization: Bearer <your_access_token>"

For a list of supported protocol versions, base asset and chains please check sample response for Retrieving the available lending protocol options for Lido exposure API endpoint.

{
   "status":true,
   "data":[
      {
         "chain":"ethereum",
         "protocol":"aave",
         "version":"V3",
         "base_asset_symbol":"USDC",
         "health_factor":1.0595224219074546,
         "liquidity_score":0.18837658303544902,
         "in_risk":true,
         "timestamp":"18-01-2024"
      },
      {
         "chain":"ethereum",
         "protocol":"aave",
         "version":"V3",
         "base_asset_symbol":"USDC",
         "health_factor":1.0597013895267886,
         "liquidity_score":0.18888576589766792,
         "in_risk":true,
         "timestamp":"18-01-2024"
      }

Chain: This indicates the blockchain network on which the financial protocol operates. In this case, it is Ethereum.

Protocol: Refers to the specific decentralized finance (DeFi) protocol in this case its AAVE.

Version: Denotes the version of the protocol being used.

Base Asset Symbol: Represents the symbol of the base asset involved in the protocol.

Health Factor: Indicates the health factor of the protocol which is a metric used in decentralized lending platforms to assess the health of a user's position.

Liquidity Score: Represents a liquidity score associated with the protocol.

In Risk: Indicates whether the protocol is currently considered to be at risk.

Timestamp: Specifies the date and time when this data was recorded

Note: The sample request below provides score data for a given dex pool.

curl https://api.alterscope.org/scores/liquidity/liquid-staking/dex-pool-scores/0xdc24316b9ae028f1497c275eb9192a3ea0f67022 -H "Authorization: Bearer <your_access_token>"

For a list of supported dex protocols and pools please check sample response for Retrieving the available dex protocol options for Lido exposure API endpoint.

The sample response below is shortened for formatting purposes and only display data for single day. The actual response will display data for whole week.

{
   "status":true,
   "data":[
      {
         "chain":"ethereum",
         "protocol":"curve",
         "version":"V3",
         "pool_address":"0xdc24316b9ae028f1497c275eb9192a3ea0f67022",
         "mean_volume_usd":160788.45423113377,
         "median_volume_usd":75693.37095945826,
         "volume_continuity_score":0.48608374767192025,
         "timestamp":"14-03-2024"
      },
      {
         "chain":"ethereum",
         "protocol":"curve",
         "version":"V3",
         "pool_address":"0xdc24316b9ae028f1497c275eb9192a3ea0f67022",
         "mean_volume_usd":208847.73139931157,
         "median_volume_usd":48219.52534662029,
         "volume_continuity_score":0.31886541907022636,
         "timestamp":"13-03-2024"
      },
      {
         "chain":"ethereum",
         "protocol":"curve",
         "version":"V3",
         "pool_address":"0xdc24316b9ae028f1497c275eb9192a3ea0f67022",
         "mean_volume_usd":124548.97114337476,
         "median_volume_usd":14230.237988262397,
         "volume_continuity_score":0.1680855461767164,
         "timestamp":"12-03-2024"
      },
      {
         "chain":"ethereum",
         "protocol":"curve",
         "version":"V3",
         "pool_address":"0xdc24316b9ae028f1497c275eb9192a3ea0f67022",
         "mean_volume_usd":154866.88146855406,
         "median_volume_usd":21948.537969712954,
         "volume_continuity_score":0.2650899167825727,
         "timestamp":"11-03-2024"
      },
      {
         "chain":"ethereum",
         "protocol":"curve",
         "version":"V3",
         "pool_address":"0xdc24316b9ae028f1497c275eb9192a3ea0f67022",
         "mean_volume_usd":98548.42896632815,
         "median_volume_usd":18706.88092443729,
         "volume_continuity_score":0.2968387715540281,
         "timestamp":"10-03-2024"
      },
      {
         "chain":"ethereum",
         "protocol":"curve",
         "version":"V3",
         "pool_address":"0xdc24316b9ae028f1497c275eb9192a3ea0f67022",
         "mean_volume_usd":71154.21795126011,
         "median_volume_usd":4334.401435388576,
         "volume_continuity_score":0.022883097505936548,
         "timestamp":"09-03-2024"
      },
      {
         "chain":"ethereum",
         "protocol":"curve",
         "version":"V3",
         "pool_address":"0xdc24316b9ae028f1497c275eb9192a3ea0f67022",
         "mean_volume_usd":82328.59841106525,
         "median_volume_usd":23075.42467400653,
         "volume_continuity_score":0.3969760086078749,
         "timestamp":"08-03-2024"
      }
   ]
}

Chain: Specifies the blockchain platform or network on which the DEX operates.

Protocol: Indicates the underlying set of rules and specifications governing the operation of the system or network.In this case its curve.

Version: Specifies the version or release of the protocol being used.

Pool Address: Refers to the unique address associated with a liquidity pool on the decentralized exchange.

Mean Volume (USD):Represents the average trading or transaction volume in US dollars over a certain period.

Median Volume (USD): Indicates the middle value of the trading or transaction volume when arranged in ascending order, providing a measure of central tendency.

Volume Continuity Score: Represents a numerical score indicating the consistency or continuity of transaction volumes over time.

Timestamp: Specifies the date and time when the data or information was recorded or retrieved.

Last updated 8 months ago