Skip to content

dividend tracker api overview | dividend tracker api documentation


How it Works

You send a list of dividend payments in JSON format to the /monthly-summary endpoint. The endpoint returns the total dividend income, grouped by month and year.

Each dividend payment in the list must include:

  • The ticker symbol e.g., AAPL
  • The payment date (formatted as YYYY-MM-DD) e.g. 2025-06-30 and,
  • The amount received e.g., 2.43
Figure: Example workflow of sending dividend data and receiving the aggregated totals.

Example

Below is an example of a list of dividend payment details (JSON format) that you'll send to the /monthly-summary endpoint.

[
{
"ticker": "AAPL",
"paymentDate": "2025-06-30",
"amount":  2.43
},
{
"ticker": "AMZN",
"paymentDate": "2025-07-01",
"amount":  1.89
},
{
"ticker": "GOOGL",
"paymentDate": "2025-07-15",
"amount":  0.75
}
]

Upon success, you'll receive aggregated data similar to below (JSON format):

{
  "2025-06": 2.43,
  "2025-07": 2.64
}

What comes next?