FRED — Get Series Observations

Retrieve the observations or data values for an economic data series with the FRED API. The request takes a file type and a series ID. Build a market research view or track changes over time. The GET request schema also lists file_type, series_id, realtime_start.

Selected price
$0 / callPublished pricing
Sellers / implementations
1 / 1
Requests · 30d
—Loading...
Success rate · 30d
—Loading...

Run sends a real API request. Charges follow the published API contract.

Request parameters
A key or file extension that indicates the type of file to send. string, optional, default: xml One of the following values: 'xml', 'json', 'xlsx', 'csv' xml = Extensible Markup Language json = JavaScript Object Notation xlsx = Excel Spreadsheet csv = Comma-Separated Values Text Format (File is returned as compressed zip file. The zip file contains the specified file format csv and a text README file.) OpenAny import profile requires json explicitly; original XML/download formats remain in official documentation.
The id for a series. string, required
Optional parameters (12)
The start of the real-time period. For more information, see Real-Time Periods, vintage_dates. YYYY-MM-DD formatted string, optional, default: today's date
The end of the real-time period. For more information, see Real-Time Periods, vintage_dates. YYYY-MM-DD formatted string, optional, default: today's date
The maximum number of results to return. integer between 1 and 100000, optional, default: 100000
non-negative integer, optional, default: 0
Sort results is ascending or descending observation_date order. One of the following strings: 'asc', 'desc'. optional, default: asc
The start of the observation period. YYYY-MM-DD formatted string, optional, default: 1776-07-04 (earliest available)
The end of the observation period. YYYY-MM-DD formatted string, optional, default: 9999-12-31 (latest available)
A key that indicates a data value transformation. string, optional, default: lin (No transformation) One of the following values: 'lin', 'chg', 'ch1', 'pch', 'pc1', 'pca', 'cch', 'cca', 'log' lin = Levels (No transformation) chg = Change ch1 = Change from Year Ago pch = Percent Change pc1 = Percent Change from Year Ago pca = Compounded Annual Rate of Change cch = Continuously Compounded Rate of Change cca = Continuously Compounded Annual Rate of Change log = Natural Log For unit transformation formulas, see: https://alfred.stlouisfed.org/help#growth_formulas
An optional parameter that indicates a lower frequency to aggregate values to. The FRED frequency aggregation feature converts higher frequency data series into lower frequency data series (e.g. converts a monthly data series into an annual data series). In FRED, the highest frequency data is daily, and the lowest frequency data is annual. There are 3 aggregation methods available- average, sum, and end of period. See the aggregation_method parameter. string, optional, default: no value for no frequency aggregation One of the following values: 'd', 'w', 'bw', 'm', 'q', 'sa', 'a', 'wef', 'weth', 'wew', 'wetu', 'wem', 'wesu', 'wesa', 'bwew', 'bwem' Frequencies without period descriptions: d = Daily w = Weekly bw = Biweekly m = Monthly q = Quarterly sa = Semiannual a = Annual Frequencies with period descriptions: wef = Weekly, Ending Friday weth = Weekly, Ending Thursday wew = Weekly, Ending Wednesday wetu = Weekly, Ending Tuesday wem = Weekly, Ending Monday wesu = Weekly, Ending Sunday wesa = Weekly, Ending Saturday bwew = Biweekly, Ending Wednesday bwem = Biweekly, Ending Monday Note that an error will be returned if a frequency is specified that is higher than the native frequency of the series. For instance if a series has the native frequency 'Monthly' (as returned by the fred/series request), it is not possible to aggregate the series to the higher 'Daily' frequency using the frequency parameter value 'd'. No frequency aggregation will occur if the frequency specified by the frequency parameter matches the native frequency [Import field summary truncated to fit the backend description limit. Complete original text is retained in officialOperation.parameters[].originalText and the documentation.]
A key that indicates the aggregation method used for frequency aggregation. This parameter has no affect if the frequency parameter is not set. string, optional, default: avg One of the following values: 'avg', 'sum', 'eop' avg = Average sum = Sum eop = End of Period
An integer that indicates an output type. integer, optional, default: 1 One of the following values: '1', '2', '3', '4' 1 = Observations by Real-Time Period 2 = Observations by Vintage Date, All Observations 3 = Observations by Vintage Date, New and Revised Observations Only 4 = Observations, Initial Release Only For output types '2' and '3', some XML attribute names start with the series ID which may have a first character that is a number (i.e. 0 through 9). In this case only, the XML attribute name starts with an underscore then the series ID in order to avoid invalid XML. If the series ID starts with a letter (i.e. A through Z) then an underscore is not prepended. For more information, read: https://alfred.stlouisfed.org/help/downloaddata#outputformats
A comma separated string of YYYY-MM-DD formatted dates in history (e.g. 2000-01-01,2005-02-24). Vintage dates are used to download data as it existed on these specified dates in history. Vintage dates can be specified instead of a real-time period using realtime_start and realtime_end. Sometimes it may be useful to enter a vintage date that is not a date when the data values were revised. For instance you may want to know the latest available revisions on a particular date. Entering a vintage date is also useful to compare series on different releases with different release dates. string, optional, no vintage dates are set by default. Your query will be limited to a specific number of vintage dates depending on the series_id, file_type and output_type specified. output_type=2, series_id=USRECD: 110 csv, 55 xlsx output_type=2, any daily series: 450 csv, 225 xlsx any output_type or other series: 1000 csv, 1000 xlsx, 2000 json, 2000 xml

