> ## 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. # Get stats for a reserve > Get current raw and cap-aware reserve liquidity, borrowing caps and counters, base APYs with historical averages, utilization with historical averages, auto-deleveraging settings, and farm reward APY components for one reserve. ## OpenAPI ````yaml /kamino-api.json get /reserves/{reservePubkey}/stats openapi: 3.1.0 info: version: 1.0.0 title: Kamino Public API description: > The Kamino API provides a comprehensive way to interact with Kamino without reading directly from the blockchain. The API also provides the ability to fetch data that might not be available from just reading the chain. The API is rate-limited for unauthenticated users. If you feel you need to make more requests or run into rate-limit issues, please reach out. servers: - url: https://api.kamino.finance security: [] paths: /reserves/{reservePubkey}/stats: get: tags: - Kamino Lend Reserves summary: Get stats for a reserve description: >- Get current raw and cap-aware reserve liquidity, borrowing caps and counters, base APYs with historical averages, utilization with historical averages, auto-deleveraging settings, and farm reward APY components for one reserve. parameters: - schema: allOf: - $ref: '#/components/schemas/AddressBase58' - description: Kamino Lend reserve public key example: FBSyPnxtHKLBZ4UeeUyAnbtFuAmTHLtso9YtsqRDRWpM required: true description: Kamino Lend reserve public key name: reservePubkey in: path - schema: type: string default: KLend2g3cP87fffoy8q1mQqGKjrxjC8boSyAYavgmjD description: KLend program ID example: KLend2g3cP87fffoy8q1mQqGKjrxjC8boSyAYavgmjD required: false description: KLend program ID name: programId in: query responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/ReserveStats' '400': description: Bad Request content: application/json: schema: type: object properties: error: type: string description: High-level error message describing the failure example: Invalid query params details: type: array items: type: object additionalProperties: {} description: >- Detailed validation issues (present only for validation errors) required: - error description: Bad request response (400) example: 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 '404': description: Not Found content: application/json: schema: type: object properties: metadata: type: string description: Error message describing why it was not found example: Account could not be found required: - metadata '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/Error' components: schemas: AddressBase58: type: string description: Valid base58-encoded address example: VEG1EMtttdHunMbSza8uoms1R18VXmYSph2bBpHcSJd ReserveStats: type: object properties: token: allOf: - $ref: '#/components/schemas/AddressBase58' - description: Reserve liquidity token mint address rateType: type: string enum: - variable - fixed - maturity description: Reserve borrow rate type example: variable fixedTerm: type: - object - 'null' properties: termSeconds: type: integer description: Fixed debt term duration in seconds example: 2592000 apy: allOf: - $ref: '#/components/schemas/Apy' - description: Current fixed-rate borrow APY example: '0.0616' required: - termSeconds - apy description: >- Fixed-term borrow details, or null for variable and maturity reserves debtMaturityTimestamp: type: - string - 'null' format: date-time description: >- Debt maturity timestamp, or null when the reserve has no configured maturity example: '2026-08-28T00:00:00.000Z' status: type: string enum: - Active - Obsolete - Hidden description: On-chain reserve visibility status example: Active supplyApy: type: object properties: current: allOf: - $ref: '#/components/schemas/Apy' - description: Current base APY example: '0.0412' avg7d: allOf: - $ref: '#/components/schemas/Apy' - type: - string - 'null' description: >- Average base APY over the last 7 days, or null when no history is available example: '0.0398' avg14d: allOf: - $ref: '#/components/schemas/Apy' - type: - string - 'null' description: >- Average base APY over the last 14 days, or null when no history is available example: '0.0395' avg30d: allOf: - $ref: '#/components/schemas/Apy' - type: - string - 'null' description: >- Average base APY over the last 30 days, or null when no history is available example: '0.039' avg60d: allOf: - $ref: '#/components/schemas/Apy' - type: - string - 'null' description: >- Average base APY over the last 60 days, or null when no history is available example: '0.0387' avg90d: allOf: - $ref: '#/components/schemas/Apy' - type: - string - 'null' description: >- Average base APY over the last 90 days, or null when no history is available example: '0.0384' avg180d: allOf: - $ref: '#/components/schemas/Apy' - type: - string - 'null' description: >- Average base APY over the last 180 days, or null when no history is available example: '0.0381' required: - current - avg7d - avg14d - avg30d - avg60d - avg90d - avg180d borrowApy: type: object properties: current: allOf: - $ref: '#/components/schemas/Apy' - description: Current base APY example: '0.0412' avg7d: allOf: - $ref: '#/components/schemas/Apy' - type: - string - 'null' description: >- Average base APY over the last 7 days, or null when no history is available example: '0.0398' avg14d: allOf: - $ref: '#/components/schemas/Apy' - type: - string - 'null' description: >- Average base APY over the last 14 days, or null when no history is available example: '0.0395' avg30d: allOf: - $ref: '#/components/schemas/Apy' - type: - string - 'null' description: >- Average base APY over the last 30 days, or null when no history is available example: '0.039' avg60d: allOf: - $ref: '#/components/schemas/Apy' - type: - string - 'null' description: >- Average base APY over the last 60 days, or null when no history is available example: '0.0387' avg90d: allOf: - $ref: '#/components/schemas/Apy' - type: - string - 'null' description: >- Average base APY over the last 90 days, or null when no history is available example: '0.0384' avg180d: allOf: - $ref: '#/components/schemas/Apy' - type: - string - 'null' description: >- Average base APY over the last 180 days, or null when no history is available example: '0.0381' required: - current - avg7d - avg14d - avg30d - avg60d - avg90d - avg180d utilization: type: object properties: current: allOf: - $ref: '#/components/schemas/Decimal' - description: >- Current utilization as a ratio of total borrow to total supply example: '0.825' avg30d: allOf: - $ref: '#/components/schemas/Decimal' - type: - string - 'null' description: >- Average utilization over the last 30 days, or null when no history is available example: '0.81' avg90d: allOf: - $ref: '#/components/schemas/Decimal' - type: - string - 'null' description: >- Average utilization over the last 90 days, or null when no history is available example: '0.79' avg180d: allOf: - $ref: '#/components/schemas/Decimal' - type: - string - 'null' description: >- Average utilization over the last 180 days, or null when no history is available example: '0.77' avg365d: allOf: - $ref: '#/components/schemas/Decimal' - type: - string - 'null' description: >- Average utilization over the last 365 days, or null when no history is available example: '0.74' required: - current - avg30d - avg90d - avg180d - avg365d description: Current reserve utilization and historical averages autoDeleverage: type: object properties: reserve: type: object properties: enabled: type: boolean description: >- Whether this reserve is subject to auto-deleveraging after its deposit or borrow limit is crossed. Effective only when the market flag is also enabled. marginCallPeriodSecs: type: integer description: >- Time in seconds that must pass before deleveraging liquidations start after the limit is crossed. Only relevant when auto-deleveraging is enabled. example: 259200 thresholdDecreaseBpsPerDay: type: integer description: >- Rate at which the deleveraging LTV threshold decreases, in bps per day. Only relevant when auto-deleveraging is enabled. example: 100 bonusIncreaseBpsPerDay: type: integer description: >- Rate at which the deleveraging liquidation bonus increases, in bps per day. Only relevant when auto-deleveraging is enabled. example: 50 minBonusBps: type: integer description: Starting bonus for deleveraging liquidations, in bps example: 10 required: - enabled - marginCallPeriodSecs - thresholdDecreaseBpsPerDay - bonusIncreaseBpsPerDay - minBonusBps market: type: object properties: enabled: type: boolean description: >- Market-wide auto-deleveraging gate. Reserve-level auto-deleveraging only applies when this is enabled. individualMarginCallPeriodSecs: type: integer description: >- Time in seconds that must pass before deleveraging liquidations start for obligations individually marked for auto-deleveraging example: 86400 required: - enabled - individualMarginCallPeriodSecs required: - reserve - market description: >- On-chain auto-deleveraging configuration of the reserve and its lending market supplyRewardApys: type: array items: type: object properties: rewardToken: allOf: - $ref: '#/components/schemas/AddressBase58' - description: Reward token mint address apy: allOf: - $ref: '#/components/schemas/Apy' - description: Current reward APY component example: '0.011' tokensPerSecond: allOf: - $ref: '#/components/schemas/Decimal' - description: Reward token emission rate in UI token units per second example: '0.00165' required: - rewardToken - apy - tokensPerSecond description: Current supply-side farm reward APY components borrowRewardApys: type: array items: type: object properties: rewardToken: allOf: - $ref: '#/components/schemas/AddressBase58' - description: Reward token mint address apy: allOf: - $ref: '#/components/schemas/Apy' - description: Current reward APY component example: '0.011' tokensPerSecond: allOf: - $ref: '#/components/schemas/Decimal' - description: Reward token emission rate in UI token units per second example: '0.00165' required: - rewardToken - apy - tokensPerSecond description: Current borrow-side farm reward APY components liquidityAvailable: allOf: - $ref: '#/components/schemas/Decimal' - description: Available reserve liquidity in UI token units liquidityAvailableUsd: allOf: - $ref: '#/components/schemas/Decimal' - description: Available reserve liquidity in USD actualAvailableLiquidity: allOf: - $ref: '#/components/schemas/Decimal' - description: >- 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. actualAvailableLiquidityUsd: allOf: - $ref: '#/components/schemas/Decimal' - description: >- 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. utilizationLimitBlockBorrowingAbovePct: type: integer description: >- Utilization percentage above which new borrowing is blocked. A value of 0 disables the limit. example: 95 borrowCaps: type: object properties: utilization: type: object properties: limitPct: type: integer description: >- Utilization percentage above which new borrowing is blocked. A value of 0 disables the limit. example: 95 currentPct: allOf: - $ref: '#/components/schemas/Decimal' - description: Current reserve utilization as a percentage example: '82.5' required: - limitPct - currentPct netWithdrawal: type: - object - 'null' properties: capacity: $ref: '#/components/schemas/Decimal' currentTotal: allOf: - $ref: '#/components/schemas/Decimal' - description: >- Amount used in the current interval in UI token units. Read as 0 once the interval has elapsed. intervalLengthSeconds: type: integer lastIntervalStartTimestamp: type: string format: date-time required: - capacity - currentTotal - intervalLengthSeconds - lastIntervalStartTimestamp description: >- Net withdrawal cap for reserve debt, or null when the cap is not configured globalDebt: type: object properties: capacity: allOf: - $ref: '#/components/schemas/Decimal' - type: - string - 'null' description: Configured cap in UI token units, or null when uncapped currentTotal: allOf: - $ref: '#/components/schemas/Decimal' - description: >- Amount currently counted against the cap in UI token units required: - capacity - currentTotal description: Global reserve debt cap and current total borrow debtOutsideElevationGroup: type: object properties: capacity: allOf: - $ref: '#/components/schemas/Decimal' - type: - string - 'null' description: Configured cap in UI token units, or null when uncapped currentTotal: allOf: - $ref: '#/components/schemas/Decimal' - description: >- Amount currently counted against the cap in UI token units required: - capacity - currentTotal description: Debt cap and current debt outside elevation groups debtAgainstCollateral: type: array items: type: object properties: capacity: allOf: - $ref: '#/components/schemas/Decimal' - type: - string - 'null' description: >- Configured cap in UI token units, or null when uncapped currentTotal: allOf: - $ref: '#/components/schemas/Decimal' - description: >- Amount currently counted against the cap in UI token units collateralReserve: allOf: - $ref: '#/components/schemas/AddressBase58' - description: >- Collateral reserve whose elevation-group debt cap is represented elevationGroup: type: integer exclusiveMinimum: 0 required: - capacity - currentTotal - collateralReserve - elevationGroup required: - utilization - netWithdrawal - globalDebt - debtOutsideElevationGroup - debtAgainstCollateral description: >- Configured reserve borrowing caps and their current on-chain counters totalSupply: allOf: - $ref: '#/components/schemas/Decimal' - description: Total reserve supply in UI token units totalSupplyUsd: allOf: - $ref: '#/components/schemas/Decimal' - description: Total reserve supply in USD totalBorrow: allOf: - $ref: '#/components/schemas/Decimal' - description: Total reserve borrow in UI token units totalBorrowUsd: allOf: - $ref: '#/components/schemas/Decimal' - description: Total reserve borrow in USD liqLTV: allOf: - $ref: '#/components/schemas/Decimal' - description: Liquidation loan-to-value ratio example: '0.8' maxLTV: allOf: - $ref: '#/components/schemas/Decimal' - description: Maximum loan-to-value ratio example: '0.75' borrowFactor: allOf: - $ref: '#/components/schemas/Decimal' - description: Borrow factor as a ratio example: '1' depositLimit: allOf: - $ref: '#/components/schemas/Decimal' - type: - string - 'null' description: Reserve deposit limit in UI token units, or null when uncapped example: '200000' borrowLimit: allOf: - $ref: '#/components/schemas/Decimal' - type: - string - 'null' description: Reserve borrow limit in UI token units, or null when uncapped example: '150000' minLiquidationBonus: allOf: - $ref: '#/components/schemas/Decimal' - description: Minimum liquidation bonus as a ratio example: '0.02' liquidationMaxDebtCloseFactorPct: type: integer description: Market maximum debt close factor as an integer percentage example: 10 limits: type: object properties: depositWithdrawalCap: type: - object - 'null' properties: capacity: $ref: '#/components/schemas/Decimal' currentTotal: allOf: - $ref: '#/components/schemas/Decimal' - description: >- Amount used in the current interval in UI token units. Read as 0 once the interval has elapsed. intervalLengthSeconds: type: integer lastIntervalStartTimestamp: type: string format: date-time required: - capacity - currentTotal - intervalLengthSeconds - lastIntervalStartTimestamp description: Deposit withdrawal cap, or null when the cap is not configured debtWithdrawalCap: type: - object - 'null' properties: capacity: $ref: '#/components/schemas/Decimal' currentTotal: allOf: - $ref: '#/components/schemas/Decimal' - description: >- Amount used in the current interval in UI token units. Read as 0 once the interval has elapsed. intervalLengthSeconds: type: integer lastIntervalStartTimestamp: type: string format: date-time required: - capacity - currentTotal - intervalLengthSeconds - lastIntervalStartTimestamp description: Debt withdrawal cap, or null when the cap is not configured required: - depositWithdrawalCap - debtWithdrawalCap proofOfReserves: type: object properties: verified: type: boolean address: $ref: '#/components/schemas/AddressBase58' required: - verified - address required: - token - rateType - fixedTerm - debtMaturityTimestamp - status - supplyApy - borrowApy - utilization - autoDeleverage - supplyRewardApys - borrowRewardApys - liquidityAvailable - liquidityAvailableUsd - actualAvailableLiquidity - actualAvailableLiquidityUsd - utilizationLimitBlockBorrowingAbovePct - borrowCaps - totalSupply - totalSupplyUsd - totalBorrow - totalBorrowUsd - liqLTV - maxLTV - borrowFactor - depositLimit - borrowLimit - minLiquidationBonus - liquidationMaxDebtCloseFactorPct - limits - proofOfReserves Error: type: object properties: error: type: string description: Error message for internal server failure example: An internal error occurred required: - error description: Internal server error response (500) example: error: An internal error occurred Apy: type: string description: Borrow interest APY example: '0.027610992938039702' examples: - '0.123' - '0' - '1' - '1.23' - '-0.5' - '999999.999999' Decimal: type: string description: Decimal value represented as string example: '1234.56789' ````