Dividends calendar

Get dividends calendar

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

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

GET

calendar

dividends

Get dividends calendar

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

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

Asking Claude about dividends income using Ainvest MCP server

Authorizations

Authorization

string

header

required

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

Query Parameters

date

string

required

The date for which to get dividends, format YYYY-MM-DD

Response

Successful response in standard envelope

data

object

Show child attributes

data.data

object[]

A list of securities with specified ex-dividend date

Show child attributes

data.data.ticker

string

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

data.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.data.pay_date

string

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

data.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 backtesting Economics

⌘I

Documentation

API Reference

Authorizations

Query Parameters

Response