Get stats for a reserve

curl --request GET \
  --url https://api.kamino.finance/reserves/{reservePubkey}/stats

const options = {method: 'GET'};

fetch('https://api.kamino.finance/reserves/{reservePubkey}/stats', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "token": "VEG1EMtttdHunMbSza8uoms1R18VXmYSph2bBpHcSJd",
  "collateralMintAddress": "VEG1EMtttdHunMbSza8uoms1R18VXmYSph2bBpHcSJd",
  "rateType": "variable",
  "fixedTerm": {
    "termSeconds": 2592000,
    "apy": "0.0616"
  },
  "debtMaturityTimestamp": "2026-08-28T00:00:00.000Z",
  "status": "Active",
  "interestRateBasis": "trueApr",
  "hostFixedInterestRateBps": 50,
  "protocolTakeRatePct": 10,
  "supplyApy": {
    "current": "0.0412",
    "avg7d": "0.0398",
    "avg14d": "0.0395",
    "avg30d": "0.039",
    "avg60d": "0.0387",
    "avg90d": "0.0384",
    "avg180d": "0.0381"
  },
  "borrowApy": {
    "current": "0.0412",
    "avg7d": "0.0398",
    "avg14d": "0.0395",
    "avg30d": "0.039",
    "avg60d": "0.0387",
    "avg90d": "0.0384",
    "avg180d": "0.0381"
  },
  "underlyingApy": {
    "current": "0.2",
    "sourceType": "lst",
    "sourceMint": "VEG1EMtttdHunMbSza8uoms1R18VXmYSph2bBpHcSJd",
    "observedAt": "2023-11-07T05:31:56Z"
  },
  "underlyingYieldExpected": true,
  "supplyApyBreakdown": {
    "lending": "0.123",
    "incentives": "0.123",
    "seasonRewards": "0.123",
    "underlying": "0.123",
    "total": "0.123"
  },
  "borrowApyBreakdown": {
    "borrow": "0.123",
    "incentives": "0.123",
    "seasonRewards": "0.123",
    "total": "0.2"
  },
  "utilization": {
    "current": "0.825",
    "avg30d": "0.81",
    "avg90d": "0.79",
    "avg180d": "0.77",
    "avg365d": "0.74"
  },
  "autoDeleverage": {
    "reserve": {
      "enabled": true,
      "marginCallPeriodSecs": 259200,
      "thresholdDecreaseBpsPerDay": 100,
      "bonusIncreaseBpsPerDay": 50,
      "minBonusBps": 10
    },
    "market": {
      "enabled": true,
      "individualMarginCallPeriodSecs": 86400
    }
  },
  "supplyRewardApys": [
    {
      "rewardToken": "VEG1EMtttdHunMbSza8uoms1R18VXmYSph2bBpHcSJd",
      "farm": "VEG1EMtttdHunMbSza8uoms1R18VXmYSph2bBpHcSJd",
      "apy": "0.011",
      "tokensPerSecond": "0.00165"
    }
  ],
  "borrowRewardApys": [
    {
      "rewardToken": "VEG1EMtttdHunMbSza8uoms1R18VXmYSph2bBpHcSJd",
      "farm": "VEG1EMtttdHunMbSza8uoms1R18VXmYSph2bBpHcSJd",
      "apy": "0.011",
      "tokensPerSecond": "0.00165"
    }
  ],
  "pairIncentives": [
    {
      "side": "supply",
      "collateralReserve": "VEG1EMtttdHunMbSza8uoms1R18VXmYSph2bBpHcSJd",
      "collateralToken": "VEG1EMtttdHunMbSza8uoms1R18VXmYSph2bBpHcSJd",
      "debtReserve": "VEG1EMtttdHunMbSza8uoms1R18VXmYSph2bBpHcSJd",
      "debtToken": "VEG1EMtttdHunMbSza8uoms1R18VXmYSph2bBpHcSJd",
      "farm": "VEG1EMtttdHunMbSza8uoms1R18VXmYSph2bBpHcSJd",
      "rewardToken": "VEG1EMtttdHunMbSza8uoms1R18VXmYSph2bBpHcSJd",
      "apy": "0.123",
      "tokensPerSecond": "1234.56789",
      "stakedUsd": "1234.56789",
      "readMoreUrl": "<string>"
    }
  ],
  "pointsPrograms": [
    {
      "side": "supply",
      "key": "<string>",
      "name": "<string>",
      "description": "<string>",
      "iconUrl": "<string>",
      "learnMoreUrl": "<string>"
    }
  ],
  "liquidityAvailable": "1234.56789",
  "liquidityAvailableUsd": "1234.56789",
  "actualAvailableLiquidity": "1234.56789",
  "actualAvailableLiquidityUsd": "1234.56789",
  "utilizationLimitBlockBorrowingAbovePct": 95,
  "borrowCaps": {
    "utilization": {
      "limitPct": 95,
      "currentPct": "82.5"
    },
    "netWithdrawal": {
      "capacity": "1234.56789",
      "currentTotal": "1234.56789",
      "intervalLengthSeconds": 123,
      "lastIntervalStartTimestamp": "2023-11-07T05:31:56Z"
    },
    "globalDebt": {
      "capacity": "1234.56789",
      "currentTotal": "1234.56789"
    },
    "debtOutsideElevationGroup": {
      "capacity": "1234.56789",
      "currentTotal": "1234.56789"
    },
    "debtAgainstCollateral": [
      {
        "capacity": "1234.56789",
        "currentTotal": "1234.56789",
        "collateralReserve": "VEG1EMtttdHunMbSza8uoms1R18VXmYSph2bBpHcSJd",
        "elevationGroup": 123
      }
    ]
  },
  "totalSupply": "1234.56789",
  "totalSupplyUsd": "1234.56789",
  "totalBorrow": "1234.56789",
  "totalBorrowUsd": "1234.56789",
  "liqLTV": "0.8",
  "maxLTV": "0.75",
  "borrowFactor": "1",
  "depositLimit": "200000",
  "borrowLimit": "150000",
  "minLiquidationBonus": "0.02",
  "maxLiquidationBonus": "0.1",
  "liquidationMaxDebtCloseFactorPct": 10,
  "insolvencyRiskUnhealthyLtvPct": 95,
  "limits": {
    "depositWithdrawalCap": {
      "capacity": "1234.56789",
      "currentTotal": "1234.56789",
      "intervalLengthSeconds": 123,
      "lastIntervalStartTimestamp": "2023-11-07T05:31:56Z"
    },
    "debtWithdrawalCap": {
      "capacity": "1234.56789",
      "currentTotal": "1234.56789",
      "intervalLengthSeconds": 123,
      "lastIntervalStartTimestamp": "2023-11-07T05:31:56Z"
    }
  },
  "proofOfReserves": {
    "verified": true,
    "address": "VEG1EMtttdHunMbSza8uoms1R18VXmYSph2bBpHcSJd"
  }
}

