Skip to main content
fastCRW Pergamon
Statistics

IMF Data

api.imf.org

The International Monetary Fund's official statistics service: consumer prices, balance of payments, direction of trade, government finance, monetary and financial statistics, exchange rates, primary commodity prices, the World Economic Outlook database and around 225 other datasets, served as SDMX 3.0 time series for roughly 200 economies.

Showing the catalogue

1Request

Owning IMF department of the dataflow, for example IMF.STA.

Dataflow id, for example CPI or BOP.

Dataflow version, or latest for the newest one.

Dot-separated key constraining the question; * means no constraint, and something like USA.CPI.*.*.* asks what is available for the United States only.

Dimension whose values you want listed, by its id in the data structure, for example COUNTRY, FREQUENCY or INDEX_TYPE. Use * to list every dimension at once.

available returns the codes left once the key is applied; exact returns only those present in the exact combination asked for.

Pull the referenced codelists or data structure into the same reply instead of returning the constraint alone.

1 credit⌘ ↵
Code follows the fields above
curl "https://api.fastcrw.com/v1/data/imfdata/availability?agencyID=IMF.STA&dataflowId=CPI&version=latest&key=*&componentId=COUNTRY" \
  -H "Authorization: Bearer $FASTCRW_API_KEY"

2Response example

A sample shape. Press Run to see live data from IMF Data.

JSON
{
  "data": {
    "dataConstraints": [
      {
        "links": [
          {
            "urn": "urn:sdmx:org.sdmx.infomodel.registry.DataConstraint=IMF.STA:CPI(5.0.0)",
            "type": "dataconstraint",
            "rel": "self"
          }
        ],
        "annotations": [
          {
            "id": "series_count",
            "title": "28643",
            "type": "sdmx_metrics"
          },
          {
            "id": "time_period_start",
            "title": "1900-01-01",
            "type": "sdmx_metrics"
          },
          {
            "id": "time_period_end",
            "title": "2026-10-01",
            "type": "sdmx_metrics"
          }
        ],
        "id": "CPI",
        "name": "Data Constraint",
        "names": {
          "en": "Data Constraint"
        },
        "description": "Data Availability Constraint",
        "descriptions": {
          "en": "Data Availability Constraint"
        },
        "version": "5.0.0",
        "agencyID": "IMF.STA",
        "role": "Actual",
        "constraintAttachment": {
          "dataStructures": [
            "urn:sdmx:org.sdmx.infomodel.datastructure.DataStructure=IMF.STA:DSD_CPI(5.0.0)"
          ]
        },
        "cubeRegions": [
          {
            "include": true,
            "components": [
              {
                "id": "COUNTRY",
                "include": false,
                "removePrefix": false,
                "values": "[ 202 items ]"
              }
            ],
            "keyValues": [],
            "annotations": []
          }
        ]
      }
    ]
  },
  "meta": {
    "schema": "https://raw.githubusercontent.com/sdmx-twg/sdmx-json/master/metadata-message/tools/schemas/2.0.0/sdmx-json-metadata-schema.json",
    "id": "IDREF3554",
    "test": false,
    "prepared": "2026-10-22T01:23:19.210784201Z",
    "contentLanguages": [
      "en"
    ],
    "sender": {
      "id": "IMF"
    }
  }
}

