> ## 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 current KVault allocations > Get current reserve allocations, utilization, supply APYs, and market collateral for a Kamino Earn Vault ## OpenAPI ````yaml /kamino-api.json get /kvaults/vaults/{pubkey}/allocations 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/{pubkey}/allocations: get: tags: - Kamino Earn Vaults summary: Get current KVault allocations description: >- Get current reserve allocations, utilization, supply APYs, and market collateral for a Kamino Earn Vault parameters: - schema: $ref: '#/components/schemas/AddressBase58' required: true description: Valid base58-encoded address name: pubkey in: path responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/KvaultAllocationsResponse' '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 KvaultAllocationsResponse: type: object properties: asOf: allOf: - $ref: '#/components/schemas/SnapshotDateTime' - description: Timestamp when the allocation snapshot was computed example: '2025-03-01T12:00:00.000Z' capitalDeployedUsd: allOf: - $ref: '#/components/schemas/Decimal' - description: Total USD value deployed across allocation reserves utilizationRatio: allOf: - $ref: '#/components/schemas/Decimal' - description: >- Borrowed share of total vault assets, including unallocated funds, in decimal format allocations: type: array items: $ref: '#/components/schemas/KvaultAllocation' unallocated: type: object properties: tokenAmount: allOf: - $ref: '#/components/schemas/Decimal' - description: Liquidity token amount not deployed to a reserve usd: allOf: - $ref: '#/components/schemas/Decimal' - description: USD value not deployed to a reserve pct: allOf: - $ref: '#/components/schemas/Decimal' - description: >- Share of vault assets not deployed to a reserve as a percentage required: - tokenAmount - usd - pct required: - asOf - capitalDeployedUsd - utilizationRatio - allocations - unallocated 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 SnapshotDateTime: type: string format: date-time description: Timestamp of the metrics snapshot example: '2023-06-29T15:15:26.464Z' Decimal: type: string description: Decimal value represented as string example: '1234.56789' KvaultAllocation: type: object properties: reserve: allOf: - $ref: '#/components/schemas/AddressBase58' - description: Public key of the allocation reserve market: allOf: - $ref: '#/components/schemas/AddressBase58' - description: Public key of the reserve lending market marketName: type: string description: Name of the reserve lending market tokenMint: allOf: - $ref: '#/components/schemas/AddressBase58' - description: Liquidity token mint of the allocation reserve symbol: type: string description: Allocation token symbol targetWeightPct: allOf: - $ref: '#/components/schemas/Decimal' - description: Configured allocation weight as a percentage actualPct: allOf: - $ref: '#/components/schemas/Decimal' - description: Current share of vault assets in the reserve as a percentage suppliedTokenAmount: allOf: - $ref: '#/components/schemas/Decimal' - description: Liquidity token amount currently supplied to the reserve suppliedUsd: allOf: - $ref: '#/components/schemas/Decimal' - description: USD value currently supplied to the reserve capTokenAmount: allOf: - $ref: '#/components/schemas/Decimal' - description: >- Maximum liquidity token amount that may be allocated to the reserve utilizationRatio: allOf: - $ref: '#/components/schemas/Decimal' - description: Current reserve utilization ratio in decimal format supplyApy: allOf: - $ref: '#/components/schemas/Apy' - description: Current base supply APY in decimal format example: '0.2' rewardsApy: allOf: - $ref: '#/components/schemas/Apy' - type: - string - 'null' description: >- Current reserve rewards APY in decimal format, or null when unavailable example: '0.2' collateral: type: array items: $ref: '#/components/schemas/KvaultAllocationCollateral' description: Other active reserves accepted as collateral in the market required: - reserve - market - marketName - tokenMint - symbol - targetWeightPct - actualPct - suppliedTokenAmount - suppliedUsd - capTokenAmount - utilizationRatio - supplyApy - rewardsApy - collateral Apy: type: string description: Borrow interest APY example: '0.027610992938039702' examples: - '0.123' - '0' - '1' - '1.23' - '-0.5' - '999999.999999' KvaultAllocationCollateral: type: object properties: mint: allOf: - $ref: '#/components/schemas/AddressBase58' - description: Liquidity token mint of the collateral reserve symbol: type: string description: Collateral token symbol totalSupplyUsd: allOf: - $ref: '#/components/schemas/Decimal' - description: Total supplied liquidity in the collateral reserve, in USD liqLtvPct: allOf: - $ref: '#/components/schemas/Decimal' - description: Liquidation loan-to-value threshold as a percentage required: - mint - symbol - totalSupplyUsd - liqLtvPct ````