Stock dividends

Get dividends for a specified stock

curl --request GET \
  --url https://openapi.ainvest.com/open/securities/stock/financials/dividends \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "declaration_date": "<string>",
      "ex_date": "<string>",
      "pay_date": "<string>",
      "amount": 123
    }
  ],
  "status_code": 123,
  "status_msg": "<string>"
}

GET

securities

stock

financials

dividends

Get dividends for a specified stock

curl --request GET \
  --url https://openapi.ainvest.com/open/securities/stock/financials/dividends \
  --header 'Authorization: Bearer <token>'

{
  "data": [
    {
      "declaration_date": "<string>",
      "ex_date": "<string>",
      "pay_date": "<string>",
      "amount": 123
    }
  ],
  "status_code": 123,
  "status_msg": "<string>"
}

ETFs are not supported yet

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your key. Get the key here

Query Parameters

ticker

string

required

US stock market ticker symbol, e.g. AAPL, TSLA, etc.

Response

Successful response in standard envelope.

data

object[]

Show child attributes

data.declaration_date

string

Declaration date, format YYYY-MM-DD. It represents the date when the dividend was first announced.

data.ex_date

string

Ex-dividend date, format YYYY-MM-DD. It represents the cutoff point for determining who is eligible to receive a company's dividend payment. For example, if a stock's ex-dividend date is set for March 1, shareholders who purchase the stock on or after that date will not receive the dividend payment.

data.pay_date

string

The date when the dividend is actually distributed to shareholders, format YYYY-MM-DD

data.amount

number

The amount in US dollars that is paid per share as a dividend

status_code

number

Status code, 0 for success

status_msg

string

Status message, success for success

Earnings ETF profile

⌘I

Documentation

API Reference

Authorizations

Query Parameters

Response