> ## 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 historical KVault metrics > Get historical Kamino Earn Vault metrics for a given vault, between an optional range of dates ## OpenAPI ````yaml /kamino-api.json GET /kvaults/vaults/{pubkey}/metrics/history 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}/metrics/history: get: tags: - Kamino Earn Vaults summary: Get historical KVault metrics description: >- Get historical Kamino Earn Vault metrics for a given vault, between an optional range of dates parameters: - schema: allOf: - $ref: '#/components/schemas/AddressBase58' - description: Valid base58-encoded address example: VEG1EMtttdHunMbSza8uoms1R18VXmYSph2bBpHcSJd required: true description: Valid base58-encoded address name: pubkey in: path - schema: anyOf: - type: string - type: number default: '1970-01-01T00:00:00.000Z' description: >- Start date of the range (defaults to Unix epoch). Accepts ISO string or epoch in ms. examples: - '1970-01-01T00:00:00.000Z' - 0 required: false description: >- Start date of the range (defaults to Unix epoch). Accepts ISO string or epoch in ms. name: start in: query - schema: anyOf: - type: string - type: number description: >- End date of the range (defaults to current time). Accepts ISO string or epoch in ms. examples: - '2025-01-01T00:00:00.000Z' - 1735689600000 required: false description: >- End date of the range (defaults to current time). Accepts ISO string or epoch in ms. name: end in: query responses: '200': description: OK content: application/json: schema: type: array items: type: object properties: timestamp: type: number description: Unix timestamp in milliseconds tvl: allOf: - $ref: '#/components/schemas/Decimal' - description: Total Value Locked in token denomination example: '1234.56789' solTvl: allOf: - $ref: '#/components/schemas/Decimal' - description: Total Value Locked in SOL example: '1234.56789' apy: allOf: - $ref: '#/components/schemas/Apy' - description: Annual Percentage Yield example: '0.2' apyTheoretical: allOf: - $ref: '#/components/schemas/Apy' - description: Theoretical Annual Percentage Yield example: '0.2' apyActual: allOf: - $ref: '#/components/schemas/Apy' - description: Actual Annual Percentage Yield example: '0.2' apyFarmRewards: allOf: - $ref: '#/components/schemas/Apy' - description: Annual Percentage Yield from Farm Rewards example: '0.2' apyReservesIncentives: allOf: - $ref: '#/components/schemas/Apy' - description: Annual Percentage Yield from Reserves Incentives example: '0.2' apyIncentives: allOf: - $ref: '#/components/schemas/Apy' - description: Annual Percentage Yield from Incentives example: '0.2' sharePrice: allOf: - $ref: '#/components/schemas/Decimal' - description: Share Price of the vault example: '1234.56789' interest: allOf: - $ref: '#/components/schemas/Decimal' - description: Interest earned in token denomination example: '1234.56789' interestUsd: allOf: - $ref: '#/components/schemas/Decimal' - description: Interest earned in USD example: '1234.56789' interestSol: allOf: - $ref: '#/components/schemas/Decimal' - description: Interest earned in SOL example: '1234.56789' reserves: type: array items: type: object properties: pubkey: allOf: - $ref: '#/components/schemas/AddressBase58' - description: Public key of the reserve example: VEG1EMtttdHunMbSza8uoms1R18VXmYSph2bBpHcSJd supplyApy: allOf: - $ref: '#/components/schemas/Apy' - description: Supply Annual Percentage Yield example: '0.2' rewardsApy: allOf: - $ref: '#/components/schemas/Apy' - description: Rewards Annual Percentage Yield example: '0.2' allocationRatio: allOf: - $ref: '#/components/schemas/Decimal' - description: Allocation Ratio example: '1234.56789' rewardTokens: type: array items: type: object properties: tokenMint: allOf: - $ref: '#/components/schemas/AddressBase58' - description: Token mint address example: >- VEG1EMtttdHunMbSza8uoms1R18VXmYSph2bBpHcSJd apy: allOf: - $ref: '#/components/schemas/Apy' - description: >- Annual Percentage Yield for the reward token example: '0.2' required: - tokenMint - apy description: List of reward tokens for the reserve required: - pubkey - supplyApy - rewardsApy - allocationRatio - rewardTokens description: List of reserves with rewards vaultRewards: type: array items: type: object properties: tokenMint: allOf: - $ref: '#/components/schemas/AddressBase58' - description: Token mint address example: VEG1EMtttdHunMbSza8uoms1R18VXmYSph2bBpHcSJd apy: allOf: - $ref: '#/components/schemas/Apy' - description: >- Annual Percentage Yield for the vault reward token example: '0.2' required: - tokenMint - apy description: List of vault reward tokens required: - timestamp - tvl - solTvl - apy - apyTheoretical - apyActual - apyFarmRewards - apyReservesIncentives - apyIncentives - sharePrice - interest - interestUsd - interestSol - reserves - vaultRewards '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 properties: {} 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: AddressBase58: type: string description: Market public key example: 9pMFoVgsG2cNiUCSBEE69iWFN7c1bz9gu9TtPeXkAMTs Decimal: type: string description: Total borrowed value in USD example: '1.000099969999999979181237244607594483571' examples: - '0.123' - '0' - '1' - '1.23' - '-42.0' - '999999.999999' Apy: type: string description: Borrow interest APY example: '0.027610992938039702' examples: - '0.123' - '0' - '1' - '1.23' - '-0.5' - '999999.999999' 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 ````