---
title: "Cron Av Prefetch"
method: POST
path: "/cron/av-prefetch"
tags: ["cron"]
---

# Cron Av Prefetch

`POST /cron/av-prefetch`

## 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/av-prefetch`
- Auth: none declared

Manual trigger for the overnight AV cache prefetch (daily 03:30 UTC;
also the watchdog's staleness re-trigger target).

Warms the full-universe AV fundamentals set (overview, statement histories,
earnings family, estimates) into the 24h financials_cache so the screener
batch and daytime valuations hit cache instead of live AV — and (Phase 89)
persists statement_history + multiple_history per ticker. Flat-rate — the
calls cost $0. `max_tickers` limits scope for smoke tests (e.g. ?max_tickers=25).
Duplicate-safe: a run started while another is in flight (or while the
screener batch runs) returns a skip shape that _run_tracked logs as
cron_runs status='skipped'. Auth: X-Cron-Secret.

## Query parameters

- `max_tickers` 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)