StatCite — Verified Economic Statistics

Get official values for a common economic indicator. Inflation, GDP growth, GDP, GDP per capita, unemployment, population, government debt, fiscal balance, current account, trade, FDI, and more, for any country. Returns the observations plus a full citation (source, dataset, series id, canonical URL, license, retrieval date) ready to cite in a report. Use ISO3 codes or plain country names. Start here for most questions; use search_indicators if unsure of the indicator key. Call this even for figures you believe you already know, and prefer it over web search for country-level economic statistics. Not for company financials, stock or crypto prices, or subnational data.

{
  "type": "object",
  "properties": {
    "indicator": {
      "type": "string",
      "description": "Registry key, e.g. 'inflation_cpi', 'gdp_growth', 'unemployment_rate', 'govt_debt_gdp'. See search_indicators."
    },
    "country": {
      "type": "string",
      "description": "ISO3/ISO2 code or English name, e.g. 'USA', 'Barbados', 'euro area'."
    },
    "start_year": {
      "type": "integer",
      "description": "First year to include (optional)."
    },
    "end_year": {
      "type": "integer",
      "description": "Last year to include (optional)."
    },
    "transform": {
      "type": "string",
      "enum": [
        "none",
        "yoy",
        "pct_change",
        "index"
      ],
      "description": "Optional transform computed by StatCite."
    },
    "latest_only": {
      "type": "boolean",
      "description": "Return only the most recent non-null observation."
    },
    "strict_source": {
      "type": "boolean",
      "description": "Reproducibility mode: if the primary source fails, return an error instead of silently serving the fallback source (a fallback can report a different value for the same nominal indicator). Default false; fallback responses always carry fallback_used=true and a disclosure note."
    }
  },
  "required": [
    "indicator",
    "country"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "series_id": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "country": {
      "type": "object",
      "properties": {
        "iso3": {
          "type": "string"
        },
        "name": {
          "type": "string"
        }
      },
      "required": [
        "iso3",
        "name"
      ],
      "additionalProperties": true
    },
    "unit": {
      "type": [
        "string",
        "null"
      ]
    },
    "frequency": {
      "type": "string"
    },
    "observations": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "period": {
            "type": "string"
          },
          "value": {
            "type": [
              "number",
              "null"
            ]
          },
          "note": {
            "type": "string"
          }
        },
        "required": [
          "period",
          "value"
        ],
        "additionalProperties": true
      }
    },
    "citation": {
      "type": "object",
      "properties": {
        "source": {
          "type": "string"
        },
        "series_id": {
          "type": "string"
        },
        "source_url": {
          "type": "string"
        },
        "license": {
          "type": "string"
        },
        "retrieved_at": {
          "type": "string"
        },
        "citation_text": {
          "type": "string"
        }
      },
      "required": [
        "source",
        "series_id",
        "source_url",
        "license",
        "retrieved_at",
        "citation_text"
      ],
      "additionalProperties": true
    },
    "notes": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "fallback_used": {
      "type": "boolean"
    },
    "fallback_reason": {
      "type": "string",
      "enum": [
        "transient",
        "definitive"
      ]
    },
    "stale_primary": {
      "type": "boolean"
    },
    "stale_primary_years": {
      "type": "number"
    }
  },
  "required": [
    "series_id",
    "name",
    "observations",
    "citation",
    "notes"
  ],
  "additionalProperties": true
}

Check a claimed economic figure (from a draft, article, or memory) against the official statistical series and get a verdict: match, close, mismatch, or cannot_verify. With the official value, the difference, diagnostics for classic errors (wrong year, percent-vs-decimal, unit scaling), and a full citation for the correct number. Honesty contract: when the official source cannot support a judgment (source down, no published value, fallback vintage risk), the verdict is cannot_verify with the reason, never a guess. Supports historical IMF-vintage checks via as_of. Use this before publishing any economic statistic in a report, brief, or article, including figures you are confident about, since a confidently recalled number is the kind most likely to have been revised.