Sample response

{
  "count": 84,
  "file_type": "json",
  "limit": 100000,
  "observation_end": "9999-12-31",
  "observation_start": "1776-07-04",
  "observations": [
    {
      "date": "1929-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "1065.9"
    },
    {
      "date": "1930-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "975.5"
    },
    {
      "date": "1931-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "912.1"
    },
    {
      "date": "1932-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "794.1"
    },
    {
      "date": "1933-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "783.3"
    },
    {
      "date": "1934-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "866.7"
    },
    {
      "date": "1935-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "944.3"
    },
    {
      "date": "1936-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "1065.0"
    },
    {
      "date": "1937-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "1120.6"
    },
    {
      "date": "1938-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "1083.9"
    },
    {
      "date": "1939-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "1170.2"
    },
    {
      "date": "1940-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "1271.7"
    },
    {
      "date": "1941-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "1497.6"
    },
    {
      "date": "1942-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "1779.4"
    },
    {
      "date": "1943-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "2081.2"
    },
    {
      "date": "1944-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "2247.3"
    },
    {
      "date": "1945-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "2224.7"
    },
    {
      "date": "1946-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "1969.3"
    },
    {
      "date": "1947-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "1950.6"
    },
    {
      "date": "1948-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "2033.2"
    },
    {
      "date": "1949-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "2021.1"
    },
    {
      "date": "1950-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "2197.5"
    },
    {
      "date": "1951-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "2376.4"
    },
    {
      "date": "1952-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "2473.1"
    },
    {
      "date": "1953-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "2587.7"
    },
    {
      "date": "1954-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "2574.2"
    },
    {
      "date": "1955-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "2758.4"
    },
    {
      "date": "1956-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "2818.6"
    },
    {
      "date": "1957-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "2878.5"
    },
    {
      "date": "1958-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "2854.6"
    },
    {
      "date": "1959-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "3050.8"
    },
    {
      "date": "1960-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "3130.4"
    },
    {
      "date": "1961-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "3211.9"
    },
    {
      "date": "1962-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "3409.8"
    },
    {
      "date": "1963-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "3559.0"
    },
    {
      "date": "1964-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "3764.8"
    },
    {
      "date": "1965-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "4008.8"
    },
    {
      "date": "1966-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "4269.4"
    },
    {
      "date": "1967-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "4386.7"
    },
    {
      "date": "1968-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "4602.8"
    },
    {
      "date": "1969-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "4745.2"
    },
    {
      "date": "1970-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "4754.6"
    },
    {
      "date": "1971-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "4913.6"
    },
    {
      "date": "1972-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "5172.2"
    },
    {
      "date": "1973-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "5475.1"
    },
    {
      "date": "1974-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "5454.1"
    },
    {
      "date": "1975-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "5430.4"
    },
    {
      "date": "1976-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "5729.1"
    },
    {
      "date": "1977-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "5997.3"
    },
    {
      "date": "1978-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "6326.9"
    },
    {
      "date": "1979-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "6547.0"
    },
    {
      "date": "1980-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "6530.3"
    },
    {
      "date": "1981-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "6688.0"
    },
    {
      "date": "1982-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "6564.6"
    },
    {
      "date": "1983-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "6863.2"
    },
    {
      "date": "1984-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "7352.5"
    },
    {
      "date": "1985-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "7640.2"
    },
    {
      "date": "1986-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "7890.9"
    },
    {
      "date": "1987-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "8161.0"
    },
    {
      "date": "1988-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "8509.9"
    },
    {
      "date": "1989-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "8822.6"
    },
    {
      "date": "1990-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "9003.0"
    },
    {
      "date": "1991-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "8988.6"
    },
    {
      "date": "1992-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "9305.0"
    },
    {
      "date": "1993-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "9559.8"
    },
    {
      "date": "1994-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "9932.2"
    },
    {
      "date": "1995-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "10206.2"
    },
    {
      "date": "1996-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "10595.1"
    },
    {
      "date": "1997-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "11058.1"
    },
    {
      "date": "1998-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "11540.7"
    },
    {
      "date": "1999-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "12108.9"
    },
    {
      "date": "2000-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "12614.3"
    },
    {
      "date": "2001-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "12750.2"
    },
    {
      "date": "2002-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "12970.8"
    },
    {
      "date": "2003-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "13352.2"
    },
    {
      "date": "2004-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "13879.0"
    },
    {
      "date": "2005-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "14340.8"
    },
    {
      "date": "2006-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "14690.9"
    },
    {
      "date": "2007-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "15009.7"
    },
    {
      "date": "2008-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "15009.0"
    },
    {
      "date": "2009-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "14565.1"
    },
    {
      "date": "2010-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "14966.5"
    },
    {
      "date": "2011-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "15286.7"
    },
    {
      "date": "2012-01-01",
      "realtime_end": "2013-08-14",
      "realtime_start": "2013-08-14",
      "value": "15693.1"
    }
  ],
  "offset": 0,
  "order_by": "observation_date",
  "output_type": 1,
  "realtime_end": "2013-08-14",
  "realtime_start": "2013-08-14",
  "sort_order": "asc",
  "units": "lin"
}

