{"id":21645,"library":"openbb-core","title":"OpenBB Core","description":"OpenBB Core is the foundational library (v1.6.8) for the OpenBB platform, providing data connectors, financial modeling, and an SDK for programmatic access. It follows a monthly release cadence.","status":"active","version":"1.6.8","language":"python","source_language":"en","source_url":"https://github.com/OpenBB-finance/OpenBB","tags":["finance","sdk","API","data","modeling"],"install":[{"cmd":"pip install openbb-core","lang":"bash","label":"Core only"},{"cmd":"pip install openbb[all]","lang":"bash","label":"Full suite"}],"dependencies":[],"imports":[{"note":"Old import path removed in v1.0+.","wrong":"from openbb import OBB","symbol":"OBB","correct":"from openbb_core.api.rest.controller import OBB"},{"note":"No common wrong import known.","wrong":"","symbol":"OBBError","correct":"from openbb_core.app.model.abstract.error import OBBError"}],"quickstart":{"code":"from openbb_core.api.rest.controller import OBB\nobb = OBB()\n# Fetch historical price data for a stock\ndf = obb.equity.price.historical(symbol='AAPL', start_date='2023-01-01', end_date='2023-12-31')\nprint(df)\n","lang":"python","description":"Instantiate the main controller and fetch data. Authentication via env vars OPENBB_PAT or provider-specific keys."},"warnings":[{"fix":"Update imports: from openbb_core.api.rest.controller import OBB.","message":"OpenBB Core v1+ removed the old monolithic openbb package structure. Imports must use openbb_core instead of openbb.","severity":"breaking","affected_versions":">=1.0.0"},{"fix":"Set environment variables like OPENBB_PAT (for personal access token) or provider-specific keys (e.g., OPENBB_POLYGON_API_KEY).","message":"The OBB controller requires an active internet connection and valid API keys for data providers; missing keys cause silent empty results.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"pip install openbb-core","message":"The legacy 'openbb' module is deprecated; install 'openbb-core' instead. Using 'pip install openbb' may install an older version.","severity":"deprecated","affected_versions":">=1.0.0"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Use 'from openbb_core.api.rest.controller import OBB' instead of 'from openbb import OBB'.","cause":"Installing 'openbb-core' but trying to import 'openbb'.","error":"ModuleNotFoundError: No module named 'openbb'"},{"fix":"Correct import: 'from openbb_core.api.rest.controller import OBB'.","cause":"Importing incorrectly: 'import openbb_core' and calling openbb_core.OBB.","error":"AttributeError: module 'openbb_core' has no attribute 'OBB'"},{"fix":"Use the new unified API endpoints (e.g., 'obb.equity.price.historical'). Refer to the official documentation for the current provider-agnostic interface.","cause":"Using deprecated endpoint path from v0.x.","error":"openbb_core.api.rest.controller.OBB object has no attribute 'equity'"},{"fix":"Set the key: os.environ['POLYGON_API_KEY'] = 'your_key' before creating the OBB object, or set persistent env vars.","cause":"Required API key not set as environment variable.","error":"ValueError: Missing API key for provider 'polygon'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}