> ## 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 multiple KVaults > Get derived stats for Kamino Earn Vaults computed from the current on-chain state: supply APY breakdown (base gross/net, vault farm incentives, reserve farm incentives), holdings, share price, utilization and the per-reserve allocation breakdown. The response is keyed by vault public key; unknown vaults are omitted. Omit the vaults parameter to include every vault. ## OpenAPI ````yaml /kamino-api.json get /kvaults/vaults/batch/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: /kvaults/vaults/batch/stats: get: tags: - Kamino Earn Vaults summary: Get stats for multiple KVaults description: >- Get derived stats for Kamino Earn Vaults computed from the current on-chain state: supply APY breakdown (base gross/net, vault farm incentives, reserve farm incentives), holdings, share price, utilization and the per-reserve allocation breakdown. The response is keyed by vault public key; unknown vaults are omitted. Omit the vaults parameter to include every vault. parameters: - schema: anyOf: - type: string - type: array items: type: string description: >- KVault public keys, provided as comma-separated or repeated query parameters (max 100). Omit to include every vault. example: VEG1EMtttdHunMbSza8uoms1R18VXmYSph2bBpHcSJd required: false description: >- KVault public keys, provided as comma-separated or repeated query parameters (max 100). Omit to include every vault. name: vaults in: query responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/KvaultBatchStatsResponse' '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 '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/Error' components: schemas: KvaultBatchStatsResponse: type: object additionalProperties: $ref: '#/components/schemas/KvaultStats' description: Vault stats keyed by vault public key. Unknown vaults are omitted. 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 KvaultStats: type: object properties: token: allOf: - $ref: '#/components/schemas/AddressBase58' - description: Vault token mint tokenPrice: allOf: - $ref: '#/components/schemas/Decimal' - description: USD price of the vault token apy: type: object properties: total: allOf: - $ref: '#/components/schemas/Apy' - description: >- Total supply APY: net base APY plus farm and reserve incentives example: '0.2' base: type: object properties: gross: allOf: - $ref: '#/components/schemas/Apy' - description: >- Gross lending APY earned by the current allocations, before vault fees example: '0.2' net: allOf: - $ref: '#/components/schemas/Apy' - description: >- Net lending APY earned by the current allocations, after vault fees example: '0.2' required: - gross - net farmIncentives: allOf: - $ref: '#/components/schemas/Apy' - description: APY from the vault farm incentives example: '0.2' reservesIncentives: allOf: - $ref: '#/components/schemas/Apy' - description: >- APY from the allocation reserve farm incentives, weighted by target allocation example: '0.2' autoCompounding: allOf: - $ref: '#/components/schemas/Apy' - description: APY from the native vault reward stream example: '0.2' required: - total - base - farmIncentives - reservesIncentives - autoCompounding holdings: type: object properties: available: allOf: - $ref: '#/components/schemas/Decimal' - description: Token amount sitting uninvested in the vault availableUsd: allOf: - $ref: '#/components/schemas/Decimal' - description: USD value sitting uninvested in the vault invested: allOf: - $ref: '#/components/schemas/Decimal' - description: Token amount invested in reserves investedUsd: allOf: - $ref: '#/components/schemas/Decimal' - description: USD value invested in reserves totalAumIncludingFees: allOf: - $ref: '#/components/schemas/Decimal' - description: Total token AUM of the vault, including pending fees totalAumIncludingFeesUsd: allOf: - $ref: '#/components/schemas/Decimal' - description: Total USD AUM of the vault, including pending fees pendingFees: allOf: - $ref: '#/components/schemas/Decimal' - description: Pending fees in token amount pendingFeesUsd: allOf: - $ref: '#/components/schemas/Decimal' - description: Pending fees in USD required: - available - availableUsd - invested - investedUsd - totalAumIncludingFees - totalAumIncludingFeesUsd - pendingFees - pendingFeesUsd sharesIssued: allOf: - $ref: '#/components/schemas/Decimal' - description: Total shares issued by the vault tokensPerShare: allOf: - $ref: '#/components/schemas/Decimal' - description: Token amount one share is worth sharePrice: allOf: - $ref: '#/components/schemas/Decimal' - description: USD price of one share utilizationRatio: allOf: - $ref: '#/components/schemas/Decimal' - description: >- Share of the vault total AUM that is borrowed out of the reserves capitalDeployed: allOf: - $ref: '#/components/schemas/Decimal' - description: Token amount deployed into reserves capitalDeployedUsd: allOf: - $ref: '#/components/schemas/Decimal' - description: USD value deployed into reserves allocations: type: array items: type: object properties: reserve: allOf: - $ref: '#/components/schemas/AddressBase58' - description: Reserve public key the vault allocates into market: allOf: - $ref: '#/components/schemas/AddressBase58' - description: Lending market public key of the reserve targetPct: allOf: - $ref: '#/components/schemas/Decimal' - description: >- Target allocation weight of the reserve as a percentage of all target weights actualPct: allOf: - $ref: '#/components/schemas/Decimal' - description: >- Share of the vault total AUM currently supplied to the reserve, in percent suppliedTokenAmount: allOf: - $ref: '#/components/schemas/Decimal' - description: Token amount currently supplied to the reserve suppliedUsd: allOf: - $ref: '#/components/schemas/Decimal' - description: USD value currently supplied to the reserve supplyApy: allOf: - $ref: '#/components/schemas/Apy' - description: Current supply APY of the reserve example: '0.2' required: - reserve - market - targetPct - actualPct - suppliedTokenAmount - suppliedUsd - supplyApy description: Per-reserve allocation breakdown required: - token - tokenPrice - apy - holdings - sharesIssued - tokensPerShare - sharePrice - utilizationRatio - capitalDeployed - capitalDeployedUsd - allocations AddressBase58: type: string description: Valid base58-encoded address example: VEG1EMtttdHunMbSza8uoms1R18VXmYSph2bBpHcSJd Decimal: type: string description: Decimal value represented as string example: '1234.56789' Apy: type: string description: Borrow interest APY example: '0.027610992938039702' examples: - '0.123' - '0' - '1' - '1.23' - '-0.5' - '999999.999999' ````