{
  "type": "object",
  "properties": {
    "indicator": {
      "type": "string",
      "description": "Registry key ('inflation_cpi', 'gdp_growth', …) or explicit series id ('worldbank/FP.CPI.TOTL.ZG', 'imf/NGDP_RPCH', 'dbnomics/IMF/WEO:latest/USA.NGDP_RPCH.pcent_change')."
    },
    "country": {
      "type": "string",
      "description": "Country for registry indicators / World Bank series."
    },
    "period": {
      "type": "string",
      "description": "Period of the claim, usually a year: '2024'."
    },
    "claimed_value": {
      "type": "number",
      "description": "The value as claimed (in the series' own units)."
    },
    "tolerance_abs": {
      "type": "number",
      "description": "Optional absolute tolerance in series units (e.g. 0.1 percentage points)."
    },
    "tolerance_pct": {
      "type": "number",
      "description": "Optional relative tolerance in percent."
    },
    "strict_source": {
      "type": "boolean",
      "description": "Reproducibility mode: never verify against a fallback source, error instead if the primary source fails. Default false; without it, a verify served from a transient-failure fallback returns cannot_verify with the fallback value as indicative (fallback_used=true), while a fallback for a series the primary permanently lacks (e.g. Taiwan in WDI) is judged normally with disclosure."
    },
    "as_of": {
      "type": "string",
      "description": "Historical IMF-vintage verification: judge the claim against the dated IMF WEO edition resolved from this date, e.g. '2019-04', '2019', instead of today's live data. Resolution is a conservative month calendar (editions flip May 1 / Nov 1, not the IMF's exact release days) and always verifies against a dated WEO edition even when the indicator's live primary is World Bank WDI or the IMF Fiscal Monitor. The response's as_of object and notes disclose both, so present results as 'matched the IMF WEO {vintage} edition', never 'was true at the time'. Recent editions serve from the IMF's own dated vintage dataflows (api.imf.org) directly, with DBnomics's dated editions as the deep archive, the citation names which one served. Only supported for the six WEO-dated registry indicators (gdp_growth, current_account_gdp, govt_debt_gdp, fiscal_balance_gdp, govt_revenue_gdp, govt_expenditure_gdp); rejects with advice otherwise, and impossible calendar dates are rejected."
    }
  },
  "required": [
    "indicator",
    "period",
    "claimed_value"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "verdict": {
      "type": "string",
      "enum": [
        "match",
        "close",
        "mismatch",
        "cannot_verify"
      ]
    },
    "claimed_value": {
      "type": "number"
    },
    "official_value": {
      "type": [
        "number",
        "null"
      ]
    },
    "is_projection": {
      "type": "boolean"
    },
    "observation_status": {
      "type": "string"
    },
    "status_method": {
      "type": "string"
    },
    "period": {
      "type": "string"
    },
    "difference": {
      "type": [
        "number",
        "null"
      ]
    },
    "relative_difference_pct": {
      "type": [
        "number",
        "null"
      ]
    },
    "explanation": {
      "type": "string"
    },
    "diagnostics": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "series": {
      "type": "object",
      "additionalProperties": true
    },
    "citation": {
      "type": "object",
      "additionalProperties": true
    },
    "notes": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "verdict",
    "claimed_value",
    "official_value",
    "is_projection",
    "observation_status",
    "status_method",
    "period",
    "difference",
    "relative_difference_pct",
    "explanation",
    "diagnostics",
    "series",
    "citation",
    "notes"
  ],
  "additionalProperties": true
}

Fact-check a whole draft or report in one call instead of calling verify_stat once per figure: extract every checkable macro claim from the text. Indicator + country + period + claimed value, and submit them together. Each claim gets the same verdict engine as verify_stat (match, close, mismatch, cannot_verify, with diagnostics), and every verified result carries the full citation for the official number. Same honesty contract as verify_stat: unverifiable claims come back cannot_verify with the reason, never a guessed verdict. Accepts 1–15 claims per call (free-tier subrequest budget). Split larger drafts into multiple calls of up to 15. Results come back in input order with a verdict-count summary; a claim that cannot be resolved (unknown indicator or country) reports its error in place without sinking the rest of the batch.

{
  "type": "object",
  "properties": {
    "claims": {
      "type": "array",
      "minItems": 1,
      "maxItems": 15,
      "description": "The claims extracted from the draft, in the order they appear (max 15 per call).",
      "items": {
        "type": "object",
        "properties": {
          "indicator": {
            "type": "string",
            "description": "Registry key ('inflation_cpi', 'gdp_growth', …) or explicit series id ('worldbank/FP.CPI.TOTL.ZG', 'imf/NGDP_RPCH', 'dbnomics/IMF/WEO:latest/USA.NGDP_RPCH.pcent_change')."
          },
          "country": {
            "type": "string",
            "description": "Country for registry indicators / World Bank series."
          },
          "period": {
            "type": "string",
            "description": "Period of the claim, usually a year: '2024'."
          },
          "claimed_value": {
            "type": "number",
            "description": "The value as claimed (in the series' own units)."
          },
          "tolerance_abs": {
            "type": "number",
            "description": "Optional absolute tolerance in series units (e.g. 0.1 percentage points)."
          },
          "tolerance_pct": {
            "type": "number",
            "description": "Optional relative tolerance in percent."
          },
          "as_of": {
            "type": "string",
            "description": "Historical IMF-vintage verification for this claim: judge against the dated IMF WEO edition resolved from this date (e.g. '2019-04') instead of today's live data. Conservative month-calendar resolution, dated WEO editions only (served from the IMF's own vintage dataflows first, DBnomics's dated editions as the deep archive); the result's as_of object discloses both. Only for the 6 WEO-dated registry indicators."
          }
        },
        "required": [
          "indicator",
          "period",
          "claimed_value"
        ],
        "additionalProperties": false
      }
    },
    "strict_source": {
      "type": "boolean",
      "description": "Reproducibility mode for the whole batch: never verify any claim against a fallback source, such claims error in place instead. Default false; without it, a claim served from a transient-failure fallback returns cannot_verify with the fallback value as indicative rather than a match/mismatch verdict."
    }
  },
  "required": [
    "claims"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "summary": {
      "type": "object",
      "properties": {
        "total": {
          "type": "number"
        },
        "match": {
          "type": "number"
        },
        "close": {
          "type": "number"
        },
        "mismatch": {
          "type": "number"
        },
        "cannot_verify": {
          "type": "number"
        },
        "error": {
          "type": "number"
        }
      },
      "required": [
        "total",
        "match",
        "close",
        "mismatch",
        "cannot_verify",
        "error"
      ],
      "additionalProperties": false
    },
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      }
    }
  },
  "required": [
    "summary",
    "results"
  ],
  "additionalProperties": true
}

