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

# Get Dividend Information for an Asset

> This endpoint retrieves the latest dividend information for a specific asset, including dividend yield, payment history, and upcoming payment dates.

**Dividend Yield**

The dividend yield is calculated based on the past year's worth of dividend payments and the current stock price.

**Payout Frequencies**

Below outline the day ranges for each payout frequency:

| Frequency         | Average Days Between Dividends |
|-------------------|:------------------------------:|
| **none**          | N/A                            |
| **monthly**       | 25-35 days                     |
| **quarterly**     | 80-100 days                    |
| **semi-annually** | 160-200 days                   |
| **yearly**        | 345-385 days                   |
| **irregular**     | Outside defined ranges         |

For caching details on this endpoint, please see: [Endpoint Caching](https://docs.ondo.finance/api-reference/endpoint-caching).




## OpenAPI

````yaml /gm-be-api-spec.json get /v1/assets/{symbol}/dividends
openapi: 3.0.4
info:
  title: GM Backend API
  description: An API spec for the Ondo GM Backend API.
  version: 1.0.0
servers:
  - url: https://api.gm.ondo.finance
    description: GM Backend API
security: []
tags:
  - name: Attestations
    description: Get Mint and Redeem Attestations
  - name: Assets
    description: Get Asset Price Information
  - name: Tickers
    description: Get Ticker Information
  - name: Chains
    description: Get On Chain Data
  - name: Limits
    description: Get Trading Limits
  - name: Status
    description: Get Market and Trading Statuses
paths:
  /v1/assets/{symbol}/dividends:
    get:
      tags:
        - Assets
      summary: Get Dividend Information for an Asset
      description: >
        This endpoint retrieves the latest dividend information for a specific
        asset, including dividend yield, payment history, and upcoming payment
        dates.


        **Dividend Yield**


        The dividend yield is calculated based on the past year's worth of
        dividend payments and the current stock price.


        **Payout Frequencies**


        Below outline the day ranges for each payout frequency:


        | Frequency         | Average Days Between Dividends |

        |-------------------|:------------------------------:|

        | **none**          | N/A                            |

        | **monthly**       | 25-35 days                     |

        | **quarterly**     | 80-100 days                    |

        | **semi-annually** | 160-200 days                   |

        | **yearly**        | 345-385 days                   |

        | **irregular**     | Outside defined ranges         |


        For caching details on this endpoint, please see: [Endpoint
        Caching](https://docs.ondo.finance/api-reference/endpoint-caching).
      operationId: getLatestDividend
      parameters:
        - name: symbol
          in: path
          description: The GM token symbol
          example: AAPLon
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DividendInfo'
        '400':
          description: >-
            One of the request parameters is invalid. Please see the returned
            message and documentation for details.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                error:
                  value:
                    code: INVALID_SYMBOL
                    message: >-
                      invalid symbol; must be at least 3 characters long and end
                      with 'on'
                    documentation: https://docs.ondo.finance/api-reference/error-codes
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                error:
                  value:
                    message: missing API key
                    code: MISSING_API_KEY
        '404':
          description: >-
            The provided asset symbol does not exist and cannot be found. Please
            see the returned message and documentation for details.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                error:
                  value:
                    message: >-
                      The provided asset symbol does not exist and cannot be
                      found.
                    code: ASSET_NOT_FOUND
        '500':
          description: >-
            An internal server error occurred. Please see the returned message
            and documentation for details.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                error:
                  value:
                    message: >-
                      An internal server error occurred. Please see the returned
                      message and documentation for details.
                    code: INTERNAL_ERROR
      security:
        - apiKey: []
components:
  schemas:
    DividendInfo:
      type: object
      properties:
        ticker:
          type: string
          description: The stock ticker associated with the asset.
          example: AAPL
        dividendYield:
          type: string
          description: >-
            The dividend yield, represented as a string-encoded decimal with up
            to 18 digits after the decimal point. ("0.05" is the equivalent of
            5%)
          example: '0.0245'
        payoutFrequency:
          type: string
          description: The frequency at which dividends are paid to shareholders.
          enum:
            - monthly
            - quarterly
            - semi-annually
            - annually
            - irregular
            - none
          example: quarterly
        lastCashAmount:
          type: string
          description: >-
            The last dividend payment amount per share, represented as a
            string-encoded decimal with up to 18 digits after the decimal point.
          example: '1.54'
        lastPaymentDate:
          type: string
          format: date
          description: The date of last dividend payment in YYYY-MM-DD format.
          example: '2025-02-15'
        timestamp:
          type: number
          description: The Unix timestamp in milliseconds when the data was last updated.
          example: 1746655938000
      required:
        - ticker
        - dividendYield
        - payoutFrequency
        - lastCashAmount
        - lastPaymentDate
        - timestamp
    ErrorResponse:
      type: object
      properties:
        message:
          type: string
          description: A human-readable message providing more details about the error.
        documentation:
          type: string
          description: A URL to the relevant documentation for this error.
        code:
          type: string
          description: >-
            A reason code identifying the specific type of error. See the Error
            Codes reference for a full list of possible values.
      required:
        - code
        - message
  securitySchemes:
    apiKey:
      type: apiKey
      name: x-api-key
      in: header

````