# Citiview Macroeconomic Indicators API

> Citiview Macroeconomic Indicators API is a paid API for AI agents from agents.citiviewgroup.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-14).

Returns macroeconomic indicators for any country — GDP, inflation, unemployment, debt, and more — sourced from IMF World Economic Outlook and World Bank, including forecasts.

## Facts

- Endpoint: GET https://agents.citiviewgroup.com/v1/economy?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/citiview-macroeconomic-indicators-api-bbfd02e7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_8mqXYMAeoYQSwLFZNxB2R

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 citiview-macroeconomic-indicators-api-bbfd02e7
```

Example prompt: Pull the GDP growth, inflation, and unemployment rates for Germany from 2018 to 2024, including IMF forecasts.

## When to prefer this

Choose this endpoint when you need reliable, multi-indicator macroeconomic time-series data for any country, especially when IMF forecasts or World Bank metrics are required. It is ideal for country risk analysis, economic research, investment due diligence, or building economic dashboards. Prefer this over general web search when you need structured, consistently formatted historical and forecast data from authoritative sources like the IMF and World Bank.

## Known failure modes

- Invalid or unrecognized country ISO code returns an error or empty result
- Unsupported indicator name in the comma-separated list may be ignored or return an error
- Year range outside available data coverage returns partial or empty data
- Network or payment authorization failure results in a 402 or 5xx error
- Requesting too many indicators simultaneously may degrade response completeness

## How this service works

Macroeconomic indicators for any country: GDP growth, inflation, unemployment, GDP, GDP per capita, government debt, budget balance, current account and population (IMF World Economic Outlook, including forecasts), plus World Bank interest rates, exports, FDI and more; ECB policy rate for euro countries.

## Output

Returns a structured JSON object with time-series values for each requested macroeconomic indicator (e.g. GDP growth %, inflation %, unemployment %, government debt % of GDP) for the specified country and year range, sourced from IMF World Economic Outlook (including forecasts), World Bank, and ECB where applicable.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "country"
     ],
     "properties": {
      "to": {
       "type": "integer"
      },
      "from": {
       "type": "integer"
      },
      "country": {
       "type": "string",
       "description": "ISO code, e.g. US, CA, DE, JPN"
      },
      "indicators": {
       "type": "string",
       "description": "Comma list: gdp_growth, inflation, unemployment, gdp_usd_billions, gdp_per_capita_usd, government_debt_pct_gdp, budget_balance_pct_gdp, current_account_pct_gdp, population_millions, lending_rate, real_interest_rate, exports_pct_gdp, fdi_inflows_usd, internet_users_pct, life_expectancy"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/citiview-macroeconomic-indicators-api-bbfd02e7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.citiviewgroup.com](https://www.zero.xyz/host/agents.citiviewgroup.com/llms.txt)