US macroPlanned coverage

Economic observations

macro.us.observations

Dated economic values with release timing, vintages and revisions.

Planned plan access: Core, Research, Professional
Schema version: 1.0.0
Record key: series_id, observation_date, available_at, revision

How to request it

When this dataset appears in your account’s catalog, select its version, supported fields and exact entity identifiers. Set a short date range and an as_of time, then request a small page. The record key identifies a row; it is not necessarily the identifier accepted by the query filter.

HTTP request template

This is a template, not a currently available request. Fill each variable from the authenticated catalog and your intended query. The Explorer can generate a complete request for an available dataset.

GET /v1/data/macro.us.observationsHTTP

curl --fail-with-body --get "$ORIGINFOLD_API_URL/v1/data/macro.us.observations" \
  --header "Authorization: Bearer $ORIGINFOLD_API_KEY" \
  --data-urlencode "dataset_version=$DATASET_VERSION" \
  --data-urlencode "fields=$FIELDS" \
  --data-urlencode "entity_id=$ENTITY_ID" \
  --data-urlencode "start=$START_DATE" \
  --data-urlencode "end=$END_DATE" \
  --data-urlencode "as_of=$AS_OF" \
  --data-urlencode "limit=25"

See a complete illustrative HTTP and Python example, including what each request parameter means.

Field dictionary

nullable fields may be empty. An empty value is not zero. Types and definitions below come from the dataset schema; the released API may expose only a qualified subset.

Field	Type	Meaning
`dataset_id`	string	Logical dataset identifier.
`version_id`	uuidv7	Immutable candidate or active version identifier.
`schema_version`	semver	Row schema version.
`source_id`	string	Approved official source identifier.
`series_id`	string	Stable MarketWeave series identifier.
`observation_date`	date	Economic period or date represented by the value; never used as availability time.
`available_at`	timestamp_utc	Earliest documented source release time, otherwise first successful acquisition time.
`vintage_id`	string	Stable source vintage identifier or immutable snapshot identifier; never invented as a historical release.
`revision`	int32	Zero-based revision sequence for a series/date knowledge history.
`source_published_at`	timestamp_utc May be empty	Documented source publication timestamp when supplied.
`ingested_at`	timestamp_utc	Successful acquisition timestamp.
`value`	float64 May be empty	Source value; missing source values remain null and are never forward-filled.
`unit`	string	Canonical unit recorded with the value.
`source_ref`	string	Immutable bounded structured source snapshot/provenance reference.
`quality_flags`	list[string]	Non-fatal quality or source caveat flags.

Understand observation time, availability and revisions · Limits and errors