{
  "error": "Invalid query request",
  "details": [
    {
      "code": "invalid_union",
      "errors": [
        [
          {
            "code": "custom",
            "path": [],
            "message": "Invalid date string"
          }
        ],
        [
          {
            "expected": "number",
            "code": "invalid_type",
            "path": [],
            "message": "Invalid input: expected number, received string"
          }
        ]
      ],
      "path": [
        "start"
      ],
      "message": "Invalid input"
    }
  ]
}

{
  "metadata": "Account could not be found"
}

{
  "error": "An internal error occurred"
}

GET

reserves

{reservePubkey}

stats

Get stats for a reserve

curl --request GET \
  --url https://api.kamino.finance/reserves/{reservePubkey}/stats

const options = {method: 'GET'};

fetch('https://api.kamino.finance/reserves/{reservePubkey}/stats', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "token": "VEG1EMtttdHunMbSza8uoms1R18VXmYSph2bBpHcSJd",
  "collateralMintAddress": "VEG1EMtttdHunMbSza8uoms1R18VXmYSph2bBpHcSJd",
  "rateType": "variable",
  "fixedTerm": {
    "termSeconds": 2592000,
    "apy": "0.0616"
  },
  "debtMaturityTimestamp": "2026-08-28T00:00:00.000Z",
  "status": "Active",
  "interestRateBasis": "trueApr",
  "hostFixedInterestRateBps": 50,
  "protocolTakeRatePct": 10,
  "supplyApy": {
    "current": "0.0412",
    "avg7d": "0.0398",
    "avg14d": "0.0395",
    "avg30d": "0.039",
    "avg60d": "0.0387",
    "avg90d": "0.0384",
    "avg180d": "0.0381"
  },
  "borrowApy": {
    "current": "0.0412",
    "avg7d": "0.0398",
    "avg14d": "0.0395",
    "avg30d": "0.039",
    "avg60d": "0.0387",
    "avg90d": "0.0384",
    "avg180d": "0.0381"
  },
  "underlyingApy": {
    "current": "0.2",
    "sourceType": "lst",
    "sourceMint": "VEG1EMtttdHunMbSza8uoms1R18VXmYSph2bBpHcSJd",
    "observedAt": "2023-11-07T05:31:56Z"
  },
  "underlyingYieldExpected": true,
  "supplyApyBreakdown": {
    "lending": "0.123",
    "incentives": "0.123",
    "seasonRewards": "0.123",
    "underlying": "0.123",
    "total": "0.123"
  },
  "borrowApyBreakdown": {
    "borrow": "0.123",
    "incentives": "0.123",
    "seasonRewards": "0.123",
    "total": "0.2"
  },
  "utilization": {
    "current": "0.825",
    "avg30d": "0.81",
    "avg90d": "0.79",
    "avg180d": "0.77",
    "avg365d": "0.74"
  },
  "autoDeleverage": {
    "reserve": {
      "enabled": true,
      "marginCallPeriodSecs": 259200,
      "thresholdDecreaseBpsPerDay": 100,
      "bonusIncreaseBpsPerDay": 50,
      "minBonusBps": 10
    },
    "market": {
      "enabled": true,
      "individualMarginCallPeriodSecs": 86400
    }
  },
  "supplyRewardApys": [
    {
      "rewardToken": "VEG1EMtttdHunMbSza8uoms1R18VXmYSph2bBpHcSJd",
      "farm": "VEG1EMtttdHunMbSza8uoms1R18VXmYSph2bBpHcSJd",
      "apy": "0.011",
      "tokensPerSecond": "0.00165"
    }
  ],
  "borrowRewardApys": [
    {
      "rewardToken": "VEG1EMtttdHunMbSza8uoms1R18VXmYSph2bBpHcSJd",
      "farm": "VEG1EMtttdHunMbSza8uoms1R18VXmYSph2bBpHcSJd",
      "apy": "0.011",
      "tokensPerSecond": "0.00165"
    }
  ],
  "pairIncentives": [
    {
      "side": "supply",
      "collateralReserve": "VEG1EMtttdHunMbSza8uoms1R18VXmYSph2bBpHcSJd",
      "collateralToken": "VEG1EMtttdHunMbSza8uoms1R18VXmYSph2bBpHcSJd",
      "debtReserve": "VEG1EMtttdHunMbSza8uoms1R18VXmYSph2bBpHcSJd",
      "debtToken": "VEG1EMtttdHunMbSza8uoms1R18VXmYSph2bBpHcSJd",
      "farm": "VEG1EMtttdHunMbSza8uoms1R18VXmYSph2bBpHcSJd",
      "rewardToken": "VEG1EMtttdHunMbSza8uoms1R18VXmYSph2bBpHcSJd",
      "apy": "0.123",
      "tokensPerSecond": "1234.56789",
      "stakedUsd": "1234.56789",
      "readMoreUrl": "<string>"
    }
  ],
  "pointsPrograms": [
    {
      "side": "supply",
      "key": "<string>",
      "name": "<string>",
      "description": "<string>",
      "iconUrl": "<string>",
      "learnMoreUrl": "<string>"
    }
  ],
  "liquidityAvailable": "1234.56789",
  "liquidityAvailableUsd": "1234.56789",
  "actualAvailableLiquidity": "1234.56789",
  "actualAvailableLiquidityUsd": "1234.56789",
  "utilizationLimitBlockBorrowingAbovePct": 95,
  "borrowCaps": {
    "utilization": {
      "limitPct": 95,
      "currentPct": "82.5"
    },
    "netWithdrawal": {
      "capacity": "1234.56789",
      "currentTotal": "1234.56789",
      "intervalLengthSeconds": 123,
      "lastIntervalStartTimestamp": "2023-11-07T05:31:56Z"
    },
    "globalDebt": {
      "capacity": "1234.56789",
      "currentTotal": "1234.56789"
    },
    "debtOutsideElevationGroup": {
      "capacity": "1234.56789",
      "currentTotal": "1234.56789"
    },
    "debtAgainstCollateral": [
      {
        "capacity": "1234.56789",
        "currentTotal": "1234.56789",
        "collateralReserve": "VEG1EMtttdHunMbSza8uoms1R18VXmYSph2bBpHcSJd",
        "elevationGroup": 123
      }
    ]
  },
  "totalSupply": "1234.56789",
  "totalSupplyUsd": "1234.56789",
  "totalBorrow": "1234.56789",
  "totalBorrowUsd": "1234.56789",
  "liqLTV": "0.8",
  "maxLTV": "0.75",
  "borrowFactor": "1",
  "depositLimit": "200000",
  "borrowLimit": "150000",
  "minLiquidationBonus": "0.02",
  "maxLiquidationBonus": "0.1",
  "liquidationMaxDebtCloseFactorPct": 10,
  "insolvencyRiskUnhealthyLtvPct": 95,
  "limits": {
    "depositWithdrawalCap": {
      "capacity": "1234.56789",
      "currentTotal": "1234.56789",
      "intervalLengthSeconds": 123,
      "lastIntervalStartTimestamp": "2023-11-07T05:31:56Z"
    },
    "debtWithdrawalCap": {
      "capacity": "1234.56789",
      "currentTotal": "1234.56789",
      "intervalLengthSeconds": 123,
      "lastIntervalStartTimestamp": "2023-11-07T05:31:56Z"
    }
  },
  "proofOfReserves": {
    "verified": true,
    "address": "VEG1EMtttdHunMbSza8uoms1R18VXmYSph2bBpHcSJd"
  }
}

