Dividends
Dividends
Dividends
Corporate action dividend. A distribution of a company earnings to a specified class of its shareholders and alters the stock price. Includes international symbols. History available since 2003. This endpoint covers over 39,000 U.S. equities, international dividends, mutual funds, ADRs, and ETFs.
Here is what you will get:
- Detailed information on both cash and stock dividends including record, payment, ex, and announce dates
- Gross and net amounts
- Details of all currencies in which a dividend can be paid
- Tax information
- The ability to keep up with the growing number of complex dividend distributions
Start building with this dataset
Get API access in minutes.
Provider
Methods
https://api.blueskyapi.com/v1/data/EDGE/ADVANCED_DIVIDENDShttps://api.blueskyapi.com/v1/data/EDGE/ADVANCED_DIVIDENDS/:symbolhttps://api.blueskyapi.com/v1/data/EDGE/ADVANCED_DIVIDENDS/:symbol/::refid- https://api.blueskyapi.com/v1/data/edge/advanced_dividends?range=last-week
- https://api.blueskyapi.com/v1/data/edge/advanced_dividends/aapl?last=4
- https://api.blueskyapi.com/v1/data/edge/advanced_dividends/AAPL,MSFT,VZ
You can fetch up to 2000 symbols at a time using a comma-separated list.
EX: AAPL,MSFT,TSLA
Time Series Query Parameters
You can use any time series query parameters with this dataset.
View the full documentation →
Response Attributes
| Key | Type | Description |
|---|---|---|
| adrFee | number, null | ADR custody fee amount. |
| amount | number, null | The split-adjusted gross dividend amount; if a gross amount is not available, the split-adjusted net dividend amount is used. |
| announceDate | string, null | Date on which the company announces that it is issuing a dividend in the future. The format is YYYY-MM-DD. |
| countryCode | string, null | Country code for the symbol, using ISO 3166-1 alpha-2 |
| coupon | number, null | Coupon payment or interest rate paid. |
| created | string, null | Date the dividend record was created. The format is YYYY-MM-DD. |
| currency | string, null | ISO currency code for the amount |
| declaredCurrencyCD | string, null | ISO currency code for certificate of deposit. |
| declaredDate | string, null | Date on which the company announces that it is issuing a dividend in the future. The format is YYYY-MM-DD. |
| declaredGrossAmount | number, null | Declared gross amount. |
| description | string, null | Security description |
exDate date | string, null | Date that determines which shareholders are entitled to receive the dividend. Typically, the ex-dividend date is set two business days before the record date. Only those shareholders who owned their shares at least two full business days before the record date are entitled to receive the dividend. The format is YYYY-MM-DD. |
| figi | string, null | OpenFIGI ID for the symbol. |
| fiscalYearEndDate | string, null | Fiscal year end date. The format is YYYY-MM-DD. |
| flag | string, null | Payment type. Supported values: • Autocall• Cash&Stock• Cash• DissenterRights• Interest• Maturity• Rebate• Stock• Special• ToBeAnnounced• Blank |
| frequency | string, null | How often the dividend is paid. Supported Values: • Every 35 Days • Annual • BiMonthly • Daily • Final • Interim • Interest on Maturity • Interest on Trigger • Irregular • Monthly • Quarterly • Semi-Annual • Trimesterly • Unspecified • Weekly • Blank |
| fromFactor | number, null | Number of starting shares. |
| fxDate | string, null | Date used for the FX(Foreign exchange) rate. The format is YYYY-MM-DD. |
| grossAmount | number, null | Dividend return on a stock before any expenses, taxes or deductions are taken into account. |
| installmentPayDate | string, null | Installment payment date. The format is YYYY-MM-DD. |
| isApproximate | boolean, null | Is approximate |
| isCapitalGains | boolean, null | Is capital gains |
| isDAP | boolean, null | Is a Dividend Advantage Portfolio, a unit investment trust. |
| isNetInvestmentIncome | boolean, null | Net investment income (NII) is income received from investment assets (before taxes) such as bonds, stocks, mutual funds, loans, and other investments (less related expenses). The individual tax rate on net investment income depends on whether it is interest income, dividend income, or capital gains. Investopedia |
| lastUpdated | string, null | Date the dividend record was last changed. The format is YYYY-MM-DD. |
| marker | string, null | Supported Values: • Annual • Arrears • Capital Gain • Capital Gain Long Term • Capital Gain Short Term • Final • Installment • Interim • Interest on Capital • Memorial • Regular • Special • Supplementary • Unspecified |
| netAmount | number, null | Net amount is the dividend return after tax. |
| notes | string, null | Long description |
| optionalElectionDate | string, null | Optional election date. The format is YYYY-MM-DD. |
| parValue | number, null | For a stock, par value is the stock value stated in the corporate charter. For a bond, par value is the face value. Par value for a fixed-income instrument security, such as a bond, determines its maturity value and dollar value of coupon payments. |
| parValueCurrency | string, null | ISO currency code for the parValue |
| paymentDate | string, null | Date the eligible shareholders are paid. The format is YYYY-MM-DD. |
| periodEndDate | string, null | Period end date. The format is YYYY-MM-DD. |
| recordDate | string, null | Date the company examines its current list of shareholders to determine who receives dividends. Only shareholders in the company books as of this date are entitled to receive dividends. The format is YYYY-MM-DD. |
refid subkey | string | Unique ID representing the dividend record. |
| registrationDate | string, null | Registration date. The format is YYYY-MM-DD. |
| secondExDate | string, null | Second ex-dividend date (see exDate). The format is YYYY-MM-DD. |
| secondPaymentDate | string, null | Second payment date. The format is YYYY-MM-DD. |
| securityType | string, null | Type of security. Supported Values: • A BLANK value is possible • Barbados Depository Receipts • Bond • Basket Warrant • Convertible Debenture • Share Depository Certificate • Chess Depository Interest • CEDEAR • Convertible Notes • Conversion • Commodity • Certificate • Convertible Unsecured Loan Stock • Currency • Contingent Value Rights • Covered Warrant • Debenture • Derivatives • Depository Receipts • Distribution Rights • Deferred Settlement Trading • Equity Shares • Exchange Traded Commodities • Exchange Traded Fund • Exchange Traded Notes • Fund • Global Depository Notes • Irredeemable Convertible Loan Stock • Index • Interval Fund • Inflation • Interbank Offered Rate • Letter of Allotment • Unit Trust • Non Convertible Debenture • Non-Redeemable Convertible Cumulative Preference S • Notes • Partly Convertible Debenture • Perpetual Exchangeable Repurchaseable Listed Share • Preferred Security • Poison Pill Rights • Preference Share • Parallel Line • Redeemable Convertible Secured Loan Stocks • Redeemable Convertible Secured Notes • Receipt • Redemption Rights • Redeemable Shares • Redeemable Optional Convertible Preference Shares • rights • Redeemable Unconvertible Notes • Structured Product • Subscription Receipts • Second Trading Line • Stapled Security • Swap Rate • Tradeable Rights • Tendered Shares Security • Unit Investment Trust • Units • Warrants • When Distributed • When Issued |
| status | string | Event action status. Supported values: • C : The issuer announced an event but later withdrew or invalidated it• P : The issuer formally cancels previously announced payment details• Q : Payment details Deleted by Issuer• U : Indicates that an existing corporate action record has been modified; The event was already published (Inserted), but one or more details have changed.• I : New corporate action record has been created and addedPayment details Cancelled (P) and Deleted (Q) apply only to the payment details, not the entire event. |
symbol* key | string | Symbol of the security |
| taxRate | number, null | Percent tax rate. For example, 15 represents a 15% tax rate |
| toDate | string, null | To date. The format is YYYY-MM-DD. |
| toFactor | number, null | Number of ending shares. |
| unAdjustedAmount | number, null | Dividend rate. The amount paid before adjustments. |
* required
Attribution
If you are using viaNexus Platform Data in your site or application, you must display “Data provided by viaNexus a product of Blue-Sky Nexus ” (linked to https://viaNexus.com/) somewhere on that site or application. Please see Attribution for details.
