Economic Research from the Federal Reserve Bank of St. Louis

fred/series

• Description
• Example
  • Request
  • Response
• Parameters
  • api_key
  • series_id
  • realtime_start
  • realtime_end

Description

Get an economic data series.

Example

Request (HTTP GET)

http://api.stlouisfed.org/fred/series?series_id=GNPCA&api_key=abcdefghijklmnopqrstuvwxyz123456

Note that API key 'abcdefghijklmnopqrstuvwxyz123456' is for demonstration purposes only. Use a registered API key instead.

Response

<?xml version="1.0" encoding="utf-8" ?>
<seriess realtime_start="2008-07-29" realtime_end="2008-07-29">
  <series id="GNPCA" realtime_start="2008-07-29" realtime_end="2008-07-29" title="Real Gross National Product" observation_start="1929-01-01" observation_end="2007-01-01" frequency="Annual" frequency_short="A" units="Billions of Chained 2000 Dollars" units_short="Bil. of Chained 2000 $" seasonal_adjustment="Not Applicable" seasonal_adjustment_short="NA" last_updated="2008-03-27 11:16:06-05"/>
</seriess>

The series tag's notes attribute is optional.

Parameters

api_key

Read API Keys for more information.

• 32 character alpha-numeric lowercase string, required

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.

• 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.

• YYYY-MM-DD formatted string, optional, default: today's date