bitpro가 원문에서 글자만 모은 내용이에요. 표·그림·수식은 빠지거나 깨질 수 있어요. 전체 75쪽 중 2쪽
ta**: Only available via API
## Complete Tutorials
- [Deposit and Borrow Tutorial](https://docs.kamino.finance/build/tutorials/borrow/deposit-and-borrow)
- [Repay and Withdraw Tutorial](https://docs.kamino.finance/build/tutorials/borrow/repay-and-withdraw)
````
### references/multiply.md
Kamino Multiply leveraged position operations:
````markdown expandable theme={null}
# Kamino Multiply Operations
Open leveraged positions, monitor health, adjust leverage, and close positions.
## Dependencies
```bash
npm install @solana/kit @kamino-finance/klend-sdk @kamino-finance/kswap-sdk @kamino-finance/scope-sdk decimal.js
```
## SDK Instantiation
```typescript
import { createSolanaRpc, address } from '@solana/kit';
import { KaminoMarket, PROGRAM_ID, getFlashLoanInstructions, getDepositWithLeverageIxs, getRepayWithCollIxs } from '@kamino-finance/klend-sdk';
const rpc = createSolanaRpc('https://api.mainnet-beta.solana.com');
const marketPubkey = address('7u3HeHxYDLhnCoErrtycNokbQYbWGzLs6JSDqGAv5PfF');
const market = await KaminoMarket.load(rpc, marketPubkey, 400, PROGRAM_ID);
```
## SDK Operations
| What to Do | SDK Method | Documentation |
|------------|------------|---------------|
| **Transactions** |
| Open leveraged position | `getDepositWithLeverageIxs({...})` | [Guide](https://docs.kamino.finance/build/developers/multiply/operations/deposit-xstocks) |
| Repay with collateral | `getRepayWithCollIxs({...})` | [Guide](https://docs.kamino.finance/build/developers/multiply/operations/repay-collateral) |
| Flash loan | `getFlashLoanInstructions({...})` | [Guide](https://docs.kamino.finance/build/developers/multiply/flash-loans) |
| **Read Position Data** |
| Get multiply positions | `market.getUserObligationsByTag(ObligationTypeTag.Multiply, userAddress)` | [Guide](https://docs.kamino.finance/build/developers/multiply/data/health-metrics) |
| Get position LTV | `obligation.refreshedStats.loanToValue` | [Guide](https://docs.kamino.finance/build/developers/multiply/data/health-metrics) |
| Get liquidation LTV | `obligation.refreshedStats.liquidationLtv` | [Guide](https://docs.kamino.finance/build/developers/multiply/data/health-metrics) |
| Get net value | `obligation.refreshedStats.netAccountValue` | [Guide](https://docs.kamino.finance/build/developers/multiply/data/health-metrics) |
## Important Notes
- Multiply uses flash loans to open positions atomically in a single transaction
- Leveraged combo operations (`getDepositWithLeverageIxs`, `getRepayWithCollIxs`) are TypeScript SDK only, not available in Rust
- Always monitor LTV to avoid liquidation
- Requires KSwap SDK for swap routing and Scope SDK for oracle price refresh
- Fetch pair LUTs from `cdn.kamino.finance/resources.json` before building transactions
## Complete Guides
- [Flash Loans](https://docs.kamino.finance/build/developers/multiply/flash-loans)
- [Open Position (xStocks)](https://docs.kamino.finance/build/developers/multiply/operations/deposit-xstocks)
- [Repay with Collateral](https://docs.kamino.finance/build/developers/multiply/operations/repay-collateral)
- [Monitor Position Health](https://docs.kamino.finance/build/developers/multiply/data/health-metrics)
````
### references/liquidity.md
Kamino Liquidity strategy operations:
````markdown expandable theme={null}
# Kamino Liquidity Operations
Deposit into automated concentrated liquidity strategies, withdraw shares, and query strategy/user data.
## Dependencies
```bash
npm install @solana/kit @kamino-finance/kliquidity-sdk decimal.js
```
## SDK Instantiation
```typescript
import { createSolanaRpc, address } from '@solana/kit';
import { Kamino } from '@kamino-finance/kliquidity-sdk';
const rpc = createSolanaRpc('https://api.mainnet-beta.solana.com');
const kamino = new Kamino('mainnet-beta', rpc);
```
## SDK Operations
| What to Do | SDK Method | Documentation |
|------------|------------|---------------|
| **Transactions** |
| Single-sided deposit | `kamino.singleSidedDepositTokenB(strategy, amount, signer, slippageBps)` | [Guide](https://docs.kamino.finance/build/developers/liquidity/operations/deposit) |
| Two-sided deposit | `kamino.deposit(strategyWithAddress, amountA, amountB, signer)` | [Guide](https://docs.kamino.finance/build/developers/liquidity/operations/deposit) |
| Withdraw all shares | `kamino.withdrawAllShares(strategyWithAddress, signer)` | [Guide](https://docs.kamino.finance/build/developers/liquidity/operations/withdraw) |
| **Read Strategy Data** |
| Get all strategies | `kamino.getAllStrategiesWithFilters(filters)` | [Guide](https://docs.kamino.finance/build/developers/liquidity/data/strategy) |
| Get share price and balances | `kamino.getStrategyShareData(strategyAddress)` | [Guide](https://docs.kamino.finance/build/developers/liquidity/data/strategy) |
| Get share price only | `kamino.getStrategySharePrice(strategyAddress)` | [Guide](https://docs.kamino.finance/build/developers/liquidity/data/strategy) |
| **Read User Data** |
| Get user positions | `kamino.getUserPositions(walletAddress)` | [Guide](https://docs.kamino.finance/build/developers/liquidity/data/user-position) |
## API Operations
| What to Do | API Endpoint | Documentation |
|------------|--------------|---------------|
| **Read Strategy Data** |
| List all strategies | `GET /strategies?status=LIVE` | [API Ref](https://kamino.com/docs/build/api-reference/liquidity/strategy-data/strategies-list) |
| Get strategy metrics | `GET /strategies/{pubkey}/metrics` | [API Ref](https://kamino.com/docs/build/api-reference/liquidity/strategy-data/strategy-metrics) |
| Historical metrics | `GET /v2/strategies/{pubkey}/history` | [API Ref](https://kamino.com/docs/build/api-reference/liquidity/strategy-data/strategy-metrics-history) |
| Total TVL | `GET /strategies/tvl` | [API Ref](https://kamino.com/docs/build/api-reference/liquidity/strategy-data/strategies-tvl) |
| Fees and rewards | `GET /strategies/fees-and-rewards?period=24h` | [API Ref](https://kamino.com/docs/build/api-reference/liquidity/strategy-data/strategies-fees-and-rewards) |
| **Read User Data** |
| User PnL | `GET /v2/strategies/{pubkey}/shareholders/{wallet}/pnl` | [API Ref](https://kamino.com/docs/build/api-reference/liquidity/user-data/user-pnl) |
| User transactions | `GET /v2/shareholders/{wallet}/transactions` | [API Ref](https://kamino.com/docs/build/api-reference/liquidity/user-data/user-transactions) |
## Important Notes
- Single-sided deposit auto-swaps half the input via the SDK's built-in swap router
- Withdrawals return both Token A and Token B proportionally
- Use `POST /luts/find-minimal` for address lookup table resolution on deposits and withdrawals
- Historical data only available via API
## Complete Guide
- [Deposit Guide](https://docs.kamino.finance/build/developers/liquidity/operations/deposit)
- [Withdraw Guide](https://docs.kamino.finance/build/developers/liquidity/operations/withdraw)
````
### references/rewards.md
Kamino Rewards farm operations:
````markdown expandable theme={null}
# Kamino Rewards Operations
Stake into farms, unstake, harvest rewards, and query farm/user data.
## Dependencies
```bash
npm install @solana/kit @kamino-finance/farms-sdk decimal.js
```
## SDK Instantiation
```typescript
import { createSolanaRpc, address } from '@solana/kit';
import { Farms, FarmState } from '@kamino-finance/farms-sdk';
const rpc = createSolanaRpc('https://api.mainnet-beta.solana.com');
const farms = new Farms(rpc);
```
## SDK Operations
| What to Do | SDK Method | Documentation |
|------------|------------|---------------|
| **Transactions** |
| Stake tokens | `farms.stakeIx(...)` | [Guide](https://docs.kamino.finance/build/developers/rewards/operations/stake) |
| Unstake tokens | `farms.unstakeIx(...)` | [Guide](https://docs.kamino.finance/build/developers/rewards/operations/unstake) |
| Withdraw unstaked | `farms.withdrawUnstakedDepositIx(...)` | [Guide](https://docs.kamino.finance/build/developers/rewards/operations/withdraw-unstaked) |
| Harvest all rewards | `farms.claimForUserForFarmAllRewardsIx(...)` | [Guide](https://docs.kamino.finance/build/developers/rewards/operations/harvest) |
| **Read Farm Data** |
| Get farm state | `FarmState.fetch(rpc, farmAddress)` | [Guide](https://docs.kamino.finance/build/developers/rewards/data/farm-state) |
| Batch-load farms | `farms.getAllFarmStatesByPubkeys(addresses)` | [Guide](https://docs.kamino.finance/build/developers/rewards/data/farm-state) |
| Find farms by mint | `farms.getFarmsForMint(stakeMint)` | [Guide](https://docs.kamino.finance/build/developers/rewards/data/farm-state) |
| Get incentive APY | `farms.getRewardsAPYForStrategy(strategyAddress)` | [Guide](https://docs.kamino.finance/build/developers/rewards/data/farm-state) |
| **Read User Data** |
| Get all user positions | `farms.getAllFarmsForUser(walletAddress, now)` | [Guide](https://docs.kamino.finance/build/developers/rewards/data/user-position) |
| Get pending rewards | `farms.getUserPendingRewards(userState, farmState, now, oraclePrices)` | [Guide](https://docs.kamino.finance/build/developers/rewards/data/user-position) |
| Get lockup status | `farms.getLockupDurationAndExpiry(farm, user, now)` | [Guide](https://docs.kamino.finance/build/developers/rewards/data/user-position) |
## API Operations
| What to Do | API Endpoint | Documentation |
|------------|--------------|---------------|
| Farm transactions | `GET /farms/{farmPubkey}/transactions` | [API Ref](https://kamino.com/docs/build/api-reference/rewards/farm-transactions) |
| Farm management history | `GET /farms/{farmPubkey}/management-history` | [API Ref](https://kamino.com/docs/build/api-reference/rewards/farm-management-history) |
| User farm transactions | `GET /farms/users/{pubkey}/transactions` | [API Ref](https://kamino.com/docs/build/api-reference/rewards/user-transactions) |
| Oracle prices (for reward valuation) | `GET /oracles/prices` | [API Ref](https://kamino.com/docs/build/api-reference/oracle/oracle-prices) |
## Important Notes
- **Delegated farms** (klend reserve farms, kvault farms) have no stake mint; a delegate authority stakes on behalf of users
- **Non-delegated farms** own their stake token; use `getFarmsForMint` to discover them
- Unstaking triggers a **withdrawal cooldown** before tokens can be withdrawn
- Reward valuation requires oracle prices from `GET /oracles/prices?source=scope`
- Farm operations are SDK-only; there are no transaction-building API endpoints for farms
## Complete Guide
- [Farm State Guide](https://docs.kamino.finance/build/developers/rewards/data/farm-state)
- [User Position Guide](https://docs.kamino.finance/build/developers/rewards/data/user-position)
- [Stake Guide](https://docs.kamino.finance/build/developers/rewards/operations/stake)
- [Harvest Guide](https://docs.kamino.finance/build/developers/rewards/operations/harvest)
````
### references/api.md
Kamino REST API endpoints:
```markdown expandable theme={null}
# Kamino API Reference
Quick reference for Kamino Finance REST API.
## Base URL
`https://api.kamino.finance`
No API key required for public endpoints.
## Complete Documentation
- Full API Reference: https://kamino.com/docs/build/api-reference
- OpenAPI Specification: https://api-docs.kamino.finance
## Key Endpoints
**Kamino Earn:**
- `POST /ktx/kvault/deposit` - Deposit to vault
- `POST /ktx/kvault/withdraw` - Withdraw from vault
- `GET /kvaults/vaults` - List all vaults
- `GET /kvaults/users/{walletAddress}/positions` - User positions
**Kamino Borrow:**
- `POST /ktx/klend/deposit` - Deposit collateral
- `POST /ktx/klend/borrow` - Borrow assets
- `POST /ktx/klend/repay` - Repay loan
- `POST /ktx/klend/withdraw` - Withdraw collateral
- `GET /v2/kamino-market` - List all markets
- `GET /kamino-market/{marketPubkey}/users/{userPubkey}/obligations` - User obligations
**Kamino Multiply:**
- Multiply operations are SDK-only (no API transaction endpoints)
- Monitor positions via `GET /kamino-market/{marketPubkey}/users/{userPubkey}/obligations`
**Kamino Liquidity:**
- `GET /strategies?status=LIVE` - List all strategies
- `GET /strategies/{pubkey}/metrics` - Strategy metrics
- `GET /v2/strategies/{pubkey}/history` - Historical metrics
- `GET /strategies/tvl` - Total TVL
- `GET /v2/strategies/{pubkey}/shareholders/{wallet}/pnl` - User PnL
- `GET /v2/shareholders/{wallet}/transactions` - User transactions
**Kamino Rewards (Farms):**
- `GET /farms/{farmPubkey}/transactions` - Farm transactions
- `GET /farms/{farmPubkey}/management-history` - Farm management history
- `GET /farms/users/{pubkey}/transactions` - User farm transactions
**Oracle:**
- `GET /oracles/prices` - Oracle prices with timestamp and staleness
- `GET /prices` - Token USD prices by mint
**KSwap (Token Swaps):**
- `GET /kswap/swap/` - Get best route and transaction for swapping between two tokens
**Utilities:**
- `POST /luts/find-minimal` - Find minimal Address Lookup Tables
## Important Notes
- All transaction endpoints return base64-encoded transactions
- Transactions use Address Lookup Tables and require `decompileTransactionMessageFetchingLookupTables`
- Client must decode, sign with fresh blockhash, and submit transactions
- Farm operations (stake, unstake, harvest) are SDK-only with no API transaction endpoints
```
## Usage Examples
Once installed, your agent can execute commands like:
* "Deposit 100 USDC into the SOL-USDC vault"
* "Check my current lending positions on Kamino"
* "Withdraw 50% of my vault shares"
* "Supply 1000 USDC to the lending market"
* "What's the APY on the SOL-USDC vault?"
* "Deposit into the KMNO/USDC liquidity strategy"
* "What are my pending farm rewards?"
* "Harvest all rewards from my staked positions"
* "Swap 1 SOL to USDC"
* "Get the current SOL price from the oracle"
For detailed code examples, see the Kamino documentation links in the reference files.
# Get airdrop metrics
Source: https://kamino.com/docs/build/airdrop/get-airdrop-metrics
/kamino-api.json get /v2/airdrop/metrics
Fetches aggregated airdrop metrics and metadata for a specific points source.
# Get user airdrop allocations
Source: https://kamino.com/docs/build/airdrop/get-user-airdrop-allocations
/kamino-api.json get /v2/airdrop/users/{pubkey}/allocations
Fetches airdrop allocation data for a specific user and source (Seasons...)
# Get transaction to borrow liquidity from a klend reserve
Source: https://kamino.com/docs/build/api-reference/borrow/actions/borrow/klend-borrow
ktx-api.json POST /ktx/klend/borrow
Borrow liquidity from the specified Kamino Lend market reserve
# Get instructions to borrow liquidity from a klend reserve
Source: https://kamino.com/docs/build/api-reference/borrow/actions/borrow/klend-borrow-instructions
ktx-api.json POST /ktx/klend/borrow-instructions
Instructions to borrow liquidity from the specified Kamino Lend market reserve. Additionally includes lookup tables to use to compress transaction size
# Get transaction to deposit into a klend reserve
Source: https://kamino.com/docs/build/api-reference/borrow/actions/deposit/klend-deposit
ktx-api.json POST /ktx/klend/deposit
Deposit tokens into the specified Kamino Lend market reserve. An optional `memo` is added to the transaction as an SPL memo instruction.
# Get instructions to deposit into a klend reserve
Source: https://kamino.com/docs/build/api-reference/borrow/actions/deposit/klend-deposit-instructions
ktx-api.json POST /ktx/klend/deposit-instructions
Instructions to deposit tokens into the specified Kamino Lend market reserve. Additionally includes lookup tables to use to compress transaction size
# Get transaction to repay debt of a klend reserve
Source: https://kamino.com/docs/build/api-reference/borrow/actions/repay/klend-repay
ktx-api.json POST /ktx/klend/repay
Repay a debt position for the specified Kamino Lend market reserve
# Get instructions to repay debt of a klend reserve
Source: https://kamino.com/docs/build/api-reference/borrow/actions/repay/klend-repay-instructions
ktx-api.json POST /ktx/klend/repay-instructions
Instructions to repay a debt position for the specified Kamino Lend market reserve. Additionally includes lookup tables to use to compress transaction size
# Get transaction to withdraw from a klend reserve
Source: https://kamino.com/docs/build/api-reference/borrow/actions/withdraw/klend-withdraw
ktx-api.json POST /ktx/klend/withdraw
Withdraw tokens from the specified Kamino Lend market reserve
# Get instructions to withdraw from a klend reserve
Source: https://kamino.com/docs/build/api-reference/borrow/actions/withdraw/klend-withdraw-instructions
ktx-api.json POST /ktx/klend/withdraw-instructions
Instructions to withdraw tokens from the specified Kamino Lend market reserve. Additionally includes lookup tables to use to compress transaction size
# Get Kamino Market config
Source: https://kamino.com/docs/build/api-reference/borrow/market-data/market-detail
kamino-api.json GET /v2/kamino-market/{pubkey}
Get configuration for a specific Kamino Lending market by market address. Optionally filter by program ID.
# Get metrics for leverage/multiply vaults
Source: https://kamino.com/docs/build/api-reference/borrow/market-data/market-leverage-metrics
kamino-api.json GET /kamino-market/{pubkey}/leverage/metrics
Get aggregated metrics for all leverage and multiply positions in a Kamino Lending market, including average leverage, total borrowed, total deposited, and number of obligations.
# Get KLend reserve history
Source: https://kamino.com/docs/build/api-reference/borrow/market-data/market-reserve-metrics-history
kamino-api.json GET /kamino-market/{marketPubkey}/reserves/{reservePubkey}/metrics/history
Get historical metrics for a specific reserve in a Kamino Lending market over a specified time range with configurable frequency (hour or day). Without a frequency, ranges shorter than 32 days are hourly and longer ranges are daily. APYs, amounts and capped available liquidity are means of raw snapshots in each UTC bucket. Other metrics retain the last snapshot.
# Get KLend market reserves account data
Source: https://kamino.com/docs/build/api-reference/borrow/market-data/market-reserves-account-data
kamino-api.json GET /kamino-market/reserves/account-data
Fetch reserve account data for given Klend markets. Returns base64-encoded account data for all reserves in the specified markets.
# Get metrics for market reserves
Source: https://kamino.com/docs/build/api-reference/borrow/market-data/market-reserves-metrics
kamino-api.json GET /kamino-market/{pubkey}/reserves/metrics
Get current metrics for all reserves in a Kamino Lending market, including APY, TVL, borrow/supply amounts, and LTV ratios.
# Get all Kamino Markets config
Source: https://kamino.com/docs/build/api-reference/borrow/market-data/markets-list
kamino-api.json GET /v2/kamino-market
Get all Kamino Lending markets configuration for a specific program ID. This is the V2 endpoint that allows filtering by program ID instead of cluster.
# Get KLend reward history
Source: https://kamino.com/docs/build/api-reference/borrow/rewards/rewards-history
kamino-api.json GET /klend/{depositReservePubkey}/{borrowReservePubkey}/rewards/history
Fetches historical KLend reward metrics for a specific deposit and borrow reserve pair
# Get KLend rewards
Source: https://kamino.com/docs/build/api-reference/borrow/rewards/rewards-list
kamino-api.json GET /klend/rewards
Fetches all active KLend reward metrics for a specific points source
# Get information about a loan (obligation)
Source: https://kamino.com/docs/build/api-reference/borrow/user-and-loans-data/loan-detail
kamino-api.json GET /klend/loans/{pubkey}
Fetches information about a loan
# Get KLend obligation history
Source: https://kamino.com/docs/build/api-reference/borrow/user-and-loans-data/obligation-metrics-history
kamino-api.json GET /v2/kamino-market/{marketPubkey}/obligations/{obligationPubkey}/metrics/history
Get historical metrics for a specific obligation in a Ka프로젝트로 돌아가기