{"uid":"cap_Np7kyGtZcKW1PXPhTVbF7","slug":"payai-macro-indicator-time-series-b58e9f40","name":"PayAI 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://payai.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":1},"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_in-ToNrXfFjL8OIJUGGLF","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":"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.","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"Track inflation rates across major economies","prompt":"I need to compare how inflation has evolved in the US, UK, and eurozone countries over the past 15 years—can you pull those CPI time series with source attribution so I can see which regions faced the biggest price shocks?"},{"title":"Monitor renewable energy adoption by country","prompt":"Show me the electricity generation from renewables as a percentage of total electricity for Germany, Denmark, and Costa Rica over the last decade, with proper source citations so I can understand their clean energy transition progress."},{"title":"Analyze unemployment trends post-pandemic","prompt":"Can you fetch the unemployment rate time series for Canada, Australia, and South Korea from 2015 to now, so I can see how quickly they've recovered from the pandemic compared to pre-crisis levels?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T00:47:00.439Z","isFirstParty":false,"canonicalSlug":"payai-macro-indicator-time-series-b58e9f40"}