openbb-imf
https://datahelp.imf.org/knowledgebase/articles/630877-api
Decision gist · record as of 2026-08-14
Yes, if you are already using OpenBB and need IMF economic data. The extension integrates cleanly into the platform, has low install friction, and is actively maintained. However, the AGPL-3.0-only license requires that any code using this package (including derivative works) be open-sourced under the same license—a significant constraint for proprietary applications. If you are building closed-source software, you will need to either accept the license terms or find an alternative IMF data source.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10 or later.
- The openbb-build command must be run after installation to generate static assets before using the provider.
- Low friction installation as a pure-Python wheel.
License · maintenance · safety
AGPL-3.0-only (agpl) — Licensed under AGPL-3.0-only, which requires that any modifications or derivative works using this package must also be released under the same license and have source code made available. This is a copyleft restriction suitable for open-source projects but may conflict with proprietary software strategies.
last release 2026-05-26 (80 days)
0 known vulnerabilities (OSV.dev, 2026-08-14) · 86,656 downloads/mo, #13,845 on PyPI
Alternatives
Verify before relying
pip install openbb-imf
openbb-build
from openbb import obb
indicators = obb.economy.available_indicators(provider="imf", dataflows="CPI,PI")
data = obb.economy.indicators(provider="imf", symbol="CPI::CP01")- Whether openbb-core and openbb-platform-api are automatically installed or must be pre-configured separately.
- Performance characteristics when querying large datasets or making many concurrent requests via async-lru.
- Specific IMF data coverage limits or frequency update schedules not documented in the excerpt.
What it is and what it does
openbb-imf is a provider extension that plugs IMF data access into the OpenBB platform's economy module. It wraps the IMF's SDMX API (which organizes data into dataflows like CPI, trade, and shipping metrics) and translates it into OpenBB's standard symbol-based query interface. Instead of learning IMF's dimension-based parameter model, users construct simple ticker-like symbols (e.g., `CPI::CP01`) and call familiar OpenBB endpoints like `obb.economy.indicators()` or `obb.economy.cpi()`.
The extension handles the heavy lifting: it fetches and caches IMF metadata, validates user inputs against IMF's constraints API, converts IMF codes into human-readable labels, and returns results with both data and series metadata. It also exposes utility endpoints for discovering available dataflows, indicators, and presentation tables, which the OpenBB Workspace UI uses to populate dropdown menus. The package depends on openbb-core, openbb-economy, openbb-platform-api, async-lru for caching, and defusedxml for safe XML parsing.
Use it for
- Retrieve CPI or inflation data for multiple countries and time periods using standardized symbol syntax without learning IMF's SDMX parameter model.
- Access direction-of-trade or shipping chokepoint data through OpenBB's economy module as part of a broader economic analysis workflow.
- Build a dashboard or research tool that queries IMF indicators programmatically, leveraging OpenBB Workspace UI integration for metadata discovery.
- Combine IMF time series with other OpenBB providers in a single Python script for cross-source economic data analysis.
- Explore available IMF dataflows and their dimensions via utility endpoints to understand what data is available before constructing queries.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you are already using OpenBB and need IMF economic data.
The extension integrates cleanly into the platform, has low install friction, and is actively maintained. However, the AGPL-3.0-only license requires that any code using this package (including derivative works) be open-sourced under the same license—a significant constraint for proprietary applications. If you are building closed-source software, you will need to either accept the license terms or find an alternative IMF data source.
Install
openbb-imf on PyPI
Before you install
Low friction installation as a pure-Python wheel. Actively maintained with a recent release. Requires openbb-core and openbb-platform-api as runtime dependencies, which must be available in your environment.
Requires Python 3.10 or later. The openbb-build command must be run after installation to generate static assets before using the provider.
License in practice
Licensed under AGPL-3.0-only, which requires that any modifications or derivative works using this package must also be released under the same license and have source code made available. This is a copyleft restriction suitable for open-source projects but may conflict with proprietary software strategies.
Quickstart
pip install openbb-imf
openbb-build
from openbb import obb
indicators = obb.economy.available_indicators(provider="imf", dataflows="CPI,PI")
data = obb.economy.indicators(provider="imf", symbol="CPI::CP01")
Verify before relying
- Whether openbb-core and openbb-platform-api are automatically installed or must be pre-configured separately.
- Performance characteristics when querying large datasets or making many concurrent requests via async-lru.
- Specific IMF data coverage limits or frequency update schedules not documented in the excerpt.
Package facts
| License | AGPL-3.0-only agpl |
| Python support | Supports the current Python release <4,>=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 5 packagesasync-lrudefusedxmlopenbb-coreopenbb-economyopenbb-platform-api |
| Maintenance | Actively maintained 80 days since the last release |
| First released | |
| Downloads | 86,656 / month, #13,845 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | License :: OSI Approved :: GNU Affero General Public License v3Programming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14 |
Evidence: openbb_imf-2.1.3-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “IMF data provider for OpenBB”
- openbb-imfProvides a provider extension for the OpenBB platform that exposes…
- openbbUnified interface to fetch financial market data from multiple…
- openbb-econdbIntegrates EconDB economic data into the OpenBB Platform, enabling…
Give your agent the search over MCP, or paste the wish link into any chat.
More Information Analysis packages
A drop-in replacement for Python's standard `re` module that adds advanced regex features like nested sets, fuzzy matching, lookaround in conditionals, and full Unicode case-folding while maintaining backward compatibility.
pyarrow provides Python bindings to Apache Arrow's C++ libraries for efficient columnar data processing, serialization, and interoperability with pandas, NumPy, and other Python ecosystem tools.
NetworkX provides data structures and algorithms for creating, analyzing, and manipulating graphs and networks, supporting everything from simple undirected graphs to complex directed and weighted networks.
Connects Python applications to Snowflake data warehouses using the DB API 2.0 specification, enabling SQL queries, data transfers, and warehouse operations.
ContourPy calculates contours of 2D quadrilateral grids using C++11 algorithms wrapped in Python, offering serial and multithreaded implementations without requiring Matplotlib as a dependency.
Snowpark Python provides APIs to query and process data directly in Snowflake without moving data to your local system, with support for both native Snowpark and pandas-compatible interfaces.
Install it if you use Snowflake and want to process data without moving it to your application layer.
See also imfp · openbb-econdb · openbb-economy · openbb-tradingeconomics · openbb-oecd · openbb-federal-reserve · openbb-fred · openfoodfacts · openbb-congress-gov · openbb-platform-api