# Kamino API
> Live data from Kamino Finance, the largest lending and automated-liquidity protocol on Solana. Kamino's lending market lets users supply and borrow SOL, stablecoins and major SPL tokens, while its automated vaults run concentrated-liquidity strategies on Solana DEXs. The reserves endpoint returns every lending reserve on the main market — supply and borrow APY, total supplied and borrowed (USD), utilization and max LTV. The reserve endpoint returns one asset by symbol. The overview endpoint returns the protocol's aggregate supplied, borrowed and TVL. The vaults endpoint returns the top automated liquidity vaults by TVL with their token pair and APY. Read live from Kamino, nothing stored. This is Kamino's own Solana lending and liquidity-vault layer — distinct from Ethereum lending (Morpho), liquid staking and DEX/price feeds.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/kamino-api/..."
```

## Pricing
- **Free** (Free) — 2,200 calls/Mo, 3 req/s
- **Starter** ($9/Mo) — 60,000 calls/Mo, 15 req/s
- **Pro** ($25/Mo) — 320,000 calls/Mo, 40 req/s
- **Scale** ($58/Mo) — 2,000,000 calls/Mo, 120 req/s

## Endpoints

### Reserve

#### `GET /v1/reserve` — One lending reserve by symbol

**Parameters:**
- `symbol` (query, required, string) — Token symbol Example: `SOL`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/kamino-api/v1/reserve?symbol=SOL"
```

**Response:**
```json
{
    "data": {
        "mint": "So11111111111111111111111111111111111111112",
        "chain": "solana",
        "market": "main",
        "source": "Kamino",
        "symbol": "SOL",
        "borrow_usd": 165193109.02,
        "supply_usd": 179021781.5,
        "max_ltv_pct": 74,
        "available_usd": 13828672.49,
        "borrow_apy_pct": 9.5707,
        "supply_apy_pct": 7.4321,
        "utilization_pct": 92.2754
    },
    "meta": {
        "timestamp": "2026-06-10T22:57:05.730Z",
        "request_id": "d3598f81-1254-432d-905e-f29930e39ec2"
    },
    "status": "ok",
    "message": "Reserve retrieved successfully",
    "success": true
}
```

### Reserves

#### `GET /v1/reserves` — Every lending reserve with APY, TVL, utilization

