/events/dividends?symbols={symbols}&start_date={start_date}&end_date={end_date}
https://api.livevol.com/v1/events/dividends?symbols=DAL&start_date=2019-01-01&end_date=2019-06-30
Name | Description | Type | Additional information |
---|---|---|---|
symbols |
Comma-separated list of symbols or special symbol ('all_symbols', 'all_optionable_symbols') |
string |
Required |
start_date |
Start date in YYYY-MM-DD format. Optional. |
string |
Constraint: value should be less than or equal to end_date value Date in yyyy-MM-dd format. (i.e. 2019-01-18) Default value is: 2003-01-01 |
end_date |
End date in YYYY-MM-DD format. Optional. |
string |
Constraint: value should be greater than or equal to start_date value Date in yyyy-MM-dd format. (i.e. 2019-01-18) Default value is: 2100-01-01 |
Collection of Dividend
Name | Description | Type | Additional information |
---|---|---|---|
underlying_symbol |
Symbol of equity or ETF |
string |
None. |
announcement_date |
Date dividend was announced |
string |
Represented as 'YYYY-MM-DD' |
ex_date |
Ex-dividend date |
string |
Represented as 'YYYY-MM-DD' |
record_date |
Date before which holders-of-record will receive the dividend. |
string |
Represented as 'YYYY-MM-DD' |
payment_date |
Payment date |
string |
Represented as 'YYYY-MM-DD' |
amount |
Actual or projected distribution amount |
decimal number |
None. |
dividend_status |
Status of dividend |
DividendStatus |
None. |
frequency |
Frequency of dividend payment. |
Frequency |
None. |
asset_type |
Type of asset |
AssetType |
None. |
data_source |
Source of dividends |
DataSource |
None. |
dividend_code |
Dividend code |
DividendCode |
None. |
currency |
Currency of distribution |
string |
None. |
distribution_details |
Distribution breakdown. For Stocks, dividends are reported, including special dividend payments. For ETFs, dividends, short-term capital gains, long-term capital gains, return of capital, or other distributions are reported. |
Collection of DistributionDetails |
None. |
[ { "underlying_symbol": "AAPL", "announcement_date": "2016-06-30", "ex_date": "2016-06-30", "record_date": "2016-06-30", "payment_date": "2016-07-10", "amount": 0.115, "dividend_status": "confirmed", "frequency": "annual", "asset_type": "stock", "data_source": "projected", "dividend_code": "regular", "currency": "USD", "distribution_details": [ { "amount": 0.115, "distribution_type": "dividend" } ] }, { "underlying_symbol": "IBM", "announcement_date": "2016-09-30", "ex_date": "2016-09-30", "record_date": "2016-09-30", "payment_date": "2016-10-23", "amount": 0.115, "dividend_status": "confirmed", "frequency": "annual", "asset_type": "stock", "data_source": "market_implied", "dividend_code": "regular", "currency": null, "distribution_details": [ { "amount": 0.115, "distribution_type": "dividend" } ] } ]
<dividends xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <dividend> <amount>0.115</amount> <announcement_date>2016-06-30</announcement_date> <asset_type>stock</asset_type> <currency>USD</currency> <data_source>projected</data_source> <distribution_details> <distribution_details> <amount>0.115</amount> <distribution_type>dividend</distribution_type> </distribution_details> </distribution_details> <dividend_code>regular</dividend_code> <dividend_status>confirmed</dividend_status> <ex_date>2016-06-30</ex_date> <frequency>annual</frequency> <payment_date>2016-07-10</payment_date> <record_date>2016-06-30</record_date> <underlying_symbol>AAPL</underlying_symbol> </dividend> <dividend> <amount>0.115</amount> <announcement_date>2016-09-30</announcement_date> <asset_type>stock</asset_type> <currency i:nil="true" /> <data_source>market_implied</data_source> <distribution_details> <distribution_details> <amount>0.115</amount> <distribution_type>dividend</distribution_type> </distribution_details> </distribution_details> <dividend_code>regular</dividend_code> <dividend_status>confirmed</dividend_status> <ex_date>2016-09-30</ex_date> <frequency>annual</frequency> <payment_date>2016-10-23</payment_date> <record_date>2016-09-30</record_date> <underlying_symbol>IBM</underlying_symbol> </dividend> </dividends>