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.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.
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. |
@meteora-ag/vault-sdk source also includes older keeper URL constants. Prefer the documented production host above for new Dynamic Vault API integrations.
Vaults
Vault Info
Returns all monitored vault states using
GET /vault_infoVault Addresses
Returns vault, LP mint, and fee account addresses using
GET /vault_addressesVault State
Returns one vault state by token mint using
GET /vault_state/{token_mint}APY
APY State
Returns current APY values for a token mint using
GET /apy_state/{token_mint}APY By Time Range
Returns APY data within a Unix timestamp range using
GET /apy_filter/{token_mint}/{start_timestamp}/{end_timestamp}Virtual Price
Virtual Price
Returns virtual price records for a token mint and strategy using
GET /virtual_price/{token_mint}/{strategy}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 URLhttps://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.