> ## Documentation Index
> Fetch the complete documentation index at: https://kamino.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Depositor & Position Data
> Query depositor positions, P&L, transaction history, and metrics
Access depositor position data, profit & loss tracking, and transaction history via the REST API and TypeScript SDK. Use these endpoints to monitor your vault's depositors and their positions.
## User Positions (All Vaults)
Get all vault positions for a specific wallet address.
```typescript SDK theme={null}
import { createSolanaRpc, address } from '@solana/kit';
import { KaminoManager } from '@kamino-finance/klend-sdk';
const manager = new KaminoManager(
createSolanaRpc('https://api.mainnet-beta.solana.com')
);
const user = address('');
const userSharesAllVaults = await manager.getUserSharesBalanceAllVaults(user);
userSharesAllVaults.forEach((shares, vault) => {
console.log(`User shares in ${vault}:`, shares);
});
```
```typescript API theme={null}
const response = await fetch(
'https://api.kamino.finance/kvaults/users//positions'
);
const positions = await response.json();
console.log('All positions:', positions);
```
```bash curl theme={null}
curl https://api.kamino.finance/kvaults/users//positions
```
## User Vault Position
Get a specific user's position in a specific vault, including share balance and token value.
```typescript SDK theme={null}
import { createSolanaRpc, address } from '@solana/kit';
import { KaminoVault } from '@kamino-finance/klend-sdk';
const vault = new KaminoVault(
createSolanaRpc('https://api.mainnet-beta.solana.com'),
address('')
);
const user = address('');
const shares = await vault.getUserShares(user);
const rate = await vault.getExchangeRate();
console.log({
shares: shares.totalShares.toString(),
tokens: shares.totalShares.mul(rate).toString(),
});
```
```typescript API theme={null}
const response = await fetch(
'https://api.kamino.finance/kvaults/users//positions/'
);
const position = await response.json();
console.log('Vault position:', position);
```
```bash curl theme={null}
curl https://api.kamino.finance/kvaults/users//positions/
```
## User Vault P\&L
Get current profit and loss data for a user's position in a specific vault. Returns P\&L in USD, SOL, and token denominations.
```typescript API theme={null}
const response = await fetch(
'https://api.kamino.finance/kvaults//users//pnl'
);
const pnl = await response.json();
console.log('User P&L:', pnl);
```
```bash curl theme={null}
curl https://api.kamino.finance/kvaults//users//pnl
```
## User Vault P\&L History
Query historical profit and loss data. Returns transaction-level P\&L history with cost basis, realized gains, and position values.
P\&L history is only available via the API.
```typescript API theme={null}
const response = await fetch(
'https://api.kamino.finance/kvaults/users//vaults//pnl/history'
);
const pnlHistory = await response.json();
console.log('P&L history:', pnlHistory);
```
```bash curl theme={null}
curl https://api.kamino.finance/kvaults/users//vaults//pnl/history
```
## User Vault Metrics History
Retrieve historical performance metrics for a specific user and vault. Returns time-series data including shares, APY, and cumulative interest earned.
Metrics history is only available via the API.
```typescript API theme={null}
const response = await fetch(
'https://api.kamino.finance/kvaults/users//vaults//metrics/history'
);
const metricsHistory = await response.json();
console.log('User vault metrics history:', metricsHistory);
```
```bash curl theme={null}
curl https://api.kamino.finance/kvaults/users//vaults//metrics/history
```
## User Total Metrics History
Query cumulative performance metrics for a user across all vaults over a time range. Returns aggregated time-series data.
Total metrics history is only available via the API.
```typescript API theme={null}
const params = new URLSearchParams({
start: '2025-01-01T00:00:00.000Z',
end: '2025-12-31T00:00:00.000Z',
}).toString();
const response = await fetch(
`https://api.kamino.finance/kvaults/users//metrics/history?${params}`
);
const totalMetrics = await response.json();
console.log('Total metrics history:', totalMetrics);
```
```bash curl theme={null}
curl "https://api.kamino.finance/kvaults/users//metrics/history?start=2025-01-01T00:00:00.000Z&end=2025-12-31T00:00:00.000Z"
```
## User Transactions
Query deposit and withdrawal transaction history for a user.
Transaction history is only available via the API.
```typescript API theme={null}
const response = await fetch(
'https://api.kamino.finance/kvaults/users//transactions'
);
const transactions = await response.json();
console.log('User transactions:', transactions);
```
```bash curl theme={null}
curl https://api.kamino.finance/kvaults/users//transactions
```
## Additional Resources