When fetching Postings or Balances the time range must be specified; as an Account matures, it's possible that there may be many thousands of data points in the various timeseries that Vault maintains.

Fetching all these data points when not necessary would incur an undue burden on the database and network; because of this, a time range must be specified.

To ensure data requests are limited appropriately, postings and balances parameters in the @requires decorator for a hook must use time range specifiers. Specifiers can be:

Strings like 1 day, 2 months, or 3 years to fetch all data for the specified duration in the past, from the effective_date of the hook execution.

latest to fetch the latest value in the timeseries at the effective_date of the hook execution.