{
  "error": "Invalid query request",
  "details": [
    {
      "code": "invalid_union",
      "errors": [
        [
          {
            "code": "custom",
            "path": [],
            "message": "Invalid date string"
          }
        ],
        [
          {
            "expected": "number",
            "code": "invalid_type",
            "path": [],
            "message": "Invalid input: expected number, received string"
          }
        ]
      ],
      "path": [
        "start"
      ],
      "message": "Invalid input"
    }
  ]
}

{
  "metadata": "Account could not be found"
}

{
  "error": "An internal error occurred"
}

Path Parameters

reservePubkey

string

required

Kamino Lend reserve public key

Example:

"FBSyPnxtHKLBZ4UeeUyAnbtFuAmTHLtso9YtsqRDRWpM"

Query Parameters

programId

string

default:KLend2g3cP87fffoy8q1mQqGKjrxjC8boSyAYavgmjD

KLend program ID

Example:

"KLend2g3cP87fffoy8q1mQqGKjrxjC8boSyAYavgmjD"

Response

token

string

required

Reserve liquidity token mint address

Example:

"VEG1EMtttdHunMbSza8uoms1R18VXmYSph2bBpHcSJd"

collateralMintAddress

string

required

Reserve collateral token mint address

Example:

"VEG1EMtttdHunMbSza8uoms1R18VXmYSph2bBpHcSJd"

