Freshness & sourcing

The 24-hour store, cold loads, where every figure comes from, how the series are computed and the dated history.Updated October 25, 2026

The 24-hour store

Each ISIN is stored with the time it was generated. A request within 24 hours of that time returns the stored payload (cached: true) in a few hundred milliseconds. Once it is older than 24 hours, the next request is still answered from the store at once, flagged stale: true, and the refresh runs in the background: ask again a minute later for the new payload. Nothing older than 7 days is served without a new read, and ?refresh=true reads before answering (at most hourly per ISIN); a fund never loaded before is read live (cached: false). Concurrent requests for the same cold ISIN trigger a single load; the others wait for it. Funds in the pre-warmed universe are refreshed on a schedule, so most popular ETFs are always warm.

Set a long HTTP timeout
A cold load typically takes 15–90 seconds and can take up to 300. Use --max-time 300 or the equivalent in your client, or send ISINs through POST /funds so they are warmed for you.

Where the figures come from

Every payload is built from documents published by the fund's own management company for that share class: the product page, the monthly factsheet, the PRIIPs KID and, where the issuer publishes them, the full holdings file and the NAV history. Documents are read as published; nothing is estimated except where the field description says so. data.dataAsOf carries the as-of date printed in the document; show it next to any figure.

When a total-return history is available, cumulativePerformance, calendarReturns and annualisedReturns are computed from it (monthly observations) so they are consistent across issuers; a distributing class’s price NAV is only used once its distributions are reinvested. Volatility, Sharpe ratio and maximum drawdown are the fund house’s own figures when it publishes them, otherwise computed over the last 36 complete months, with the Sharpe ratio over a same-currency money-market fund. Otherwise the figures stated in the factsheet are used and the series may be empty. Coverage varies by issuer: ETF providers usually publish holdings and NAV files, active managers usually publish a factsheet and a KID only — the coverage pages say what to expect per fund house.

History

Every successful refresh is also kept as a dated snapshot; GET /funds/{isin}/history serves TER, KID costs, fund size, risk indicator and top holdings over time (Pro and up), from 15 September 2026 on.