# Building with LLMs
Source: https://kamino.com/docs/build/agentic-finance/building-with-llms
Leverage Kamino documentation with AI agents and language models for faster development
<Note>
Kamino documentation is optimized for AI-powered development. Our machine-readable resources enable LLMs and AI agents to understand our APIs and build transactions on Solana.
</Note>
## Kamino AI Resources
<div>
<CardGroup>
<Card title="skill.md" icon="brain-circuit" href="https://kamino.com/docs/skill.md">
Structured capability reference with API endpoints, SDK methods, and integration workflows. Start here for agent tool use.
</Card>
<Card title="llms.txt" icon="file-lines" href="https://kamino.com/docs/llms.txt">
Curated index of all documentation pages with one-line descriptions and direct URLs.
</Card>
<Card title="llms-pages.json" icon="brackets-curly" href="https://kamino.com/docs/llms-pages.json">
Machine-readable JSON mapping of every page with title, section, URL, and keywords.
</Card>
</CardGroup>
</div>
### skill.md
The skill.md file provides a comprehensive, machine-readable reference of Kamino's capabilities across all four products: Earn, Borrow, Multiply, and Liquidity.
| Includes | Description |
| - | - |
| API endpoints | Complete REST endpoint reference for all products |
| SDK methods | TypeScript method signatures with real code examples |
| Workflows | Step-by-step operations: deposit, borrow, withdraw, repay, stake, harvest |
| Integration patterns | Earn vaults, Borrow markets, Liquidity strategies, and Farms |
| Use cases | Agent transaction building, API integration, automated DeFi strategies |
### llms.txt
A structured navigation map of Kamino's entire documentation, enabling LLMs to discover relevant pages and resources efficiently.
| Includes | Description |
| - | - |
| Page directory | All documentation pages with direct URLs |
| Tutorials | Organized by category: Earn, Borrow, Liquidity, Rewards, Oracle |
| API reference | Endpoint navigation and documentation links |
| Recipes | Code example locations and implementation guides |
### llms-pages.json
A JSON file mapping every page path to its metadata: title, URL, section, description, and keywords. Useful for programmatic discovery and filtering.
```json theme={null}
{
"/products/lending-vaults": {
"title": "Lending Vaults",
"url": "https://kamino.com/docs/products/lending-vaults",
"section": "Docs",
"description": "Single-token managed yield aggregation across Kamino's lending markets",
"keywords": ["kamino", "lending vaults", "yield", "vault shares", "auto-compounding"]
}
}
```
# Agent Integrations: Using OpenClaw with Kamino
Source: https://kamino.com/docs/build/agentic-finance/openclaw-agent-integration
Build an OpenClaw skill to enable AI agents to autonomously interact with Kamino's lending markets and yield vaults
<Check>
By the end of this tutorial, you will have the following skill files configured for your agent.
</Check>
<div>
| File | Purpose |
| - | - |
| [`SKILL.md`](#skill-md) | Main skill instructions: capabilities, quick reference, and workflows |
| [`references/setup.md`](#references/setup-md) | Environment setup: RPC, wallet keypair, OpenClaw config |
| [`references/earn.md`](#references/earn-md) | Earn vault operations: deposit, withdraw, vault data, user positions |
| [`references/borrow.md`](#references/borrow-md) | Borrow market operations: deposit, borrow, repay, withdraw, market data |
| [`references/multiply.md`](#references/multiply-md) | Multiply operations: leveraged positions, flash loans, position health |
| [`references/liquidity.md`](#references/liquidity-md) | Liquidity strategy operations: deposit, withdraw, strategy metrics, user PnL |
| [`references/rewards.md`](#references/rewards-md) | Farm operations: stake, unstake, harvest, farm state, pending rewards |
| [`references/api.md`](#references/api-md) | Complete REST API endpoint reference for all products |
</div>
## Prerequisites
* Node.js 22+
* Solana wallet with SOL for transaction fees
* RPC endpoint
## Skill Folder Structure
<Steps>
<Step title="Create Skill Directory">
Create a new directory for the Kamino skill in your OpenClaw workspace:
```bash theme={null}
mkdir -p ~/.openclaw/workspace/skills/kamino
cd ~/.openclaw/workspace/skills/kamino
```
</Step>
<Step title="Create File Structure">
Create the following files in the directory:
```
kamino/
├── SKILL.md # Main skill instructions for the agent
└── references/
├── setup.md # Environment and SDK setup
├── earn.md # Kamino Earn operations (vaults)
├── borrow.md # Kamino Borrow operations (lending)
├── multiply.md # Kamino Multiply operations (leverage)
├── liquidity.md # Kamino Liquidity operations (strategies)
├── rewards.md # Kamino Rewards operations (farms)
└── api.md # Kamino API reference
```
```bash theme={null}
mkdir -p references
touch SKILL.md references/setup.md references/earn.md references/borrow.md references/multiply.md references/liquidity.md references/rewards.md references/api.md
```
</Step>
<Step title="Get a Solana RPC Endpoint">
Choose an RPC provider:
* **Free**: `https://api.mainnet-beta.solana.com` (rate limited)
* **Recommended**: Helius, QuickNode, or Triton (paid, production-ready)
</Step>
<Step title="Create or Use Existing Wallet Keypair">
Create a new keypair if needed:
```bash theme={null}
solana-keygen new --outfile ~/solana-wallet.json
```
Or use an existing keypair file.
</Step>
<Step title="Configure OpenClaw">
Add your Solana credentials to `~/.openclaw/openclaw.json`:
```json theme={null}
{
"gateway": {
"env": {
"SOLANA_RPC_URL": "https://api.mainnet-beta.solana.com",
"SOLANA_WS_URL": "wss://api.mainnet-beta.solana.com",
"WALLET_KEYPAIR_PATH": "/path/to/your/solana-wallet.json"
}
}
}
```
Replace `/path/to/your/solana-wallet.json` with the actual path to your keypair file.
</Step>
<Step title="Restart OpenClaw Gateway">
After updating the configuration:
```bash theme={null}
openclaw gateway restart
```
</Step>
<Step title="Verify Setup">
Test your RPC connection:
```bash theme={null}
curl -X POST $SOLANA_RPC_URL \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"getHealth"}'
```
</Step>
</Steps>
### For Other AI Agents
* **Claude**: Copy the SKILL.md content into your conversation or attach as a file
* **Cursor**: Clone into `.cursor/skills/kamino` directory
* **Custom Agents**: Reference the markdown files directly
## File Templates
Copy the following templates into your skill files.
### SKILL.md
The main skill file that teaches agents how to interact with Kamino:
```markdown expandable theme={null}
# Kamino Skill
Interact with Kamino Finance on Solana: Earn vaults, Borrow markets, Liquidity strategies, and Rewards farms.
## Prerequisites
See [setup.md](references/setup.md) for installation and configuration.
Required:
- Solana RPC endpoint
- Wallet keypair for signing transactions
- `@solana/kit` and relevant Kamino SDKs installed
## What You Can Do
**Kamino Earn** - Deposit into yield-generating vaults
**Kamino Borrow** - Supply collateral, borrow assets, repay loans
**Kamino Multiply** - Open and manage leveraged positions
**Kamino Liquidity** - Deposit into automated concentrated liquidity strategies
**Kamino Rewards** - Stake, unstake, and harvest farm rewards
**KSwap** - Swap between any two tokens via Kamino's swap aggregator
**Oracle (Scope)** - Read token prices on-chain or via REST
## Quick Reference
| Operation | Method | Reference |
|-----------|--------|-----------|
| Earn: Deposit | SDK or API | [earn.md](references/earn.md) |
| Earn: Withdraw | SDK or API | [earn.md](references/earn.md) |
| Borrow: Deposit Collateral | API | [borrow.md](references/borrow.md) |
| Borrow: Borrow Assets | API | [borrow.md](references/borrow.md) |
| Borrow: Repay Loan | API | [borrow.md](references/borrow.md) |
| Borrow: Withdraw Collateral | API | [borrow.md](references/borrow.md) |
| Multiply: Open Position | SDK | [multiply.md](references/multiply.md) |
| Multiply: Monitor Health | SDK | [multiply.md](references/multiply.md) |
| Multiply: Close Position | SDK | [multiply.md](references/multiply.md) |
| Liquidity: Deposit | SDK | [liquidity.md](references/liquidity.md) |
| Liquidity: Withdraw | SDK | [liquidity.md](references/liquidity.md) |
| Liquidity: Strategy Data | SDK or API | [liquidity.md](references/liquidity.md) |
| Rewards: Stake | SDK | [rewards.md](references/rewards.md) |
| Rewards: Unstake | SDK | [rewards.md](references/rewards.md) |
| Rewards: Harvest | SDK | [rewards.md](references/rewards.md) |
| KSwap: Swap Tokens | API | [api.md](references/api.md) |
| Oracle: Read Prices | SDK or API | [api.md](references/api.md) |
| Query Market Data | SDK | [borrow.md](references/borrow.md) |
| Get Vault/Market Lists | API | [api.md](references/api.md) |
## Core Workflow
### For Kamino Earn:
1. Choose a vault (get list via API or use known address)
2. Deposit tokens to earn yield
3. Withdraw vault shares when needed
### For Kamino Borrow:
1. Supply collateral to a market
2. Borrow assets against your collateral
3. Monitor health factor (keep LTV below 75%)
4. Repay loans and withdraw collateral
### For Kamino Multiply:
1. Choose a strategy (LST, JLP, stablecoin, or xStocks)
2. Open a leveraged position with target leverage
3. Monitor LTV and liquidation risk
4. Adjust leverage, repay debt, or close position
### For Kamino Liquidity:
1. Choose a strategy (get list via API or use known address)
2. Deposit tokens (single-sided or two-sided)
3. Monitor share price and PnL
4. Withdraw shares when needed
### For Kamino Rewards:
1. Find the farm for your position (by stake mint or known address)
2. Stake share tokens into the farm
3. Monitor pending rewards
4. Harvest rewards or unstake and withdraw
**SOL/BTC Market**: `7u3HeHxYDLhnCoErrtycNokbQYbWGzLs6JSDqGAv5PfF`
## Reference Files
- **[setup.md](references/setup.md)** — Installation and OpenClaw configuration
- **[earn.md](references/earn.md)** — Vault deposit/withdraw code examples
- **[borrow.md](references/borrow.md)** — Lending market operations
- **[multiply.md](references/multiply.md)** — Leveraged position operations
- **[liquidity.md](references/liquidity.md)** — Liquidity strategy operations
- **[rewards.md](references/rewards.md)** — Farm staking and reward harvesting
- **[api.md](references/api.md)** — Complete API endpoint reference
```
### references/setup.md
Setup guide for using Kamino with OpenClaw:
```markdown expandable theme={null}
# Kamino Setup
Configure OpenClaw to interact with Kamino Finance protocols on Solana.
## Prerequisites
Before using this skill, you need:
- OpenClaw installed (Node.js 22+)
- Solana RPC endpoint (get from Helius, QuickNode, or use public endpoint)
- Solana wallet keypair file for signing transactions
For complete developer documentation: https://kamino.com/docs/build
**SOL/BTC Market**: `7u3HeHxYDLhnCoErrtycNokbQYbWGzLs6JSDqGAv5PfF`
```
### references/earn.md
Kamino Earn vault operations:
````markdown expandable theme={null}
# Kamino Earn Operations
Deposit into yield-generating vaults, withdraw shares, and query vault/user data.
## Dependencies
```bash
npm install @solana/kit @kamino-finance/klend-sdk decimal.js
```
## SDK Instantiation
```typescript
import { createSolanaRpc, address } from '@solana/kit';
import { KaminoVault, KaminoManager } from '@kamino-finance/klend-sdk';
const rpc = createSolanaRpc('https://api.mainnet-beta.solana.com');
// Initialize a specific vault
const vault = new KaminoVault(
rpc,
address('VAULT_PUBKEY_HERE')
);
// Or use manager for multi-vault operations
const manager = new KaminoManager(rpc);
```
## SDK Operations
| What to Do | SDK Method | Documentation |
|------------|------------|---------------|
| **Transactions** |
| Deposit to vault | `vault.depositIxs(signer, amount)` | [Recipe](https://docs.kamino.finance/build/recipes/earn/earn-via-sdk) |
| Withdraw from vault | `vault.withdrawIxs(signer, shareAmount)` | [Recipe](https://docs.kamino.finance/build/recipes/earn/earn-withdraw-via-sdk) |
| **Read Vault Data** |
| Get vault holdings | `vault.getVaultHoldings()` | [Data Docs](https://docs.kamino.finance/build/earn/data/vault-data) |
| Get vault APY | `vault.getAPYs()` | [Data Docs](https://docs.kamino.finance/build/earn/data/vault-data) |
| Get exchange rate | `vault.getExchangeRate()` | [Data Docs](https://docs.kamino.finance/build/earn/data/vault-data) |
| Get allocations | `vault.getVaultAllocations()` | [Data Docs](https://docs.kamino.finance/build/earn/data/vault-data) |
| Get vault overview | `manager.getVaultOverview(vault, tokenPrice)` | [Data Docs](https://docs.kamino.finance/build/earn/data/vault-data) |
| **Read User Data** |
| Get user shares | `vault.getUserShares(userAddress)` | [Data Docs](https://docs.kamino.finance/build/earn/data/user-position-data) |
| Get all positions | `manager.getUserSharesBalanceAllVaults(userAddress)` | [Data Docs](https://docs.kamino.finance/build/earn/data/user-position-data) |
## API Operations
| What to Do | API Endpoint | Documentation |
|------------|--------------|---------------|
| **Transactions** |
| Deposit to vault | `POST /ktx/kvault/deposit` | [Recipe](https://docs.kamino.finance/build/recipes/earn/earn-via-api) |
| Withdraw from vault | `POST /ktx/kvault/withdraw` | [Recipe](https://docs.kamino.finance/build/recipes/earn/earn-withdraw-via-api) |
| **Read Vault Data** |
| List all vaults | `GET /kvaults/vaults` | [API Docs](https://api-docs.kamino.finance) |
| Get vault details | `GET /vault/{vaultPubkey}` | [API Docs](https://api-docs.kamino.finance) |
| Get vault metrics | `GET /vault/{vaultPubkey}/metrics` | [API Docs](https://api-docs.kamino.finance) |
| Historical metrics | `GET /vault/{vaultPubkey}/metrics/history` | [API Docs](https://api-docs.kamino.finance) |
| **Read User Data** |
| Get user positions | `GET /kvaults/users/{wallet}/positions` | [API Docs](https://api-docs.kamino.finance) |
| Get vault position | `GET /kvaults/users/{wallet}/vaults/{vaultPubkey}/position` | [API Docs](https://api-docs.kamino.finance) |
| Get position PnL | `GET /kvaults/users/{wallet}/vaults/{vaultPubkey}/pnl` | [API Docs](https://api-docs.kamino.finance) |
| Get transactions | `GET /kvaults/users/{wallet}/transactions` | [API Docs](https://api-docs.kamino.finance) |
## Important Notes
- Withdrawals use **vault share amounts**, not underlying token amounts
- SDK automatically handles farm unstaking if needed
- API transactions use Address Lookup Tables - must use `decompileTransactionMessageFetchingLookupTables`
- Historical data only available via API
## Complete Tutorial
[Earn and Withdraw Tutorial](https://docs.kamino.finance/build/tutorials/earn/earn-and-withdraw)
````
### references/borrow\.md
Kamino Borrow operations (deposit collateral, borrow, repay, withdraw):
````markdown expandable theme={null}
# Kamino Borrow Operations
Supply collateral, borrow assets, repay loans, withdraw collateral, and query market/user data.
**SOL/BTC Market**: `7u3HeHxYDLhnCoErrtycNokbQYbWGzLs6JSDqGAv5PfF`
## Dependencies
```bash
npm install @solana/kit @kamino-finance/klend-sdk decimal.js
```
## SDK Instantiation
```typescript
import { createSolanaRpc, address } from '@solana/kit';
import { KaminoMarket, VanillaObligation, PROGRAM_ID } from '@kamino-finance/klend-sdk';
const rpc = createSolanaRpc('https://api.mainnet-beta.solana.com');
const marketPubkey = address('7u3HeHxYDLhnCoErrtycNokbQYbWGzLs6JSDqGAv5PfF');
// Load market with 400ms slot duration
const market = await KaminoMarket.load(rpc, marketPubkey, 400, PROGRAM_ID);
// Get user's obligation
const userAddress = address('USER_WALLET_ADDRESS');
const obligation = await market.getObligationByWallet(
userAddress,
new VanillaObligation(PROGRAM_ID)
);
```
## SDK Operations
| What to Do | SDK Method | Documentation |
|------------|------------|---------------|
| **Read Market Data** |
| Get total deposit TVL | `market.getTotalDepositTVL()` | [Data Docs](https://docs.kamino.finance/build/borrow/data/market-data) |
| Get total borrow TVL | `market.getTotalBorrowTVL()` | [Data Docs](https://docs.kamino.finance/build/borrow/data/market-data) |
| Get all reserves | `market.getReserves()` | [Data Docs](https://docs.kamino.finance/build/borrow/data/market-data) |
| Get reserve deposit TVL | `reserve.getDepositTvl()` | [Data Docs](https://docs.kamino.finance/build/borrow/data/market-data) |
| Get reserve borrow TVL | `reserve.getBorrowTvl()` | [Data Docs](https://docs.kamino.finance/build/borrow/data/market-data) |
| Get reserve borrow APY | `reserve.totalBorrowAPY(slot)` | [Data Docs](https://docs.kamino.finance/build/borrow/data/market-data) |
| Get reserve supply APY | `reserve.totalSupplyAPY(slot)` | [Data Docs](https://docs.kamino.finance/build/borrow/data/market-data) |
| Get reserve utilization | `reserve.calculateUtilizationRatio()` | [Data Docs](https://docs.kamino.finance/build/borrow/data/market-data) |
| **Read User Data** |
| Get user's obligation | `market.getObligationByWallet(user, obligationType)` | [Data Docs](https://docs.kamino.finance/build/borrow/data/user-position-data) |
| Get all user obligations | `market.getAllUserObligations(user)` | [Data Docs](https://docs.kamino.finance/build/borrow/data/user-position-data) |
| Get LTV ratio | `obligation.loanToValue()` | [Data Docs](https://docs.kamino.finance/build/borrow/data/user-position-data) |
| Get borrow utilization | `obligation.refreshedStats.borrowUtilization` | [Data Docs](https://docs.kamino.finance/build/borrow/data/user-position-data) |
| Get user deposits | `obligation.deposits` | [Data Docs](https://docs.kamino.finance/build/borrow/data/user-position-data) |
| Get user borrows | `obligation.borrows` | [Data Docs](https://docs.kamino.finance/build/borrow/data/user-position-data) |
## API Operations
| What to Do | API Endpoint | Documentation |
|------------|--------------|---------------|
| **Transactions** |
| Deposit collateral | `POST /ktx/klend/deposit` | [Recipe](https://docs.kamino.finance/build/recipes/borrow/deposit-via-api) |
| Borrow assets | `POST /ktx/klend/borrow` | [Recipe](https://docs.kamino.finance/build/recipes/borrow/borrow-via-api) |
| Repay loan | `POST /ktx/klend/repay` | [Recipe](https://docs.kamino.finance/build/recipes/borrow/repay-via-api) |
| Withdraw collateral | `POST /ktx/klend/withdraw` | [Recipe](https://docs.kamino.finance/build/recipes/borrow/withdraw-via-api) |
| **Read Market Data** |
| List all markets | `GET /v2/kamino-market` | [API Docs](https://api-docs.kamino.finance) |
| Get market details | `GET /kamino-market/{marketPubkey}` | [API Docs](https://api-docs.kamino.finance) |
| Historical reserve APY | `GET /kamino-market/{marketPubkey}/reserves/{reservePubkey}/metrics/history` | [API Docs](https://api-docs.kamino.finance) |
| **Read User Data** |
| Get user obligations | `GET /kamino-market/{marketPubkey}/users/{userPubkey}/obligations` | [API Docs](https://api-docs.kamino.finance) |
| Get obligation details | `GET /kamino-market/{marketPubkey}/obligations/{obligationPubkey}` | [API Docs](https://api-docs.kamino.finance) |
| Get obligation PnL | `GET /kamino-market/{marketPubkey}/users/{userPubkey}/obligations/{obligationPubkey}/pnl` | [API Docs](https://api-docs.kamino.finance) |
| Get user rewards | `GET /kamino-market/{marketPubkey}/users/{userPubkey}/rewards` | [API Docs](https://api-docs.kamino.finance) |
## Important Notes
- **Address Lookup Tables**: All API transactions use ALTs, must use `decompileTransactionMessageFetchingLookupTables`
- **Health checks**: Always verify obligation LTV before borrowing or withdrawing collateral
- **Commitment levels**: Use `finalized` for blockhash, `confirmed` for transaction sends
- **Error handling**: Wrap all operations in try-catch blocks
- **Historical da프로젝트로 돌아가기