Kamino Liquidity SDK

Typescript SDK for integrating with Kamino Liquidity (automated CLMM vaults) on Solana. Kamino manages concentrated liquidity positions across Orca Whirlpools, Raydium CLMM, and Meteora DLMM, handling automatic rebalancing, fee compounding, and reward collection.

Quick Start

npm install @kamino-finance/kliquidity-sdk @solana/kit decimal.js

import { Kamino } from '@kamino-finance/kliquidity-sdk';
import { createSolanaRpc } from '@solana/kit';

const rpc = createSolanaRpc('https://api.mainnet-beta.solana.com');
const kamino = new Kamino('mainnet-beta', rpc);

// List all live strategies
const strategies = await kamino.getAllStrategiesWithFilters({ strategyCreationStatus: 'LIVE' });

// Get share price for a strategy
const sharePrice = await kamino.getStrategySharePrice(strategies[0].address);
console.log('Share price:', sharePrice.toString());

Documentation

Document	Description
Overview	Core concepts, installation, and SDK setup
Reading Strategies	List strategies, get metrics, balances, and ranges
Deposits	Both-sided and single-sided deposits
Withdrawals	Partial and full share withdrawals
Positions & PnL	User positions, fees, rewards, strategy holders
REST API Reference	Kamino Public API endpoints
API Response Types	TypeScript interfaces for API responses
SDK Types	SDK type reference
FAQ	Common questions

Examples

See the examples/ directory for runnable code. Setup:

cd examples
yarn install
export RPC_ENDPOINT=YOUR_RPC_URL_HERE

Example	Run	Description
Read strategy	yarn read-strategy	Strategy data, share price, token balances
Read positions	yarn read-positions	User positions and USD values
Strategy APY	yarn strategy-apy	APR/APY, position range, pool price
Strategy holders	yarn strategy-holders	All holders of a strategy
Deposit & stake	yarn deposit-and-stake	Deposit tokens and stake in farm
Unstake & withdraw	yarn unstake-and-withdraw	Unstake from farm and withdraw

Development

Codegen

Copy the new idl from the kamino-liquidity program to src/kamino-client/idl.json:

yarn codegen:kliquidity

Setup localnet

Ensure deps contains the correct .so you want to test against. Either build it from the main repo or dump it from mainnet:

yarn start-validator

Run tests

yarn start-validator-and-test
# Or, if the local validator is already running:
yarn test

Sync with smart contracts

yarn
solana program dump 6LtLpnUFNByNXLyCoK9wA2MykKAmQNZKBdY8s47dehDc -u m deps/kamino.so
yarn codegen