{"uid":"cap_pJvLsXP3QbkuoSAFpU94Y","slug":"imf-datamapper-series-fetcher-bd6576e1","name":"IMF DataMapper Series Fetcher","description":"Returns one IMF DataMapper indicator (e.g. NGDP_RPCH real GDP growth) for one or more countries, optionally limited to a year range. Output has unit, per-country series of {year, value, forecast_flag}, and a top-level forecast_flag. A point is a forecast when year >= the current UTC year.","url":"https://imf-datamapper-series.x402supply.com/tools/get_series?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"endYear":{"type":"integer","maximum":2100,"minimum":1980,"description":"Last year to include"},"countries":{"type":"string","maxLength":200,"minLength":2,"description":"Comma-separated IMF country codes (ISO alpha-3), e.g. USA,DEU,JPN. Up to 20"},"indicator":{"type":"string","pattern":"^[A-Za-z0-9_.]+$","maxLength":40,"minLength":1,"description":"IMF indicator code, e.g. NGDP_RPCH. Find codes with search_indicators"},"startYear":{"type":"integer","maximum":2100,"minimum":1980,"description":"First year to include"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_l0OL-uX3_bI787hZniKTU","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns time-series data for a single IMF DataMapper indicator (e.g. real GDP growth) across one or more countries, with forecast flags and optional year range filtering.","exampleAgentPrompt":"Pull the IMF real GDP growth indicator NGDP_RPCH for USA, DEU, and JPN from 2000 to 2025, and flag which data points are forecasts.","exampleUseCases":[{"title":"G7 GDP growth comparison dashboard","prompt":"Get the IMF real GDP growth data (NGDP_RPCH) for USA, GBR, DEU, FRA, ITA, CAN, and JPN from 2015 to 2026 so I can compare how each G7 economy has grown and what the IMF projects going forward."},{"title":"Emerging market inflation trend analysis","prompt":"Fetch the IMF inflation indicator PCPIPCH for BRA, IND, ZAF, and MEX covering 2010 through 2025, and let me know which years are forecasts vs actual figures."},{"title":"Single country fiscal deficit series","prompt":"I need the IMF general government net lending/borrowing indicator GGXCNL_NGDP for the USA from 2000 to 2024 — just that one country, and tell me which recent years are IMF projections."}],"resultDescription":"A JSON object containing the indicator's unit label, a per-country map of year-value time series (each point carrying the year, numeric value, and a forecast boolean), and a top-level forecast_flag indicating whether any future projections are included. Forecast points are those where the year is >= the current UTC year.","failureModes":["Invalid or unrecognized IMF indicator code returns an error — use search_indicators to find valid codes","Invalid ISO alpha-3 country code causes missing or empty series for that country","Year range outside 1980–2100 is rejected by schema validation","Requesting more than 20 countries at once may be unsupported","Network timeout or upstream IMF DataMapper API unavailability","Payment failure (insufficient USDC) blocks the request"],"whenToPreferThis":"Use this endpoint when you need structured, per-country economic time-series data from the IMF DataMapper for a specific indicator — especially when you need both historical actuals and forward-looking IMF forecasts in a single call, with clear forecast flags. Prefer this over general web search or other economic data APIs when IMF-sourced authority and standardized indicator codes (like NGDP_RPCH, PCPIPCH) matter for your use case.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-16T12:30:06.994Z","isFirstParty":false,"canonicalSlug":"imf-datamapper-series-fetcher-bd6576e1"}