Economic and market series

Reference series are published measures that are observed rather than traded: economic statistics, interest rates, yields and spreads, index levels and volatility indices, and physical quantities. The rates, credit, and volatility views are on rates, credit, and volatility.

Routes

you need	route
search or list series	GET /v1/series
one series: its latest observation, or its quote	GET /v1/series/{key}
a value series' observations	GET /v1/series/{key}/observations
a value series' projections and forecasts	GET /v1/series/{key}/projections
a bar series' daily bars and indicators	GET /v1/series/{key}/history, GET /v1/series/{key}/technicals

Every parameter and response schema is in the API reference.

Series kinds and keys

Each series is one concept with one key, such as series:us.cpi.all_items.sa (instrument keys). Its kind is its instrument_type:

kind	what it holds	example
economic	economic statistics: prices, employment, output	series:us.cpi.all_items.sa
rate	interest rates, yields, and spreads	series:us.treasury.spread.10y_2y
index	index levels and volatility indices	series:us.equity_index.sp500
physical	physical quantities (physical supply and demand)	series:us.crude_oil.stocks.commercial.nsa

GET /v1/series lists every series, filtered by kind, asset_class, asset_subclass, category, or q.

Series shapes

A series is served in one shape, stated as shape in its series block:

shape	what one item is	routes	explained on
values	an observation of a period (a month, a quarter, a week)	/observations, /projections	series values
bars	a daily market bar	/history, /technicals	price history, technicals

GET /v1/series/{key} answers a value series with its latest observation, and a bar series with its quote. A route of the other shape answers 404 not_supported and names the right one.

curl "https://api.tauric.ai/v1/series/us.cpi.all_items.sa/observations?limit=12" \
  -H "Authorization: Bearer $TAURIC_API_KEY"
curl "https://api.tauric.ai/v1/series/us.equity_index.sp500/history?period=6mo" \
  -H "Authorization: Bearer $TAURIC_API_KEY"

Labor and price statistics

Many economic series are labor and price statistics; GET /v1/series?kind=economic lists them.

Revision status

Each value carries its revision status: preliminary or revised. When none is stated, status is null with status_not_stated; do not read that as final. A period the publisher states has no value is listed in missing as not_published, and a withdrawn value is status_withdrawn (series values).

Units

Each series carries its machine-readable unit (index, percent, US dollars per hour, hours). as_published holds the published unit words.

Concepts with two segments

Twelve concepts have a point-in-time record in two segments, among them payrolls, the unemployment rate, CPI, and PPI. Their point_in_time.segments lists each interval as [from, until), oldest first, with its own since and historical_vintages; a series with one segment has segments: null. The two segments meet at 2026-10-02T00:00:00Z. point_in_time.since and historical_vintages describe the segment the answer is read from (point in time):

read	what you get
current, or known_at from 2026-10-02T00:00:00Z	the published values with their revision status; since 2026-09-30 and historical_vintages.status: unsupported
known_at before 2026-10-02T00:00:00Z	the values as recorded then, with no revision status (status_not_stated, not final); before a period's own record began, its published vintages (evidence: source_vintage), reaching further back (payrolls from 1955-05-07)

curl "https://api.tauric.ai/v1/series/us.employment.nonfarm_payrolls.sa/observations?known_at=2026-10-01T12:00:00Z" \
  -H "Authorization: Bearer $TAURIC_API_KEY"

Release times

A new value is normally published at 08:30 or 10:00 ET, sometimes later. refreshed_at says when a value was last stored or confirmed. A revision to any period is served within a day.

Values missing from the latest publication

When the latest publication no longer carries a value, the value is still served, marked field_states.value: unconfirmed; a change or other figure derived from it is marked the same (physical supply and demand has an example).

Projections

GET /v1/series/{key}/projections serves what a value series holds that is not an observation (served periods), such as the potential-GDP quarters to 2036 (model_output) or a projected marketing year (projection). known_at reads the projections as they were held at an instant. A series that holds none answers an empty list with not_held.

Publication lag and freshness

A value series states its publication lag in freshness.observed_through and freshness.source_lag_days (freshness), on every macro snapshot member and every /v1/series/{key} and /observations answer. The Treasury views carry source_lag_days beside curve_date. Compare observed_through before you combine two series (the Treasury yield curve has an example).