# agentstools.dev Macro Indicator Time-Series

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

Returns a cited macroeconomic or development indicator as a time-series for one or more countries, tagging each value with its source, year, and country ISO3.

## Facts

- Endpoint: GET https://api.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/agentstools-dev-macro-indicator-time-series-ad399e99
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_78I1U5rEKOULXJXrDSseC

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 agentstools-dev-macro-indicator-time-series-ad399e99
```

Example prompt: Can you pull the GDP per capita and inflation rate for Brazil, Argentina, and Chile from 2010 to 2023, citing the source for each data point?

## When to prefer this

Use this endpoint when you need authoritative, cited macroeconomic or development statistics for one or more countries over time, especially when data provenance and source attribution matter. Prefer this over general web search when you need structured, machine-readable time-series data from official sources like World Bank or IMF. Best suited for comparing indicators across countries or tracking trends over years.

## Known failure modes

- Unknown indicator key returns 400 with list of valid canonical keys
- Country code not recognized returns error suggesting ISO2/ISO3 alternatives
- No data available for the requested year range returns empty series or partial results
- Source preference (e.g. 'fred') may not cover non-US countries, falling back to auto
- Years parameter outside valid range returns 400 validation error
- Network or upstream World Bank/IMF API unavailability causes 5xx error

## 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

A time-series array of indicator values for each requested country, where every data point is tagged with the source (World Bank, IMF, or FRED), the source's own indicator code, the year, and the country's ISO3 code.

## 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/agentstools-dev-macro-indicator-time-series-ad399e99/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.agentstools.dev](https://www.zero.xyz/host/api.agentstools.dev/llms.txt)