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

# DAMM v2 Data API Overview

> Learn how the DAMM v2 Data API exposes indexed pools, pool groups, OHLCV candles, historical volume, protocol stats, and query filters.

<Tip>
  **All DAMM v2 APIs have a rate limit of 10 requests per second (10 RPS).** Explore the production spec at the [Prod Swagger UI](https://damm-v2.datapi.meteora.ag/swagger-ui/) or the development spec at the [Dev Swagger UI](https://damm-v2-api.dev.metdev.io/swagger-ui/).
</Tip>

## Base URLs

| Environment | Base URL                            | Swagger UI                                            |
| ----------- | ----------------------------------- | ----------------------------------------------------- |
| Production  | `https://damm-v2.datapi.meteora.ag` | [Open](https://damm-v2.datapi.meteora.ag/swagger-ui/) |
| Development | `https://damm-v2-api.dev.metdev.io` | [Open](https://damm-v2-api.dev.metdev.io/swagger-ui/) |

The checked-in OpenAPI file uses the same endpoint schema for both environments. Use the server dropdown in the API playground to switch between production and development.

## Pools

<CardGroup>
  <Card title="Pools" icon="file-code" iconType="solid" href="/api-reference/damm-v2/pools/pools">
    Returns a paginated list of pools using `GET` `/pools`
  </Card>

  <Card title="Groups" icon="file-code" iconType="solid" href="/api-reference/damm-v2/pools/groups">
    Returns a paginated list of pool groups using `GET` `/pools/groups`
  </Card>

  <Card title="Group" icon="file-code" iconType="solid" href="/api-reference/damm-v2/pools/group">
    Returns pools that belong to a specific pool group using `GET` `/pools/groups/{lexical_order_mints}`
  </Card>

  <Card title="Pool" icon="file-code" iconType="solid" href="/api-reference/damm-v2/pools/pool">
    Returns metadata and current indexed state for a single pool using `GET` `/pools/{address}`
  </Card>

  <Card title="OHLCV" icon="file-code" iconType="solid" href="/api-reference/damm-v2/pools/ohlcv">
    Returns OHLCV candles for a single pool over a time range using `GET` `/pools/{address}/ohlcv`
  </Card>

  <Card title="Historical Volume" icon="file-code" iconType="solid" href="/api-reference/damm-v2/pools/historical-volume">
    Returns historical volume for a pool aggregated into time buckets using `GET` `/pools/{address}/volume/history`
  </Card>
</CardGroup>

## Stats

<CardGroup>
  <Card title="Protocol Overview" icon="file-code" iconType="solid" href="/api-reference/damm-v2/stats/protocol-overview">
    Returns aggregated protocol-level metrics across all pools using `GET` `/stats/protocol_metrics`
  </Card>
</CardGroup>

## Query Syntax

List endpoints use common query parameters:

| Parameter   | Use                                                               |
| ----------- | ----------------------------------------------------------------- |
| `page`      | 1-based page number.                                              |
| `page_size` | Page size. Pool lists support up to `1000`.                       |
| `query`     | Search by pool name, tokens, or address.                          |
| `sort_by`   | Format: `<field>:<direction>` or `<metric>_<window>:<direction>`. |
| `filter_by` | Format: `<field><op><value> [&& <field><op><value> ...]`.         |

Supported time windows include `5m`, `30m`, `1h`, `2h`, `4h`, `12h`, and `24h`.

Common sortable fields include `tvl`, `fee_pct`, `bin_step`, `pool_created_at`, `farm_apy`, `volume_*`, `fee_*`, `fee_tvl_ratio_*`, and `apr_*`.

Common filter fields include `tvl`, `is_blacklisted`, `pool_address`, `name`, `token_x`, `token_y`, `volume_*`, `fee_*`, `fee_tvl_ratio_*`, and `apr_*`.