Finance Database by Jeroen Bouma offers an extensive collection of over 300,000 symbols across various financial instruments, including Equities, ETFs, Funds, Indices, Currencies, Cryptocurrencies, and Money Markets. It's designed to provide a comprehensive overview of sectors, industries, and types of investments.
This extension integrates the Finance Database datasets into OpenBB. It enhances the capabilities of OpenBB’s equity, crypto, and ETF search functionalities. This integration adds capabilities to search through a broad spectrum of financial instruments.
- Python 3.12+
- OpenBB Core 2.0.1+
uvfor local development
Add the provider and the asset routers used by the examples to your uv project:
uv add openbb-fd openbb-equity openbb-etf openbb-cryptoAlternatively, for the latest version directly from the repository:
uv add git+https://github.com/piiq/openbb-fd.gitRebuild the generated interface after changing installed extensions:
uv run openbb-builduv sync --locked
uv run openbb-build
uv run pytest
uv run ruff check .
uv run ty check
uv run rumdl check --config pyproject.toml README.mdThe development group installs the equity, ETF, and crypto routers for the generated obb interface, plus the Platform API for HTTP integration tests. OpenBB 5 installs these asset routers through its optional routers extra; a provider installation alone does not install them.
Run the API and the live integration tests in separate terminals:
uv run openbb-api --host 127.0.0.1 --port 8000
uv run pytest integrationfrom openbb import obbHere are some command examples to demonstrate the usage of this integration:
To search for equities in a defense industry:
>>> sample = obb.equity.search(query="Defense", provider="fd")
>>> print(f"Total companies in the sample: {len(sample.to_df()['name'].unique())}")
Total companies in the sample: 880To find ETFs matching certain criteria:
>>> sample = obb.etf.search(query="Wheat", provider="fd")
>>> print(f"Total etfs in the sample: {len(sample.to_df()['name'].unique())}")
Total etfs in the sample: 10For cryptocurrency analysis:
>>> sample = obb.crypto.search(query="node", provider="fd")
>>> print(f"Total cryptos in the sample: {len(sample.to_df()['name'].unique())}")
Total cryptos in the sample: 10This project is licensed under the MIT License.