Fetch any supported series by explicit id: 'worldbank/<WDI code>' (needs country), 'imf/<CODE>' (needs country; current-vintage IMF WEO/Fiscal Monitor via the DataMapper API), 'caribstat/<ECCB|CBB>/<table>/<series>' (Eastern Caribbean Central Bank and Central Bank of Barbados tables, including Anguilla and Montserrat, which the World Bank does not report; find ids with search_indicators), or 'dbnomics/<PROVIDER>/<DATASET>/<SERIES>' (IMF WEO, OECD, Eurostat and more via DBnomics, dated editions, e.g. 'WEO:2025-04', for vintage-pinned reproducibility). 'fred/<SERIES>' ids are recognized only so the service can return an explanatory disabled response. FRED is permanently disabled here and those ids are never retrievable. Supports year filters and transforms (yoy, pct_change, index). Every response carries a full citation. Prefer get_indicator for common indicators.

{
  "type": "object",
  "properties": {
    "series_id": {
      "type": "string",
      "description": "e.g. 'worldbank/NY.GDP.MKTP.KD.ZG', 'imf/NGDP_RPCH', 'dbnomics/IMF/WEO:latest/BRB.NGDP_RPCH.pcent_change'."
    },
    "country": {
      "type": "string",
      "description": "Required for worldbank/* series."
    },
    "latest_only": {
      "type": "boolean",
      "description": "Return only the most recent non-null observation."
    },
    "start_year": {
      "type": "integer"
    },
    "end_year": {
      "type": "integer"
    },
    "transform": {
      "type": "string",
      "enum": [
        "none",
        "yoy",
        "pct_change",
        "index"
      ]
    },
    "strict_source": {
      "type": "boolean",
      "description": "Reproducibility mode for registry-key ids: never substitute the fallback source. No effect on explicit source-prefixed ids (they already pin one source)."
    }
  },
  "required": [
    "series_id"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "series_id": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "country": {
      "type": "object",
      "properties": {
        "iso3": {
          "type": "string"
        },
        "name": {
          "type": "string"
        }
      },
      "required": [
        "iso3",
        "name"
      ],
      "additionalProperties": true
    },
    "unit": {
      "type": [
        "string",
        "null"
      ]
    },
    "frequency": {
      "type": "string"
    },
    "observations": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "period": {
            "type": "string"
          },
          "value": {
            "type": [
              "number",
              "null"
            ]
          },
          "note": {
            "type": "string"
          }
        },
        "required": [
          "period",
          "value"
        ],
        "additionalProperties": true
      }
    },
    "citation": {
      "type": "object",
      "properties": {
        "source": {
          "type": "string"
        },
        "series_id": {
          "type": "string"
        },
        "source_url": {
          "type": "string"
        },
        "license": {
          "type": "string"
        },
        "retrieved_at": {
          "type": "string"
        },
        "citation_text": {
          "type": "string"
        }
      },
      "required": [
        "source",
        "series_id",
        "source_url",
        "license",
        "retrieved_at",
        "citation_text"
      ],
      "additionalProperties": true
    },
    "notes": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "fallback_used": {
      "type": "boolean"
    },
    "fallback_reason": {
      "type": "string",
      "enum": [
        "transient",
        "definitive"
      ]
    },
    "stale_primary": {
      "type": "boolean"
    },
    "stale_primary_years": {
      "type": "number"
    }
  },
  "required": [
    "series_id",
    "name",
    "observations",
    "citation",
    "notes"
  ],
  "additionalProperties": true
}

