Decentralized Exchange Protocols
The DEX endpoints can be used to retrieve the data analytics and score analysis of various decentralized exchange pools and protocols.
Last updated
The DEX endpoints can be used to retrieve the data analytics and score analysis of various decentralized exchange pools and protocols.
Last updated
curl https://api.alterscope.org/data/liquidity/dex/available-dexes -H "Authorization: Bearer <your_access_token>"{
"status":true,
"data":[
{
"chain":"ethereum",
"protocol":"curve",
"version":"V3",
"exchange_name":"Curve.fi",
"number_of_pools":69
},
{
"chain":"ethereum",
"protocol":"uniswap",
"version":"V3",
"exchange_name":"Uniswap",
"number_of_pools":2663
},
{
"chain":"ethereum",
"protocol":"swaap",
"version":"V2",
"exchange_name":"Swaap",
"number_of_pools":2
},
{
"chain":"ethereum",
"protocol":"fraxfinance",
"version":"V2",
"exchange_name":"Fraxswap",
"number_of_pools":22
},
{
"chain":"ethereum",
"protocol":"balancer",
"version":"V2",
"exchange_name":"Balancer",
"number_of_pools":100
},
{
"chain":"ethereum",
"protocol":"pancakeswap",
"version":"V3",
"exchange_name":"Pancakeswap",
"number_of_pools":152
},
{
"chain":"arbitrum",
"protocol":"gmx",
"version":"V2",
"exchange_name":"GMX",
"number_of_pools":11
}
]
}Chain: Indicates that the protocol operates on the Ethereum blockchain.
Protocol: Refers to the specific protocol being used, in this case, "Curve." which is a decentralized exchange protocol designed for stablecoin trading.
Version: Specifies the version of the protocol.
Exchange Name: Indicates the name of the decentralized exchange.
Number of Pools: Indicates the total number of liquidity pools available within the decentralized exchange.
The request below will return the total of 3 pools from which pools at page 2 will be skipped:
curl https://api.alterscope.org/data/liquidity/dex/available-pools/ethereum/curve/V3/3/2 -H "Authorization: Bearer <your_access_token>"{
"status":true,
"data":[
{
"chain":"ethereum",
"protocol":"curve",
"version":"V3",
"pool_address":"0x4f062658eaaf2c1ccf8c8e36d6824cdf41167956"
},
{
"chain":"ethereum",
"protocol":"curve",
"version":"V3",
"pool_address":"0x42d7025938bec20b69cbae5a77421082407f053a"
}
]Status: Indicates the current status of the information being queried. In this case, it is set to "true," suggesting that the information is valid or active.
Data: This section contains an array of objects, with each object representing details about a specific instance of the Ethereum-based Curve protocol.
a. Chain: Specifies the blockchain network, and in this case, it is set to "ethereum," indicating that the Curve protocol is implemented on the Ethereum blockchain.
b. Protocol: Identifies the specific protocol being referred to, and here it is "curve," c. Version: Indicates the version of the protocol, and in this instance, it is "V3" .
d. Pool Address: Provides the Ethereum address associated with the pool related to this specific instance of the Curve protocol.
Below is a sample request with0x4f062658eaaf2c1ccf8c8e36d6824cdf41167956 pool address.
curl https://api.alterscope.org/data/liquidity/dex/pool-analytics/0x4f062658eaaf2c1ccf8c8e36d6824cdf41167956 -H "Authorization: Bearer <your_access_token>"The response below is shortened for formatting purposes and provide the details for a particular pool address.The actual response wil provide details for all pool addresses.
{
"status":true,
"data":[
{
"chain":"ethereum",
"protocol":"curve",
"version":"V3",
"pool_address":"0x4f062658eaaf2c1ccf8c8e36d6824cdf41167956",
"token_amounts":[
{
"token_index":0,
"token_amount":518723.68,
"token_amount_usd":519260.1532943955
},
{
"token_index":1,
"token_amount":670825.8747287109,
"token_amount_usd":670859.2140995725
},
{
"token_index":2,
"token_amount":666719.049342,
"token_amount_usd":666452.3617222633
},
{
"token_index":3,
"token_amount":416047.308811,
"token_amount_usd":416172.1230036433
}
],
"token_amount_changes":[
{
"token_index":0,
"token_exchange_amount":29604.499999999993,
"token_exchange_usd":29640.07509009719
},
{
"token_index":1,
"token_exchange_amount":-39173.173061940266,
"token_exchange_usd":-39179.774320744335
},
{
"token_index":2,
"token_exchange_amount":-0.9455979999984265,
"token_exchange_usd":-12.740826937471866
},
{
"token_index":3,
"token_exchange_amount":10694.066072,
"token_exchange_usd":10697.719318217047
}
],
"token_volumes":[
{
"token_index":0,
"token_exchange_amount":141198.86,
"token_exchange_usd":141367.05885017425
},
{
"token_index":1,
"token_exchange_amount":51458.13760116178,
"token_exchange_usd":51465.78262826082
},
{
"token_index":2,
"token_exchange_amount":77916.80664,
"token_exchange_usd":77905.22711062488
},
{
"token_index":3,
"token_exchange_amount":10694.066072,
"token_exchange_usd":10697.719318217047
}
],
"volume_usd":140717.8939536385,
"fee_usd":56.2871575814554,
"tvl_usd":2272743.8521198747,
"num_unique_wallets":5,
"num_transactions":5,
"timestamp":"10-01-2024"
}
]
}Status: Indicates whether the data retrieval was successful (true) or not (false).
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.
For Token Index 0:
Token Amount: 518,723.68 units.
Token Amount USD: Equivalent value in USD
For Token Index 1:
Token Amount: 670,825.87 units.
Token Amount USD: Equivalent value in USD
Token Amount Changes: Changes in token amounts due to exchanges.
For Token Index 0:
Token Exchange Amount: Increase of 29,604.50 units.
Token Exchange USD: Equivalent value in USD
For Token Index 1:
Token Exchange Amount: Decrease of 39,173.17 units.
Token Exchange USD: Equivalent value in USD
Token Volumes: Information about token exchange volumes.
For Token Index 0:
Token Exchange Amount: 141,198.86 units.
Token Exchange USD: Equivalent value in USD.
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.
Num Transactions: The total number of transactions.
Timestamp: The date and time of the data.
Note: The sample request below shows data analytics for dex ethereum chain and curve protocol.
curl https://api.alterscope.org/data/liquidity/dex/protocol-analytics/ethereum/curve/V3 -H "Authorization: Bearer <your_access_token>"{
"status":true,
"data":[
{
"chain":"ethereum",
"protocol":"curve",
"version":"V3",
"number_pools":134,
"volume_usd":101815637.69406167,
"fee_usd":14275.329625502236,
"tvl_usd":1487691526.5125606,
"num_unique_wallets":79,
"num_transactions":611,
"timestamp":"10-01-2024"
},
{
"chain":"ethereum",
"protocol":"curve",
"version":"V3",
"number_pools":134,
"volume_usd":75259388.11619864,
"fee_usd":12729.977378508884,
"tvl_usd":1443831039.331556,
"num_unique_wallets":89,
"num_transactions":628,
"timestamp":"09-01-2024"
},
{
"chain":"ethereum",
"protocol":"curve",
"version":"V3",
"number_pools":134,
"volume_usd":93074663.78976387,
"fee_usd":12558.170570493372,
"tvl_usd":1436969776.8029768,
"num_unique_wallets":89,
"num_transactions":620,
"timestamp":"08-01-2024"
},
{
"chain":"ethereum",
"protocol":"curve",
"version":"V3",
"number_pools":134,
"volume_usd":42436635.78817472,
"fee_usd":7022.872225321558,
"tvl_usd":1421678889.0068808,
"num_unique_wallets":51,
"num_transactions":327,
"timestamp":"07-01-2024"
},
{
"chain":"ethereum",
"protocol":"curve",
"version":"V3",
"number_pools":134,
"volume_usd":458002095.9427567,
"fee_usd":261488.89993302792,
"tvl_usd":1432715552.7894251,
"num_unique_wallets":52,
"num_transactions":392,
"timestamp":"06-01-2024"
},
{
"chain":"ethereum",
"protocol":"curve",
"version":"V3",
"number_pools":134,
"volume_usd":646954602.5218725,
"fee_usd":320251.97295946424,
"tvl_usd":1452101011.0679977,
"num_unique_wallets":78,
"num_transactions":581,
"timestamp":"05-01-2024"
}
]
}Chain: This indicates that the data is related to the particular blockchain network.
Protocol: Refers to the protocol, which is a decentralized finance (DeFi) protocol typically used for trading on the blockchain.
Version: Specifies the version of the protocol being utilized.
Number of Pools: Represents the total count of liquidity pools within the Curve protocol at the given timestamp.
Volume (USD): Indicates the total trading volume in USD within the specified time period.
Fee (USD): Represents the total fees earned in USD by the protocol during the given timeframe.
TVL (Total Value Locked) - USD: Denotes the total value of assets (cryptocurrencies or tokens) locked within the protocol, measured in USD.
Number of Unique Wallets: Represents the count of distinct wallets addresses that interacted with the protocol.
Number of Transactions: Indicates the total count of transactions that occurred within the protocol.
Timestamp: Specifies the date and time at which the provided data snapshot was taken.
Note: The sample request below shows data analytics for curve protocol.
curl https://api.alterscope.org/data/liquidity/dex/protocol-overview/curve -H "Authorization: Bearer <your_access_token>".{
"status":true,
"data":[
{
"chain":"ethereum",
"protocol":"curve",
"version":"V3",
"number_pools":134,
"volume_usd":45057465.201750934,
"fee_usd":6754.376684376131,
"tvl_usd":1435142290.6535392,
"num_unique_wallets":64,
"num_transactions":456,
"timestamp":"20-01-2024"
},
{
"chain":"ethereum",
"protocol":"curve",
"version":"V3",
"number_pools":134,
"volume_usd":199467749.27726495,
"fee_usd":34069.45533276601,
"tvl_usd":1438538956.177513,
"num_unique_wallets":80,
"num_transactions":665,
"timestamp":"19-01-2024"
},
{
"chain":"ethereum",
"protocol":"curve",
"version":"V3",
"number_pools":134,
"volume_usd":606290120.0112575,
"fee_usd":314953.74537371466,
"tvl_usd":1460936973.4823995,
"num_unique_wallets":56,
"num_transactions":465,
"timestamp":"17-01-2024"
},
{
"chain":"ethereum",
"protocol":"curve",
"version":"V3",
"number_pools":134,
"volume_usd":89868753.9839625,
"fee_usd":12308.92627978903,
"tvl_usd":1446979811.7493067,
"num_unique_wallets":67,
"num_transactions":372,
"timestamp":"16-01-2024"
},
{
"chain":"ethereum",
"protocol":"curve",
"version":"V3",
"number_pools":134,
"volume_usd":161160974.7780499,
"fee_usd":18228.762776722844,
"tvl_usd":1435149362.7714183,
"num_unique_wallets":66,
"num_transactions":430,
"timestamp":"15-01-2024"
},
{
"chain":"ethereum",
"protocol":"curve",
"version":"V3",
"number_pools":134,
"volume_usd":55421157.10479452,
"fee_usd":7129.290138714996,
"tvl_usd":1432652284.4134073,
"num_unique_wallets":63,
"num_transactions":343,
"timestamp":"14-01-2024"
}
]
}Chain: This indicates that the protocol operates on the Ethereum blockchain, a popular blockchain platform known for smart contracts and decentralized applications (DApps).
Protocol: Refers to the specific decentralized finance (DeFi) protocol being discussed.
Version: Denotes the version of the Curve Finance protocol being used, in this case, version 3 (V3).
Number of Pools: Represents the total number of liquidity pools available within the Curve Finance protocol at the specified timestamp.
Volume (USD): Represents the total trading volume in USD across all pools within the Curve Finance protocol during the specified timestamp.
Fee (USD): Represents the total fees generated in USD across all pools within the Curve Finance protocol during the specified timestamp.
TVL (USD): Stands for Total Value Locked (TVL) and represents the total value of assets locked within the Curve Finance protocol, denominated in USD.
Number of Unique Wallets: Indicates the total number of unique wallets or addresses that participated in transactions within the Curve Finance protocol during the specified time period.
Number of Transactions: Represents the total number of transactions that occurred within the Curve Finance protocol during the specified time period.
Timestamp: Specifies the date and time when the provided data was recorded.
curl https://api.alterscope.org/scores/liquidity/dex/pool-score/<pool_address> -H "Authorization: Bearer <your_access_token>"{
"status":true,
"data":[
{
"chain":"ethereum",
"protocol":"uniswap",
"version":"V3",
"pool_address":"0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
"mean_volume_usd":39941.92704864373,
"median_volume_usd":5751.8987987946,
"volume_continuity_score":0.47549519879257934,
"timestamp":"11-01-2024"
}
]
}{
"status":true,
"data":[
{
"chain":"ethereum",
"protocol":"uniswap",
"version":"V3",
"pool_address":"0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
"mean_volume_usd":39941.92704864373,
"median_volume_usd":5751.8987987946,
"volume_continuity_score":0.47549519879257934,
"timestamp":"11-01-2024"
},
{
"chain":"ethereum",
"protocol":"uniswap",
"version":"V3",
"pool_address":"0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
"mean_volume_usd":65218.66350777575,
"median_volume_usd":9284.980469723163,
"volume_continuity_score":0.4727939893721308,
"timestamp":"10-01-2024"
}
"pool_address":"0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
"mean_volume_usd":64029.12049476423,
"median_volume_usd":5780.267556432212,
"volume_continuity_score":0.4509446336730747,
"timestamp":"09-01-2024"
},
{
"chain":"ethereum",
"protocol":"uniswap",
"version":"V3",
"pool_address":"0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
"mean_volume_usd":61525.833440983115,
"median_volume_usd":5266.460554879306,
"volume_continuity_score":0.44649997366191396,
"timestamp":"09-01-2024"
},
{
"chain":"ethereum",
"protocol":"uniswap",
"version":"V3",
"pool_address":"0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
"mean_volume_usd":59659.464612770724,
"median_volume_usd":5171.2880985818065,
"volume_continuity_score":0.4480028467697199,
"timestamp":"09-01-2024"
},
{
"chain":"ethereum",
"protocol":"uniswap",
"version":"V3",
"pool_address":"0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640",
"mean_volume_usd":58107.24041761238,
"median_volume_usd":5002.474439280519,
"volume_continuity_score":0.44769126868695375,
"timestamp":"09-01-2024"
}
]
}Chain: Indicates the blockchain network or platform being used.
Protocol: This field specify the dex protocol used.
Version: Represents the version number associated with the blockchain or protocol.
Mean Volume USD: Refers to the average trading transaction volume in US dollars over a certain period.
Median Volume USD: Indicates the median trading or transaction volume in US dollars.
Volume Continuity Score: This score could represent a measure of the consistency or regularity of transaction volumes over time.
Timestamp: Represents the timestamp when the data was recorded.
Note: The sample request below retrieves protocol score for ethereum chain and uniswap protocol.
curl https://api.alterscope.org/scores/liquidity/dex/protocol-score/ethereum/uniswap/V3 -H "Authorization: Bearer <your_access_token>"{
"status":true,
"data":[
{
"chain":"ethereum",
"protocol":"uniswap",
"version":"V3",
"mean_volume_usd":30057.35683569536,
"median_volume_usd":2439.114402775852,
"volume_continuity_score":0.4823413434081393,
"timestamp":"20-12-2023"
},
{
"chain":"ethereum",
"protocol":"uniswap",
"version":"V3",
"mean_volume_usd":21661.180052610656,
"median_volume_usd":2172.049829696295,
"volume_continuity_score":0.4868080263267876,
"timestamp":"19-12-2023"
},
{
"chain":"ethereum",
"protocol":"uniswap",
"version":"V3",
"mean_volume_usd":24993.592458027866,
"median_volume_usd":2578.539249292922,
"volume_continuity_score":0.48752147729499223,
"timestamp":"18-12-2023"
},
{
"chain":"ethereum",
"protocol":"uniswap",
"version":"V3",
"mean_volume_usd":18606.02010425795,
"median_volume_usd":1847.5820364396382,
"volume_continuity_score":0.48707963884582645,
"timestamp":"17-12-2023"
},
{
"chain":"ethereum",
"protocol":"uniswap",
"version":"V3",
"mean_volume_usd":28319.970875951945,
"median_volume_usd":1880.9502043386037,
"volume_continuity_score":0.4824967705848901,
"timestamp":"16-12-2023"
},
{
"chain":"ethereum",
"protocol":"uniswap",
"version":"V3",
"mean_volume_usd":20433.871158236456,
"median_volume_usd":2247.551193415587,
"volume_continuity_score":0.489671700317849,
"timestamp":"15-12-2023"
},
{
"chain":"ethereum",
"protocol":"uniswap",
"version":"V3",
"mean_volume_usd":19955.648051362416,
"median_volume_usd":2143.3246847353244,
"volume_continuity_score":0.4891432579118372,
"timestamp":"14-12-2023"
}
]
}Chain: Indicates the blockchain network or platform, and in this case, it is specified as Ethereum. This suggests that the subsequent data is related to the Ethereum blockchain.
Protocol: This field is intended to specify the dex protocol for which volume continuity score has to be calculated.
Version: Represents the version number associated with the blockchain or cryptocurrency protocol.
Mean Volume USD: Refers to the average trading or transaction volume in US dollars over a certain period.
Median Volume USD: Indicates the median trading or transaction volume in US dollars.
Volume Continuity Score: This score could represent a measure of the consistency or regularity of transaction volumes over time.
Timestamp: Represents the timestamp or point in time when the data was recorded or when the specified measurements were taken.
Note: The sample request below retrieves volume continuity score for uniswap protocol.
curl https://api.alterscope.org/scores/liquidity/dex/protocol-overview/uniswap -H "Authorization: Bearer <your_access_token>"{
"status":true,
"data":[
{
"chain":"ethereum",
"protocol":"uniswap",
"version":"V3",
"mean_volume_usd":24993.592458027866,
"median_volume_usd":2578.539249292922,
"volume_continuity_score":0.48752147729499223,
"timestamp":"18-12-2023"
},
{
"chain":"ethereum",
"protocol":"uniswap",
"version":"V3",
"mean_volume_usd":18606.02010425795,
"median_volume_usd":1847.5820364396382,
"volume_continuity_score":0.48707963884582645,
"timestamp":"17-12-2023"
},
{
"chain":"ethereum",
"protocol":"uniswap",
"version":"V3",
"mean_volume_usd":28319.970875951945,
"median_volume_usd":1880.9502043386037,
"volume_continuity_score":0.4824967705848901,
"timestamp":"16-12-2023"
},
{
"chain":"ethereum",
"protocol":"uniswap",
"version":"V3",
"mean_volume_usd":20433.871158236456,
"median_volume_usd":2247.551193415587,
"volume_continuity_score":0.489671700317849,
"timestamp":"15-12-2023"
},
{
"chain":"ethereum",
"protocol":"uniswap",
"version":"V3",
"mean_volume_usd":19955.648051362416,
"median_volume_usd":2143.3246847353244,
"volume_continuity_score":0.4891432579118372,
"timestamp":"14-12-2023"
},
{
"chain":"ethereum",
"protocol":"uniswap",
"version":"V3",
"mean_volume_usd":24734.69607204835,
"median_volume_usd":2315.9890814078117,
"volume_continuity_score":0.48695219403226414,
"timestamp":"13-12-2023"
},
{
"chain":"ethereum",
"protocol":"uniswap",
"version":"V3",
"mean_volume_usd":21023.387630533733,
"median_volume_usd":2178.0373935742728,
"volume_continuity_score":0.4878724636481174,
"timestamp":"12-12-2023"
}
]
}Chain: Indicates the blockchain network or platform and in this case, it is specified as Ethereum.
Protocol: This field is likely intended to specify the protocol used in the context of the blockchain.
version: Represents the version number associated with the protocol.
mean_volume_usd: Refers to the average trading or transaction volume in US dollars over a certain period.
median_volume_usd: Indicates the median trading or transaction volume in US dollars.
volume_continuity_score: This score could represent a measure of the consistency or regularity of transaction volumes over time.
timestamp: Represents the timestamp or point in time when the data was recorded.
curl https://api.alterscope.org/scores/liquidity/dex/all-protocols -H "Authorization: Bearer <your_access_token>"The sample response below will display volume continuity score data for all dex protocols in last 7 days.
{
 "status":true,
 "data":[
  {
    "chain":"ethereum",
    "protocol":"pancakeswap",
    "version":"V3",
    "mean_volume_usd":29589.14927246872,
    "median_volume_usd":6368.1783921135575,
    "volume_continuity_score":0.4659007013842846,
    "timestamp":"18-12-2023"
  },
  {
    "chain":"arbitrum",
    "protocol":"gmx",
    "version":"V2",
    "mean_volume_usd":6681.483814945259,
    "median_volume_usd":793.7822523097593,
    "volume_continuity_score":0.3055157947974464,
    "timestamp":"18-12-2023"
  },
  {
    "chain":"ethereum",
    "protocol":"uniswap",
    "version":"V3",
    "mean_volume_usd":24993.592458027866,
    "median_volume_usd":2578.539249292922,
    "volume_continuity_score":0.48752147729499223,
    "timestamp":"18-12-2023"
  },
  {
    "chain":"ethereum",
    "protocol":"swaap",
    "version":"V2",
    "mean_volume_usd":4482.255662164273,
    "median_volume_usd":4482.255662164273,
    "volume_continuity_score":0.7310585786300049,
    "timestamp":"18-12-2023"
  },
  {
    "chain":"ethereum",
    "protocol":"fraxfinance",
    "version":"V2",
    "mean_volume_usd":27486.726988694325,
    "median_volume_usd":24254.204259372476,
    "volume_continuity_score":0.5293918625053363,
    "timestamp":"18-12-2023"
  },
  {
    "chain":"ethereum",
    "protocol":"balancer",
    "version":"V2",
    "mean_volume_usd":85850.7614282503,
    "median_volume_usd":4136.407823868942,
    "volume_continuity_score":0.0001308545790956831,
    "timestamp":"18-12-2023"
  },
  {
    "chain":"ethereum",
    "protocol":"curve",
    "version":"V3",
    "mean_volume_usd":313267.24748210487,
    "median_volume_usd":24593.33388618997,
    "volume_continuity_score":0.20139140135869218,
    "timestamp":"18-12-2023"
  },
  {
    "chain":"arbitrum",
    "protocol":"gmx",
    "version":"V2",
    "mean_volume_usd":4328.41116904584,
    "median_volume_usd":201.58422363585333,
    "volume_continuity_score":0.05793788269195299,
    "timestamp":"17-12-2023"
  },
  {
    "chain":"ethereum",
    "protocol":"fraxfinance",
    "version":"V2",
    "mean_volume_usd":17911.737782378004,
    "median_volume_usd":19948.500933084906,
    "volume_continuity_score":0.5294863104811488,
    "timestamp":"17-12-2023"
  },
  {
    "chain":"ethereum",
    "protocol":"balancer",
    "version":"V2",
    "mean_volume_usd":37385.65147008538,
    "median_volume_usd":3480.2560048307223,
    "volume_continuity_score":0.008216865345538392,
    "timestamp":"17-12-2023"
  },
  {
    "chain":"ethereum",
    "protocol":"curve",
    "version":"V3",
    "mean_volume_usd":166992.16279540127,
    "median_volume_usd":20355.412414207007,
    "volume_continuity_score":0.2931618325576049,
    "timestamp":"17-12-2023"
  },
  {
    "chain":"ethereum",
    "protocol":"pancakeswap",
    "version":"V3",
    "mean_volume_usd":20512.34336295109,
    "median_volume_usd":5009.574099113711,
    "volume_continuity_score":0.476398258173493,
    "timestamp":"17-12-2023"
  },
  {
    "chain":"ethereum",
    "protocol":"uniswap",
    "version":"V3",
    "mean_volume_usd":18606.02010425795,
    "median_volume_usd":1847.5820364396382,
    "volume_continuity_score":0.48707963884582645,
    "timestamp":"17-12-2023"
  },
  {
    "chain":"ethereum",
    "protocol":"pancakeswap",
    "version":"V3",
    "mean_volume_usd":21985.19854772773,
    "median_volume_usd":3800.7382050793685,
    "volume_continuity_score":0.44142837555675746,
    "timestamp":"16-12-2023"
  },
  {
    "chain":"arbitrum",
    "protocol":"gmx",
    "version":"V2",
    "mean_volume_usd":6059.4520742304085,
    "median_volume_usd":356.2810022115123,
    "volume_continuity_score":0.06051225818712912,
    "timestamp":"16-12-2023"
  },
  {
    "chain":"ethereum",
    "protocol":"swaap",
    "version":"V2",
    "mean_volume_usd":187.55557027786864,
    "median_volume_usd":187.55557027786864,
    "volume_continuity_score":0.7310585786300049,
    "timestamp":"16-12-2023"
  },
  {
    "chain":"ethereum",
    "protocol":"fraxfinance",
    "version":"V2",
    "mean_volume_usd":21020.86713300575,
    "median_volume_usd":22215.49048834546,
    "volume_continuity_score":0.5369072873707963,
    "timestamp":"16-12-2023"
  },
  {
    "chain":"ethereum",
    "protocol":"balancer",
    "version":"V2",
    "mean_volume_usd":22768.29295825683,
    "median_volume_usd":4496.2723497748,
    "volume_continuity_score":0.20624813274964288,
    "timestamp":"16-12-2023"
  },
  {
    "chain":"ethereum",
    "protocol":"curve",
    "version":"V3",
    "mean_volume_usd":1601035.7569652111,
    "median_volume_usd":25943.234676601907,
    "volume_continuity_score":0.000028679777510687358,
    "timestamp":"16-12-2023"
  },
  {
    "chain":"ethereum",
    "protocol":"uniswap",
    "version":"V3",
    "mean_volume_usd":28319.970875951945,
    "median_volume_usd":1880.9502043386037,
    "volume_continuity_score":0.4824967705848901,
    "timestamp":"16-12-2023"
  },
  {
    "chain":"ethereum",
    "protocol":"fraxfinance",
    "version":"V2",
    "mean_volume_usd":25319.766521318998,
    "median_volume_usd":22171.5247545379,
    "volume_continuity_score":0.5356894178873546,
    "timestamp":"15-12-2023"
  },
  {
    "chain":"ethereum",
    "protocol":"balancer",
    "version":"V2",
    "mean_volume_usd":16415.073721387234,
    "median_volume_usd":3715.931908593845,
    "volume_continuity_score":0.272400874756338,
    "timestamp":"15-12-2023"
  },
  {
    "chain":"ethereum",
    "protocol":"curve",
    "version":"V3",
    "mean_volume_usd":246458.1252632962,
    "median_volume_usd":20253.26336000146,
    "volume_continuity_score":0.1736256578914597,
    "timestamp":"15-12-2023"
  },
  {
    "chain":"ethereum",
    "protocol":"pancakeswap",
    "version":"V3",
    "mean_volume_usd":17929.618575126187,
    "median_volume_usd":4958.202837016856,
    "volume_continuity_score":0.48192320399916966,
    "timestamp":"15-12-2023"
  },
  {
    "chain":"arbitrum",
    "protocol":"gmx",
    "version":"V2",
    "mean_volume_usd":8294.102454945452,
    "median_volume_usd":242.56038098041643,
    "volume_continuity_score":0.002539262604231573,
    "timestamp":"15-12-2023"
  },
  {
    "chain":"ethereum",
    "protocol":"uniswap",
    "version":"V3",
    "mean_volume_usd":20433.871158236456,
    "median_volume_usd":2247.551193415587,
    "volume_continuity_score":0.489671700317849,
    "timestamp":"15-12-2023"
  },
  {
    "chain":"ethereum",
    "protocol":"fraxfinance",
    "version":"V2",
    "mean_volume_usd":22152.6047379183,
    "median_volume_usd":21894.621846931048,
    "volume_continuity_score":0.5369904325239573,
    "timestamp":"14-12-2023"
  },
  {
    "chain":"ethereum",
    "protocol":"balancer",
    "version":"V2",
    "mean_volume_usd":17099.655196670687,
    "median_volume_usd":3717.480720364058,
    "volume_continuity_score":0.1905802188744348,
    "timestamp":"14-12-2023"
  },
  {
    "chain":"ethereum",
    "protocol":"pancakeswap",
    "version":"V3",
    "mean_volume_usd":19178.41283137255,
    "median_volume_usd":7651.82885752177,
    "volume_continuity_score":0.4947253740359122,
    "timestamp":"14-12-2023"
  },
  {
    "chain":"arbitrum",
    "protocol":"gmx",
    "version":"V2",
    "mean_volume_usd":2041.5949848629216,
    "median_volume_usd":1.14807e-15,
    "volume_continuity_score":0,
    "timestamp":"14-12-2023"
  },
  {
    "chain":"ethereum",
    "protocol":"uniswap",
    "version":"V3",
    "mean_volume_usd":19955.648051362416,
    "median_volume_usd":2143.3246847353244,
    "volume_continuity_score":0.4891432579118372,
    "timestamp":"14-12-2023"
  },
  {
    "chain":"ethereum",
    "protocol":"swaap",
    "version":"V2",
    "mean_volume_usd":2302.81660266711,
    "median_volume_usd":2302.81660266711,
    "volume_continuity_score":0.7310585786300049,
    "timestamp":"14-12-2023"
  },
  {
    "chain":"ethereum",
    "protocol":"curve",
    "version":"V3",
    "mean_volume_usd":429121.2763210712,
    "median_volume_usd":14364.008934764559,
    "volume_continuity_score":0.0032950272711777706,
    "timestamp":"14-12-2023"
  },
  {
    "chain":"ethereum",
    "protocol":"balancer",
    "version":"V2",
    "mean_volume_usd":108649.6245978276,
    "median_volume_usd":4813.829388811851,
    "volume_continuity_score":0.00011039822867207698,
    "timestamp":"13-12-2023"
  },
  {
    "chain":"ethereum",
    "protocol":"curve",
    "version":"V3",
    "mean_volume_usd":377857.96672422555,
    "median_volume_usd":41459.441435580025,
    "volume_continuity_score":0.2895916463048446,
    "timestamp":"13-12-2023"
  },
  {
    "chain":"arbitrum",
    "protocol":"gmx",
    "version":"V2",
    "mean_volume_usd":1664.8285733519542,
    "median_volume_usd":1.0884500000000002e-15,
    "volume_continuity_score":0,
    "timestamp":"13-12-2023"
  },
  {
    "chain":"ethereum",
    "protocol":"uniswap",
    "version":"V3",
    "mean_volume_usd":24734.69607204835,
    "median_volume_usd":2315.9890814078117,
    "volume_continuity_score":0.48695219403226414,
    "timestamp":"13-12-2023"
  },
  {
    "chain":"ethereum",
    "protocol":"swaap",
    "version":"V2",
    "mean_volume_usd":10523.775191594515,
    "median_volume_usd":10523.775191594515,
    "volume_continuity_score":0.7310585786300049,
    "timestamp":"13-12-2023"
  },
  {
    "chain":"ethereum",
    "protocol":"fraxfinance",
    "version":"V2",
    "mean_volume_usd":21481.57333423195,
    "median_volume_usd":23140.393402433852,
    "volume_continuity_score":0.523484572280371,
    "timestamp":"13-12-2023"
  },
  {
    "chain":"ethereum",
    "protocol":"pancakeswap",
    "version":"V3",
    "mean_volume_usd":30684.72716688016,
    "median_volume_usd":8835.773758276891,
    "volume_continuity_score":0.4806109810280416,
    "timestamp":"13-12-2023"
  },
  {
    "chain":"arbitrum",
    "protocol":"gmx",
    "version":"V2",
    "mean_volume_usd":9378.398536093162,
    "median_volume_usd":395.36637908397455,
    "volume_continuity_score":0.06449611683911174,
    "timestamp":"12-12-2023"
  },
  {
    "chain":"ethereum",
    "protocol":"uniswap",
    "version":"V3",
    "mean_volume_usd":21023.387630533733,
    "median_volume_usd":2178.0373935742728,
    "volume_continuity_score":0.4878724636481174,
    "timestamp":"12-12-2023"
  },
  {
    "chain":"ethereum",
    "protocol":"swaap",
    "version":"V2",
    "mean_volume_usd":10730.053261165887,
    "median_volume_usd":1113.82115823055,
    "volume_continuity_score":0.012591904571556938,
    "timestamp":"12-12-2023"
  },
  {
    "chain":"ethereum",
    "protocol":"fraxfinance",
    "version":"V2",
    "mean_volume_usd":22060.01871097381,
    "median_volume_usd":23988.302539731703,
    "volume_continuity_score":0.5271771107966989,
    "timestamp":"12-12-2023"
  },
  {
    "chain":"ethereum",
    "protocol":"balancer",
    "version":"V2",
    "mean_volume_usd":32030.388967848772,
    "median_volume_usd":2999.109434195716,
    "volume_continuity_score":0.028193510807060274,
    "timestamp":"12-12-2023"
  },
  {
    "chain":"ethereum",
    "protocol":"curve",
    "version":"V3",
    "mean_volume_usd":301607.93537603883,
    "median_volume_usd":35099.820452417676,
    "volume_continuity_score":0.28502787730945933,
    "timestamp":"12-12-2023"
  },
  {
    "chain":"ethereum",
    "protocol":"pancakeswap",
    "version":"V3",
    "mean_volume_usd":20102.78728770403,
    "median_volume_usd":6930.449322673427,
    "volume_continuity_score":0.49069686886270975,
    "timestamp":"12-12-2023"
  }
 ]
} Â Â Â chain: Indicates the blockchain network or platform, and in this case, it is specified as Ethereum.
protocol: This field is likely intended to specify the protocol used in the context of the blockchain or cryptocurrency.
version: Represents the version number associated with the blockchain or cryptocurrency protocol.
mean_volume_usd: Refers to the average trading or transaction volume in US dollars over a certain period.
median_volume_usd: Indicates the median trading or transaction volume in US dollars.
volume_continuity_score: This score could represent a measure of the consistency or regularity of transaction volumes over time.
timestamp: Represents the timestamp or point in time when the data was recorded.
For a supported list of decentralised exchange chains and protocol versions please refer to sample response for API endpoint.
To get a list of pool address for which data can be retrieved please check API endpoint.
For a supported list of decentralised exchange chains and protocol versions please refer to sample response for for all protocols API endpoint.
For a supported list of decentralised exchange chains and protocol versions please refer to sample response for for all protocols API endpoint.
Note: The sample request below retrieves volume continuity score for a specific pool. To get a list of pool address for which data can be retrieved please check API endpoint.
For a supported list of decentralised exchange chains and protocol versions please refer to sample response for for all protocols API endpoint.
For a supported list of decentralised exchange chains and protocol versions please refer to sample response for for all protocols API endpoint.
This endpoint returns key metrics and the Volume Continuity Score for the specified protocol from the last 7 days (Note: Only supported chain is "ethereum" and protocols are "uniswap v3, curve v3, swaap v2, fraxswap v2, balancer v2, and pancakeswap v3". Please use protocol names and versions as indicated in previous sentence while feeding as arguments for all protocols, e.g. /ethereum/uniswap/v3).
the name of the chain
the name of the protocol
the version of the protocol
GET /scores/liquidity/dex/protocol-score/{chain}/{protocol}/{version} HTTP/1.1
Host: api.alterscope.org
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"chain": "ethereum",
"protocol": "uniswap",
"version": "V3",
"mean_volume_usd": 5688.330092692035,
"median_volume_usd": 467.05636086774064,
"volume_continuity_score": 0.48004188599083564,
"timestamp": "14-10-2023"
}This endpoint returns key metrics and the Volume Continuity Score for the specified protocol from the last 7 days (Note: Only supports "uniswap, curve, swaap, fraxswap, balancer, and pancakeswap".).
the name of the protocol
GET /scores/liquidity/dex/protocol-overview/{protocol} HTTP/1.1
Host: api.alterscope.org
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"chain": "ethereum",
"protocol": "uniswap",
"version": "V3",
"mean_volume_usd": 5688.330092692035,
"median_volume_usd": 467.05636086774064,
"volume_continuity_score": 0.48004188599083564,
"timestamp": "14-10-2023"
}This endpoint returns key metrics and the Volume Continuity Score for all protocols from the last 7 days (Note: Only supported protocols are Uniswap and Curve so far).
GET /scores/liquidity/dex/all-protocols HTTP/1.1
Host: api.alterscope.org
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"chain": "ethereum",
"protocol": "uniswap",
"version": "V3",
"mean_volume_usd": 5688.330092692035,
"median_volume_usd": 467.05636086774064,
"volume_continuity_score": 0.48004188599083564,
"timestamp": "14-10-2023"
}This endpoint returns the list of available decentralized exchanges supported in our product. You can use the information from this endpoint to make requests to other data and score endpoints for decentralized exchanges.
This endpoint returns the list of available pools for a protocol. It helps you to fetch by pages using batch size and skipping batches. You can get the available number of pools using /available-dexes.
the name of the chain
the name of the protocol
the version of the protocol
the number of pools you want to get in this request
the number of batches to skip for pagination
This endpoint returns the data analytics for given pool address. You can get the list of pool addresses using /available-dexes and /available-pools/... endpoints.
the address of the pool to be examined
This endpoint returns the data analytics for given protocol. You can get the list of protocols using /available-dexes endpoint.
the name of the chain
the name of the protocol
the version of the protocol
This endpoint returns the data analytics in every chain and version supported for given protocol. You can get the list of protocols using /available-dexes endpoint.
the name of the protocol
This endpoint returns key metrics and the Volume Continuity Score for the specified pool from the last 7 days (Note: Only supports pools in Uniswap V3, Curve, Swaap V2, Fraxswap V2, Balancer V2, Pancakeswap V3).
the address of the pool
GET /data/liquidity/dex/available-dexes HTTP/1.1
Host: api.alterscope.org
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"chain": "ethereum",
"protocol": "curve",
"version": "V3",
"exchange_name": "Curve.fi",
"number_of_pools": 69
}GET /data/liquidity/dex/available-pools/{chain}/{protocol}/{version}/{batchSize}/{skipBatch} HTTP/1.1
Host: api.alterscope.org
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"chain": "ethereum",
"protocol": "curve",
"version": "V3",
"pool_address": "0xbebc44782c7db0a1a60cb6fe97d0b483032ff1c7"
}GET /data/liquidity/dex/pool-analytics/{poolAddress} HTTP/1.1
Host: api.alterscope.org
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"chain": "ethereum",
"protocol": "curve",
"version": "V3",
"pool_address": "0xbebc44782c7db0a1a60cb6fe97d0b483032ff1c7",
"token_amounts": [
{
"token_index": 0,
"token_amount": 85906252.28943926,
"token_amount_usd": 85914925.38467039
},
{
"token_index": 1,
"token_amount\"": 87848016.685712,
"token_amount_usd\"": 87786523.074032
},
{
"token_index": 2,
"token_amount": 34642085.817676,
"token_amount_usd": 34668919.74016817
}
],
"token_amount_changes": [
{
"token_index": 0,
"token_exchange_amount": 2917367.146036858,
"token_exchange_usd": 2917136.363222608
},
{
"token_index": 1,
"token_exchange_amount": 4235539.809461001,
"token_exchange_usd": 4226824.135025036
},
{
"token_index": 2,
"token_exchange_amount": -7141964.429500986,
"token_exchange_usd": -7148722.223183848
}
],
"token_volumes": [
{
"token_index": 0,
"token_exchange_amount": 7495488.453778524,
"token_exchange_usd": 7495186.246704999
},
{
"token_index": 1,
"token_exchange_amount": 59249162.73775101,
"token_exchange_usd": 59218877.06476131
},
{
"token_index": 2,
"token_exchange_amount": 65465424.732683,
"token_exchange_usd": 65512124.64693531
}
],
"volume_usd": 66113093.97920077,
"fee_usd": 6611.309397920078,
"tvl_usd": 208370368.19887054,
"num_unique_wallets": 45,
"num_transactions": 242,
"timestamp": "08-01-2024"
}GET /data/liquidity/dex/protocol-analytics/{chain}/{protocol}/{version} HTTP/1.1
Host: api.alterscope.org
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"chain": "ethereum",
"protocol": "uniswap",
"version": "V3",
"number_pools": 2534,
"volume_usd": 1096524827.0630238,
"fee_usd": 1212327.5785307982,
"tvl_usd": 1825895881.6433496,
"num_unique_wallets": 229,
"num_transactions": 41963,
"timestamp": "08-01-2024"
}GET /data/liquidity/dex/protocol-overview/{protocol} HTTP/1.1
Host: api.alterscope.org
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"chain": "ethereum",
"protocol": "uniswap",
"version": "V3",
"number_pools": 2534,
"volume_usd": 1096524827.0630238,
"fee_usd": 1212327.5785307982,
"tvl_usd": 1825895881.6433496,
"num_unique_wallets": 229,
"num_transactions": 41963,
"timestamp": "08-01-2024"
}GET /scores/liquidity/dex/pool-score/{poolAddress} HTTP/1.1
Host: api.alterscope.org
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"chain": "ethereum",
"protocol": "curve",
"version": "V3",
"pool_address": "0xbebc44782c7db0a1a60cb6fe97d0b483032ff1c7",
"mean_volume_usd": 192279.5529764858,
"median_volume_usd": 8617.63644921393,
"volume_continuity_score": 0.010837446947138675,
"timestamp": "14-10-2023"
}