Skip to main content

Global Macro Database by Karsten Müller, Chenzi Xu, Mohamed Lehbib and Ziliang Chen (2025)

Project description

The Global Macro Database (Python Package)

Website Badge

License: MIT

Link to paper 📄

This repository complements paper, Müller, Xu, Lehbib, and Chen (2025), which introduces a panel dataset of 46 macroeconomic variables across 243 countries from historical records beginning in the year 1086 until 2024, including projections through the year 2030.

Features

  • Unparalleled Coverage: Combines data from 32 contemporary sources (e.g., IMF, World Bank, OECD) with 78 historical datasets.
  • Extensive Variables: GDP, inflation, government finance, trade, employment, interest rates, and more.
  • Harmonized Data: Resolves inconsistencies and splices all available data together.
  • Scheduled Updates: Regular releases ensure data reliability.
  • Full Transparency: All code is open source and available in this repository.
  • Accessible Formats: Provided in .dta, .csv and as Stata /Python/R package.

Data access

Download via website

Python package:

pip install global_macro_data

How to use (examples)

from global_macro_data import gmd

# Get preview data (Singapore 2000-2020)
df = gmd()

# Get data from latest available version
df = gmd(show_preview=False)

# Get data from a specific version
df = gmd(version="2025_01")

# Get data for a specific country
df = gmd(country="USA")

# Get data for multiple countries
df = gmd(country=["USA", "CHN", "DEU"])

# Get specific variables
df = gmd(variables=["rGDP", "infl", "unemp"])

# Combine parameters
df = gmd(version="2025_01", country=["USA", "CHN"], variables=["rGDP", "unemp", "CPI"])

Parameters

  • version (str): Dataset version in format 'YYYY_MM' (e.g., '2025_01'). If None, the latest dataset is used.
  • country (str or list): ISO3 country code(s) (e.g., "SGP" or ["MRT", "SGP"]). If None, returns all countries.
  • variables (list): List of variable codes to include (e.g., ["rGDP", "unemp"]). If None, all variables are included.
  • show_preview (bool): If True and no other parameters are provided, shows a preview.

Release schedule

Release Date Details
2025-01-30 Initial release: 2025_01
2025-04-01 2025_03
2025-07-01 2025_06
2025-10-01 2025_09
2026-01-01 2025_12

Citation

To cite this dataset, please use the following reference:

@techreport{mueller2025global, 
    title = {The Global Macro Database: A New International Macroeconomic Dataset}, 
    author = {Müller, Karsten and Xu, Chenzi and Lehbib, Mohamed and Chen, Ziliang}, 
    year = {2025}, 
    type = {Working Paper}
}

Acknowledgments

The development of the Global Macro Database would not have been possible without the generous funding provided by the Singapore Ministry of Education (MOE) through the PYP grants (WBS A-0003319-01-00 and A-0003319-02-00), a Tier 1 grant (A-8001749- 00-00), and the NUS Risk Management Institute (A-8002360-00-00). This financial support laid the foundation for the successful completion of this extensive project.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

global_macro_data-0.3.1.tar.gz (5.6 kB view details)

Uploaded Source

Built Distribution

global_macro_data-0.3.1-py3-none-any.whl (6.1 kB view details)

Uploaded Python 3

File details

Details for the file global_macro_data-0.3.1.tar.gz.

File metadata

  • Download URL: global_macro_data-0.3.1.tar.gz
  • Upload date:
  • Size: 5.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.12.5

File hashes

Hashes for global_macro_data-0.3.1.tar.gz
Algorithm Hash digest
SHA256 1d5945af95455590cd98b3b15226dafe88e3b0b1bcd289c0a82ebef896cfd493
MD5 940827d2f17aa0512175b63a6ecf209b
BLAKE2b-256 4f528037f914dadafb8c5d3ce22f2c14bbfb2d4f03d2a5fe3a0e0ceff9121031

See more details on using hashes here.

File details

Details for the file global_macro_data-0.3.1-py3-none-any.whl.

File metadata

File hashes

Hashes for global_macro_data-0.3.1-py3-none-any.whl
Algorithm Hash digest
SHA256 31aac726b1fde35ecc263e62e1bace80d37ca42b554c329da53074b186f0a375
MD5 cd9f030985ce42ed02ddc610780775f2
BLAKE2b-256 f4eb1ba05ae961773dc32bd1c2051a720aec719e2d40110a7a92e7b5cc8f45f9

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page