> ## 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 KLend Market metrics history

> Get historical metrics (TVL and number of obligations) for a Kamino Lending market over a specified time range.



## OpenAPI

````yaml /kamino-api.json get /kamino-market/{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:
  /kamino-market/{pubkey}/metrics/history:
    get:
      tags:
        - Kamino Lend Markets
      summary: Get KLend Market metrics history
      description: >-
        Get historical metrics (TVL and number of obligations) for a Kamino
        Lending market over a specified time range.
      parameters:
        - schema:
            allOf:
              - $ref: '#/components/schemas/AddressBase58'
              - description: Market public key
                example: 7u3HeHxYDLhnCoErrtycNokbQYbWGzLs6JSDqGAv5PfF
          required: true
          description: Market public key
          name: pubkey
          in: path
        - schema:
            type: string
            enum:
              - mainnet-beta
              - devnet
              - localnet
            default: mainnet-beta
            description: Solana cluster environment
            example: mainnet-beta
          required: false
          description: Solana cluster environment
          name: env
          in: query
        - schema:
            anyOf:
              - type: string
              - type: number
            default: '1970-01-01T00:00:00.000Z'
            description: Date input (ISO 8601 string or epoch in ms)
            examples:
              - '2024-01-01T00:00:00.000Z'
              - 1704067200000
            example: 2020-01-01T00:00Z
          required: false
          description: Date input (ISO 8601 string or epoch in ms)
          name: start
          in: query
        - schema:
            anyOf:
              - type: string
              - type: number
            description: Date input (ISO 8601 string or epoch in ms)
            examples:
              - '2024-01-01T00:00:00.000Z'
              - 1704067200000
            example: 2020-02-01T00:00Z
          required: false
          description: Date input (ISO 8601 string or epoch in ms)
          name: end
          in: query
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/MarketMetricsResponse'
        '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
    MarketMetricsResponse:
      type: object
      properties:
        market:
          allOf:
            - $ref: '#/components/schemas/AddressBase58'
            - description: Market public key
              example: 9pMFoVgsG2cNiUCSBEE69iWFN7c1bz9gu9TtPeXkAMTs
        timestamp:
          $ref: '#/components/schemas/SnapshotDateTime'
        metrics:
          type: object
          properties:
            borrowTVL:
              allOf:
                - $ref: '#/components/schemas/Decimal'
                - description: Total borrowed value in USD
                  example: '1.000099969999999979181237244607594483571'
            depositTVL:
              allOf:
                - $ref: '#/components/schemas/Decimal'
                - description: Total deposited value in USD
                  example: '8.357187000999999979181237244607594483571'
            obligations:
              type: integer
              description: Number of obligations
              example: 38
          required:
            - borrowTVL
            - depositTVL
            - obligations
          description: Market metrics
      required:
        - market
        - timestamp
        - metrics
    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'

````