> ## 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.

# Dynamic Vault Data API Overview

> Learn how the Dynamic Vault Data API exposes indexed vault state, vault addresses, APY history, strategy allocation, and virtual price data.

The Dynamic Vault Data API exposes read-only indexed data for supported vaults, including vault addresses, APY snapshots, strategy allocation, LP supply, total amount, fee amount, virtual price, and timestamps.

<Tip>
  The checked-in Dynamic Vault OpenAPI file does not declare a rate limit. Treat the API as a read-only data source for discovery and dashboards, and use on-chain vault accounts as the source of truth for transaction-critical execution.
</Tip>

## Base URL

| Environment | Base URL | Notes |
| - | - | - |
| Production | `https://merv2-api.meteora.ag` | Verified live for Dynamic Vault routes such as `/vault_info` and `/vault_addresses`. |

The `@meteora-ag/vault-sdk` source also includes older keeper URL constants. Prefer the documented production host above for new Dynamic Vault API integrations.

## Vaults

<CardGroup>
  <Card title="Vault Info" icon="file-code" iconType="solid" href="/api-reference/dynamic-vault/vaults/get_vault_info">
    Returns all monitored vault states using `GET` `/vault_info`
  </Card>

  <Card title="Vault Addresses" icon="file-code" iconType="solid" href="/api-reference/dynamic-vault/vaults/get_vault_addresses">
    Returns vault, LP mint, and fee account addresses using `GET` `/vault_addresses`
  </Card>

  <Card title="Vault State" icon="file-code" iconType="solid" href="/api-reference/dynamic-vault/vaults/get_vault_state">
    Returns one vault state by token mint using `GET` `/vault_state/{token_mint}`
  </Card>
</CardGroup>

## APY

<CardGroup>
  <Card title="APY State" icon="file-code" iconType="solid" href="/api-reference/dynamic-vault/apy/get_apy_state">
    Returns current APY values for a token mint using `GET` `/apy_state/{token_mint}`
  </Card>

  <Card title="APY By Time Range" icon="file-code" iconType="solid" href="/api-reference/dynamic-vault/apy/get_apy_by_time_range">
    Returns APY data within a Unix timestamp range using `GET` `/apy_filter/{token_mint}/{start_timestamp}/{end_timestamp}`
  </Card>
</CardGroup>

## Virtual Price

<CardGroup>
  <Card title="Virtual Price" icon="file-code" iconType="solid" href="/api-reference/dynamic-vault/virtual-price/get_virtual_price">
    Returns virtual price records for a token mint and strategy using `GET` `/virtual_price/{token_mint}/{strategy}`
  </Card>
</CardGroup>

## Common Response Fields

`VaultState` responses include these fields:

| Field | Meaning |
| - | - |
| `symbol` | Display symbol for the vault token. |
| `token_address` | Underlying token mint. |
| `pubkey` | Vault account address. |
| `lp_mint` | Vault LP mint. |
| `fee_pubkey` | Fee vault token account. |
| `enabled` | Current vault enabled flag from indexed state. |
| `total_amount` | Total vault amount in base token units. |
| `total_amount_with_profit` | Total amount including indexed profit accounting. |
| `token_amount` | Amount currently held in the vault reserve token account. |
| `fee_amount` | Indexed fee amount. |
| `lp_supply` | Current LP mint supply. |
| `virtual_price` | String virtual price derived from vault accounting. |
| `usd_rate` | Indexed USD rate for the vault token. |
| `closest_apy`, `average_apy`, `long_apy` | Short, 24-hour, and longer-window APY values from the API schema. |
| `earned_amount`, `earned_usd_amount` | Indexed earned amount in token units and USD terms. |
| `strategies` | Strategy allocation array. |
| `timestamp` | API snapshot timestamp. |

## Strategy Fields

| Field | Meaning |
| - | - |
| `pubkey` | Strategy account address. |
| `reserve` | Strategy reserve account. |
| `strategy_type` | Program strategy enum string. |
| `strategy_name` | Display name for the strategy. |
| `liquidity` | Strategy liquidity in base token units. |
| `max_allocation` | Configured maximum allocation percent. |
| `isolated` | Whether the strategy is isolated in the API's risk model. |
| `disabled` | Whether the API marks the strategy disabled. |
| `safe_utilization_threshold` | API utilization threshold for strategy safety. |

## Query Parameters

| Endpoint | Parameter | Meaning |
| - | - | - |
| `/vault_state/{token_mint}` | `token_mint` | Underlying token mint public key. |
| `/apy_state/{token_mint}` | `token_mint` | Underlying token mint public key. |
| `/apy_filter/{token_mint}/{start_timestamp}/{end_timestamp}` | `start_timestamp`, `end_timestamp` | Unix timestamps in seconds. `end_timestamp` must be greater than `start_timestamp`. |
| `/virtual_price/{token_mint}/{strategy}` | `strategy` | Strategy identifier expected by the API. |

## API Or On-Chain Data

| Need | Use |
| - | - |
| Vault discovery | Data API `/vault_info` or `/vault_addresses`. |
| Dashboard APY and strategy allocation | Data API APY and vault-state endpoints. |
| Transaction construction | On-chain vault, LP mint, token vault, and strategy accounts. |
| Deposit/withdraw execution | TypeScript SDK or CPI with fresh on-chain state and simulation. |
| Virtual price display | Data API for display, on-chain calculation for execution-sensitive flows. |

## Source Note

The production URL `https://damm-api.meteora.ag/swagger-ui/` serves the Dynamic AMM keeper OpenAPI spec, not the Dynamic Vault routes listed above. The Dynamic Vault routes in this guide are backed by the checked-in `developer-guides/dynamic-vault/api-reference/openapi.json` file and live `merv2-api` route checks.


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