imfp

Tests PyPI Version Code style: black

imfp, by Christopher C. Smith, is a Python package for downloading data from the International Monetary Fund's RESTful JSON API.

📚 Full Documentation

Installation

pip install -q --upgrade imfp

Quick Start

import imfp

# Get list of available databases
databases = imfp.imf_databases()

# Get parameters for a specific database (e.g., PCPS - Primary Commodity Price System)
params = imfp.imf_parameters("PCPS")

# Fetch data with specific parameters
df = imfp.imf_dataset(
    database_id="PCPS",
    frequency=["A"],
    start_year=2000,
    end_year=2015
)

Key Features

  • Comprehensive access to IMF's extensive economic databases
  • Parameter discovery
  • Rate limit and bandwidth management
  • Returns data in pandas DataFrames

Contributing

We welcome contributions to improve imfp! Here's how you can help:

  1. If you find a bug, please open an issue
  2. To fix a bug:
    • Fork and clone the repository and open a terminal in the repository directory
    • Install uv with curl -LsSf https://astral.sh/uv/install.sh | sh
    • Install the dependencies with uv sync
    • Install a git hook to enforce conventional commits with curl -o- https://raw.githubusercontent.com/chriscarrollsmith/conventional-commits-git-hook/master/scripts/install.sh | sh
    • Create a fix, commit it with an "Angular-style Conventional Commit" message, and push it to your fork
    • Open a pull request to our main branch

Note that if you want to change and preview the documentation, you will need to install the Quarto CLI tool and run uv run great-docs build (or uv run great-docs preview).

Version incrementing, package building, testing, changelog generation, documentation rendering, publishing to PyPI, and Github release creation is handled automatically by the GitHub Actions workflow based on the commit messages.

Project links

Data verified by PyPI on Aug 2, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (2.0.0)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for chriscarrollsmith from gravatar.com chriscarrollsmith

Credits

Author: Christopher C. Smith

GitHub Statistics

Data verified by PyPI on Aug 2, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

MIT License (Apache License)

Requires

Python >=3.10

Tags

economics finance IMF API

Classifiers

Report project as malware

Download files

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

Source Distribution

imfp-1.3.1.tar.gz (32.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

imfp-1.3.1-py3-none-any.whl (26.3 kB view details)

Uploaded Python 3

File details

Details for the file imfp-1.3.1.tar.gz.

File metadata

  • Download URL: imfp-1.3.1.tar.gz
  • Upload date:
  • Size: 32.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for imfp-1.3.1.tar.gz
Algorithm Hash digest
SHA256 c312a9262c0a0afcd52a15adbe2e04b71335621d1dc61ccfaff815c2ef84df7b
MD5 d507a71028cc59c4ffb76a103888201a
BLAKE2b-256 bcf4e3d3e0900a506ead79909c7b4f3578aaf017fbfb4b0c738dd862b3cf0d42

See more details on using hashes here.

Provenance

The following attestation bundles were made for imfp-1.3.1.tar.gz:

Publisher: release.yml on Promptly-Technologies-LLC/imfp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file imfp-1.3.1-py3-none-any.whl.

File metadata

  • Download URL: imfp-1.3.1-py3-none-any.whl
  • Upload date:
  • Size: 26.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for imfp-1.3.1-py3-none-any.whl
Algorithm Hash digest
SHA256 cd08a28a41afeebfe5ffc850364bb51b7fb44b8acab83f2a10789eab747fcaab
MD5 290b9e9d8fb95569fb42ada3a81e4254
BLAKE2b-256 491fef6c45e4bea591fa8ece1b0f5dd5760ec6db957f34b88f38339a3331e397

See more details on using hashes here.

Provenance

The following attestation bundles were made for imfp-1.3.1-py3-none-any.whl:

Publisher: release.yml on Promptly-Technologies-LLC/imfp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

2.0.0

2 files

1.3.4

2 files

1.3.3

2 files

1.3.2

2 files

This release

1.3.1 This release

2 files

1.3.0

2 files

1.2.1

2 files

1.2.0

2 files

1.1.10

2 files

1.1.9

2 files

1.1.8

2 files

1.1.7

2 files

1.1.6

2 files

1.1.5

2 files

1.1.4

2 files

1.1.3

2 files

1.1.2

2 files

1.1.1

2 files

1.1.0

2 files

1.0.8

2 files

1.0.7

2 files

1.0.6

2 files

1.0.5

2 files

1.0.4

2 files

1.0.3

2 files

1.0.2

2 files

1.0.1

2 files

1.0.0

2 files

0.0.2

2 files

0.0.1

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page