rateType

enum<string>

required

Reserve borrow rate type

Available options:

variable,

fixed,

maturity

Example:

"variable"

fixedTerm

object | null

required

Fixed-term borrow details, or null for variable and maturity reserves

Show child attributes

debtMaturityTimestamp

string<date-time> | null

required

Debt maturity timestamp, or null when the reserve has no configured maturity

Example:

"2026-08-28T00:00:00.000Z"

status

enum<string>

required

On-chain reserve visibility status

Available options:

Active,

Obsolete,

Hidden

Example:

"Active"

interestRateBasis

enum<string>

required

How the reserve interprets its rate config (borrow rate curve, hostFixedInterestRateBps, reward emissions). legacy: nominal slot-year rates accrued per slot over 63,072,000 slots, so the realized annual rate is the configured rate times 500 / recentSlotDurationInMs (see /slots/duration). trueApr: wall-clock rates accrued per second over 31,536,000 seconds, no slot adjustment. To plot the curve from /reserves/{reservePubkey}/charts borrowCurve: factor = basis === trueApr ? 1 : 500 / recentSlotDurationInMs; borrowApr(u) = (curveRate(u) + hostFixedInterestRateBps / 10000) * factor; supplyApr(u) = u * curveRate(u) * factor * (1 - protocolTakeRatePct / 100). Static per reserve config; reserves in one market can differ.

Available options:

legacy,

trueApr

Example:

"trueApr"

hostFixedInterestRateBps

integer

required

Fixed host interest added on top of the curve or fixed borrow rate, in basis points of the nominal annual rate in the reserve interestRateBasis. Paid entirely to the host: included in borrow APR, excluded from supply APR. 0 when not configured.

Example:

50

protocolTakeRatePct

integer

required

Share of borrow interest taken by the protocol as an integer percentage from the reserve config. Depositors keep (100 - protocolTakeRatePct) / 100 of the curve interest; this is the raw config value, not the depositor keep-ratio.

Example:

10

supplyApy

object

required

Show child attributes

borrowApy

object

required

Show child attributes

underlyingApy

object | null

required