Response result

Response structure

Inferred from examples
  • countinteger
  • file_typestring
  • limitinteger
  • observation_endstring
  • observation_startstring
  • observationsobject[]
    • datestring
    • realtime_endstring
    • realtime_startstring
    • valuestring
  • offsetinteger
  • order_bystring
  • output_typeinteger
  • realtime_endstring
  • realtime_startstring
  • sort_orderstring
  • unitsstring

Common questions

Do I need a separate key for every provider?

Use your OpenAny API key for standard API access. Read it from OPENANY_API_KEY in your environment and keep it out of prompts, source code and logs.

Are these providers interchangeable?

No. Each offering has its own inputs, pricing and response contract. Selecting a catalog offering does not establish automatic routing or fallback. Confirm the service contract before calling.

How is this API billed?

API-key calls use your shared balance at the selected implementation's published rate. Check the billing unit and request-specific pricing rules before making a paid call. Recorded usage determines the final charge under that contract.

Where do the price and contract come from?

The selected implementation publishes its provider, request contract, revision and billing rules through OpenAny's public API catalog. A revision number identifies a contract version, not a price update date. A price update timestamp is not supplied; do not treat a page date as one.

How do OpenAny Balance and x402 differ?

OpenAny Balance uses an API key and one shared balance. Card, USDC and x402 top-ups, card auto top-up and USDC subscriptions fund that balance; available routes appear on the Credits page. Direct x402 is a separate pay-per-request flow, available only on listings that show it and requiring an authorized payment client.

Does Playground send a paid request?

Yes. After you sign in, Run sends a real API request using an active OpenAny API key. Charges follow the published API contract and use your shared balance. Selecting an implementation, editing inputs and viewing sample responses do not send requests.

Use FRED — Get Series Observations with your agent

Inspect endpoint contracts and confirm availability and pricing before a paid call.