Skip to content

daxyquant/Global-Macro-Database

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

36 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

The Global Macro Database

Website Badge

License: CC BY-NC-SA 4.0

Link to paper 📄

This repository complements our 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) and 86 historical datasets, totaling 118 sources.
  • Extensive Variables: Covers national accounts, consumption, investment, trade, prices, government finances, interest rates, employment, and financial crises.
  • Transparent Source Prioritization: Prioritizes country-specific sources over international aggregators to ensure both historical depth and accuracy.
  • Harmonized Data: All data is cleaned, spliced, and chainlinked for consistent cross-country comparison.
  • Comprehensive Metadata: Variable definitions follow SNA 2008 standards and are documented in the technical appendix.
  • Frequent Updates: Quarterly releases with version control and changelogs.
  • Open Access & Tools: Access data via web, Python, R, or Stata packages. All processing code is open source.

Data Access

Download via Website

Stata package:

ssc install gmd
gmd rGDP, country(FRA)

Python package:

pip install global_macro_data
from global_macro_data import gmd
df = gmd(version="2025_09", country=["USA", "CHN"], variables=["rGDP", "CPI"])

R package:

install.packages("devtools")
devtools::install_github("KMueller-Lab/Global-Macro-Database-R")
library(globalmacrodata)
df <- gmd(version = "2025_09", country = c("USA", "CHN"), variables = c("rGDP", "CPI"))

Release Schedule

Release Date Version Details
2025-01-30 2025_01 Initial release
2025-03-31 2025_03 Legacy version
2025-06-30 2025_06 Legacy version
2025-08-23 2025_08 Legacy version (Patch)
2025-09-30 2025_09 Current version
2025-12-31 2025_12 Planned
2026-03-31 2026_03 Planned
2026-06-30 2026_06 Planned

Release Note (2025_09)

Overview

Released September 30, 2025. This quarterly update introduces improved government finance statistics, streamlined source handling, a new outlier detection process, and numerous fixes and small improvements.

Key changes

Improved Government Finance Statistics

  • Distinguishes between central and general government data
  • Included in the GMD as separate series and consolidated aggregates

Improved Download Infrastructure

  • Downloads now pull directly from IMF, Eurostat, OECD, and UN rather than dbnomics
  • IMF downloads now use the newly released API (3.0)

Pipeline Improvements

  • The GMD pipeline was overhauled
  • Runtime improved by approximately 10x

New and Improved Sources

  • Various IMF and OECD datasets are treated as a single "source" where appropriate
  • Added historical monetary statistics for France and unemployment series from Eurostat

Automated Error Checking

  • Automated checks now cover multiple error types across the dataset
  • Suspicious values are manually reviewed and confirmed

Bug Fixes

  • Thanks to many contributors, various small bugs were identified and fixed
  • Corrected systematic mistakes identified in the World Bank's WDI and IMF's FPP data

Citation

Please cite the dataset as:

@techreport{GMD2025,
  title = {The Global Macro Database: A New International Macroeconomic Dataset},
  author = {M{"u}ller, Karsten and Xu, Chenzi and Lehbib, Mohamed and Chen, Ziliang},
  institution = {National Bureau of Economic Research},
  type = {Working Paper},
  series = {Working Paper Series},
  number = {33714},
  year = {2025},
  month = {April},
  doi = {10.3386/w33714},
  URL = {http://www.nber.org/papers/w33714},
}

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.

License

The Global Macro Database (GMD) is licensed under the Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License (CC BY-NC-SA 4.0) . This means that the dataset is freely available for research and educational purposes but may not be used commercially.

Under this license, users are free to:

  • Share – copy and redistribute the material in any medium or format

  • Adapt – remix, transform, and build upon the material

  • These freedoms are granted under the following conditions:

    • Attribution – Appropriate credit must be given to the Global Macro Database (GMD), including a link to the license and indication of any changes made. Attribution must not imply endorsement.
    • NonCommercial – The material may not be used for commercial purposes.
    • ShareAlike – If you remix or build upon the material, you must distribute your contributions under the same license.

For licensing or usage inquiries, please contact us at hello@globalmacrodata.com.

About

This repository includes replication code and raw data used in the construction of the Global Macro Database.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • Stata 98.8%
  • TeX 1.2%