Sign in
OpenAPI 3.1.0Proprietary2026-08-201,5563,2076.4 MB

652554d2aae1

Global Economy & Trade

IMF SDMX 3.0 generic time series

Fetch an IMF SDMX 3.0 time series via the public API (no key).

Source: International Monetary Fund. See /imf/dataflows for families and /imf/dataflows/{dataflow} for the valid indicator codes.

get/api/v1/imf/series/{dataflow}/{country}

Path parameters

dataflowstring required

Family slug: bop, irfcl, fsi, gfs, pcps, or cpi.

Family slug: bop, irfcl, fsi, gfs, pcps, or cpi.

countrystring required

Reporter: ISO3 code, snake_case name, region alias, or 'all'. PCPS commodity prices are global - use 'world' or 'all' with a pinned indicator.

Reporter: ISO3 code, snake_case name, region alias, or 'all'. PCPS commodity prices are global - use 'world' or 'all' with a pinned indicator.

Query parameters

indicatorstring nullable

Indicator code from /imf/dataflows/{dataflow} (for CPI this is the COICOP expenditure code). Omit to fetch all indicators (bounded to the latest N). Required when country is 'all'.

Example:CP01

Indicator code from /imf/dataflows/{dataflow} (for CPI this is the COICOP expenditure code). Omit to fetch all indicators (bounded to the latest N). Required when country is 'all'.

frequencystring nullable

month, quarter, annual, or an SDMX code (A/Q/M).

month, quarter, annual, or an SDMX code (A/Q/M).

start_datestring nullable

Inclusive lower bound (YYYY-MM-DD).

Inclusive lower bound (YYYY-MM-DD).

end_datestring nullable

Inclusive upper bound (YYYY-MM-DD).

Inclusive upper bound (YYYY-MM-DD).

limitinteger nullable

Most-recent N observations per series.

Most-recent N observations per series.

filtersstring nullable

Pin extra dimensions, comma-separated DIMENSION:CODE. Use a dimension the chosen dataflow has (see /imf/dataflows/{dataflow}): e.g. TYPE_OF_TRANSFORMATION:IX for cpi, SECTOR:S1311 for gfs, BOP_ACCOUNTING_ENTRY:B_CA for bop.

Example:TYPE_OF_TRANSFORMATION:IX

Pin extra dimensions, comma-separated DIMENSION:CODE. Use a dimension the chosen dataflow has (see /imf/dataflows/{dataflow}): e.g. TYPE_OF_TRANSFORMATION:IX for cpi, SECTOR:S1311 for gfs, BOP_ACCOUNTING_ENTRY:B_CA for bop.

Response

Time series for one IMF SDMX dataflow family, country, and indicator.

dataStubData required

Response shape not yet documented; fields are returned as-is.

Example response

{
  "meta": {
    "endpoint": "/api/v1/fred/us/cpi",
    "data_time": "2026-04-16T14:30:00Z",
    "response_time": "2026-04-16T14:30:12Z",
    "provider": "Sugra API v1.0.1",
    "source": "sugra_crypto",
    "attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
    "fallback_chain": [
      "sugra_crypto",
      "sugra_finance"
    ]
  }
}