> ## Documentation Index > Fetch the complete documentation index at: https://docs.arrays.org/llms.txt > Use this file to discover all available pages before exploring further. # Get Economic Indicators > [OpenAPI JSON Spec](/docs/output/v1_macro_economic-indicators_get.json) Retrieve economic indicator time series data with series metadata and observations **Overview** This endpoint provides economic indicator data from FRED (Federal Reserve Economic Data), including series metadata (seasonal adjustment, frequency, units) and time series observations (date, value, release date). **Key Features** - **Series Metadata**: Returns complete series information including seasonal adjustment type, frequency, and units - **Release Dates**: Each observation includes its first release date (when the data was initially published) - **Flexible Time Filtering**: Choose to filter by observed_at (publish timestamp) or calendar date - **Point-in-Time Data**: Tracks when data was released, supporting historical analysis **Indicator Types** Currently supported 34 indicators: - **GDP**: Gross Domestic Product - **REAL_GDP**: Real Gross Domestic Product (GDPC1) - **REAL_GDP_PER_CAPITA**: Real GDP Per Capita (A939RX0Q048SBEA) - **INITIAL_CLAIMS**: Initial Jobless Claims (ICSA) - **UNEMPLOYMENT_RATE**: Unemployment Rate (UNRATE) - **TOTAL_NONFARM_PAYROLL**: Total Nonfarm Payroll (PAYEMS) - **FEDERAL_FUNDS**: Federal Funds Effective Rate (FEDFUNDS) - **CPI**: Consumer Price Index (CPIAUCSL) - **INFLATION_RATE_YOY**: Inflation Rate YoY (FPCPITOTLZGUSA) - **CORE_PPI**: Core PPI - Final Demand Less Foods and Energy (PPIFES) - **PPI_FINAL_DEMAND**: PPI Final Demand (PPIFIS) - **CONSUMER_SENTIMENT**: Consumer Sentiment Index (UMCSENT) - **CONSUMER_INFLATION_EXPECTATIONS**: Consumer Inflation Expectations (MICH) - **RETAIL_SALES**: Retail Sales (RSXFS) - **DURABLE_GOODS**: Durable Goods Orders (DGORDER) - **INDUSTRIAL_PRODUCTION**: Industrial Production Index (INDPRO) - **SMOOTHED_RECESSION_PROBABILITIES**: Smoothed Recession Probabilities (RECPROUSM156N) - **CORE_CPI**: Core CPI - All Items Less Food and Energy (CPILFESL) - **TIPS_5_YEAR**: 5-Year Treasury Inflation-Indexed Security (DFII5) - **TIPS_10_YEAR**: 10-Year Treasury Inflation-Indexed Security (DFII10) - **TIPS_20_YEAR**: 20-Year Treasury Inflation-Indexed Security (DFII20) - **TIPS_30_YEAR**: 30-Year Treasury Inflation-Indexed Security (DFII30) - **VIX**: CBOE Volatility Index (VIXCLS) - **TREASURY_YIELD_1_MONTH**: 1-Month Treasury Constant Maturity Rate (DGS1MO) - **TREASURY_YIELD_3_MONTH**: 3-Month Treasury Constant Maturity Rate (DGS3MO) - **TREASURY_YIELD_6_MONTH**: 6-Month Treasury Constant Maturity Rate (DGS6MO) - **TREASURY_YIELD_2_YEAR**: 2-Year Treasury Constant Maturity Rate (DGS2) - **TREASURY_YIELD_5_YEAR**: 5-Year Treasury Constant Maturity Rate (DGS5) - **TREASURY_YIELD_10_YEAR**: 10-Year Treasury Constant Maturity Rate (DGS10) - **TREASURY_YIELD_20_YEAR**: 20-Year Treasury Constant Maturity Rate (DGS20) - **TREASURY_YIELD_30_YEAR**: 30-Year Treasury Constant Maturity Rate (DGS30) - **GOLD_VIX**: CBOE Gold ETF Volatility Index (GVZCLS) - **CRUDE_OIL_VIX**: CBOE Crude Oil ETF Volatility Index (OVXCLS) - **RUSSELL_2000_VIX**: CBOE Russell 2000 Volatility Index (RVXCLS) **Time Filter Types** - **OBSERVED_AT**: Filter by observation publish timestamp (when data was released to FRED) - **CALENDAR_START_DATE**: Filter by the calendar date that the observation represents (e.g., 2024-01-01 for Q1 2024) - **RELEASE_DATE**: Filter by release/vintage date (when the data revision was published by FRED) **Response Structure** The response contains two parts: - **series**: Metadata about the indicator (name, title, seasonal adjustment (e.g., "Seasonally Adjusted Annual Rate", "Seasonally Adjusted", "Not Seasonally Adjusted"), frequency, units, notes) - **observations**: Array of data points, each containing: - **date**: Calendar date of the observation (ISO 8601 format, e.g., "2024-01-01") - **value**: Indicator value (double precision) - **releaseDate**: First release date in ISO 8601 format (e.g., "2024-04-25") - **observedAt**: Observation publish timestamp (Unix timestamp in seconds, e.g., 1714041000) **Usage Examples** 1. **Get GDP data by observed_at (publish time)**: `?indicator_type=GDP&time_type=OBSERVED_AT&start_time=1704067200&end_time=1735689600` 2. **Get GDP data by calendar date**: `?indicator_type=GDP&time_type=CALENDAR_START_DATE&start_time=1704067200&end_time=1735689600` **Important Notes** - All parameters are required (indicator_type, time_type, start_time, end_time) - Timestamps are Unix timestamps in seconds (UTC) - CALENDAR_START_DATE filter is recommended for most use cases - OBSERVED_AT filter is useful for tracking when data was published/updated - Release dates indicate when data first appeared (initial release, not revisions) - Seasonal adjustment info helps interpret the data correctly ## OpenAPI ````yaml /api-reference/openapi.json get /v1/macro/economic-indicators openapi: 3.0.0 info: contact: {} description: >- Welcome to Arrays! Arrays is a unified financial data layer for both financial institutions and retail users, delivering comprehensive market data across crypto and equity markets. Our datasets cover fundamentals, ETFs, options, crypto, and more. Visit [arrays.org](https://arrays.org) to request an API key and start your free trial. You can explore our full API offerings in the documentation below. For any questions regarding APIs or pricing, please contact support@arrays.org. title: Arrays API version: '1.0' servers: - url: https://data-tools.prd.arrays.org/api security: [] paths: /v1/macro/economic-indicators: get: tags: - Macro summary: Get Economic Indicators description: >- [OpenAPI JSON Spec](/docs/output/v1_macro_economic-indicators_get.json) Retrieve economic indicator time series data with series metadata and observations **Overview** This endpoint provides economic indicator data from FRED (Federal Reserve Economic Data), including series metadata (seasonal adjustment, frequency, units) and time series observations (date, value, release date). **Key Features** - **Series Metadata**: Returns complete series information including seasonal adjustment type, frequency, and units - **Release Dates**: Each observation includes its first release date (when the data was initially published) - **Flexible Time Filtering**: Choose to filter by observed_at (publish timestamp) or calendar date - **Point-in-Time Data**: Tracks when data was released, supporting historical analysis **Indicator Types** Currently supported 34 indicators: - **GDP**: Gross Domestic Product - **REAL_GDP**: Real Gross Domestic Product (GDPC1) - **REAL_GDP_PER_CAPITA**: Real GDP Per Capita (A939RX0Q048SBEA) - **INITIAL_CLAIMS**: Initial Jobless Claims (ICSA) - **UNEMPLOYMENT_RATE**: Unemployment Rate (UNRATE) - **TOTAL_NONFARM_PAYROLL**: Total Nonfarm Payroll (PAYEMS) - **FEDERAL_FUNDS**: Federal Funds Effective Rate (FEDFUNDS) - **CPI**: Consumer Price Index (CPIAUCSL) - **INFLATION_RATE_YOY**: Inflation Rate YoY (FPCPITOTLZGUSA) - **CORE_PPI**: Core PPI - Final Demand Less Foods and Energy (PPIFES) - **PPI_FINAL_DEMAND**: PPI Final Demand (PPIFIS) - **CONSUMER_SENTIMENT**: Consumer Sentiment Index (UMCSENT) - **CONSUMER_INFLATION_EXPECTATIONS**: Consumer Inflation Expectations (MICH) - **RETAIL_SALES**: Retail Sales (RSXFS) - **DURABLE_GOODS**: Durable Goods Orders (DGORDER) - **INDUSTRIAL_PRODUCTION**: Industrial Production Index (INDPRO) - **SMOOTHED_RECESSION_PROBABILITIES**: Smoothed Recession Probabilities (RECPROUSM156N) - **CORE_CPI**: Core CPI - All Items Less Food and Energy (CPILFESL) - **TIPS_5_YEAR**: 5-Year Treasury Inflation-Indexed Security (DFII5) - **TIPS_10_YEAR**: 10-Year Treasury Inflation-Indexed Security (DFII10) - **TIPS_20_YEAR**: 20-Year Treasury Inflation-Indexed Security (DFII20) - **TIPS_30_YEAR**: 30-Year Treasury Inflation-Indexed Security (DFII30) - **VIX**: CBOE Volatility Index (VIXCLS) - **TREASURY_YIELD_1_MONTH**: 1-Month Treasury Constant Maturity Rate (DGS1MO) - **TREASURY_YIELD_3_MONTH**: 3-Month Treasury Constant Maturity Rate (DGS3MO) - **TREASURY_YIELD_6_MONTH**: 6-Month Treasury Constant Maturity Rate (DGS6MO) - **TREASURY_YIELD_2_YEAR**: 2-Year Treasury Constant Maturity Rate (DGS2) - **TREASURY_YIELD_5_YEAR**: 5-Year Treasury Constant Maturity Rate (DGS5) - **TREASURY_YIELD_10_YEAR**: 10-Year Treasury Constant Maturity Rate (DGS10) - **TREASURY_YIELD_20_YEAR**: 20-Year Treasury Constant Maturity Rate (DGS20) - **TREASURY_YIELD_30_YEAR**: 30-Year Treasury Constant Maturity Rate (DGS30) - **GOLD_VIX**: CBOE Gold ETF Volatility Index (GVZCLS) - **CRUDE_OIL_VIX**: CBOE Crude Oil ETF Volatility Index (OVXCLS) - **RUSSELL_2000_VIX**: CBOE Russell 2000 Volatility Index (RVXCLS) **Time Filter Types** - **OBSERVED_AT**: Filter by observation publish timestamp (when data was released to FRED) - **CALENDAR_START_DATE**: Filter by the calendar date that the observation represents (e.g., 2024-01-01 for Q1 2024) - **RELEASE_DATE**: Filter by release/vintage date (when the data revision was published by FRED) **Response Structure** The response contains two parts: - **series**: Metadata about the indicator (name, title, seasonal adjustment (e.g., "Seasonally Adjusted Annual Rate", "Seasonally Adjusted", "Not Seasonally Adjusted"), frequency, units, notes) - **observations**: Array of data points, each containing: - **date**: Calendar date of the observation (ISO 8601 format, e.g., "2024-01-01") - **value**: Indicator value (double precision) - **releaseDate**: First release date in ISO 8601 format (e.g., "2024-04-25") - **observedAt**: Observation publish timestamp (Unix timestamp in seconds, e.g., 1714041000) **Usage Examples** 1. **Get GDP data by observed_at (publish time)**: `?indicator_type=GDP&time_type=OBSERVED_AT&start_time=1704067200&end_time=1735689600` 2. **Get GDP data by calendar date**: `?indicator_type=GDP&time_type=CALENDAR_START_DATE&start_time=1704067200&end_time=1735689600` **Important Notes** - All parameters are required (indicator_type, time_type, start_time, end_time) - Timestamps are Unix timestamps in seconds (UTC) - CALENDAR_START_DATE filter is recommended for most use cases - OBSERVED_AT filter is useful for tracking when data was published/updated - Release dates indicate when data first appeared (initial release, not revisions) - Seasonal adjustment info helps interpret the data correctly parameters: - description: Indicator type (enum, required) in: query name: indicator_type required: true schema: type: string enum: - GDP - REAL_GDP - REAL_GDP_PER_CAPITA - INITIAL_CLAIMS - UNEMPLOYMENT_RATE - TOTAL_NONFARM_PAYROLL - FEDERAL_FUNDS - CPI - INFLATION_RATE_YOY - CORE_PPI - PPI_FINAL_DEMAND - CONSUMER_SENTIMENT - CONSUMER_INFLATION_EXPECTATIONS - RETAIL_SALES - DURABLE_GOODS - INDUSTRIAL_PRODUCTION - SMOOTHED_RECESSION_PROBABILITIES - CORE_CPI - TIPS_5_YEAR - TIPS_10_YEAR - TIPS_20_YEAR - TIPS_30_YEAR - VIX - TREASURY_YIELD_1_MONTH - TREASURY_YIELD_3_MONTH - TREASURY_YIELD_6_MONTH - TREASURY_YIELD_2_YEAR - TREASURY_YIELD_5_YEAR - TREASURY_YIELD_10_YEAR - TREASURY_YIELD_20_YEAR - TREASURY_YIELD_30_YEAR - GOLD_VIX - CRUDE_OIL_VIX - RUSSELL_2000_VIX - description: Time filter type (enum, required) in: query name: time_type required: true schema: type: string enum: - OBSERVED_AT - CALENDAR_START_DATE - RELEASE_DATE - description: Start time (Unix timestamp in seconds) in: query name: start_time required: true schema: type: integer format: int64 - description: End time (Unix timestamp in seconds) in: query name: end_time required: true schema: type: integer format: int64 responses: '200': description: Successfully retrieved economic indicators content: application/json: schema: allOf: - $ref: '#/components/schemas/model.APIResponse' - properties: data: items: $ref: '#/components/schemas/model.EconomicIndicatorsDataV2' type: array type: object '400': description: Parameter validation error content: application/json: schema: allOf: - $ref: '#/components/schemas/model.APIResponse' - properties: error: $ref: '#/components/schemas/model.APIError' type: object '404': description: Indicator not found content: application/json: schema: allOf: - $ref: '#/components/schemas/model.APIResponse' - properties: error: $ref: '#/components/schemas/model.APIError' type: object '500': description: Internal server error content: application/json: schema: allOf: - $ref: '#/components/schemas/model.APIResponse' - properties: error: $ref: '#/components/schemas/model.APIError' type: object security: - ApiKeyAuth: [] components: schemas: model.APIResponse: properties: data: {} error: $ref: '#/components/schemas/model.APIError' metadata: {} pagination: {} request_id: type: string success: type: boolean type: object model.EconomicIndicatorsDataV2: properties: observations: description: Observation data points items: $ref: '#/components/schemas/model.EconomicIndicatorObservation' type: array series: allOf: - $ref: '#/components/schemas/model.EconomicIndicatorSeries' description: Series metadata type: object model.APIError: properties: code: example: RESOURCE_NOT_FOUND type: string details: items: $ref: '#/components/schemas/model.APIErrorDetail' type: array docs_url: type: string examples: items: type: string type: array hint: type: string message: example: The requested resource was not found. type: string suggestions: items: type: string type: array type: object model.EconomicIndicatorObservation: properties: date: description: Observation date (ISO 8601) example: '2024-01-15' type: string observed_at: description: Observation publish timestamp (Unix timestamp in seconds) example: 1714041000 type: integer release_date: description: First release date (ISO 8601) example: '2024-04-25' type: string value: description: Indicator value example: 28284.498 type: number type: object model.EconomicIndicatorSeries: properties: frequency: description: Data frequency example: Quarterly type: string name: description: Series ID (e.g., "GDP") example: GDP type: string notes: description: Series notes/description type: string seasonal_adjustment: description: Seasonal adjustment type example: Seasonally Adjusted Annual Rate type: string title: description: Series title example: Gross Domestic Product type: string units: description: Data units example: Billions of Dollars type: string type: object model.APIErrorDetail: properties: field: type: string got: type: string reason: type: string type: object securitySchemes: ApiKeyAuth: description: 'API Key authentication. Example: "your-api-key-here"' in: header name: X-API-Key type: apiKey ````