Get free API key
All APIsexpand_more
search
appsAll APIs
functionHow metrics are calculated

Economic indicator time series

GET/stable/economic-series1 tokens per call

Returns the observations of one macroeconomic series, newest first. Look up series IDs in /stable/economic-indicators. You can narrow the range with from and to.

What you can do with this API

  • check_circleChart the US consumer price index over time
  • check_circleCompare changes in interest rates or unemployment with stock prices
  • check_circleShow the latest indicator value on a dashboard

Example URL

https://api.zenithcode.net/stable/economic-series?id=CPIAUCSL&from=2024-01-01&to=2026-12-31&limit=100

Shown without percent-encoding for readability. Non-ASCII values are encoded automatically when sent.

Parameters

ParameterRequiredDescriptionExample
id
string
RequiredSeries ID (FRED series_id, e.g. CPIAUCSL = US consumer price index). See /stable/economic-indicatorsCPIAUCSL
from
string
OptionalStart date (YYYY-MM-DD), lower bound of the observation date2024-01-01
to
string
OptionalEnd date (YYYY-MM-DD), upper bound of the observation date2026-12-31
limit
number
OptionalMaximum number of rows to return (default 100, max 5,000)100

Try it

Run it with your own parameters and check the response as a table, JSON or CSV. Sign-in required; each run uses 1 tokens.

travel_exploreTry in the API Viewer

Response example (real data)

lock
Live response examples are shown to signed-in users only (they include exchange data such as stock prices). Sign in to view

Response fields

seriesobject
attributionstring
observationsarray

Related APIs

FAQ

How many tokens does one call use?expand_more

1 tokens per call, regardless of how many rows come back. Your monthly allowance depends on your plan.

Do I need an account to try it?expand_more

Use the API Viewer to run it with your own parameters. Sign up for free and sign in (no credit card). Each run uses this API's tokens.

Can I get CSV instead of JSON?expand_more

Add format=csv to the URL to get CSV, ready for spreadsheets or pandas.

Can I get labels in English?expand_more

With neither lang nor Accept-Language, labels such as sector names are returned in English; add lang=ja or send Accept-Language: ja for Japanese. Company and sector names are always returned in both languages as nameJa / nameEn and sectorJa / sectorEn. Field names are the same in both languages.