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...
| Seller | Pricing | Requests · 30d | Performance | Access |
|---|---|---|---|---|
fredCurrent FRED — Get Series Observations · GET | $0 / call | — | —successP50— |
Run sends a real API request. Charges follow the published API contract.
Response structure
countintegerfile_typestringlimitintegerobservation_endstringobservation_startstringobservationsobject[]datestringrealtime_endstringrealtime_startstringvaluestring
offsetintegerorder_bystringoutput_typeintegerrealtime_endstringrealtime_startstringsort_orderstringunitsstring
// Inferred from response examples. Fields are optional and other fields may be returned.
export type ApiResponse = {
count?: number;
file_type?: string;
limit?: number;
observation_end?: string;
observation_start?: string;
observations?: Array<{
date?: string;
realtime_end?: string;
realtime_start?: string;
value?: string;
}>;
offset?: number;
order_by?: string;
output_type?: number;
realtime_end?: string;
realtime_start?: string;
sort_order?: string;
units?: string;
};- Method
- GET
- Endpoint
https://api.openany.si/v1/agent-apis/fred/fred/series/observations- Content type
- application/json
- Authentication
Authorization: Bearer $OPENANY_API_KEY
curl \
'https://api.openany.si/v1/agent-apis/fred/fred/series/observations?file_type=json&limit=100&series_id=GNPCA' \
-X GET \
-H "Authorization: Bearer $OPENANY_API_KEY" \
-H 'Content-Type: application/json'Input parameters
Fields in this listing; additional options and input encoding can vary by provider.
| Parameter | Location | Type | Required | Description |
|---|---|---|---|---|
file_type | URL query parametersquery | string | Yes | 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. enum: "json" |
series_id | URL query parametersquery | string | Yes | The id for a series. string, required |
realtime_start | URL query parametersquery | string | No | 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 |
realtime_end | URL query parametersquery | string | No | 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 |
limit | URL query parametersquery | integer | No | The maximum number of results to return.
integer between 1 and 100000, optional, default: 100000 minimum: 1 · maximum: 100000 |
offset | URL query parametersquery | integer | No | non-negative integer, optional, default: 0 minimum: 0 |
sort_order | URL query parametersquery | string | No | Sort results is ascending or descending observation_date order.
One of the following strings: 'asc', 'desc'.
optional, default: asc enum: "asc", "desc" |
observation_start | URL query parametersquery | string | No | The start of the observation period. YYYY-MM-DD formatted string, optional, default: 1776-07-04 (earliest available) |
observation_end | URL query parametersquery | string | No | The end of the observation period. YYYY-MM-DD formatted string, optional, default: 9999-12-31 (latest available) |
units | URL query parametersquery | string | No | 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 enum: "lin", "chg", "ch1", "pch", "pc1", "pca", "cch", "cca", "log" |
frequency | URL query parametersquery | string | No | 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.] enum: "d", "w", "bw", "m", "q", "sa", "a", "wef", "weth", "wew", "wetu", "wem", "wesu", "wesa", "bwew", "bwem" |
aggregation_method | URL query parametersquery | string | No | 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 enum: "avg", "sum", "eop" |
output_type | URL query parametersquery | integer | No | 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 enum: 1, 2, 3, 4 |
vintage_dates | URL query parametersquery | string | No | 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 |
Required markers inside a nested object or variant apply when that object or variant is used.
Sample response
Sample response · Configured HTTP 200; actual status is unverified. Example from the provider's documentation. Field values in your results will differ.
{
"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"
}Agent integration
Copy the resource contract without sharing an API key.
View API Markdown
# 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.
## Available implementations
fred · FRED — Get Series Observations: https://openany.si/markets/apis/capabilities/fred-get-series-observations?offering=d17436e2-94ac-4545-b755-2a3b7a1ddd84 · $0 / call
## Selected API contract
Documentation: https://openany.si/markets/apis/capabilities/fred-get-series-observations
Method: GET
Endpoint: https://api.openany.si/v1/agent-apis/fred/fred/series/observations
Price: $0 / call
Provider: fred
Contract revision: 3
Price source: OpenAny public API contract and documented provider unit rates. Price update time: not supplied.
Use OPENANY_API_KEY from the environment. API Key calls use your shared balance.
## Prepared request
```bash
curl \
'https://api.openany.si/v1/agent-apis/fred/fred/series/observations?file_type=json&limit=100&series_id=GNPCA' \
-X GET \
-H "Authorization: Bearer $OPENANY_API_KEY" \
-H 'Content-Type: application/json'
```
## API contract
```json
{
"resource_type": "api",
"name": "FRED — Get Series Observations",
"endpoint": "https://api.openany.si/v1/agent-apis/fred/fred/series/observations",
"method": "GET",
"content_type": "none",
"execution_mode": "sync",
"authentication": {
"type": "bearer",
"environment_variable": "OPENANY_API_KEY"
},
"inputs": [
{
"description": "A key or file extension that indicates the type of file to send.\n\nstring, optional, default: xml\n\nOne of the following values: 'xml', 'json', 'xlsx', 'csv'\n\nxml = Extensible Markup Language\n\njson = JavaScript Object Notation\n\nxlsx = Excel Spreadsheet\n\ncsv = 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.)\nOpenAny import profile requires json explicitly; original XML/download formats remain in official documentation.",
"enum_values": [
"json"
],
"location": "query",
"name": "file_type",
"nullable": false,
"required": true,
"type": "string"
},
{
"description": "The id for a series.\n\nstring, required",
"location": "query",
"name": "series_id",
"nullable": false,
"required": true,
"type": "string"
},
{
"description": "The start of the real-time period. For more information, see Real-Time Periods, vintage_dates.\n\nYYYY-MM-DD formatted string, optional, default: today's date",
"location": "query",
"name": "realtime_start",
"nullable": false,
"required": false,
"type": "string"
},
{
"description": "The end of the real-time period. For more information, see Real-Time Periods, vintage_dates.\n\nYYYY-MM-DD formatted string, optional, default: today's date",
"location": "query",
"name": "realtime_end",
"nullable": false,
"required": false,
"type": "string"
},
{
"description": "The maximum number of results to return.\n\ninteger between 1 and 100000, optional, default: 100000",
"location": "query",
"maximum": "100000",
"minimum": "1",
"name": "limit",
"nullable": false,
"required": false,
"type": "integer"
},
{
"description": "non-negative integer, optional, default: 0",
"location": "query",
"minimum": "0",
"name": "offset",
"nullable": false,
"required": false,
"type": "integer"
},
{
"description": "Sort results is ascending or descending observation_date order.\n\nOne of the following strings: 'asc', 'desc'.\n\noptional, default: asc",
"enum_values": [
"asc",
"desc"
],
"location": "query",
"name": "sort_order",
"nullable": false,
"required": false,
"type": "string"
},
{
"description": "The start of the observation period.\n\nYYYY-MM-DD formatted string, optional, default: 1776-07-04 (earliest available)",
"location": "query",
"name": "observation_start",
"nullable": false,
"required": false,
"type": "string"
},
{
"description": "The end of the observation period.\n\nYYYY-MM-DD formatted string, optional, default: 9999-12-31 (latest available)",
"location": "query",
"name": "observation_end",
"nullable": false,
"required": false,
"type": "string"
},
{
"description": "A key that indicates a data value transformation.\n\nstring, optional, default: lin (No transformation)\n\nOne of the following values: 'lin', 'chg', 'ch1', 'pch', 'pc1', 'pca', 'cch', 'cca', 'log'\n\nlin = Levels (No transformation)\n\nchg = Change\n\nch1 = Change from Year Ago\n\npch = Percent Change\n\npc1 = Percent Change from Year Ago\n\npca = Compounded Annual Rate of Change\n\ncch = Continuously Compounded Rate of Change\n\ncca = Continuously Compounded Annual Rate of Change\n\nlog = Natural Log\n\nFor unit transformation formulas, see:\n\nhttps://alfred.stlouisfed.org/help#growth_formulas",
"enum_values": [
"lin",
"chg",
"ch1",
"pch",
"pc1",
"pca",
"cch",
"cca",
"log"
],
"location": "query",
"name": "units",
"nullable": false,
"required": false,
"type": "string"
},
{
"description": "An optional parameter that indicates a lower frequency to aggregate values to. \nThe 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). \nIn FRED, the highest frequency data is daily, and the lowest frequency data is annual. \nThere are 3 aggregation methods available- average, sum, and end of period. \nSee the aggregation_method parameter. \n\nstring, optional, default: no value for no frequency aggregation\n\nOne of the following values: 'd', 'w', 'bw', 'm', 'q', 'sa', 'a', 'wef', 'weth', 'wew', 'wetu', 'wem', 'wesu', 'wesa', 'bwew', 'bwem'\n\nFrequencies without period descriptions:\n\nd = Daily\n\nw = Weekly\n\nbw = Biweekly\n\nm = Monthly\n\nq = Quarterly\n\nsa = Semiannual\n\na = Annual\n\nFrequencies with period descriptions:\n\nwef = Weekly, Ending Friday\n\nweth = Weekly, Ending Thursday\n\nwew = Weekly, Ending Wednesday\n\nwetu = Weekly, Ending Tuesday\n\nwem = Weekly, Ending Monday\n\nwesu = Weekly, Ending Sunday\n\nwesa = Weekly, Ending Saturday\n\nbwew = Biweekly, Ending Wednesday\n\nbwem = Biweekly, Ending Monday\n\n Note that an error will be returned if a frequency is specified that is higher than the native frequency of the series.\n For instance if a series has the native frequency 'Monthly' (as returned by the fred/series request), \n it is not possible to aggregate the series to the higher 'Daily' frequency using the frequency parameter value 'd'. \n\n No frequency aggregation will occur if the frequency specified by the frequency parameter matches the native frequency\n[Import field summary truncated to fit the backend description limit. Complete original text is retained in officialOperation.parameters[].originalText and the documentation.]",
"enum_values": [
"d",
"w",
"bw",
"m",
"q",
"sa",
"a",
"wef",
"weth",
"wew",
"wetu",
"wem",
"wesu",
"wesa",
"bwew",
"bwem"
],
"location": "query",
"name": "frequency",
"nullable": false,
"required": false,
"type": "string"
},
{
"description": "A key that indicates the aggregation method used for frequency aggregation. \nThis parameter has no affect if the frequency parameter is not set. \n\nstring, optional, default: avg\n\nOne of the following values: 'avg', 'sum', 'eop'\n\navg = Average\n\nsum = Sum\n\neop = End of Period",
"enum_values": [
"avg",
"sum",
"eop"
],
"location": "query",
"name": "aggregation_method",
"nullable": false,
"required": false,
"type": "string"
},
{
"description": "An integer that indicates an output type.\n\ninteger, optional, default: 1\n\nOne of the following values: '1', '2', '3', '4'\n\n1 = Observations by Real-Time Period\n\n2 = Observations by Vintage Date, All Observations\n\n3 = Observations by Vintage Date, New and Revised Observations Only\n\n4 = Observations, Initial Release Only\n\nFor 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). \nIn this case only, the XML attribute name starts with an underscore then the series ID in order to avoid invalid XML. \nIf the series ID starts with a letter (i.e. A through Z) then an underscore is not prepended.\n\nFor more information, read:\n\nhttps://alfred.stlouisfed.org/help/downloaddata#outputformats",
"enum_values": [
1,
2,
3,
4
],
"location": "query",
"name": "output_type",
"nullable": false,
"required": false,
"type": "integer"
},
{
"description": "A comma separated string of YYYY-MM-DD formatted dates in history (e.g. 2000-01-01,2005-02-24).\nVintage dates are used to download data as it existed on these specified dates in history.\nVintage dates can be specified instead of a real-time period using realtime_start and realtime_end.\n\nSometimes it may be useful to enter a vintage date that is not a date when the data values were revised. \nFor instance you may want to know the latest available revisions on a particular date.\nEntering a vintage date is also useful to compare series on different releases with different release dates.\n\nstring, optional, no vintage dates are set by default.\n\nYour query will be limited to a specific number of vintage dates depending on the series_id, file_type and output_type specified.\n\noutput_type=2, series_id=USRECD: 110 csv, 55 xlsx\n\noutput_type=2, any daily series: 450 csv, 225 xlsx\n\nany output_type or other series: 1000 csv, 1000 xlsx, 2000 json, 2000 xml",
"location": "query",
"name": "vintage_dates",
"nullable": false,
"required": false,
"type": "string"
}
],
"billing": {
"currency": "USD",
"mode": "fixed",
"priceMicroUsd": "0",
"rounding": null,
"unit": "call",
"unitQuantity": null
},
"examples": [
{
"http_status": 200,
"name": "Official example · Official example (not executed) (HTTP assumed",
"request": {
"body": null,
"headers": {},
"path": {},
"query": {
"file_type": "json",
"limit": 100,
"series_id": "GNPCA"
}
},
"response_body": {
"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"
}
}
]
}
```Error handling
| Status | Next step |
|---|---|
400 | Check the offering and request fields. |
401 / 403 | Verify your credentials and access permissions. |
402 | Inspect the selected access mode and returned payment requirements. |
429 | Respect the returned rate limit and retry guidance. |
5xx | Inspect the error and usage record before retrying a paid operation. |
Official example · Official example (not executed) (HTTP assumed
Example from the provider's documentation. Field values in your results will differ.
Prepare your environment
Use a terminal with cURL installed.
Use an OpenAny API key with shared-balance access. Confirm availability and price before running; a call may charge your balance.
Set the key in your terminal using the hidden prompt below. Keep its value out of source files and logs.
Terminal · macOS / Linuxprintf 'OpenAny API key: ' read -r -s OPENANY_API_KEY export OPENANY_API_KEY printf '\n'Run the request
Paste the complete command below into your terminal.
Values to replace before running 14
Review these request fields before running. Keep the published provider and request method unchanged.
file_type- 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.
series_id- The id for a series. string, required
realtime_start- 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
realtime_end- 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
limit- The maximum number of results to return. integer between 1 and 100000, optional, default: 100000
offset- non-negative integer, optional, default: 0
sort_order- Sort results is ascending or descending observation_date order. One of the following strings: 'asc', 'desc'. optional, default: asc
observation_start- The start of the observation period. YYYY-MM-DD formatted string, optional, default: 1776-07-04 (earliest available)
observation_end- The end of the observation period. YYYY-MM-DD formatted string, optional, default: 9999-12-31 (latest available)
units- 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
frequency- 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.]
aggregation_method- 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
output_type- 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
vintage_dates- 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
Terminal · cURLcurl \ 'https://api.openany.si/v1/agent-apis/fred/fred/series/observations?file_type=json&limit=100&series_id=GNPCA' \ -X GET \ -H "Authorization: Bearer $OPENANY_API_KEY" \ -H 'Content-Type: application/json'Check the response
Sample response · Configured HTTP 200; actual status is unverified.
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" }
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.