global-macro-data 2.0.0

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

The Global Macro Database (Python Package)

This package provides Python access to the Global Macro Database (GMD).

Installation

Install the latest published release from PyPI:

pip install global-macro-data

Install the latest code directly from GitHub:

pip install git+https://github.com/KMueller-Lab/Global-Macro-Database-Python.git

Install a specific Git ref from GitHub:

pip install git+https://github.com/KMueller-Lab/Global-Macro-Database-Python.git@<tag-or-commit>

Updating

Upgrade an existing PyPI install:

pip install --upgrade global-macro-data

Upgrade an existing GitHub install:

pip install --upgrade --force-reinstall git+https://github.com/KMueller-Lab/Global-Macro-Database-Python.git

Quick Start

from global_macro_data import gmd

# Latest dataset
full_df = gmd()

# Specific vintage
df = gmd(version="2025_12")

# Filter countries and variables
subset = gmd(
    version="2025_12",
    country=["USA", "CHN"],
    variables=["rGDP", "infl", "unemp"],
)

# Raw source-level data for one variable
raw_rgdp = gmd(variables="rGDP", raw=True, version="2025_12")

# Load helper tables
varlist_df = gmd(vars="load")
country_df = gmd(country="load")
source_df = gmd(sources="load")
bib_df = gmd(cite="load")

# Print citations
gmd(cite="GMD")
gmd(print_option="GMD")

API Reference

The gmd() function supports the following options:

Parameter	Values	Description
version	"YYYY_MM", "current", "list"	Select data vintage
country	ISO3 code(s), "load", "list"	Filter by country
variables	Variable code(s)	Select specific variables
raw	True / False	Load raw source-level data
vars	"load", "list"	Load or display variable definitions
sources	Source name, "load", "list"	Query specific data sources
cite	Source key, "load"	Retrieve BibTeX citations
print_option	"GMD", "Stata"	Print APA-style citations
fast	"yes" or True	Cache data locally for faster reloading
network	"yes"	Override network detection

Helper functions are also available:

• get_available_versions() -- list all data vintages
• get_current_version() -- get the latest version string
• list_variables() -- print the variable table
• list_countries() -- print the country table

Citation

When using the Global Macro Database, please cite:

@techreport{mueller2025global,
    title = {The Global Macro Database: A New International Macroeconomic Dataset},
    author = {M{\"u}ller, Karsten and Xu, Chenzi and Lehbib, Mohamed and Chen, Ziliang},
    year = {2025},
    institution = {National Bureau of Economic Research},
    type = {Working Paper},
    number = {33714}
}