> ## 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 user metrics for a single KVault > Get historical timeseries of total usd/sol/interest/apy for a single user Kamino Earn Vault position ## OpenAPI ````yaml /kamino-api.json GET /kvaults/users/{userPubkey}/vaults/{vaultPubkey}/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/users/{userPubkey}/vaults/{vaultPubkey}/metrics/history: get: tags: - Kamino Earn User summary: Get historical user metrics for a single KVault description: >- Get historical timeseries of total usd/sol/interest/apy for a single user Kamino Earn Vault position parameters: - schema: allOf: - $ref: '#/components/schemas/AddressBase58' - description: Valid base58-encoded address of the vault example: HDsayqAsDWy3QvANGqh2yNraqcD8Fnjgh73Mhb3WRS5E required: true description: Valid base58-encoded address of the vault name: vaultPubkey in: path - schema: allOf: - $ref: '#/components/schemas/AddressBase58' - description: Valid base58-encoded address of the user wallet example: AxqtG9SHDkZTLSWg81Sp7VqAzQpRqXtR9ziJ3VQAS8As required: true description: Valid base58-encoded address of the user wallet name: userPubkey 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: $ref: '#/components/schemas/UserKvaultMetrics' '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: AddressBase58: type: string description: Valid base58-encoded address example: VEG1EMtttdHunMbSza8uoms1R18VXmYSph2bBpHcSJd UserKvaultMetrics: type: object properties: createdOn: allOf: - $ref: '#/components/schemas/SnapshotDateTime' - description: Timestamp when the snapshot was created (ISO 8601 format) example: '2025-03-01T12:00:00.000Z' sharesAmount: allOf: - $ref: '#/components/schemas/Decimal' - description: User's total shares amount usdAmount: allOf: - $ref: '#/components/schemas/Decimal' - description: User's USD amount in kvault solAmount: allOf: - $ref: '#/components/schemas/Decimal' - description: User's SOL amount in kvault apy: allOf: - $ref: '#/components/schemas/Apy' - description: >- APY in decimal format (not percentage) represented as string. Multiply by 100 to get percentage (%) - 0.1 in API response is 10%. example: '0.2' cumulativeInterestEarned: allOf: - $ref: '#/components/schemas/Decimal' - description: Total interest earned in kvault token amount for kvault cumulativeInterestEarnedUsd: allOf: - $ref: '#/components/schemas/Decimal' - description: Total interest earned in USD for kvault cumulativeInterestEarnedSol: allOf: - $ref: '#/components/schemas/Decimal' - description: Total interest earned in SOL for kvault interestEarnedPerSecond: allOf: - $ref: '#/components/schemas/Decimal' - description: Interest earned per second at that specific moment in token interestEarnedPerSecondUsd: allOf: - $ref: '#/components/schemas/Decimal' - description: Interest earned per second at that specific moment in USD interestEarnedPerSecondSol: allOf: - $ref: '#/components/schemas/Decimal' - description: Interest earned per second at that specific moment in SOL required: - createdOn - sharesAmount - usdAmount - solAmount - apy - cumulativeInterestEarned - cumulativeInterestEarnedUsd - cumulativeInterestEarnedSol - interestEarnedPerSecond - interestEarnedPerSecondUsd - interestEarnedPerSecondSol 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' Apy: type: string description: Borrow interest APY example: '0.027610992938039702' examples: - '0.123' - '0' - '1' - '1.23' - '-0.5' - '999999.999999' ````