---
title: "Cron Dividends Refresh"
method: POST
path: "/cron/dividends-refresh"
tags: ["cron"]
---

# Cron Dividends Refresh

`POST /cron/dividends-refresh`

## Request

- Base URL: `https://api.equity-rank.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.equity-rank.com/cron/dividends-refresh`
- Auth: none declared

Manual trigger for the dividend_history refresh (weekly Sun 05:40 UTC; DIV-01).

AlphaVantage DIVIDENDS + SPLITS for every screener_cache ticker (+ ledger
symbols), split-restated by scripts/backfill_corporate_actions.build_rows,
UPSERT (merge-duplicates) into dividend_history on (symbol,
ex_dividend_date). Flat-rate AV, ~10-15 min for the universe.
`max_symbols` bounds the pull for a smoke test. Auth: X-Cron-Secret.

## Query parameters

- `max_symbols` integer, nullable

## Headers

- `x-cron-secret` string, nullable

## Response `202`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/equity-rank/apis/equity-rank-api.md) · [All operations](https://skmtc.dev/equity-rank/apis/equity-rank-api/llms.txt) · [OpenAPI document](https://skmtc.dev/equity-rank/apis/equity-rank-api/revisions/c2f2463fee33?raw)