Strategy

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.

StrategyWithAddress
StrategyBalances
PriceData
StrategyPrices
StrategiesFilters

On-chain strategy account paired with its address.

type StrategyWithAddress = {
  address: Address;
  strategy: WhirlpoolStrategy;
};

Raw token amounts and computed position values.

type StrategyBalances = {
  computedHoldings: Holdings;
  prices: PriceData;
  tokenAAmounts: Decimal;
  tokenBAmounts: Decimal;
};

Pool price, range bounds, and rebalance triggers.

type PriceData = {
  aPrice: Decimal | null;
  bPrice: Decimal | null;
  poolPrice: Decimal;
  lowerPrice: Decimal;
  upperPrice: Decimal;
};

Oracle and TWAP prices for strategy tokens and rewards.

type StrategyPrices = { /* ... */ };

Query parameters for filtering strategies by type, status, and ownership.

type StrategiesFilters = { /* ... */ };

Developers

Earn

Borrow

Multiply

Liquidity

Portfolio

Rewards

Oracle

Agentic Finance

Resources

Reading Strategy Data

Get All Strategies

Get Strategies with Filters

Get Strategy Metrics

Get Strategy Info

Get Strategy Historical Metrics

Get Total TVL

Get Strategy Fees and Rewards

Strategy Types

Additional Resources

API Examples

SDK Examples

​Reading Strategy Data

​Get All Strategies

​Get Strategies with Filters

​Get Strategy Metrics

​Get Strategy Info

​Get Strategy Historical Metrics

​Get Total TVL

​Get Strategy Fees and Rewards

​Strategy Types

​Additional Resources

API Examples

SDK Examples

Reading Strategy Data

Get All Strategies

Get Strategies with Filters

Get Strategy Metrics

Get Strategy Info

Get Strategy Historical Metrics

Get Total TVL

Get Strategy Fees and Rewards

Strategy Types

Additional Resources