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.2.tar.gz (34.3 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.2-py3-none-any.whl (26.9 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: imfp-1.3.2.tar.gz
  • Upload date:
  • Size: 34.3 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.2.tar.gz
Algorithm Hash digest
SHA256 3d250b858d0d773dbb6cf2a6e68d43e8940cd2451105739ed739fbe80e500429
MD5 06855534723146aac69b556447a6fa4a
BLAKE2b-256 af0b58fa756f6a6b55ee1aa00fb6cedd2a055adf75e97597916fd0ce0b46c11c

See more details on using hashes here.

Provenance

The following attestation bundles were made for imfp-1.3.2.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.2-py3-none-any.whl.

File metadata

  • Download URL: imfp-1.3.2-py3-none-any.whl
  • Upload date:
  • Size: 26.9 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.2-py3-none-any.whl
Algorithm Hash digest
SHA256 422d6c8b0756e53dd8bb070ddd7e704ca1bf2c0d79be4e6942f8f76bf56167fd
MD5 7b57dddf105d4e17a06f7b99e2a7b3bc
BLAKE2b-256 4232db25e94e8ec6060f9b20e3aa4f0b8c0576a86171a4f7b83fc5ad0696fe73

See more details on using hashes here.

Provenance

The following attestation bundles were made for imfp-1.3.2-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

This release

1.3.2 This release

2 files

1.3.1

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