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.

GET /v1/assets/{symbol}/dividends

Get Dividend Information for an Asset

cURL

curl --request GET \
  --url https://api.gm.ondo.finance/v1/assets/{symbol}/dividends \
  --header 'x-api-key: <api-key>'

200

{
  "ticker": "AAPL",
  "dividendYield": "0.0245",
  "payoutFrequency": "quarterly",
  "lastCashAmount": "1.54",
  "lastPaymentDate": "2025-02-15",
  "timestamp": 1746655938000
}

Authorizations

x-api-key · string · header · required

Path Parameters

symbol · string · required

The GM token symbol

Response

200

application/json

OK

ticker · string · required

The stock ticker associated with the asset.

Example:

"AAPL"

dividendYield · string · required

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 · enum<string> · required

The frequency at which dividends are paid to shareholders.

Available options: monthly, quarterly, semi-annually, annually, irregular, none

Example:

"quarterly"

lastCashAmount · string · required

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 · string<date> · required

The date of last dividend payment in YYYY-MM-DD format.

Example:

"2025-02-15"

timestamp · number · required

The Unix timestamp in milliseconds when the data was last updated.

Example:

1746655938000