> ## 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 USD benchmark lending rates

> Returns USD benchmark lending rates aggregated across multiple protocols. Data is sourced from Allez and cached. Supports filtering by date range and downsampling by frequency.



## OpenAPI

````yaml /kamino-api.json get /benchmark-rates/usd
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:
  /benchmark-rates/usd:
    get:
      tags:
        - Other
      summary: Get USD benchmark lending rates
      description: >-
        Returns USD benchmark lending rates aggregated across multiple
        protocols. Data is sourced from Allez and cached. Supports filtering by
        date range and downsampling by frequency.
      parameters:
        - 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
        - schema:
            type: string
            enum:
              - hour
              - day
            default: hour
            description: Data frequency/granularity. Defaults to hour.
            example: hour
          required: false
          description: Data frequency/granularity. Defaults to hour.
          name: frequency
          in: query
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BenchmarkRatesResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    BenchmarkRatesResponse:
      type: array
      items:
        $ref: '#/components/schemas/BenchmarkRate'
    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
    BenchmarkRate:
      type: object
      properties:
        index:
          type: integer
          description: Index of the data point
        hour:
          type: string
          description: Timestamp of the data point
        tracked_supply:
          type: number
          description: Total tracked USD supply
        avg_rate:
          type: number
          description: Average lending rate
        elements:
          type: integer
          description: Number of data elements
        included_protocols:
          type: integer
          description: Number of protocols included
      required:
        - index
        - hour
        - tracked_supply
        - avg_rate
        - elements
        - included_protocols

````