{"uid":"cap_78I1U5rEKOULXJXrDSseC","slug":"agentstools-dev-macro-indicator-time-series-ad399e99","name":"agentstools.dev Macro Indicator Time-Series","description":"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.","url":"https://api.agentstools.dev/macro/indicator?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":{"p10Cents":"1.0000","medianCents":"1.0000","p90Cents":"1.0000","minCents":"1.0000","maxCents":"1.0000","p95Cents":"1.0000","sampleCount":1,"varies":false,"failureChargeRate":null},"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_hHaR6BEauIujhfjxJqove","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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?","exampleUseCases":null,"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T00:43:01.202Z","isFirstParty":false,"canonicalSlug":"agentstools-dev-macro-indicator-time-series-ad399e99"}