Attribution: Source: International Monetary Fund, IMF Data (https://data.imf.org). IMF Data is reproduced under the IMF's Copyright and Usage terms; commercial reuse requires permission from copyright@imf.org.

Licence: The IMF’s Copyright and Usage terms carry a "Special Terms for Statistical Data (“Data”)" section that covers exactly what this provider serves: it names "IMF Statistical Data, including but not limited to, International Financial Statistics (IFS), Balance of Payments (BOP), Direction of Trade (DOT), and Government Finance Statistics (GFS)", the "World Economic Outlook database", "Primary Commodity Prices", "IMF Financial Data", "Exchange Rate Data", and "Most statistical data available on www.IMF.org, www.data.IMF.org, or the iData Portal that explicitly identify the International Monetary Fund as the source." For that Data the page states: "Users may download, extract, copy, create derivative works, publish, distribute, and use Data obtained from IMF Sites subject to these conditions:" — the conditions being that "Distributed or reproduced Data must appear accurately with attribution to the IMF as the source, e.g. “Source: International Monetary Fund, Database Name, <<link to the dataset>>.”"; that "Users shall not infringe upon the integrity of the Data and shall refrain from any act of alteration of the Data that intentionally affects its nature or accuracy. If material transformation occurs, it must be stated explicitly along with the required source citation."; that redistributors "agree to take reasonable efforts to communicate and promote compliance by their users with these terms"; and that "If IMF Data is sold by Users as a standalone product, sellers must inform purchasers that the Data is available free of charge from the IMF." Redistribution is therefore granted in writing, conditional on attribution — redistribution is true. Commercial use is NOT granted: the same section closes "For any potential commercial reuse of IMF Data, email copyright@imf.org to request permission", which is a permission process and not a licence, so commercialUse is false. Two prohibitions in the general terms bind any caller regardless: "The IMF prohibits bulk download of information by automated technology without explicit permission and reserves the right to terminate access to its Sites or Content", and "The IMF does not permit use of its Content or Sites for the training of large language models (LLMs) without explicit permission." We therefore proxy individual live SDMX queries against the IMF’s own published machine API and keep no corpus; callers who want commercial reuse, bulk harvesting, or model training must obtain that permission from copyright@imf.org themselves. Note that this grant is specific to statistical Data: for IMF Content that is not Data the general terms are far narrower, permitting only "Free non-systematic downloading and/or printing of Content for personal, noncommercial usage only ... without any right to resell, redistribute, compile, or create derivative works". The page also warns that "For material not attributed to the IMF, users should obtain permission directly from the respective third-party copyright holder."

Ask with this source

A prompt for your agent that names this source and how to call it through the crw MCP.

  • Available dimension values

    Use IMF Data (imfdata) from fastCRW Pergamon, capability "Available dimension values" (availability). You are assembling a series key and need to know which countries, indicators or frequencies really exist in that dataset rather than which are merely allowed. Example options: agencyID=IMF.STA, dataflowId=CPI, version=latest. Use the crw MCP tools: crw_find_data to confirm the source and its options, then crw_get_data with provider "imfdata" and capability "availability". Tell me the credits used and cite the licence from the response. If the crw MCP tools are missing, install them with: npx -y crw-mcp install --api-key <your fastCRW API key>

  • Dataset to category mappings

    Use IMF Data (imfdata) from fastCRW Pergamon, capability "Dataset to category mappings" (categorisations). You have a category from the subject tree and want the exact list of dataflows filed under it, or the reverse. Example options: detail=full. Use the crw MCP tools: crw_find_data to confirm the source and its options, then crw_get_data with provider "imfdata" and capability "categorisations". Tell me the credits used and cite the licence from the response. If the crw MCP tools are missing, install them with: npx -y crw-mcp install --api-key <your fastCRW API key>

  • Subject category tree

    Use IMF Data (imfdata) from fastCRW Pergamon, capability "Subject category tree" (categoryscheme). You want to browse IMF datasets by subject area instead of searching the flat catalogue by name. Example options: agencyID=IMF, categorySchemeId=DATASETS_BY_DOMAIN, version=latest. Use the crw MCP tools: crw_find_data to confirm the source and its options, then crw_get_data with provider "imfdata" and capability "categoryscheme". Tell me the credits used and cite the licence from the response. If the crw MCP tools are missing, install them with: npx -y crw-mcp install --api-key <your fastCRW API key>

  • Codelist codes

    Use IMF Data (imfdata) from fastCRW Pergamon, capability "Codelist codes" (codelist). You have a code from a series key or an observation and need its meaning, or you need the legal values for a dimension. Example options: agencyID=IMF, codelistId=CL_FREQ, version=latest. Use the crw MCP tools: crw_find_data to confirm the source and its options, then crw_get_data with provider "imfdata" and capability "codelist". Tell me the credits used and cite the licence from the response. If the crw MCP tools are missing, install them with: npx -y crw-mcp install --api-key <your fastCRW API key>