Global Macro Database by Karsten Müller, Chenzi Xu, Mohamed Lehbib and Ziliang Chen (2025)
Project description
The Global Macro Database (Python Package)
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
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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1d5945af95455590cd98b3b15226dafe88e3b0b1bcd289c0a82ebef896cfd493 |
|
MD5 | 940827d2f17aa0512175b63a6ecf209b |
|
BLAKE2b-256 | 4f528037f914dadafb8c5d3ce22f2c14bbfb2d4f03d2a5fe3a0e0ceff9121031 |
File details
Details for the file global_macro_data-0.3.1-py3-none-any.whl
.
File metadata
- Download URL: global_macro_data-0.3.1-py3-none-any.whl
- Upload date:
- Size: 6.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.12.5
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 31aac726b1fde35ecc263e62e1bace80d37ca42b554c329da53074b186f0a375 |
|
MD5 | cd9f030985ce42ed02ddc610780775f2 |
|
BLAKE2b-256 | f4eb1ba05ae961773dc32bd1c2051a720aec719e2d40110a7a92e7b5cc8f45f9 |