---
title: "Aggregate DEX liquidity and volume for tracked Base tokens"
method: GET
path: "/v1/dex/metrics"
tags: ["Market"]
---

# Aggregate DEX liquidity and volume for tracked Base tokens

`GET /v1/dex/metrics`

## Request

- Base URL: `https://api.m2msentinel.com`
- URL: `https://api.m2msentinel.com/v1/dex/metrics`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer
  - API key in header `PAYMENT-SIGNATURE`

The `coverage` object states exactly which tokens were aggregated. This is not a whole-chain total.

## Response `200`

Aggregate with coverage and provenance

- DexMetricsResponse
  - `status` string
  - `metrics` object
    - `indexedPools` integer
    - `totalVolume24hUsd` integer
    - `totalLiquidityDepthUsd` integer
    - `topPairs` object[]
      - `pair` string
      - `dex` string
      - `pairAddress` string
      - `liquidityUsd` integer
      - `volume24hUsd` integer
      - `priceUsd` number
  - `coverage` object
    - `description` string
    - `trackedTokens` string[]
    - `sourcesQueried` integer
    - `sourcesSucceeded` integer
    - `degraded` boolean
  - `provenance` Provenance: Where a value came from and how old it is. Present on every data response.
    - `source` string
    - `endpoint` string
    - `trustLevel` 'HIGH_TRUST_PRIMARY' | 'QUORUM_PUBLIC' | 'DEGRADED_LOW_TRUST'
    - `agreement` integer: Providers that returned the selected result.
    - `sampled` integer: Providers that answered at all.
    - `retrievedAt` string, date-time
    - `ageSeconds` integer
    - `network` string
    - `note` string, nullable

## Other responses

- `401`: Missing or invalid credential, or a credential was supplied in the query string
- `402`: No credential supplied for a payable route, or the issuance-anchored 31-day credit allowance is exhausted
- `429`: A plan burst limit or bounded public/intent retry limit was exceeded
- `503`: The upstream data source is unavailable. No value is returned rather than an estimated one.

---

[API](https://skmtc.dev/m2msentinel/apis/m2m-sentinel-base-contract-capability-checks-before-you-sign.md) · [All operations](https://skmtc.dev/m2msentinel/apis/m2m-sentinel-base-contract-capability-checks-before-you-sign/llms.txt) · [OpenAPI document](https://skmtc.dev/m2msentinel/apis/m2m-sentinel-base-contract-capability-checks-before-you-sign/revisions/2dadd4e704fd?raw)