# PayAI Macro Indicator Time-Series

> PayAI Macro Indicator Time-Series is a paid API for AI agents from payai.agentstools.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-11).

Retrieves a cited time-series for one macroeconomic or development indicator across one or more countries, fusing World Bank and IMF data with source attribution per data point.

## Facts

- Endpoint: GET https://payai.agentstools.dev/macro/indicator?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/payai-macro-indicator-time-series-b58e9f40
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Np7kyGtZcKW1PXPhTVbF7

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 payai-macro-indicator-time-series-b58e9f40
```

Example prompt: Can you pull the GDP per capita time series for Brazil, India, and Nigeria from 2010 to 2023, using auto source selection, so I can compare their development trajectories?

## When to prefer this

Choose this endpoint when you need a focused, cited time-series for a specific indicator across one or more countries — especially when source attribution per data point matters. Prefer this over the country-basket endpoint when you need historical depth, multi-country comparison, or a single non-standard indicator. Use when you have a specific World Bank code or canonical indicator key and need clean, source-tagged data.

## Known failure modes

- Unknown indicator key returns an error suggesting valid canonical keys or raw World Bank codes
- Country name or code not recognized returns a validation error listing accepted formats
- No data available for the requested year range returns empty series or partial results
- Source parameter set to a provider that lacks data for the indicator falls back if auto, errors if forced
- Years parameter malformed (wrong format) returns a 400 validation error
- Rate limit or payment failure returns 402 Payment Required

## How this service works

One macroeconomic or development indicator for one or more countries as a cited time-series. Fuses free authoritative sources (World Bank, IMF) and tags every value with its source, source code, year and country ISO3. Accepts a canonical indicator key or a raw World Bank code.

## Output

Returns a time-series array of data points for the requested indicator and countries, where each point includes the year, country ISO3 code, numeric value, and full source attribution (source name, source code). Multiple countries produce parallel series in a single response.

## 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",
     "required": [
      "indicator",
      "country"
     ],
     "properties": {
      "range": {
       "type": "integer",
       "maximum": 65,
       "minimum": 1,
       "description": "Most recent N years (ignored when years is set)"
      },
      "years": {
       "type": "string",
       "description": "A single year or a Y1:Y2 range, e.g. 2015:2023"
      },
      "source": {
       "enum": [
        "auto",
        "worldbank",
        "imf",
        "fred"
       ],
       "type": "string",
       "description": "Preferred source (default auto = first with data)"
      },
      "country": {
       "type": "string",
       "description": "One or more countries as ISO-2, ISO-3, name, or a World Bank aggregate code, comma-separated"
      },
      "indicator": {
       "type": "string",
       "examples": [
        "gdp_current_usd",
        "gdp_per_capita_usd",
        "gdp_growth",
        "gni_per_capita_atlas",
        "gross_savings_gdp",
        "inflation_cpi",
        "real_interest_rate",
        "broad_money_gdp",
        "unemployment",
        "labor_force",
        "govt_debt_gdp",
        "govt_health_exp_gdp",
        "govt_education_exp_gdp",
        "trade_balance_gdp",
        "current_account_gdp",
        "exports_gdp",
        "imports_gdp",
        "fdi_net_inflows_gdp",
        "population",
        "population_growth",
        "life_expectancy",
        "gini",
        "poverty_headcount_national",
        "urban_population_pct",
        "co2_per_capita",
        "renewable_energy_pct",
        "electricity_access_pct",
        "internet_users_pct",
        "mobile_subscriptions_per_100"
       ],
       "description": "Canonical indicator key or a raw World Bank code such as NY.GDP.MKTP.CD"
      }
     }
    }
   },
   "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/payai-macro-indicator-time-series-b58e9f40/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from payai.agentstools.dev](https://www.zero.xyz/host/payai.agentstools.dev/llms.txt)