Archived

This project has been archived by its maintainers, and is no longer receiving any updates.

OpenBB Platform

OpenBB is committed to build the future of investment research by focusing on an open source infrastructure accessible to everyone, everywhere.

Check our website at openbb.co

Overview

The OpenBB Platform provides a convenient way to access raw financial data from multiple data providers. The package comes with a ready to use REST API - this allows developers from any language to easily create applications on top of OpenBB Platform.

Installation

The command below provides access to the core functionalities behind the OpenBB Platform.

pip install openbb

This will install the following data providers:

Extension Name	Description	Installation Command	Minimum Subscription Type Required
openbb-benzinga	Benzinga data connector	pip install openbb-benzinga	Paid
openbb-federal-reserve	FederalReserve data connector	pip install openbb-federal-reserve	Free
openbb-fmp	FMP data connector	pip install openbb-fmp	Free
openbb-fred	FRED data connector	pip install openbb-fred	Free
openbb-intrinio	Intrinio data connector	pip install openbb-intrinio	Paid
openbb-oecd	OECD data connector	pip install openbb-oecd	Free
openbb-polygon	Polygon data connector	pip install openbb-polygon	Free
openbb-sec	SEC data connector	pip install openbb-sec	Free
openbb-tiingo	Tiingo data connector	pip install openbb-tiingo	Free
openbb-tradingeconomics	TradingEconomics data connector	pip install openbb-tradingeconomics	Paid
openbb-yahoo-finance	Yahoo Finance data connector	pip install openbb-yfinance	Free

To install extensions that expand the core functionalities specify the extension name or use all to install all.

# Install a single extension, e.g. openbb-charting and yahoo finance
pip install openbb[charting]
pip install openbb-yfinance

Alternatively, you can install all extensions at once.

pip install openbb[all]

Note: These instruction are specific to v4. For installation instructions and documentation for v3 go to our website.

Python

>>> from openbb import obb
>>> output = obb.equity.price.historical("AAPL")
>>> df = output.to_dataframe()
>>> df.head()
              open    high     low  ...  change_percent             label  change_over_time
date                                ...
2022-09-19  149.31  154.56  149.10  ...         3.46000  September 19, 22          0.034600
2022-09-20  153.40  158.08  153.08  ...         2.28000  September 20, 22          0.022800
2022-09-21  157.34  158.74  153.60  ...        -2.30000  September 21, 22         -0.023000
2022-09-22  152.38  154.47  150.91  ...         0.23625  September 22, 22          0.002363
2022-09-23  151.19  151.47  148.56  ...        -0.50268  September 23, 22         -0.005027

[5 rows x 12 columns]

API keys

To fully leverage the OpenBB Platform you need to get some API keys to connect with data providers. Here are the 3 options on where to set them:

OpenBB Hub
Runtime
Local file

1. OpenBB Hub

Set your keys at OpenBB Hub and get your personal access token from https://my.openbb.co/app/sdk/pat to connect with your account.

>>> from openbb import obb
>>> openbb.account.login(pat="OPENBB_PAT")

>>> # Persist changes in OpenBB Hub
>>> obb.account.save()

2. Runtime

>>> from openbb import obb
>>> obb.user.credentials.fmp_api_key = "REPLACE_ME"
>>> obb.user.credentials.polygon_api_key = "REPLACE_ME"

>>> # Persist changes in ~/.openbb_platform/user_settings.json
>>> obb.account.save()

3. Local file

You can specify the keys directly in the ~/.openbb_platform/user_settings.json file.

Populate this file with the following template and replace the values with your keys:

{
  "credentials": {
    "fmp_api_key": "REPLACE_ME",
    "polygon_api_key": "REPLACE_ME",
    "benzinga_api_key": "REPLACE_ME",
    "fred_api_key": "REPLACE_ME"
  }
}

REST API

The OpenBB Platform comes with a ready to use REST API built with FastAPI. Start the application using this command:

uvicorn openbb_core.api.rest_api:app --host 0.0.0.0 --port 8000 --reload

Check openbb-core README for additional info.

Install for development

To develop the OpenBB Platform you need to have the following:

Git
Python 3.8 or higher
Virtual Environment with poetry and toml packages installed
- To install these packages activate your virtual environment and run pip install poetry toml

How to install the platform in editable mode?

Activate your virtual environment
Navigate into the openbb_platform folder
Run python dev_install.py to install the packages in editable mode

Metadata

Release files for openbb-nightly 4.1.5.dev202403180010

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for openbb-nightly 4.1.5.dev202403180010
File	Size	Uploaded
openbb_nightly-4.1.5.dev202403180010.tar.gz	3.9 MB	Mar 18, 2024	Details

Built distribution (wheel)

Table of built distributions (wheels) for openbb-nightly 4.1.5.dev202403180010
File	Interpreter	ABI	Platform	Reset
openbb_nightly-4.1.5.dev202403180010-py3-none-any.whl 4.3 MB Mar 18, 2024	Python 3	none	any	Details

Total release size: 8.3 MB

Release files / openbb_nightly-4.1.5.dev202403180010.tar.gz

Download URL	openbb_nightly-4.1.5.dev202403180010.tar.gz
Size	3.9 MB
Tags	Source
SHA-256 checksum How to use checksums	`82edc7f64ddcdafd323674a58ccbc4373192f91bf259ea43eb3f673b9edf3b35`
BLAKE2b-256 checksum How to use checksums	`9d580a7cbb97f2467857608b551a78a23837645ea12def5cdd6468dd205621dc`
Upload date	Mar 18, 2024
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/5.0.0 CPython/3.12.2`

Release files / openbb_nightly-4.1.5.dev202403180010-py3-none-any.whl

Download URL	openbb_nightly-4.1.5.dev202403180010-py3-none-any.whl
Size	4.3 MB
Tags	Python 3
SHA-256 checksum How to use checksums	`7f94f2124d43a3b63fbafbcd5eef8dda9600378bbd16c418ebefb61d9ed6cf13`
BLAKE2b-256 checksum How to use checksums	`8710fe67791538638688230988cb23943152ab65b660e5467f6e53e14af23999`
Upload date	Mar 18, 2024
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/5.0.0 CPython/3.12.2`