**Parameters:**
- `limit` (query, optional, string) — Max results (1-200) Example: `100`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/kamino-api/v1/reserves?limit=100"
```

**Response:**
```json
{
    "data": {
        "chain": "solana",
        "count": 55,
        "market": "main",
        "source": "Kamino",
        "reserves": [
            {
                "mint": "So11111111111111111111111111111111111111112",
                "symbol": "SOL",
                "borrow_usd": 165193109.02,
                "supply_usd": 179021781.5,
                "max_ltv_pct": 74,
                "available_usd": 13828672.49,
                "borrow_apy_pct": 9.5707,
                "supply_apy_pct": 7.4321,
                "utilization_pct": 92.2754
            },
            {
                "mint": "Dso1bDeDjCQxTrWHqUUi63oBvV7Mdm6WaobLbQ7gnPQ",
                "symbol": "dSOL",
                "borrow_usd": 61.74,
                "supply_usd": 150442281.16,
                "max_ltv_pct": 45,
                "available_usd": 150442219.43,
                "borrow_apy_pct": 1.2769,
                "supply_apy_pct": 0,
                "utilization_pct": 0
            },
            {
                "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
                "symbol": "USDC",
                "borrow_usd": 91906975.86,
                "supply_usd": 118044596.36,
                "max_ltv_pct": 80,
                "available_usd": 26137620.5,
                "borrow_apy_pct": 5.5216,
                "supply_apy_pct": 3.3818,
                "utilization_pct": 77.8578
            },
            {
                "mint": "J1toso1uCk3RLmjorhTtrVwY9HJ7X8V9yYac6Y7kGCPn",
    
…(truncated, see openapi.json for full schema)
```

### Overview

#### `GET /v1/overview` — Protocol aggregate supplied, borrowed, TVL

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/kamino-api/v1/overview"
```

**Response:**
```json
{
    "data": {
        "chain": "solana",
        "market": "main",
        "source": "Kamino",
        "protocol": "Kamino",
        "reserve_count": 55,
        "utilization_pct": 42.5196,
        "total_borrow_usd": 340510528.73,
        "total_supply_usd": 800832147.82,
        "total_available_usd": 460321619.09
    },
    "meta": {
        "timestamp": "2026-06-10T22:57:06.000Z",
        "request_id": "050b3389-cb63-49b9-aef1-730588e3cea5"
    },
    "status": "ok",
    "message": "Overview retrieved successfully",
    "success": true
}
```

### Vaults

#### `GET /v1/vaults` — Top automated liquidity vaults by TVL

**Parameters:**
- `limit` (query, optional, string) — Max results (1-100) Example: `25`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/kamino-api/v1/vaults?limit=25"
```

**Response:**
```json
{
    "data": {
        "chain": "solana",
        "count": 25,
        "source": "Kamino",
        "vaults": [
            {
                "pair": "USDS-USDC",
                "apy_pct": 0.2663,
                "token_a": "USDS",
                "token_b": "USDC",
                "tvl_usd": 21598753.67,
                "strategy": "819tcubKaRghnpDKnbJhUhyuPFoBMKdTREMoAKBKb7xf",
                "apy_7d_pct": 0.1852,
                "apy_24h_pct": 0.2663
            },
            {
                "pair": "SyrupUSDC-USDC",
                "apy_pct": 0.0688,
                "token_a": "SyrupUSDC",
                "token_b": "USDC",
                "tvl_usd": 20160767.3,
                "strategy": "C7HgBuY7AGjdMUnELGfd7nfHcU4resTaND4WxGDrj5zv",
                "apy_7d_pct": 0.6395,
                "apy_24h_pct": 0.0688
            },
            {
                "pair": "pyUSD-USDC",
                "apy_pct": 0.0837,
                "token_a": "pyUSD",
                "token_b": "USDC",
                "tvl_usd": 19737960.06,
                "strategy": "Hmj82e48X9LNW8LeMLk186iE4UKPoUwWuLwoiqMpUiGm",
                "apy_7d_pct": 0.4004,
                "apy_24h_pct": 0.0837
            },
            {
                "pair": "USDG-USDC",
                "apy_pct": 0.4191,
                "token_a": "USDG",
                "token_b": "USDC",
                "tvl_usd": 17315056.96,
                "strategy": "ByPbo7yGcsfrEXet3ip3DcMKf4hwhUv71b6aAU9umBdu",
                
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Service metadata

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/kamino-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "source": "Kamino API (api.kamino.finance, live)",
        "service": "kamino-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/vaults": "Top automated liquidity vaults by TVL with pair and APY (limit=25).",
            "GET /v1/reserve": "One lending reserve by symbol (symbol=SOL).",
            "GET /v1/overview": "Protocol aggregate supplied, borrowed and available (USD).",
            "GET /v1/reserves": "Every lending reserve — supply/borrow APY, TVL, utilization, max LTV."
        },
        "description": "Live data from Kamino Finance, the largest lending and automated-liquidity protocol on Solana. Kamino's lending market lets users supply and borrow SOL, stablecoins and major SPL tokens, while its automated vaults run concentrated-liquidity strategies on Solana DEXs. The reserves endpoint returns every lending reserve on the main market — supply and borrow APY, total supplied and borrowed (USD), utilization and max LTV; the reserve endpoint returns one asset by symbol; the overview endpoint returns the protocol's aggregate supplied, borrowed and TVL; the vaults endpoint returns the top automated liquidity vaults by TVL with token pair and APY. Live, no key, nothing stored. Distinct from Ethereum lending (Morpho), liquid staking and DEX/price feeds — this is Kamino's own Solana lending and liquidity-vault layer.",
        "reserve_count": 55,
        "upstream_status": "ok"
    },
    "meta": 
…(truncated, see openapi.json for full schema)
```


---
Marketplace page: https://www.oanor.com/api/kamino-api
OpenAPI spec: https://www.oanor.com/api/kamino-api/openapi.json
