# Alpha Vantage Economic Indicator

> Alpha Vantage Economic Indicator is a paid API for AI agents from Alpha Vantage at alphavantage.mpp.paywithlocus.com, paid per call via MPP, $0.008/call, status unknown (last checked 2026-10-11).

Fetches US macroeconomic indicator time series data including GDP, CPI, inflation, unemployment, treasury yields, and more via Alpha Vantage.

## Facts

- Endpoint: POST https://alphavantage.mpp.paywithlocus.com/alphavantage/economic-indicator?utm_source=zero.xyz
- Price: $0.008/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Provider: Alpha Vantage
- Docs: https://www.alphavantage.co/documentation/
- Website: https://www.alphavantage.co
- Tags: finance, stocks, forex, crypto, market-data, technical-analysis, data
- Canonical page: https://www.zero.xyz/c/alpha-vantage-economic-indicator-9cb86403
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_8wlS5aI_YY3O4WXtgLmCu

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability alpha-vantage-economic-indicator-9cb86403 -d '<json body>'
```

Example prompt: Pull me the quarterly US Real GDP time series from Alpha Vantage so I can see how the economy has been trending over the past few years.

## When to prefer this

Use this endpoint when you need official US macroeconomic time series data such as GDP, CPI, inflation, federal funds rate, treasury yields, unemployment, retail sales, durable goods, or nonfarm payrolls. Prefer this over stock/forex endpoints when the user's question is about broad economic conditions rather than individual asset prices.

## Known failure modes

- Missing required 'indicator' field returns validation error
- Invalid indicator name (e.g. typo) returns API error
- Invalid interval for a given indicator (e.g. quarterly for UNEMPLOYMENT which only supports monthly) may return empty or error
- Invalid maturity value for TREASURY_YIELD returns error
- Network timeout or upstream Alpha Vantage outage returns 5xx error

## How this service works

US economic indicators — GDP, Treasury yield, CPI, inflation, unemployment, and more.

## Output

Returns a time series array of date-value pairs for the requested economic indicator (e.g. GDP in billions, CPI index, unemployment rate as percentage), covering multiple years of historical data at the specified interval (daily, weekly, monthly, quarterly, or annual).

## Example request

```json
{
 "datatype": "json",
 "interval": "quarterly",
 "indicator": "REAL_GDP"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "indicator"
 ],
 "properties": {
  "datatype": {
   "type": "string",
   "description": "\"json\" (default) or \"csv\""
  },
  "interval": {
   "type": "string",
   "description": "\"daily\", \"weekly\", \"monthly\", \"quarterly\", or \"annual\" (varies by indicator)"
  },
  "maturity": {
   "type": "string",
   "description": "Treasury yield maturity: \"3month\", \"2year\", \"5year\", \"7year\", \"10year\", \"30year\" (TREASURY_YIELD only)"
  },
  "indicator": {
   "type": "string",
   "description": "Indicator function: REAL_GDP, REAL_GDP_PER_CAPITA, TREASURY_YIELD, FEDERAL_FUNDS_RATE, CPI, INFLATION, RETAIL_SALES, DURABLES, UNEMPLOYMENT, NONFARM_PAYROLL"
  }
 },
 "additionalProperties": true
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/alpha-vantage-economic-indicator-9cb86403/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from alphavantage.mpp.paywithlocus.com](https://www.zero.xyz/host/alphavantage.mpp.paywithlocus.com/llms.txt)
