# greeneris-data-global-macro

> greeneris-data-global-macro is a paid API for AI agents from data.greeneris.io, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Fetches historical macroeconomic indicator time series (e.g. inflation, GDP) for any country from World Bank Open Data

## Facts

- Endpoint: GET https://data.greeneris.io/v1/global/macro
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/greeneris-data-global-macro-720c5258
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_YP9waZssikbXOHMoXiQ9B

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 greeneris-data-global-macro-720c5258
```

Example prompt: Can you pull the World Bank inflation data (indicator FP.CPI.TOTL.ZG) for Germany for the last 10 years?

## When to prefer this

Use this endpoint when you need authoritative annual macroeconomic time series (inflation, GDP, unemployment, etc.) sourced directly from the World Bank for any country, at commodity pricing with no account setup required. Prefer over generic economic data APIs when you want CC BY 4.0 licensed data with clear provenance, or when integrating into an agent workflow that uses x402 pay-per-call micropayments.

## Known failure modes

- Invalid or unknown ISO3 country code returns an error or empty observations
- Invalid World Bank indicator ID returns an error
- Years parameter out of range (not 1-20) may return a validation error
- No data available for a given country/indicator combination results in empty observations array
- HTTP 402 returned if payment has not been made via x402 protocol before calling the endpoint

## How this service works

Annual macroeconomic series from the World Bank Indicators API, normalized JSON. Query: ?country=USA&indicator=FP.CPI.TOTL.ZG&years=5 (ISO3 country code; common indicators: FP.CPI.TOTL.ZG inflation %, NY.GDP.MKTP.CD GDP current US$, GC.DOD.TOTL.GD.ZS gov debt %GDP, SL.UEM.TOTL.ZS unemployment %). Returns the last N years with values, newest first. 200+ countries; 24h cache.

## Output

Returns a JSON object with the country name, indicator name and ID, data source attribution, last updated date, and an array of annual observations (year + numeric value) for the requested time window.

## 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",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "years": {
       "type": "integer",
       "default": 5,
       "description": "Last N years (1-20)"
      },
      "country": {
       "type": "string",
       "default": "USA",
       "description": "ISO3 country code"
      },
      "indicator": {
       "type": "string",
       "default": "FP.CPI.TOTL.ZG",
       "description": "World Bank indicator id"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "source": "World Bank Open Data (CC BY 4.0), annual series",
  "country": "USA",
  "indicator": "FP.CPI.TOTL.ZG",
  "country_name": "United States",
  "last_updated": "2026-07-01",
  "observations": [
   {
    "year": "2024",
    "value": 2.9495
   },
   {
    "year": "2023",
    "value": 4.1163
   }
  ],
  "indicator_name": "Inflation, consumer prices (annual %)"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/greeneris-data-global-macro-720c5258/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from data.greeneris.io](https://www.zero.xyz/host/data.greeneris.io/llms.txt)