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",
  "rateType": "variable",
  "fixedTerm": {
    "termSeconds": 2592000,
    "apy": "0.0616"
  },
  "debtMaturityTimestamp": "2026-08-28T00:00:00.000Z",
  "status": "Active",
  "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"
  },
  "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",
      "apy": "0.011",
      "tokensPerSecond": "0.00165"
    }
  ],
  "borrowRewardApys": [
    {
      "rewardToken": "VEG1EMtttdHunMbSza8uoms1R18VXmYSph2bBpHcSJd",
      "apy": "0.011",
      "tokensPerSecond": "0.00165"
    }
  ],
  "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",
  "liquidationMaxDebtCloseFactorPct": 10,
  "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",
  "rateType": "variable",
  "fixedTerm": {
    "termSeconds": 2592000,
    "apy": "0.0616"
  },
  "debtMaturityTimestamp": "2026-08-28T00:00:00.000Z",
  "status": "Active",
  "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"
  },
  "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",
      "apy": "0.011",
      "tokensPerSecond": "0.00165"
    }
  ],
  "borrowRewardApys": [
    {
      "rewardToken": "VEG1EMtttdHunMbSza8uoms1R18VXmYSph2bBpHcSJd",
      "apy": "0.011",
      "tokensPerSecond": "0.00165"
    }
  ],
  "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",
  "liquidationMaxDebtCloseFactorPct": 10,
  "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"

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"

supplyApy

object

required

Show child attributes

borrowApy

object

required

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

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

required

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

Example:

"200000"

borrowLimit

string

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"

liquidationMaxDebtCloseFactorPct

integer

required

Market maximum debt close factor as an integer percentage

Example:

10

limits

object

required

Show child attributes

proofOfReserves

object

required

Show child attributes

API Reference

Earn

Borrow

Liquidity

Oracle

Rewards

Portfolio

Tokens

Swap

Lookup Tables

Full API Reference

Get stats for a reserve

Path Parameters

Query Parameters

Response