Vault

Reading Vault Data

Retrieve vault TVL, APY, farm rewards, allocation weights, and user share balances using the Kamino SDK and API.

Historical vault data is only available via the API.

Get All Vaults

This fetches all available Kamino vaults from the API, and returns an array of vault objects containing address, state, and configuration data for each vault.

getAllVaults

const url = 'https://api.kamino.finance/kvaults/vaults';
const res = await fetch(url);
if (!res.ok) {
  throw new Error(`Request failed: ${res.status} ${res.statusText}`);
}
const vaults = await res.json();

console.log({
  address: vaults[0].address,
  name: vaults[0].state.name,
  tokenMint: vaults[0].state.tokenMint,
  sharesIssued: vaults[0].state.sharesIssued,
  tokenAvailable: vaults[0].state.tokenAvailable,
});

View Code

Get Vault Info

Retrieves real-time vault metrics including holdings, APY rates, and exchange rate. And uses the SDK to query on-chain vault state and performance data.

Using the SDK requires a private RPC connection or the public rate-limited RPC endpoint.

TypeScript
Rust

getVaultInfo

import { createSolanaRpc, address } from '@solana/kit';
import { KaminoVault } from '@kamino-finance/klend-sdk';

const vault = new KaminoVault(
  createSolanaRpc('https://api.mainnet-beta.solana.com'), // RPC
  address('HDsayqAsDWy3QvANGqh2yNraqcD8Fnjgh73Mhb3WRS5E') // USDC vault
);

console.log({
  holdings: (await vault.getVaultHoldings()).asJSON(),
  apys: await vault.getAPYs(),
  exchangeRate: (await vault.getExchangeRate()).toString(),
});

View Code

Read and inspect a vault’s on-chain state with the kvault-interface crate — configuration, fees, AUM, and per-reserve allocations — using zero-copy deserialization, no SDK or RPC framework required beyond solana-client.

Add Dependencies

[dependencies]
kvault-interface = "0.1.0"
solana-client = "2.3"
solana-pubkey = "2.1"

Fetch and Parse the Vault

from_account_data::<VaultState> deserializes the raw account bytes into a zero-copy VaultState view.

use std::str::FromStr;

use kvault_interface::{
    from_account_data,
    state::{VaultAllocation, VaultState},
    Fraction,
};
use solana_client::rpc_client::RpcClient;
use solana_pubkey::Pubkey;

let rpc = RpcClient::new("https://api.mainnet-beta.solana.com".to_string());
let vault_pubkey = Pubkey::from_str("HDsayqAsDWy3QvANGqh2yNraqcD8Fnjgh73Mhb3WRS5E").unwrap();

let vault_account = rpc.get_account(&vault_pubkey).unwrap();
let vault = from_account_data::<VaultState>(&vault_account.data).unwrap();

Read Vault Configuration

println!("Vault: {vault_pubkey}");
println!("  Admin: {}", vault.vault_admin_authority);
println!("  Token mint: {}", vault.token_mint);
println!("  Available liquidity: {}", vault.token_available);
println!("  Shares issued: {}", vault.shares_issued);
println!("  Performance fee: {} bps", vault.performance_fee_bps);
println!("  Management fee: {} bps", vault.management_fee_bps);

let prev_aum = Fraction::from_bits(u128::from(vault.prev_aum_sf));
println!("  Previous AUM: {prev_aum:.6}");

Fields suffixed with _sf are scaled fractions (fixed-point integers, 68 integer bits + 60 fractional bits). Convert them to a readable decimal with Fraction::from_bits(u128::from(value)).

Inspect Per-Reserve Allocations

The vault splits its assets across Klend reserves. Empty slots have a default reserve pubkey, so filter those out.

let active_allocations: Vec<&VaultAllocation> = vault
    .vault_allocation_strategy
    .iter()
    .filter(|a| a.reserve != Pubkey::default())
    .collect();

println!("\n  Active allocations: {}", active_allocations.len());
for alloc in &active_allocations {
    let target = Fraction::from_bits(u128::from(alloc.token_target_allocation_sf));
    println!("    Reserve: {}", alloc.reserve);
    println!("      Weight: {}", alloc.target_allocation_weight);
    println!("      cToken balance: {}", alloc.ctoken_allocation);
    println!("      Token cap: {}", alloc.token_allocation_cap);
    println!("      Target allocation: {target:.6}");
}

View Code

Get User Vault Position Historical Info

This queries historical performance metrics for a specific user’s position in a vault over a time range, and returns time-series data including the user’s balance, yield, and allocation changes.

getUserVaultPositionHistory

const kvaultPubkey = 'HDsayqAsDWy3QvANGqh2yNraqcD8Fnjgh73Mhb3WRS5E'; // vault address
const ownerPubkey = 'AxqtG9SHDkZTLSWg81Sp7VqAzQpRqXtR9ziJ3VQAS8As'; // user address

const API_BASE_URL = 'https://api.kamino.finance';

const params = new URLSearchParams({
  start: '2024-01-01T00:00:00.000Z',
  end: '2025-01-01T00:00:00.000Z',
}).toString();

const url = `${API_BASE_URL}/kvaults/users/${ownerPubkey}/vaults/${kvaultPubkey}/metrics/history?${params}`;
const res = await fetch(url);
if (!res.ok) {
  throw new Error(`Request failed: ${res.status} ${res.statusText}`);
}
const data = await res.json();
console.log(data);

View Code

Get Vault Metrics History

