> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kamino.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get principal token yields

> Get fresh stored APYs for principal tokens with active Kamino reserves. Each value matches reserve stats `underlyingApy.current` for the same stored snapshot. Sources without a value from the last 48 hours are omitted; matured principal tokens with a fresh zero row report 0.



## OpenAPI

````yaml /kamino-api.json get /yields/principal-tokens
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:
  /yields/principal-tokens:
    get:
      tags:
        - Yields
      summary: Get principal token yields
      description: >-
        Get fresh stored APYs for principal tokens with active Kamino reserves.
        Each value matches reserve stats `underlyingApy.current` for the same
        stored snapshot. Sources without a value from the last 48 hours are
        omitted; matured principal tokens with a fresh zero row report 0.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PtYieldsResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    PtYieldsResponse:
      type: array
      items:
        $ref: '#/components/schemas/PtYieldItem'
    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
    PtYieldItem:
      type: object
      properties:
        apy:
          allOf:
            - $ref: '#/components/schemas/Apy'
            - description: >-
                Fresh stored PT APY in decimal units for an active Kamino
                reserve. Matches reserve stats `underlyingApy.current` for the
                same stored snapshot.
        tokenMint:
          allOf:
            - $ref: '#/components/schemas/AddressBase58'
            - description: Valid base58-encoded address of the token mint
              example: So11111111111111111111111111111111111111112
              examples:
                - So11111111111111111111111111111111111111112
                - EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v
                - DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263
      required:
        - apy
        - tokenMint
    Apy:
      type: string
      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'
      examples:
        - '0.123'
        - '0'
        - '1'
        - '1.23'
        - '-0.5'
        - '999999.999999'
    AddressBase58:
      type: string
      description: Valid base58-encoded address
      example: VEG1EMtttdHunMbSza8uoms1R18VXmYSph2bBpHcSJd

````

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