Statistical Data and Metadata eXchange (SDMX) in Python#
sdmx
is a Python package that implements SDMX 2.1 (ISO 17369:2013) and 3.0, which are standards and formats for exchange of statistical data and metadata that are developed and used by national statistical agencies, central banks, and international organisations.
sdmx
can be used to:
explore the data available from data providers such as the World Bank, International Monetary Fund, Eurostat, OECD, and United Nations;
read and write data and metadata in SDMX formats including SDMX-ML (XML) and SDMX-JSON, either:
from local files, or
retrieved from SDMX web services, with query validation and caching;
convert data and metadata into pandas objects, for use with the analysis, plotting, and other tools in the Python data science ecosystem;
apply the SDMX Information Model to your own data;
…and much more.
Get started#
The SDMX standards are designed to be flexible enough to accommodate almost any data. To do this, they include a large number of abstract concepts for describing data, metadata, and their relationships. These are collectively called the SDMX Information Model (IM).
This documentation does not repeat full descriptions of SDMX, the IM, or SDMX web services; it focuses on the Python implementation in sdmx
itself.
Detailed knowledge of the IM is not needed to use sdmx
; see a usage example in only 10 lines of code or a longer, narrative walkthrough.
To learn about SDMX in more detail, use the list of resources and references, or read the API documentation and implementation notes for the sdmx.model
and sdmx.message
modules that fully implement the IM in Python.
sdmx
user guide#
- Data sources
- Data source limitations
ABS
: Australian Bureau of Statistics (SDMX-ML)ABS_JSON
: Australian Bureau of Statistics (SDMX-JSON)BBK
: German Federal BankBIS
: Bank for International SettlementsECB
: European Central BankESTAT
: Eurostat and relatedILO
: International Labour OrganizationIMF
: International Monetary Fund’s “SDMX Central” sourceINEGI
: National Institute of Statistics and Geography (Mexico)INSEE
: National Institute of Statistics and Economic Studies (France)ISTAT
: National Institute of Statistics (Italy)LSD
: National Institute of Statistics (Lithuania)NB
: Norges Bank (Norway)NBB
: National Bank of Belgium (Belgium)OECD
: Organisation for Economic Cooperation and Development (SDMX-ML)OECD_JSON
: Organisation for Economic Cooperation and Development (SDMX-JSON)SGR
: SDMX Global RegistrySPC
: Pacific Data Hub DotStat by the Pacific Community (SPC)STAT_EE
: Statistics Estonia (Estonia)UNESCO
: UN Educational, Scientific and Cultural OrganizationUNICEF
: UN Children’s FundUNSD
: United Nations Statistics DivisionWB
: World Bank Group “World Integrated Trade Solution”WB_WDI
: World Bank Group “World Development Indicators”- Source API
- API reference
- Implementation notes
- How to…
- What’s new?
- v2.12.0 (2023-10-11)
- v2.11.0 (2023-08-04)
- v2.10.0 (2023-05-20)
- v2.9.0 (2023-04-30)
- v2.8.0 (2023-03-31)
- v2.7.1 (2023-03-09)
- v2.7.0 (2022-11-14)
- v2.6.3 (2022-09-29)
- v2.6.2 (2022-01-11)
- v2.6.1 (2021-07-27)
- v2.6.0 (2021-07-11)
- v2.5.0 (2021-06-27)
- v2.4.1 (2021-04-12)
- v2.4.0 (2021-03-28)
- v2.3.0 (2021-03-10)
- v2.2.1 (2021-02-27)
- v2.2.0 (2021-02-26)
- v2.1.0 (2021-02-22)
- v2.0.1 (2021-01-31)
- v2.0.0 (2021-01-26)
- v1.7 and earlier
- pandaSDMX (versions 0.9 and earlier)
- Development
Contributing and getting help#
Ask usage questions (“How do I?”) on Stack Overflow using the tag
[python-sdmx]
.Report bugs, suggest features, or view the source code on GitHub.
The older sdmx-python Google Group may have answers for some questions.