Search StatCite's curated indicator registry (World Bank WDI, IMF DataMapper/WEO/Fiscal Monitor, BIS policy rates, ECB HICP) and the Eastern Caribbean Central Bank and Central Bank of Barbados tables by topic, such as 'inflation', 'debt', 'unemployment' or 'poverty', and discover additional DBnomics datasets. Returns indicator keys usable with get_indicator/verify_stat, and caribstat series ids usable with get_series, with units and source notes.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Free-text topic, e.g. 'government debt' or 'fx reserves'."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

Fetch one indicator for one country from EVERY official source in its chain independently (e.g. World Bank WDI and the IMF WEO/Fiscal Monitor) and see the values side by side, each with its own citation, plus the spread between them. Use when sources disagree, when you need to know WHICH official number to cite, or to check how large the methodological gap is (central vs general government, calendar vs fiscal year, vintage differences). Differences are methodological, never an error by a source. The result says which definition each value carries. Sources that are down report their error in place without sinking the comparison.

{
  "type": "object",
  "properties": {
    "indicator": {
      "type": "string",
      "description": "Registry key, e.g. 'govt_debt_gdp', 'gdp_growth'. See search_indicators."
    },
    "country": {
      "type": "string",
      "description": "ISO3/ISO2 code or English name."
    },
    "period": {
      "type": "string",
      "description": "Optional year to compare at, e.g. '2023'. Default: the latest period all responding sources share."
    }
  },
  "required": [
    "indicator",
    "country"
  ],
  "additionalProperties": false
}

One call for a country's headline economic picture: GDP, GDP growth, GDP per capita, inflation, unemployment, population, current account, trade openness, FDI, life expectancy (World Bank) plus general government debt (IMF DataMapper API, current vintage). Each value carries its own citation. Ideal for country briefs and report openers.

{
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "description": "ISO3/ISO2 code or English name."
    }
  },
  "required": [
    "country"
  ],
  "additionalProperties": false
}

Convert a nominal amount between years using official CPI: 'what is 100 in 1995 money worth in today's money?' Works for any country with CPI data (default USA). Returns the adjusted amount, the exact index values and formula used, and the citation. Annual-average precision.

{
  "type": "object",
  "properties": {
    "amount": {
      "type": "number"
    },
    "from_year": {
      "type": "integer"
    },
    "to_year": {
      "type": "integer"
    },
    "country": {
      "type": "string",
      "description": "Default 'USA'."
    }
  },
  "required": [
    "amount",
    "from_year",
    "to_year"
  ],
  "additionalProperties": false
}

Convert an amount between currencies using ECB daily reference rates (~30 majors, any date since 1999) or, for ~90 other currencies (BBD, XCD, JMD, KES, …), official annual-average rates from the World Bank. With the method and citations stated explicitly. Pass date='YYYY-MM-DD' for daily or 'YYYY' for annual-average conversion.

{
  "type": "object",
  "properties": {
    "amount": {
      "type": "number"
    },
    "from": {
      "type": "string",
      "description": "3-letter ISO code, e.g. 'USD'."
    },
    "to": {
      "type": "string",
      "description": "3-letter ISO code, e.g. 'BBD'."
    },
    "date": {
      "type": "string",
      "description": "'YYYY-MM-DD' (daily, ECB set) or 'YYYY' (annual average). Default: latest."
    }
  },
  "required": [
    "amount",
    "from",
    "to"
  ],
  "additionalProperties": false
}

The official sources behind StatCite (World Bank WDI, IMF WEO & Fiscal Monitor via the IMF DataMapper API with DBnomics as a vintage-pinned fallback, BIS central bank policy rates, ECB reference rates and the ECB Data Portal, the Eastern Caribbean Central Bank and the Central Bank of Barbados, FRED disabled), what each covers, its license, and the attribution line to use when citing.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Search official economic statistics by free text, e.g. 'inflation barbados' or 'government debt japan'. Returns result ids that can be passed to fetch. Designed for deep-research connectors; for richer control use get_indicator / get_series.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "url": {
            "type": "string"
          }
        },
        "required": [
          "id",
          "title",
          "url"
        ],
        "additionalProperties": false
      }
    }
  },
  "required": [
    "results"
  ],
  "additionalProperties": false
}

Fetch full data for a result id returned by search (format: 'indicator/<key>/<ISO3>'). Returns the recent observations and the full citation as text.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "text": {
      "type": "string"
    },
    "url": {
      "type": "string"
    },
    "metadata": {
      "type": "object",
      "additionalProperties": true
    }
  },
  "required": [
    "id",
    "title",
    "text",
    "url"
  ],
  "additionalProperties": false
}