Skip to main content

​
Reading Strategy Data

Retrieve strategy metadata, share price, TVL, APY, and aggregate metrics using the Kamino SDK and API.
Historical strategy data is only available via the API. For the TypeScript shapes used by the methods below — both arguments and return values — see Strategy Types.

​
Get All Strategies

Fetches all live strategies from the API. Returns an array of strategy objects with addresses and pool metadata.
getAllStrategies
const url = 'https://api.kamino.finance/strategies?env=mainnet-beta&status=LIVE';
const res = await fetch(url);
if (!res.ok) {
  throw new Error(`Request failed: ${res.status} ${res.statusText}`);
}
const strategies = await res.json();

console.log({
  address: strategies[0].address,
  pool: strategies[0].pool,
  tokenA: strategies[0].tokenA,
  tokenB: strategies[0].tokenB,
});
View Code

​
Get Strategies with Filters

Filter strategies by type, status, community, or owner using the SDK. These filtering options aren’t exposed by the public API.
getStrategiesWithFilters
import { createSolanaRpc } from '@solana/kit';
import { Kamino, StrategiesFilters } from '@kamino-finance/kliquidity-sdk';

const RPC_ENDPOINT = 'https://api.mainnet-beta.solana.com';

const rpc = createSolanaRpc(RPC_ENDPOINT);
const kamino = new Kamino('mainnet-beta', rpc);

const filters: StrategiesFilters = {
  strategyCreationStatus: 'LIVE',
  strategyType: 'NON_PEGGED',
};

const results = await kamino.getAllStrategiesWithFilters(filters);

console.log(`Filters:`, filters);
console.log(`Matched strategies: ${results.length}`);
console.log('First 10:');
for (const { address, strategy } of results.slice(0, 10)) {
  console.log({
    address: address.toString(),
    tokenAMint: strategy.tokenAMint.toString(),
    tokenBMint: strategy.tokenBMint.toString(),
    sharesMint: strategy.sharesMint.toString(),
  });
}
View Code

​
Get Strategy Metrics

Returns real-time strategy metrics including share price, TVL, and APY for a specific strategy.
getStrategyMetrics
const strategyPubkey = '2H4xebnp2M9JYgPPfUw58uUQahWF8f1YTNxwwtmdqVYV'; // strategy address

const url = `https://api.kamino.finance/strategies/${strategyPubkey}/metrics?env=mainnet-beta`;
const res = await fetch(url);
if (!res.ok) {
  throw new Error(`Request failed: ${res.status} ${res.statusText}`);
}
const metrics = await res.json();

console.log({
  sharePrice: metrics.sharePrice,
  totalValueLocked: metrics.totalValueLocked,
  apy: metrics.apy,
});
View Code

​
Get Strategy Info

Live on-chain read of a strategy’s share price and underlying balances.
getStrategyInfo
import { createSolanaRpc, address } from '@solana/kit';
import { Kamino } from '@kamino-finance/kliquidity-sdk';

const RPC_ENDPOINT = 'https://api.mainnet-beta.solana.com';
const STRATEGY = address('CEz5keL9hBCUbtVbmcwenthRMwmZLupxJ6YtYAgzp4ex'); // strategy address

const rpc = createSolanaRpc(RPC_ENDPOINT);
const kamino = new Kamino('mainnet-beta', rpc);

const shareData = await kamino.getStrategyShareData(STRATEGY);
const { price, balance } = shareData;
const { computedHoldings, tokenAAmounts, tokenBAmounts, prices } = balance;

console.log('Strategy:', STRATEGY);
console.log('Share price (USD):', price.toString());
console.log('Total holdings (USD):', computedHoldings.totalSum.toString());
console.log('Available token A:', computedHoldings.available.a.toString());
console.log('Available token B:', computedHoldings.available.b.toString());
console.log('Invested token A:', computedHoldings.invested.a.toString());
console.log('Invested token B:', computedHoldings.invested.b.toString());
console.log('Raw token A amount:', tokenAAmounts.toString());
console.log('Raw token B amount:', tokenBAmounts.toString());
console.log('Token A price (USD):', prices.aPrice?.toString() ?? 'n/a');
console.log('Token B price (USD):', prices.bPrice?.toString() ?? 'n/a');
View Code

​
Get Strategy Historical Metrics

Time-series data for charting strategy share price, TVL, fees, and APY.
getStrategyHistoricalMetrics
const strategyPubkey = '2H4xebnp2M9JYgPPfUw58uUQahWF8f1YTNxwwtmdqVYV'; // strategy 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}/v2/strategies/${strategyPubkey}/history?${params}`;
const res = await fetch(url);
if (!res.ok) {
  throw new Error(`Request failed: ${res.status} ${res.statusText}`);
}
const history = await res.json();

for (const item of history) {
  console.log({
    timestamp: item.timestamp,
    sharePrice: item.sharePrice,
    tvl: item.tvl,
    apy: item.apy,
  });
}
View Code

​
Get Total TVL

Returns aggregate total value locked across all live strategies.
getTotalTvl
const url = 'https://api.kamino.finance/strategies/tvl?env=mainnet-beta';
const res = await fetch(url);
if (!res.ok) {
  throw new Error(`Request failed: ${res.status} ${res.statusText}`);
}
const data = await res.json();

console.log({ totalTvl: data });
View Code

​
Get Strategy Fees and Rewards

Returns fees and rewards earned across all strategies over a chosen time period (24h, 7d, or 30d).
getStrategyFeesAndRewards
const url = 'https://api.kamino.finance/strategies/fees-and-rewards?env=mainnet-beta&period=24h';
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

​
Strategy Types

TypeScript shapes used by the Kliquidity SDK for strategy reads — both arguments (e.g. StrategiesFilters) and return values.
On-chain strategy account paired with its address.
type StrategyWithAddress = {
  address: Address;
  strategy: WhirlpoolStrategy;
};

​
Additional Resources

API Examples

SDK Examples