Time Series

Stable

Point-in-time correctness, revisions and the reproducibility guarantees behind every historical query.

Most analytical errors involving historical data are not arithmetic mistakes. They are the result of using information that was not available at the time being analysed. The time series layer exists to make that failure mode structurally difficult.

Point-in-time semantics#

Every series is stored bitemporally: each observation carries both the period it describes and the timestamp at which it became known. A query therefore has two dates, and conflating them is the single most common source of backtests that cannot be reproduced in live conditions.

periodDateRangerequired
The span of time the data describes.
asOfDaterequired
The knowledge cutoff. Observations published after this instant are excluded, including revisions to periods inside the range.
revisions'latest' | 'original' | 'all'
Whether to return the most recent value known as of the cutoff, the first published value, or the full revision history.
alignment'period-end' | 'publication'
Whether an observation is indexed to the period it covers or to the moment it became public. The distinction is decisive for anything involving lag.

Revisions#

Reported figures change after publication, sometimes substantially and sometimes years later. A series that shows only current values is a reconstruction of the past that never existed. The revision history is retained in full, and the gap between an original print and its final value is itself queryable — it is frequently more informative than either number alone.

Revision classTypical causeHandling
ScheduledRoutine re-estimation on a published calendarExpected; surfaced with the calendar reference
MethodologicalThe definition of the series changedBreaks comparability; the break is flagged, never smoothed
CorrectionAn error in a prior publicationBoth values retained; the correction is timestamped
RebasingIndex base period movedOld and new bases kept separate rather than chained silently

Last updated 2026-09-08