v1

latestOpenAPI 3.0.42026-07-262045103.2 KB

Assets

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

Path parameters

symbolstring required

The GM token symbol

Response

tickerstring required

The stock ticker associated with the asset.

dividendYieldstring 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%)

The frequency at which dividends are paid to shareholders.

lastCashAmountstring required

The last dividend payment amount per share, represented as a string-encoded decimal with up to 18 digits after the decimal point.

lastPaymentDatestring date required

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

timestampnumber required

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

Example response

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