Bring an economic series into your dashboard
Use QVeris to retrieve economic time series for research notes, macro dashboards and AI-generated briefings. Start with a named series, a date range and a clear unit, then use the returned observations to build a chart or table. The FRED observations tool provides a concrete starting point.
A useful first task is a monthly US unemployment-rate table for a completed year. It has a defined series ID, an observation frequency and a published source. Once the table is correct, you can add other series rather than beginning with a broad request to summarize “the economy”.
The FRED UNRATE series page provides the series definition. Keep that definition with the values so your readers know which population and measure the chart describes.
Choose the measure, unit and frequency
| Decision | Example | Common mismatch |
|---|---|---|
| Series identity | UNRATE | Choosing a similarly named but different measure |
| Unit | Percent for the selected rate series | Confusing an index level with a percentage change |
| Frequency | Monthly | Presenting monthly observations as daily releases |
| Adjustment | The series’ published seasonal convention | Comparing adjusted and unadjusted series without a label |
Use series metadata to confirm definitions before transforming values. A request for year-over-year change is not equivalent to a request for the original level. If you apply a transformation, state it in the chart title or axis label and retain the untransformed series where practical.
Request a year of observations
The following request parameters ask for UNRATE observations during 2025 in ascending date order. They are inspected input fields, not a claim about the returned number of observations.
{
"series_id": "UNRATE",
"file_type": "json",
"observation_start": "2025-01-01",
"observation_end": "2025-12-31",
"sort_order": "asc"
}Check the returned dates and any missing-value markers before charting. Keep a missing observation separate from a measured zero. The FRED observations API reference documents date ranges, transformations and output options. Use only the options exposed by the selected QVeris route.
Separate observation dates from information dates
An economic observation can describe January while being released later. It can also be revised after its first publication. For a current macro dashboard, the latest available vintage may be appropriate; for a historical decision study, you may need the values known at the decision date.
FRED supports real-time periods and vintage-related queries for this distinction. Here, “real-time” refers to the information vintage, not an exchange-style live data stream. Keep the chosen vintage parameters with the dataset, and verify whether the series provides the historical coverage your study needs.
When writing a briefing, label the observation period and retrieval date separately. Do not treat the last row’s observation date as its publication timestamp. If release timing is not supplied, state that limitation instead of inventing an exact release hour.
Turn the series into a concise briefing
Start with a table of observations, then describe direction and magnitude using the series’ units. A change from one percentage rate to another is often best described in percentage points; a relative percentage change answers a different question. Include the formula when a calculation could be misunderstood.
Combine the result with market news for event context, or exchange-rate data for a currency-related workflow. Use Python integration for repeatable retrieval and review usage pricing before scheduling refreshes. Keep interpretation separate from the measured series.
Frequently asked questions
Is an economic data API an economic calendar?
A series API returns observations. A calendar tracks scheduled releases and may require a different capability.
Can later revisions change an old chart?
Yes. Retain the downloaded version and vintage parameters when reproducibility matters.
Build a sourced 2025 UNRATE monthly series
Open the prefilled QVeris task to retrieve monthly UNRATE observations for 2025. The output will include available values, units, seasonal-adjustment context, source, retrieval date and the first-to-last change when both endpoints exist.
Use QVeris to retrieve the UNRATE economic series for January through December 2025. Inspect the observations tool and series definition. Return the available monthly values with units, seasonal adjustment context, source and retrieval date. Describe the first-to-last change in percentage points only if the endpoints exist. Distinguish observation periods from release dates and identify the data vintage used. Respond in English.