Retrieves historical vault-level performance metrics including TVL, APY, and farm rewards APY. Returns time-series data showing the vault’s total value locked, yield rates, and reward rates over time.

getVaultMetricsHistory

const kvaultPubkey = 'HDsayqAsDWy3QvANGqh2yNraqcD8Fnjgh73Mhb3WRS5E'; // vault address

const API_BASE_URL = 'https://api.kamino.finance';

const params = new URLSearchParams({
  start: '2024-06-01T00:00:00.000Z',
  end: '2025-01-01T00:00:00.000Z',
}).toString();

const url = `${API_BASE_URL}/kvaults/vaults/${kvaultPubkey}/metrics/history?${params}`;
const res = await fetch(url);
if (!res.ok) {
  throw new Error(`Request failed: ${res.status} ${res.statusText}`);
}
const data = await res.json();

for (const item of data) {
  console.log({
    tvl: item.tvl,
    apy: item.apy,
    apyFarmRewards: item.apyFarmRewards,
  });
}

View Code

Get Advanced Vault Allocation Info

Queries the vault’s allocation strategy showing how funds are distributed across different reserves with their target weights and current allocations.

getVaultAllocations

import { createSolanaRpc, address } from '@solana/kit';
import { KaminoVault } from '@kamino-finance/klend-sdk';

const vault = new KaminoVault(
  createSolanaRpc('https://api.mainnet-beta.solana.com'), // RPC
  address('HDsayqAsDWy3QvANGqh2yNraqcD8Fnjgh73Mhb3WRS5E') // USDC vault
);

const allocations = await vault.getVaultAllocations();

for (const [address, overview] of allocations) {
  console.log(
    `Reserve: ${address}: weight ${overview.targetWeight.toString()}, allocation: ${overview.ctokenAllocation.toString()}`
  );
}

View Code

Get Advanced Vault Incentives Info

Retrieves detailed incentive information for the vault including delegated farm rewards, reserve farm incentives, and direct vault farm incentives along with comprehensive vault overview metrics.

getVaultIncentives

import { createSolanaRpc, address } from '@solana/kit';
import { KaminoManager, KaminoVault } from '@kamino-finance/klend-sdk';
import { Decimal } from 'decimal.js';

const rpc = createSolanaRpc('https://api.mainnet-beta.solana.com');
const vault = new KaminoVault(
  rpc,
  address('HDsayqAsDWy3QvANGqh2yNraqcD8Fnjgh73Mhb3WRS5E') // USDC vault
);

const kaminoManager = new KaminoManager(rpc);

const vaultTokenPrice = new Decimal(1.0); // as it is an USDC vault the token price is 1
const vaultOverview = await kaminoManager.getVaultOverview(vault, vaultTokenPrice);

console.log('vaultOverview', vaultOverview);
console.log('delegated farm incentives', vaultOverview.delegatedFarmIncentives);
console.log('reserves farm incentives', vaultOverview.reservesFarmsIncentives);
console.log('vault farm incentives', vaultOverview.vaultFarmIncentives);

View Code

Earn revenue by deploying vaults with custom fee structures. Set performance fees on profits and management fees on assets under management.

vaultRevenueShare

import { createSolanaRpc, address, generateKeyPairSigner } from '@solana/kit';
import { KaminoManager, KaminoVaultConfig } from '@kamino-finance/klend-sdk';
import { TOKEN_PROGRAM_ADDRESS } from '@solana-program/token';
import { Decimal } from 'decimal.js';

const rpc = createSolanaRpc('https://api.mainnet-beta.solana.com');
const adminSigner = await generateKeyPairSigner();
const tokenMint = address('EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v'); // USDC

const kaminoManager = new KaminoManager(rpc);

const kaminoVaultConfig = new KaminoVaultConfig({
  admin: adminSigner,
  tokenMint: tokenMint,
  tokenMintProgramId: TOKEN_PROGRAM_ADDRESS,
  performanceFeeRatePercentage: new Decimal(10.0),  // 10% performance fee on profits
  managementFeeRatePercentage: new Decimal(1.0),    // 1% annual management fee on AUM
  name: 'Revenue Share Vault',
  vaultTokenSymbol: 'kUSDC',
  vaultTokenName: 'kUSDC receipt',
});

View Code

Developers

Earn

Borrow

Multiply

Liquidity

Portfolio

Rewards

Oracle

Agentic Finance

Resources

Reading Vault Data

Get All Vaults

Get Vault Info

Add Dependencies

Fetch and Parse the Vault

Read Vault Configuration

Inspect Per-Reserve Allocations

Get User Vault Position Historical Info

Get Vault Metrics History

Get Advanced Vault Allocation Info

Get Advanced Vault Incentives Info

Additional Resources

API Examples

SDK Examples

​Reading Vault Data

​Get All Vaults

​Get Vault Info

​Add Dependencies

​Fetch and Parse the Vault

​Read Vault Configuration

​Inspect Per-Reserve Allocations

​Get User Vault Position Historical Info

​Get Vault Metrics History

​Get Advanced Vault Allocation Info

​Get Advanced Vault Incentives Info

​Vault Revenue Share

​Additional Resources

API Examples

SDK Examples

Reading Vault Data

Get All Vaults

Get Vault Info

Add Dependencies

Fetch and Parse the Vault

Read Vault Configuration

Inspect Per-Reserve Allocations

Get User Vault Position Historical Info

Get Vault Metrics History

Get Advanced Vault Allocation Info

Get Advanced Vault Incentives Info

Vault Revenue Share

Additional Resources