dex-metrics-mcp
by kukapay
README.md
# DEX Metrics MCP
An MCP server that tracks trading volume metrics segmented by DEX, blockchain, aggregator, frontend, and Telegram bot, powered by Dune Analytics.
## Features
- Latest 24-hour and 7-day trading volumes by DEX and aggregator.
- Daily, weekly, and monthly trading volumes by DEX and blockchain.
- Year-over-year monthly trading volume by aggregator.
- Solana-specific weekly trading volume by DEX.
- 7-day trading volume by frontend and daily trading volume by Telegram bot.
## Prerequisites
- Python 3.10 or higher
- [uv](https://github.com/astral-sh/uv) (recommended package manager)
- A Dune Analytics API key (obtainable from [Dune Analytics](https://dune.com))
## Installation
1. **Clone the Repository**
```bash
git clone https://github.com/kukapay/dex-metrics-mcp.git
cd dex-metrics-mcp
```
2. **Install Dependencies**
```bash
uv sync
```
3. **Installing to Claude Desktop**:
Install the server as a Claude Desktop application:
```bash
uv run mcp install main.py --name "DEX Metrics"
```
Configuration file as a reference:
```json
{
"mcpServers": {
"DEX Metrics": {
"command": "uv",
"args": [ "--directory", "/path/to/dex-metrics-mcp", "run", "main.py" ],
"env": { "DUNE_API_KEY": "dune_api_key"}
}
}
}
```
Replace `/path/to/dex-metrics-mcp` with your actual installation path, and `dune_api_key` with your API key from Dune Analytics.
## Example Usage
The server exposes the following tools, accessible via MCP client or API calls:
- `get_latest_trading_volume_by_dex(limit: int = 1000)`: Latest 24-hour/7-day trading volume by DEX.
- `get_latest_trading_volume_by_aggregator(limit: int = 1000)`: Latest 24-hour/7-day trading volume by aggregator.
- `get_daily_trading_volume_by_chain(limit: int = 1000)`: Daily trading volume by blockchain.
- `get_daily_trading_volume_by_dex(limit: int = 1000)`: Daily trading volume by DEX.
- `get_weekly_trading_volume_by_dex(limit: int = 1000)`: Weekly trading volume by DEX.
- `get_monthly_trading_volume_by_dex(limit: int = 1000)`: Monthly trading volume by DEX.
- `get_yoy_monthly_trading_volume_by_aggragator(limit: int = 1000)`: Year-over-year monthly trading volume by aggregator.
- `get_weekly_solana_trading_volume_by_dex(limit: int = 1000)`: Weekly Solana trading volume by DEX.
- `get_weekly_trading_volume_by_frontend(limit: int = 1000)`: 7-day trading volume by frontend.
- `get_daily_trading_volume_by_telegram_bot(limit: int = 1000)`: Daily trading volume by Telegram bot.
Each tool returns data in a markdown-formatted table or an error message if the query fails.
### 1. get_latest_trading_volume_by_dex
**Prompt**:
```
Show me the latest 24-hour and 7-day trading volumes for the top 3 DEXs.
```
**Sample Output**
```
| Rank | 24 Hours Volume | 7 Days Volume | Project |
|-------:|------------------:|-----------------:|:-------------------|
| 1 | 1.04615e+10 | 6.47677e+10 | pancakeswap |
| 2 | 5.76535e+09 | 2.83344e+10 | uniswap |
| 3 | 5.97486e+08 | 3.99537e+09 | aerodrome |
```
### 2. get_latest_trading_volume_by_aggregator
**Prompt**:
```
What are the latest trading volumes for the top aggregators?
```
**Sample Output**:
```
| Rank | 24 Hours Volume | 7 Days Volume | Project |
|-------:|------------------:|----------------:|:-------------|
| 1 | 1.1695e+09 | 4.90404e+09 | 1inch |
| 2 | 1.82229e+08 | 1.51975e+09 | cow_protocol |
| 3 | 1.27245e+08 | 9.27161e+08 | kyberswap |
| 4 | 1.71105e+08 | 8.04235e+08 | paraswap |
| 5 | 1.28048e+08 | 7.2434e+08 | 0x API |
| 6 | 7.64132e+07 | 5.59379e+08 | bebop |
| 7 | 5.43385e+07 | 4.34735e+08 | odos |
| 8 | 1.5311e+07 | 1.51742e+08 | tokenlon |
| 9 | 1.43633e+07 | 9.72625e+07 | sushiswap |
| 10 | 5.83158e+06 | 4.04518e+07 | lifi |
| 11 | 4.34389e+06 | 1.37878e+07 | velora_delta |
| 12 | 1.69631e+06 | 1.3618e+07 | DODO X |
| 13 | 222302 | 1.56062e+06 | yield_yak |
```
### 3. get_weekly_trading_volume_by_chain
**Prompt**:
```
Give me the weekly trading volume by blockchain for the last 3 weeks.
```
**Sample Output**:
```
| date | abstract | arbitrum | avalanche_c | base | berachain | blast | bnb | boba | celo | corn | ethereum | fantom | flare | gnosis | ink | kaia | linea | mantle | nova | opbnb | optimism | plume | polygon | ronin | scroll | sei | shape | sonic | sophon | unichain | worldchain | zkevm | zksync | zora |
|:-----------|-------------:|--------------:|--------------:|--------------:|--------------:|--------------:|--------------:|-----------:|--------------:|-----------------:|--------------:|--------------:|-----------------:|--------------:|-----------------:|--------------:|--------------:|--------------:|---------:|-----------------:|--------------:|-----------------:|--------------:|--------------:|-----------------:|--------------:|--------------:|--------------:|-----------:|-----------------:|---------------:|-----------------:|--------------:|-----------------:|
| 2025-06-16 | nan | 9.38256e+08 | nan | 1.58636e+09 | 1.95158e+07 | 3.58591e+06 | 1.76758e+10 | 422.179 | 9.2226e+06 | 384747 | 3.41262e+09 | nan | 830244 | 8.49618e+06 | 7.54501e+06 | 6.85967e+06 | nan | 8.74519e+06 | nan | 169854 | nan | 1.76011e+06 | nan | 8.23164e+06 | 974608 | nan | 3303.76 | nan | 904.862 | 6.39224e+08 | 4.60864e+06 | 131774 | nan | nan |
| 2025-06-09 | nan | nan | nan | 8.08403e+09 | 1.19792e+08 | nan | 7.69719e+10 | nan | 4.65667e+07 | nan | nan | nan | 9.56724e+06 | 4.71154e+07 | nan | nan | 4.15043e+07 | nan | 77288.3 | 1.12306e+06 | 3.87023e+08 | nan | 6.83745e+08 | 2.67283e+07 | nan | 5.74708e+07 | 14672.9 | 3.69606e+08 | 11632.2 | 3.17004e+09 | 2.13648e+07 | 684156 | 1.01001e+07 | nan |
| 2025-06-02 | nan | 3.53842e+09 | 5.36681e+08 | nan | 1.20582e+08 | 1.14138e+07 | nan | 2166.94 | 3.66404e+07 | nan | 1.33867e+10 | 2.64185e+06 | nan | nan | nan | nan | 3.28449e+07 | 2.56004e+07 | nan | 1.07262e+06 | 2.64984e+08 | nan | 6.06311e+08 | 1.86708e+07 | 3.34686e+06 | nan | 7527.77 | 3.37454e+08 | 17947.7 | nan | nan | 504967 | nan | 44434.9 |
```
### 4. get_daily_trading_volume_by_dex
**Prompt**:
```
Show the daily trading volume for the top DEXs over the past 3 days.
```
**Output**:
```
| date | 0x-API | 1inch-LOP | aerodrome | agni | airswap | akronswap | alienbase | apeswap | arbswap | auragi | autotronic | babyswap | balancer | bancor | baseswap | beethoven_x | beets | beraswap | biswap | blasterswap | blazeswap | bridgers | burrbear | camelot | carbon_defi | chronos | citadelswap | clipper | curve | dackieswap | defi_kingdoms | defiswap | derpdex | dfyn | dodo | dooar | dracula_finance | dragon_swap | dyorswap | echodex | elk_finance | ellipsis_finance | enosys | equalizer | ezkalibur | fenix | flashliquidity | fluid | fraxswap | fusionx | gemswap | glacier | gmx | gooddollar_reserve | honeyswap | horizondex | hyperjump | icecreamswap | infusion | inkswap | inkyswap | integral | iziswap | jelly_swap | katana | klay_swap | kodiak | kyberswap | leetswap | lynex | maverick | mdex | mento | merchant_moe | mindgames | moonbase | mute | neopin | nile | nomiswap | nuri | oasisswap | oku | openocean | openxswap | pancakeswap | pharaoh | plantbaseswap | quickswap | ramses | rcpswap | reservoir_swap | rocketswap | rooster_protocol | sailor_finance | scale | scrollswap | secta | shadow | sharkswap | sharkyswap | shibaswap | silverswap | smardex | sobal | solidlizard | solidly | soswap | spacefi | sparkdex | spartacus_exchange | spartadex | spiritswap | spookyswap | stablebase | sterling_finance | sushiswap | swaap | swapbased | swapr | syncswap | synthetix | tamadotmeme | tapio | thena | throne_exchange | thruster | torus | trader_joe | ubeswap | unichainswap | uniswap | valantis | velocore | velodrome | verse_dex | vesync | wagmi | wardenswap | wigoswap | wombat | wombatexchange | woofi | xchange | xei_finance | yaka | zebra | zipswap | zkswap_finance | zyberswap |
|:-----------|--------------:|--------------:|--------------:|--------------:|----------:|-------------:|------------:|----------:|----------:|---------:|-------------:|-----------:|--------------:|-----------------:|--------------:|--------------:|--------------:|--------------:|---------:|--------------:|------------:|-----------:|-----------------:|--------------:|--------------:|----------:|--------------:|--------------:|--------------:|-------------:|----------------:|----------------:|----------:|---------:|--------------:|--------:|------------------:|-----------------:|------------:|----------:|--------------:|-------------------:|---------:|------------:|------------:|---------:|-----------------:|--------------:|-----------------:|----------:|----------:|----------:|-----------:|---------------------:|------------:|-------------:|------------:|---------------:|-----------:|----------:|-----------:|--------------:|----------:|-----------------:|--------------:|------------:|--------------:|------------:|------------:|--------------:|--------------:|--------:|-----------------:|---------------:|------------:|-----------:|--------:|----------:|--------------:|-----------:|-------:|------------:|--------------:|--------------:|------------:|--------------:|--------------:|----------------:|--------------:|--------------:|----------:|-----------------:|-------------:|-------------------:|-----------------:|---------:|-------------:|---------:|--------------:|------------:|-------------:|-----------------:|-----------------:|----------:|------------:|--------------:|--------------:|---------:|----------:|--------------:|---------------------:|------------:|-------------:|-----------------:|-------------:|-------------------:|--------------:|--------------:|------------:|-----------------:|-----------:|------------:|--------------:|-----------:|--------------:|------------------:|-----------------:|-----------:|--------------:|----------:|---------------:|--------------:|-----------:|-----------:|--------------:|------------:|---------:|--------------:|-------------:|-----------:|----------:|-----------------:|--------------:|----------:|--------------:|---------:|---------:|----------:|-----------------:|------------:|
| 2025-06-16 | nan | nan | nan | 5.17501e+06 | nan | nan | 115864 | nan | 250785 | nan | 2.96129 | 65987 | nan | nan | nan | 85021 | nan | nan | nan | nan | 1.04997 | nan | nan | nan | nan | nan | nan | 3.49696e+06 | nan | nan | nan | nan | 731.589 | 10738.9 | nan | 104969 | nan | nan | nan | 234.03 | nan | 1842.4 | nan | nan | nan | 44.556 | nan | nan | nan | nan | nan | 85.4182 | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | 877027 | nan | nan | nan | 46112.3 | nan | 4.42811e+06 | nan | 27214.4 | nan | nan | nan | 37.9268 | 44185.4 | nan | nan | 5.69643 | 396933 | nan | 1.71238e+06 | nan | nan | 1.04532e+10 | nan | nan | nan | nan | nan | 4233.85 | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | 7156.7 | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | 5.16973e+09 | nan | nan | nan | nan | 1443.4 | 2.4018e+06 | nan | nan | nan | nan | nan | nan | nan | nan | 11983 | nan | nan | nan |
| 2025-06-15 | nan | nan | nan | nan | nan | nan | nan | nan | 178329 | 57.4843 | nan | nan | nan | nan | nan | 18689.8 | nan | 3.37023e+06 | nan | nan | nan | nan | 938258 | 2.64189e+07 | nan | nan | nan | 1.74476e+06 | nan | nan | nan | nan | 116.337 | 5451.89 | 6.41525e+07 | nan | nan | 3.39459e+06 | nan | 101.281 | 1138.97 | 8361.53 | nan | nan | nan | nan | 12.1067 | nan | nan | nan | nan | nan | nan | nan | nan | 60.6806 | nan | nan | 11294.1 | nan | nan | nan | nan | 289925 | nan | nan | 7.29448e+06 | nan | nan | 2.17033e+06 | 1.04775e+08 | nan | 163788 | nan | nan | 1.37116 | 16183.9 | 16533.2 | nan | nan | nan | nan | nan | nan | nan | nan | 3.29049e+07 | nan | nan | nan | nan | nan | nan | 1.29957e+06 | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | 25722 | nan | 23.3758 | nan | 11306.1 | nan | nan | nan | nan | 9.35944e+06 | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | 6.4704e+07 | 15992.8 | nan | 2.50242e+09 | nan | nan | nan | 19559 | nan | nan | nan | nan | nan | nan | nan | 45.3201 | 0.0232591 | nan | nan | nan | nan | nan |
| 2025-06-14 | nan | nan | nan | nan | nan | nan | 35111.6 | nan | nan | nan | 1.2276 | nan | nan | nan | nan | nan | nan | nan | nan | 1318.77 | nan | nan | nan | nan | nan | nan | 109.555 | nan | nan | nan | nan | nan | 69.2538 | 8400.21 | nan | nan | 20.121 | 3.57664e+06 | nan | nan | nan | nan | nan | nan | 434.224 | nan | 8.34132 | nan | 452427 | nan | nan | nan | nan | 97.9239 | nan | 67.1673 | 0.0379641 | nan | nan | nan | 6021.05 | nan | 58161.7 | nan | nan | nan | nan | 30563.3 | nan | nan | nan | nan | 277624 | 20283 | 11.2586 | nan | nan | nan | nan | 8.21209 | nan | nan | nan | nan
```
### 5. get_weekly_trading_volume_by_dex
**Prompt**:
```
What is the weekly trading volume for DEXs for the last 3 weeks?
```
**Output**:
```
| date | 0x-API | 1inch-LOP | abstractswap | aerodrome | agni | airswap | akronswap | alienbase | apeswap | arbswap | auragi | autotronic | babyswap | balancer | bancor | baseswap | beethoven_x | beets | beraswap | biswap | blasterswap | blazeswap | bridgers | burrbear | camelot | carbon_defi | chronos | citadelswap | clipper | curve | dackieswap | defi_kingdoms | defiswap | derpdex | dfx | dfyn | dodo | dooar | dracula_finance | dragon_swap | dyorswap | echodex | elk_finance | ellipsis_finance | enosys | equalizer | ezkalibur | fenix | flashliquidity | fluid | fraxswap | fusionx | gemswap | glacier | gmx | gooddollar_reserve | gravity_finance | gridex | honeyswap | horizondex | hyperjump | icecreamswap | infusion | inkyswap | integral | iziswap | jelly_swap | jojo | katana | klay_swap | kodiak | kyberswap | leetswap | lynex | maverick | mdex | mento | merchant_moe | mindgames | moonbase | mummy_finance | mute | neopin | nile | nomiswap | nuri | oasisswap | oku | openocean | openxswap | otsea | pancakeswap | pharaoh | plantbaseswap | quickswap | ramses | rcpswap | reservoir_swap | rocketswap | rooster_protocol | rubicon | sailor_finance | scale | scrollswap | secta | shadow | sharkswap | sharkyswap | shibaswap | silverswap | smardex | sobal | solidlizard | solidly | soswap | spacefi | sparkdex | spartacus_exchange | spartadex | spiritswap | spookyswap | stablebase | sterling_finance | sushiswap | swaap | swapbased | swapblast | swapr | syncswap | synthetix | tamadotmeme | tapio | thena | throne_exchange | thruster | torus | trader_joe | tropicalswap | ubeswap | unichainswap | uniswap | valantis | velocimeter | velocore | velodrome | verse_dex | vesync | wagmi | wardenswap | wigoswap | wombat | wombat_exchange | wombatexchange | woofi | xchange | xei_finance | yaka | zebra | zipswap | zkswap_finance | zyberswap |
|:-----------|--------------:|--------------:|---------------:|--------------:|--------------:|--------------:|------------:|---------------:|--------------:|----------------:|---------:|-------------:|-----------------:|--------------:|--------------:|--------------:|-----------------:|--------------:|--------------:|--------------:|-----------------:|------------:|-----------:|----------------:|--------------:|-----------------:|----------:|--------------:|--------------:|--------------:|----------------:|----------------:|-----------------:|----------:|----------:|---------:|--------------:|--------------:|------------------:|--------------:|-----------:|----------:|--------------:|-------------------:|----------------:|--------------:|------------:|-----------:|-----------------:|--------------:|--------------:|-----------------:|----------:|----------:|-----------------:|---------------------:|------------------:|-----------:|------------:|-------------:|------------:|---------------:|-----------:|-----------------:|--------------:|-----------------:|-----------------:|----------:|--------------:|-----------------:|--------------:|-----------------:|-----------:|--------------:|--------------:|-----------------:|--------------:|-----------------:|------------:|-----------:|----------------:|-----------------:|---------:|--------------:|-------------:|--------------:|------------:|--------------:|--------------:|------------:|----------:|--------------:|--------------:|----------------:|--------------:|--------------:|----------:|-----------------:|-----------------:|-------------------:|----------:|-----------------:|---------:|-------------:|--------:|--------------:|------------:|-------------:|--------------:|--------------:|----------:|-----------:|--------------:|--------------:|----------:|----------:|--------------:|---------------------:|------------:|-----------------:|--------------:|-------------:|-------------------:|--------------:|--------------:|-----------------:|------------:|--------------:|--------------:|------------:|----------------:|---------:|--------------:|------------------:|--------------:|----------:|--------------:|---------------:|-----------------:|---------------:|--------------:|----------------:|--------------:|-----------:|--------------:|------------:|---------:|---------------:|-------------:|--------------:|---------:|------------------:|-----------------:|--------------:|-----------:|-----------------:|-----------------:|----------------:|----------:|-----------------:|------------:|
| 2025-06-16 | nan | nan | nan | nan | nan | nan | 24.2525 | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | 7.28563e+07 | nan | 1273.09 | nan | nan | nan | nan | 3648.3 | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | 36.3991 | nan | nan | nan | nan | nan | 305697 | 860.33 | nan | nan | nan | 174.148 | nan | 414.896 | nan | nan | nan | nan | nan | nan | nan | nan | 1.47767e+07 | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | 9.65602 | nan | nan | nan | nan | nan | nan | nan | 7.30748e+07 | 0.0200598 | nan | 6.28695e+06 | 5362.32 | nan | 33937.3 | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | 8.06026e+06 | nan | nan | nan | nan | nan | nan | nan | nan | nan | 1.44479e+07 | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | 5.97894e+07 | nan | nan | nan | nan | nan | nan | nan | nan | 7.51978e+06 | nan | nan | nan | nan | 1121.72 | 283741 | nan |
| 2025-06-09 | nan | nan | nan | 3.9427e+09 | nan | nan | 128.279 | nan | nan | nan | nan | 18.8197 | nan | nan | nan | nan | nan | nan | nan | nan | 27456.6 | nan | nan | nan | nan | nan | nan | nan | 2.3489e+07 | nan | nan | nan | nan | nan | nan | nan | 1.81381e+09 | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | 190.978 | nan | nan | nan | nan | nan | nan | 3268.86 | nan | nan | nan | nan | 0.499602 | nan | nan | nan | nan | 855556 | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | 253829 | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | 2.41518e+07 | nan | nan | nan | nan | 0.0791926 | 3.18769e+08 | nan | nan | nan | 194835 | nan | nan | nan | nan | 1380.09 | nan | 2.74333e+08 | nan | nan | 1.92528e+06 | 1.72294e+07 | nan | nan | nan | nan | nan | nan | nan | nan | 3557.75 | nan | nan | nan | 28.5826 | 7.63858e+07 | nan | nan | nan | nan | nan | nan | nan | nan | 9.52574e+07 | nan | 1.93153e+07 | 10.7357 | nan | nan | 105207 | nan | nan | nan | nan | nan | 2.80255e+08 | nan | 7104.12 | nan | nan | nan | nan | nan | nan | 4.2073e+07 | nan | 2.89495 | nan | nan | nan | nan | 2992.39 |
| 2025-06-02 | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | 474073 | nan | 2.95847e+06 | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | 390840 | nan | nan | nan | nan | 46.4313 | nan | nan | nan | nan | nan | 5.17036e+08 | nan | nan | nan | 454.08 | nan | nan | nan | nan | nan | nan | nan | nan | 1.8465e+09 | nan | nan | nan | nan | nan | nan | nan | nan | 94065 | nan | 0.595781 | nan | nan | 89123.5 | nan | nan | nan | nan | 1.86389e+07 | nan | nan | nan | 0.970446 | nan | 8.43072e+08 | nan | nan | nan | nan | nan | nan | nan | 30839 | nan | nan | 1.70075e+06 | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | 178.302 | nan | nan | nan | nan | 31.864 | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | 31939 | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | 472.482 | nan | nan | nan | nan | nan | nan | nan | nan |
```
### 6. get_monthly_trading_volume_by_dex
**Prompt**:
```
Provide the monthly trading volume by DEX for the last 3 months.
```
**Output**:
```
| date | 0x-API | 1inch-LOP | abstractswap | aerodrome | agni | airswap | akronswap | alienbase | apeswap | arbswap | auragi | autotronic | babyswap | balancer | bancor | baseswap | beethoven_x | beets | beraswap | biswap | blasterswap | blazeswap | bridgers | burrbear | camelot | carbon_defi | chronos | citadelswap | clipper | curve | dackieswap | defi_kingdoms | defiswap | derpdex | dfx | dfyn | dodo | dooar | dracula_finance | dragon_swap | dyorswap | echodex | elk_finance | ellipsis_finance | enosys | equalizer | ezkalibur | fenix | flashliquidity | fluid | fraxswap | fusionx | gemswap | glacier | gmx | gooddollar_reserve | gravity_finance | gridex | honeyswap | horizondex | hyperjump | icecreamswap | infusion | inkyswap | integral | iziswap | jelly_swap | jojo | katana | klay_swap | kodiak | kyberswap | leetswap | lynex | maverick | mdex | mento | merchant_moe | mindgames | moonbase | mummy_finance | mute | neopin | nile | nomiswap | nuri | oasisswap | oku | openocean | openxswap | otsea | pancakeswap | pharaoh | plantbaseswap | quickswap | ramses | rcpswap | reservoir_swap | rocketswap | rooster_protocol | rubicon | sailor_finance | scale | scrollswap | secta | shadow | sharkswap | sharkyswap | shibaswap | silverswap | smardex | sobal | solidlizard | solidly | soswap | spacefi | sparkdex | spartacus_exchange | spartadex | spiritswap | spookyswap | stablebase | sterling_finance | sushiswap | swaap | swapbased | swapblast | swapr | syncswap | synthetix | tamadotmeme | tapio | thena | throne_exchange | thruster | torus | trader_joe | tropicalswap | ubeswap | unichainswap | uniswap | valantis | velocimeter | velocore | velodrome | verse_dex | vesync | wagmi | wardenswap | wigoswap | wombat | wombat_exchange | wombatexchange | woofi | xchange | xei_finance | yaka | zebra | zipswap | zkswap_finance | zyberswap |
|:-----------|--------------:|--------------:|---------------:|--------------:|--------------:|--------------:|------------:|---------------:|--------------:|----------------:|---------:|-------------:|-----------------:|--------------:|--------------:|--------------:|-----------------:|--------------:|--------------:|--------------:|-----------------:|------------:|-----------:|----------------:|--------------:|-----------------:|----------:|--------------:|--------------:|--------------:|----------------:|----------------:|-----------------:|----------:|----------:|---------:|--------------:|--------------:|------------------:|--------------:|-----------:|----------:|--------------:|-------------------:|----------------:|--------------:|------------:|-----------:|-----------------:|--------------:|--------------:|-----------------:|----------:|----------:|-----------------:|---------------------:|------------------:|-----------:|------------:|-------------:|------------:|---------------:|-----------:|-----------------:|--------------:|-----------------:|-----------------:|----------:|--------------:|-----------------:|--------------:|-----------------:|-----------:|--------------:|--------------:|-----------------:|--------------:|-----------------:|------------:|-----------:|----------------:|-----------------:|---------:|--------------:|-------------:|--------------:|------------:|--------------:|--------------:|------------:|----------:|--------------:|--------------:|----------------:|--------------:|--------------:|----------:|-----------------:|-----------------:|-------------------:|----------:|-----------------:|---------:|-------------:|--------:|--------------:|------------:|-------------:|--------------:|--------------:|----------:|-----------:|--------------:|--------------:|----------:|----------:|--------------:|---------------------:|------------:|-----------------:|--------------:|-------------:|-------------------:|--------------:|--------------:|-----------------:|------------:|--------------:|--------------:|------------:|----------------:|---------:|--------------:|------------------:|--------------:|----------:|--------------:|---------------:|-----------------:|---------------:|--------------:|----------------:|--------------:|-----------:|--------------:|------------:|---------:|---------------:|-------------:|--------------:|---------:|------------------:|-----------------:|--------------:|-----------:|-----------------:|-----------------:|----------------:|----------:|-----------------:|------------:|
| 2025-06-16 | nan | nan | nan | nan | nan | nan | 24.2525 | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | 7.28563e+07 | nan | 1273.09 | nan | nan | nan | nan | 3648.3 | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | 36.3991 | nan | nan | nan | nan | nan | 305697 | 860.33 | nan | nan | nan | 174.148 | nan | 414.896 | nan | nan | nan | nan | nan | nan | nan | nan | 1.47767e+07 | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | 9.65602 | nan | nan | nan | nan | nan | nan | nan | 7.30748e+07 | 0.0200598 | nan | 6.28695e+06 | 5362.32 | nan | 33937.3 | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | 8.06026e+06 | nan | nan | nan | nan | nan | nan | nan | nan | nan | 1.44479e+07 | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | 5.97894e+07 | nan | nan | nan | nan | nan | nan | nan | nan | 7.51978e+06 | nan | nan | nan | nan | 1121.72 | 283741 | nan |
| 2025-06-09 | nan | nan | nan | 3.9427e+09 | nan | nan | 128.279 | nan | nan | nan | nan | 18.8197 | nan | nan | nan | nan | nan | nan | nan | nan | 27456.6 | nan | nan | nan | nan | nan | nan | nan | 2.3489e+07 | nan | nan | nan | nan | nan | nan | nan | 1.81381e+09 | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | 190.978 | nan | nan | nan | nan | nan | nan | 3268.86 | nan | nan | nan | nan | 0.499602 | nan | nan | nan | nan | 855556 | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | 253829 | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | 2.41518e+07 | nan | nan | nan | nan | 0.0791926 | 3.18769e+08 | nan | nan | nan | 194835 | nan | nan | nan | nan | 1380.09 | nan | 2.74333e+08 | nan | nan | 1.92528e+06 | 1.72294e+07 | nan | nan | nan | nan | nan | nan | nan | nan | 3557.75 | nan | nan | nan | 28.5826 | 7.63858e+07 | nan | nan | nan | nan | nan | nan | nan | nan | 9.52574e+07 | nan | 1.93153e+07 | 10.7357 | nan | nan | 105207 | nan | nan | nan | nan | nan | 2.80255e+08 | nan | 7104.12 | nan | nan | nan | nan | nan | nan | 4.2073e+07 | nan | 2.89495 | nan | nan | nan | nan | 2992.39 |
| 2025-06-02 | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | 474073 | nan | 2.95847e+06 | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | 390840 | nan | nan | nan | nan | 46.4313 | nan | nan | nan | nan | nan | 5.17036e+08 | nan | nan | nan | 454.08 | nan | nan | nan | nan | nan | nan | nan | nan | 1.8465e+09 | nan | nan | nan | nan | nan | nan | nan | nan | 94065 | nan | 0.595781 | nan | nan | 89123.5 | nan | nan | nan | nan | 1.86389e+07 | nan | nan | nan | 0.970446 | nan | 8.43072e+08 | nan | nan | nan | nan | nan | nan | nan | 30839 | nan | nan | 1.70075e+06 | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | 178.302 | nan | nan | nan | nan | 31.864 | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | 31939 | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | nan | 472.482 | nan | nan | nan | nan | nan | nan | nan | nan |
```
### 7. get_yoy_monthly_trading_volume_by_aggragator
**Prompt**:
```
Show year-over-year monthly trading volume for aggregators.
```
**Output**:
```
| year | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 |
|-------:|-----------------:|------------:|------------:|------------:|------------:|------------:|--------------:|--------------:|--------------:|--------------:|--------------:|--------------:|
| 2025 | 2.6344e+11 | 2.36686e+11 | 1.6914e+11 | 1.5959e+11 | 3.85094e+11 | 2.81759e+11 | nan | nan | nan | nan | nan | nan |
| 2024 | 9.5693e+10 | 9.49883e+10 | 1.98208e+11 | 1.61585e+11 | 1.49672e+11 | 1.22593e+11 | 1.30714e+11 | 1.33184e+11 | 1.00131e+11 | 1.25579e+11 | 2.17639e+11 | 2.56072e+11 |
| 2023 | 6.0862e+10 | 7.81583e+10 | 1.39304e+11 | 7.03345e+10 | 7.58675e+10 | 6.19053e+10 | 6.09686e+10 | 5.25148e+10 | 4.05014e+10 | 7.06179e+10 | 8.01446e+10 | 9.3638e+10 |
| 2022 | 1.96723e+11 | 1.33929e+11 | 1.27323e+11 | 1.25358e+11 | 1.55012e+11 | 9.74443e+10 | 7.48634e+10 | 7.5175e+10 | 6.05425e+10 | 5.23205e+10 | 9.32754e+10 | 3.97584e+10 |
| 2021 | 5.15043e+10 | 6.17656e+10 | 6.19704e+10 | 1.28866e+11 | 2.95496e+11 | 1.28202e+11 | 1.00236e+11 | 1.33086e+11 | 1.38861e+11 | 1.70694e+11 | 2.39774e+11 | 2.17806e+11 |
| 2020 | 1.02144e+08 | 2.46819e+08 | 3.92454e+08 | 3.0359e+08 | 4.67602e+08 | 9.219e+08 | 3.01124e+09 | 9.83209e+09 | 2.38549e+10 | 1.60263e+10 | 1.59911e+10 | 2.15735e+10 |
| 2019 | 986565 | 1.18262e+07 | 1.65042e+07 | 3.52948e+07 | 4.59905e+07 | 4.15597e+07 | 4.45867e+07 | 2.68348e+07 | 2.43976e+07 | 2.77607e+07 | 5.40536e+07 | 8.70401e+07 |
```
### 8. get_weekly_solana_trading_volume_by_dex
**Prompt**:
```
What is the weekly trading volume for DEXs on Solana for the last 3 weeks?
```
**Output**
```
| date | goosefx_ssl | lifinity | meteora | phoenix | pumpdotfun | pumpswap | raydium | raydium_launchlab | stabble | whirlpool |
|:-----------|-----------------:|------------:|-----------------:|-----------------:|--------------:|--------------:|------------:|--------------------:|-----------------:|------------:|
| 2025-06-16 | nan | 9.81445e+07 | 3.46272e+08 | 3.44096e+07 | 1.90687e+08 | 8.02281e+09 | 1.01863e+09 | 1.07869e+07 | 4.95819e+10 | 6.51327e+08 |
| 2025-06-09 | nan | 6.18942e+08 | 1.94626e+09 | 8.03845e+07 | 1.01708e+09 | 4.34817e+10 | 6.33283e+09 | 6.49009e+07 | 2.15622e+11 | 3.69636e+09 |
| 2025-06-02 | nan | 6.84921e+08 | 1.93531e+09 | 1.68665e+08 | 1.14978e+09 | 3.4177e+10 | 5.42204e+09 | 6.05058e+07 | 2.89378e+08 | 2.85667e+09 |
```
### 9. get_weekly_trading_volume_by_frontend
**Prompt**:
```
List the trading volume by frontend, sorted by volume
```
**Output**:
```
| | frontend | tx_count | user_count | volume |
|---:|:--------------------------------------|-----------:|-------------:|-----------------:|
| 0 | Cowswap Integrators | 20238 | 7101 | 1.14368e+09 |
| 1 | 1inch Integrators | 76552 | 30989 | 3.84088e+08 |
| 2 | Uniswap Website & Wallet: Default | 210880 | 59950 | 3.23129e+08 |
| 3 | OKX Wallet | 79271 | 21295 | 2.87817e+08 |
| 4 | Unknown: Uniswap V2 Router | 174365 | 17415 | 2.64427e+08 |
| 5 | 1inch Website: Default | 7908 | 2774 | 2.55316e+08 |
| 6 | Paraswap Integrators | 10831 | 4943 | 1.88714e+08 |
| 7 | Tokenlon Integrators | 5376 | 1614 | 1.56388e+08 |
| 8 | Kyber Integrators | 11331 | 3281 | 1.50065e+08 |
| 9 | Unknown: Uniswap V3 Router 1 | 13221 | 286 | 1.26051e+08 |
| 10 | Uniswap Website: Uniswap X ON | 9903 | 6268 | 1.18794e+08 |
| 11 | Banana Gun Telegram Bot | 92795 | 12503 | 9.24787e+07 |
| 12 | Pendle Finance | 4122 | 2706 | 7.80994e+07 |
| 13 | Curvefi Frontend | 1846 | 912 | 7.33432e+07 |
| 14 | Odos Frontend | 3121 | 1561 | 5.93105e+07 |
| 15 | Integral Frontend | 979 | 1 | 5.6517e+07 |
| 16 | MetaMask Swaps | 47346 | 27208 | 4.90175e+07 |
```
### 10. get_daily_trading_volume_by_telegram_bot
**Prompt**:
```
Show the daily trading volume for Telegram bots for the last 3 days.
```
**Output**:
```
| date | Alpha DEX | Autosnipe | Banana Gun | Bitfoot | Bloom | Blum | BonkBot | ChainSwap | Consortium Key | Floki Trading Bot | Jupbot | Looter | Maestro | Magnum | MevX | Mizar | Moonbot | Nova | Pepe Boost | PinkPunk | RoboTech | Sanji | Shuriken | Sigma | Sol Trading Bot | Soul Sniper | Tirador | TradeWiz | Trojan | Unibot | XCeption | baZOOka | uDEX |
|:-----------|------------:|------------:|-------------:|----------:|------------:|----------:|------------:|------------:|-----------------:|--------------------:|----------:|---------:|------------:|-----------:|-----------------:|---------:|----------:|-----------:|-----------------:|-----------:|-----------:|---------:|-----------:|--------------:|------------------:|--------------:|----------:|-----------------:|--------------:|---------:|-----------:|--------------:|------------:|
| 2025-06-16 | 97752.9 | 1743.21 | 8.44282e+06 | 2966.46 | 1.4035e+06 | 5187.14 | 1.61537e+06 | 21813 | 97847.3 | 0.0305078 | 9098.02 | 4527.94 | 1.22424e+06 | 33.9883 | 396885 | 27831.7 | 2927.28 | 111.282 | 555479 | 63385.2 | 28032.3 | 12112.8 | 124707 | 1.63298e+06 | 571822 | 18853.7 | 889.393 | 205116 | 4.73797e+06 | 72113.6 | 5027.14 | 158.99 | nan |
| 2025-06-15 | 256075 | 5877.59 | 1.65475e+07 | 11902.3 | 4.80051e+06 | 6252.82 | 6.07813e+06 | 100445 | 263162 | 63.5202 | 34643.4 | 46306.7 | 5.75185e+06 | 216.869 | 1.17818e+06 | 17633.5 | 4975.31 | 546.1 | 999106 | 178507 | 10356 | 35245.4 | 198899 | 3.02438e+06 | 1.86025e+06 | 81188.4 | 2639.15 | 746235 | 1.52717e+07 | 93074.7 | 20719.6 | 37.6789 | 20.2985 |
| 2025-06-14 | 277884 | 2889.19 | 1.49987e+07 | 15868.9 | 4.81029e+06 | 11588.4 | 5.54798e+06 | 106636 | 279717 | 456.944 | 7150.09 | 11824.8 | 5.48423e+06 | 204.858 | 1.31443e+06 | 24250.4 | 9052.33 | 18010.2 | 840265 | 202311 | 9645.36 | 32860.7 | 194910 | 3.28851e+06 | 1.92175e+06 | 122102 | 2582.13 | 679836 | 1.4186e+07 | 152476 | 20985.6 | 0.0250854 | 0.0379885 |
```
## License
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
TDQS
A3.7/5.0
Scored across 10 tools
Disambiguation3/5
The tools have overlapping purposes with multiple variations of trading volume retrieval by different dimensions (DEX, chain, frontend, etc.), which could cause confusion. However, the descriptions clearly specify the breakdown dimension and timeframe, helping to distinguish them. There is some ambiguity between similar tools like get_weekly_trading_volume_by_dex and get_weekly_solana_trading_volume_by_dex, but the descriptions clarify the scope.
Naming Consistency5/5
All tools follow a consistent snake_case naming pattern with a clear get_<timeframe>_trading_volume_by_<dimension> structure. The naming is predictable and uniform across all 10 tools, making it easy to understand what each tool does based on its name alone.
Tool Count4/5
With 10 tools, the count is reasonable for a metrics server focused on trading volume data. However, there is some redundancy with multiple tools covering similar dimensions (e.g., multiple DEX-focused tools with different timeframes), which makes the set feel slightly heavy but still within appropriate bounds for the domain.
Completeness3/5
The server covers various dimensions (DEX, chain, frontend, aggregator, Telegram bot) and timeframes (daily, weekly, monthly, latest, YoY), but there are notable gaps. For example, there is no tool for creating, updating, or deleting data, and coverage is inconsistent across dimensions (e.g., no monthly data for chains or frontends). The surface is focused on retrieval only, which limits completeness for a full metrics management system.
Maintenance
ActivityInactive
ResponsivenessNo issues