> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blockworks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Dex Aggregator Volumes

> Daily DEX volume in USD routed through one aggregator to one DEX version on one chain, split by pair category, with the number of DEX fills (hops). Each series is one chain, aggregator, DEX and DEX version. Many series per aggregator, so name the routes you need.

One row per DEX aggregator route, keyed by chain, aggregator, DEX and DEX version: the aggregator and DEX with their mapped project records, and the chain. The id is the series key of the dex- aggregator-volumes timeseries model.

| | |
| - | - |
| Access | Spot-dex-protocols-dataset |
| Tabular model | `dex-aggregator-volumes`: primary key `id` |
| Timeseries model | `dex-aggregator-volumes`: intervals `1d`, series key `id` (DEX Aggregator Volume ID), every series available in one call |

## Endpoints

> [card] [List DEX Aggregator Volumes](https://docs.blockworks.com/api-reference/data-api/dex-aggregators/tabular-dex-aggregator-volumes.md)
>
> One page of rows with per-column filters, sorting and pagination.

> [card] [Batch Get DEX Aggregator Volume timeseries](https://docs.blockworks.com/api-reference/data-api/dex-aggregators/timeseries-dex-aggregator-volumes.md)
>
> Up to 10 series in one request, named by series key in `series`.

> [card] [Get DEX Aggregator Volume timeseries](https://docs.blockworks.com/api-reference/data-api/dex-aggregators/timeseries-dex-aggregator-volumes-by-id.md)
>
> One series over a time window, keyed by its DEX Aggregator Volume ID.

## Metrics

11 metrics. Use the `Field` value in `selections`; every point starts with the timestamp and continues in this order.

| Field | Name | Type | Unit | Description |
| - | - | - | - | - |
| `volumeUSD` | | | | |
| `dexHops` | | | | |
| `blockchainTokenVolumeUSD` | | | | |
| `stablecoinSwapVolumeUSD` | | | | |
| `lstSwapVolumeUSD` | | | | |
| `tokenizedAssetVolumeUSD` | | | | |
| `projectTokenVolumeUSD` | | | | |
| `memeVolumeUSD` | | | | |
| `compositeVolumeUSD` | | | | |
| `predictionMarketVolumeUSD` | | | | |
| `otherVolumeUSD` | | | | |

## Columns

Use the `Field` value in `selections`, `sortBy`, and as the base of a filter parameter (`Field` plus one of its `Filters` suffixes).

| Field | Type | Filters | Sort | Description |
| - | - | - | - | - |
| `aggregatorID` | string | | | The aggregator the trade was routed through (cowswap, kyberswap, 0x, 1inch, jupiter). |
| `chain` | string | | | The short name of the chain (ethereum, base, solana). |
| `exchangeID` | string | | | The DEX the trade filled on. |
| `exchangeProjectID` | string | | | The identifier of the DEX's project record; null when unmapped. |
| `exchangeVersion` | string | | | The version of that DEX (v2, v3, clmm-v1, dlmm). |
| `id` | string | | | The series key of the dex-aggregator-volumes timeseries model, the chain, aggregator, DEX and DEX version, joined with underscores. |
| `name` | string | | | The display name of the series. |
| `networkID` | string | | | The chain's networkID in the blockchains model; null when unmapped. |
| `projectID` | string | | | The identifier of the aggregator's project record; null when unmapped. |
| `slug` | string | | | The aggregator's project slug, the slug used for the same protocol across the API; null when unmapped. |

## Example

```bash curl theme={null}
curl "https://api.blockworks.com/query/timeseries/dex-aggregator-volumes/1d/<id>?timeframe=7d&selections=volumeUSD,dexHops" \
  -H "X-Blockworks-API-Key: $BLOCKWORKS_API_KEY"
```

See [Get DEX Aggregator Volume timeseries](https://docs.blockworks.com/api-reference/data-api/dex-aggregators/timeseries-dex-aggregator-volumes-by-id.md) for the response and the errors.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.