macro-indicator
GET api.agentstools.dev/macro/indicator
Why an agent can trust this route.
Sonar evidence is advisory. Paid delivery is shown as verified only when paid probes are available; otherwise route estimates use the unpaid handshake as a clearly labeled proxy.
Observed outcomes
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.
Resource: api.agentstools.dev/macro/indicator
Network: eip155:8453 · Asset: 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 · Pay to: 0xF22e558a00D91Ee12A1F50C52186FecB8dDFf493
Payment methods: — · Last validation: 2026-09-14 07:15:53.431+00
{
"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"
}
}
},
"paymentRequirements": [
{
"raw": {
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"extra": {
"name": "USD Coin",
"version": "2"
},
"payTo": "0xF22e558a00D91Ee12A1F50C52186FecB8dDFf493",
"amount": "10000",
"scheme": "exact",
"network": "eip155:8453",
"maxTimeoutSeconds": 300
},
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"payTo": "0xF22e558a00D91Ee12A1F50C52186FecB8dDFf493",
"scheme": "exact",
"network": "eip155:8453",
"amountAtomic": "10000"
}
]
}Source catalog records are retained separately from live endpoint observations. Sonar score, uptime, and latency are advisory metrics. CDP indexing is not inferred from validation.