Registry / analytics / openbb-derivatives

openbb-derivatives

library1.6.2pypypi✓ verified 84d ago

Derivatives extension for the OpenBB Platform (v1.6.2). Provides access to options, futures, and other derivative securities data from multiple providers. Follows monthly releases aligned with OpenBB core.

analytics

pip install openbb-derivatives

INSTALL

IMPORT

SIG · OPENBB-DERIVATIVES

openbb-derivatives

analyticspythonv1.6.2

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

OBBject

✓ from openbb import obb

✗ from openbb_core import obb

Top-level obb is the standard entry point since OpenBB v4.

DerivativesFetcher

✓ from openbb_derivatives import DerivativesFetcher

✗ from openbb.derivatives import DerivativesFetcher

Import directly from the extension package, not from openbb namespace.

Basic usage: get options chains for AAPL via CBOE provider.

from openbb import obb # Fetch options chains using obb.derivatives.options result = obb.derivatives.options.chains(symbol='AAPL', provider='cboe') print(result.to_df())

Debug

Known issues

breakingOpenBB v4 changed the import structure; all extensions became separate packages. Old imports like `from openbb import derivatives` will fail.

fix

Install and import from the specific extension package (e.g., `openbb-derivatives`) and use `obb.derivatives`.

affects: <4

deprecatedThe 'yahoo_finance' provider for derivatives was removed; use 'yfinance' or 'cboe' instead.

fix

Replace 'yahoo_finance' with 'yfinance' or 'cboe' in your code.

affects: >=1.5.0

gotchaSome providers require API keys set as environment variables (e.g., POLYGON_API_KEY, INTRINIO_KEY). Without them, requests fail silently or return empty data.

fix

Set required env vars before initializing obb. For example: `os.environ['POLYGON_API_KEY'] = 'your_key'`.

affects: all

Errors

Common errors & fixes

ModuleNotFoundError: No module named 'openbb_derivatives'

The extension is not installed or the pip package name is 'openbb-derivatives' but the import is 'openbb_derivatives'.

fix

Run: pip install openbb-derivatives

AttributeError: module 'openbb' has no attribute 'derivatives'

The extension package is not imported or not installed correctly; OpenBB core alone doesn't include derivatives.

fix

Install the extension: pip install openbb-derivatives, then restart the Python interpreter.

KeyError: 'provider'

The selected provider (e.g., 'cboe') does not support the requested data type (e.g., futures).

fix

Check available providers for the specific route using: obb.derivatives.options.providers

Upgrade

Version history

1.6.2latest on PyPI · released May 26, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

30 hits · last 30 days

node

OpenAI (training)

Resources

No resource links recorded.