SDMXthon: the pythonic SDMX

SDMXthon is a library for parsing, validate and write SDMX documents.

Based on Pandas and written in python, it allows the conversion from different data formats, as CSV or JSON, and inputting the data straight from a Pandas Dataframe.

Main features of the library:

  • SDMX to Pandas Dataframe

  • SDMX metadata parsing

  • Data and metadata validation

  • Pandas Dataframe to SDMX

  • All SDMX-ML 2.1 formats supported


SDMXthon is designed upon the necessity of a python library that guarantees the conversion of data to SDMX from many formats and vice versa.

The philosophy to build it was to provide a simple way to parse and access the data and metadata, perform validations on it, modify the data if necessary using the Pandas infrastructure and provide an engine to write the SDMX-ML files.

For a quickstart, please head to the Walkthrough

Information Model

The library is based on the SDMX Information model. Same names for classes and properties have been used.

Access to the main features of SDMXthon

All access to parse the SDMX files are in the Api package

Classes of the library are in the Model package


To install the library, just run the following command:

pip install SDMXthon

It requires at least python 3.8