GET
/
vault_state
/
{token_mint}
get_vault_state
curl --request GET \
  --url https://merv2-api.meteora.ag/vault_state/{token_mint}
{
  "symbol": "USDC",
  "token_address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
  "pubkey": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
  "is_monitoring": true,
  "vault_order": 1,
  "usd_rate": 1,
  "closest_apy": 0.05,
  "average_apy": 0.048,
  "long_apy": 0.052,
  "earned_amount": 1000000,
  "virtual_price": "1.05234",
  "enabled": 1,
  "lp_mint": "7dHbWXmci3dT6jZtZwrzqQzrmSjmKhc2EEcr6rKhTgvD",
  "fee_pubkey": "HKy7a5FnL8Qg2HUE6YRkG6xfv8FvVcFqPXvR6T7bGpQ2",
  "total_amount": 50000000,
  "total_amount_with_profit": 52500000,
  "token_amount": 51000000,
  "fee_amount": 250000,
  "lp_supply": 48500000,
  "earned_usd_amount": 1000,
  "strategies": [
    {
      "pubkey": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
      "reserve": "8UJgxaiQx5nTrdDgph5FiahMmzduuLTLf5WmsPegYA6W",
      "strategy_type": "Solend",
      "strategy_name": "Solend USDC Main Pool",
      "liquidity": 10000000,
      "max_allocation": 50,
      "isolated": false,
      "disabled": false,
      "safe_utilization_threshold": 80
    }
  ],
  "timestamp": 1640995200
}

Path Parameters

token_mint
string
required

The token mint address (Solana public key)

Example:

"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"

Response

Vault state information

Complete state information for a vault

symbol
string
required

Token symbol (e.g., USDC, SOL)

Example:

"USDC"

token_address
string
required

Token mint address

Example:

"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v"

pubkey
string
required

Vault public key address

Example:

"9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM"

is_monitoring
boolean
required

Whether the vault is currently being monitored

Example:

true

vault_order
integer
required

Display order of the vault

Example:

1

usd_rate
number
required

Current USD exchange rate for the token

Example:

1

closest_apy
number
required

Most recent APY calculation

Example:

0.05

average_apy
number
required

Moving average APY

Example:

0.048

long_apy
number
required

Long-term APY calculation

Example:

0.052

earned_amount
integer
required

Total amount earned by the vault

Example:

1000000

virtual_price
string
required

Current virtual price as decimal string

Example:

"1.05234"

enabled
integer
required

Whether the vault is enabled (1) or disabled (0)

Example:

1

lp_mint
string
required

LP token mint address

Example:

"7dHbWXmci3dT6jZtZwrzqQzrmSjmKhc2EEcr6rKhTgvD"

fee_pubkey
string
required

Fee collection account public key

Example:

"HKy7a5FnL8Qg2HUE6YRkG6xfv8FvVcFqPXvR6T7bGpQ2"

total_amount
integer
required

Total amount deposited in the vault

Example:

50000000

total_amount_with_profit
integer
required

Total amount including accumulated profits

Example:

52500000

token_amount
integer
required

Current token amount in the vault

Example:

51000000

fee_amount
integer
required

Accumulated fee amount

Example:

250000

lp_supply
integer
required

Total LP token supply

Example:

48500000

earned_usd_amount
number
required

Earned amount in USD

Example:

1000

strategies
object[]
required

List of strategies used by this vault

timestamp
integer
required

Last update timestamp

Example:

1640995200