> ## 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 token USD price history

> Returns one unrounded spot price in USD per bucket, preferring the most recently observed spot token ID throughout the request and filling its missing buckets from other spot IDs. Timestamps are bucket starts; gaps are possible. Start is inclusive and defaults to full history; end is exclusive and defaults to now.



## OpenAPI

````yaml /kamino-api.json get /v2/prices/{mint}/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:
  /v2/prices/{mint}/history:
    get:
      tags:
        - Prices
      summary: Get token USD price history
      description: >-
        Returns one unrounded spot price in USD per bucket, preferring the most
        recently observed spot token ID throughout the request and filling its
        missing buckets from other spot IDs. Timestamps are bucket starts; gaps
        are possible. Start is inclusive and defaults to full history; end is
        exclusive and defaults to now.
      parameters:
        - schema:
            $ref: '#/components/schemas/AddressBase58'
          required: true
          description: Valid base58-encoded address
          name: mint
          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:
            type: string
            enum:
              - hour
              - day
            description: >-
              Bucket frequency. Defaults to hour for a start-to-end range of at
              most 32 days, otherwise day.
          required: false
          description: >-
            Bucket frequency. Defaults to hour for a start-to-end range of at
            most 32 days, otherwise day.
          name: frequency
          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-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:
                $ref: '#/components/schemas/PriceHistoryV2Response'
        '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
    PriceHistoryV2Response:
      type: object
      properties:
        mint:
          allOf:
            - $ref: '#/components/schemas/AddressBase58'
            - description: Token mint requested by the caller.
        frequency:
          type: string
          enum:
            - hour
            - day
          description: >-
            Bucket frequency. Defaults to hour for a start-to-end range of at
            most 32 days, otherwise day.
        history:
          type: array
          items:
            $ref: '#/components/schemas/PriceHistoryV2Point'
          description: >-
            Spot prices ordered by bucket start, with one price per bucket. Gaps
            are possible.
      required:
        - mint
        - frequency
        - history
    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
    PriceHistoryV2Point:
      type: object
      properties:
        timestamp:
          type: string
          format: date-time
          description: UTC bucket start, not the observation time.
        price:
          allOf:
            - $ref: '#/components/schemas/Decimal'
            - description: Stored spot price in USD, returned without rounding.
      required:
        - timestamp
        - price
    Decimal:
      type: string
      description: Decimal value represented as string
      example: '1234.56789'

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.