Native yield of the reserve liquidity token itself: LST staking yield, principal-token implied yield, or the yield of an RWA / yield-bearing token. Excludes lending interest, farm incentives, season rewards and pair-specific rewards. Null when the token is not yield-bearing or no fresh source is available; a missing source is never reported as 0. Already included in supplyApyBreakdown.total.

Show child attributes

underlyingYieldExpected

boolean

required

True when the reserve token earns its own yield (staking, pool or yield-feed token). underlyingApy null with true means the yield source is unavailable; null with false means the token has no underlying yield.

Example:

true

supplyApyBreakdown

object

required

Components of the supply APY shown in the Kamino UI for an anonymous viewer, all in decimal APY units. total = lending + incentives + seasonRewards + underlying. underlying is 0 when underlyingApy is null.

Show child attributes

borrowApyBreakdown

object

required

Components of the borrow APY shown in the Kamino UI for an anonymous viewer, decimal units. total = borrow - incentives - seasonRewards.

Show child attributes

utilization

object

required

Current reserve utilization and historical averages

Show child attributes

autoDeleverage

object

required

On-chain auto-deleveraging configuration of the reserve and its lending market

Show child attributes

supplyRewardApys

object[]

required

Current supply-side farm reward APY components

Show child attributes

borrowRewardApys

object[]

required

Current borrow-side farm reward APY components

Show child attributes

pairIncentives

object[]

required

Live pair-specific incentives whose eligibility depends on the counterparty asset. Rows are present only while the configured farm is active, funded, emitting and staked. These APYs are not included in supplyApyBreakdown.total or borrowApyBreakdown.total. Derive collateral "Up to" APY as max(apy) over supply rows and estimated net borrow APY as borrowApy.current - apy.

Show child attributes

pointsPrograms

object[]

required

Partner points programs for this reserve and side. These programs have no numeric APY and are not included in supplyApyBreakdown.total or borrowApyBreakdown.total.

Show child attributes

liquidityAvailable

string

required

Available reserve liquidity in UI token units

Example:

"1234.56789"

liquidityAvailableUsd

string

required

Available reserve liquidity in USD

Example:

"1234.56789"

actualAvailableLiquidity

string

required

Maximum cap-aware reserve liquidity available for borrowing across cross mode and configured elevation groups, in UI token units. This does not include obligation-specific collateral or LTV constraints.

Example:

"1234.56789"

actualAvailableLiquidityUsd

string

required

Maximum cap-aware reserve liquidity available for borrowing across cross mode and configured elevation groups, in USD. This does not include obligation-specific collateral or LTV constraints.

Example:

"1234.56789"

utilizationLimitBlockBorrowingAbovePct

integer

required

Utilization percentage above which new borrowing is blocked. A value of 0 disables the limit.

Example:

95

borrowCaps

object

required

Configured reserve borrowing caps and their current on-chain counters

Show child attributes

totalSupply

string

required

Total reserve supply in UI token units

Example:

"1234.56789"

totalSupplyUsd

string

required

Total reserve supply in USD

Example:

"1234.56789"

totalBorrow

string

required

Total reserve borrow in UI token units

Example:

"1234.56789"

totalBorrowUsd

string

required

Total reserve borrow in USD

Example:

"1234.56789"

liqLTV

string

required

Liquidation loan-to-value ratio

Example:

"0.8"

maxLTV

string

required

Maximum loan-to-value ratio

Example:

"0.75"

borrowFactor

string

required

Borrow factor as a ratio

Example:

"1"

depositLimit

string | null

required

Reserve deposit limit in UI token units, or null when uncapped

Example:

"200000"

borrowLimit

string | null

required

Reserve borrow limit in UI token units, or null when uncapped

Example:

"150000"

minLiquidationBonus

string

required

Minimum liquidation bonus as a ratio

Example:

"0.02"

maxLiquidationBonus

string

required

Maximum liquidation bonus as a ratio

Example:

"0.1"

liquidationMaxDebtCloseFactorPct

integer

required

Market maximum debt close factor as an integer percentage

Example:

10

insolvencyRiskUnhealthyLtvPct

integer

required

Market LTV threshold as an integer percentage; obligations above it can be fully liquidated instead of being capped by the debt close factor

Example:

95

limits

object

required

Show child attributes

proofOfReserves

object

required

Show child attributes

API Reference

Distributor Codes

Earn

Borrow

Liquidity

Oracle

Rewards

Portfolio

Tokens

Swap

Lookup Tables

Full API Reference

Get stats for a reserve

Path Parameters

Query Parameters

Response