{"id":24841,"library":"xbbg","title":"xbbg","description":"Independent client for Bloomberg data workflows. Current version 1.2.1, supports Python 3.10-3.14. Releases follow semantic versioning with frequent minor/patch updates. Provides pandas- and Arrow-native wrappers around Bloomberg's data services (historical, reference, tick, BQL, etc.) without requiring Bloomberg Terminal GUI.","status":"active","version":"1.2.1","language":"python","source_language":"en","source_url":"https://github.com/alpha-xone/xbbg","tags":["bloomberg","finance","data","market-data"],"install":[{"cmd":"pip install xbbg","lang":"bash","label":"Latest stable"},{"cmd":"pip install xbbg==1.2.1","lang":"bash","label":"Pin version"}],"dependencies":[{"reason":"Bloomberg C++ SDK wrapper for live Bloomberg connectivity","package":"blpapi","optional":false},{"reason":"Used for output DataFrame format","package":"pandas","optional":true},{"reason":"Used for output Table format","package":"pyarrow","optional":true}],"imports":[{"wrong":"from xbbg import blp","symbol":"Backend","correct":"from xbbg import Backend"},{"symbol":"Engine","correct":"from xbbg import Engine"},{"symbol":"ArrowTable","correct":"from xbbg import ArrowTable"}],"quickstart":{"code":"from xbbg import blp\n\ndf = blp.bdh(\n    tickers=['AAPL US Equity'],\n    flds=['PX_LAST'],\n    start_date='2024-01-01',\n    end_date='2024-01-10',\n)\nprint(df.head())","lang":"python","description":"Fetch historical closing prices for Apple. Requires Bloomberg terminal or Bloomberg Server API (SAPI) running with necessary subscriptions."},"warnings":[{"fix":"Use 'from xbbg import blp' and call blp.bdh(...).","message":"All Bloomberg data functions (bdh, bdp, bds, etc.) are exposed via xbbg.blp, not as standalone imports. Common mistake: from xbbg import bdh (AttributeError). Always use: from xbbg import blp then blp.bdh(...).","severity":"gotcha","affected_versions":">=0.1.0"},{"fix":"Always provide full Bloomberg ticker: 'TSLA US Equity', 'EURUSD Curncy', 'SPX Index'.","message":"Bloomberg ticker strings must include exchange/type suffix (e.g., 'AAPL US Equity', 'TSLA US Equity'). Omitting suffix (e.g., just 'AAPL') causes errors or wrong data.","severity":"gotcha","affected_versions":">=0.1.0"},{"fix":"Use Python xbbg directly or the JavaScript/NAPI bindings (js-xbbg, napi-xbbg).","message":"In version 1.1.0, the apps xbbg-browser, xbbg-bridge, and xbbg-server were removed. Users of those should migrate to JavaScript bindings or direct Python API.","severity":"deprecated","affected_versions":"~=1.0.0, <1.1.0"},{"fix":"Set pivot='on' to get ticker-column format, or handle MultiIndex appropriately.","message":"bdh with per=ticker/security yields multi-index columns. Reshaping or indexing incorrectly leads to unexpected outputs.","severity":"gotcha","affected_versions":">=0.1.0"},{"fix":"Run 'pip install blpapi' and ensure Bloomberg services (bbcomm) are available.","message":"Bloomberg API (blpapi) must be installed separately and configured. xbbg does not bundle it; pip install blpapi is required for live data.","severity":"gotcha","affected_versions":">=0.1.0"}],"env_vars":null,"search_vec":"'-3.14':14 '1.2.1':10 '3.10':13 'around':30 'arrow':27 'arrow-n':26 'bloomberg':5,31,42,45 'bql':38 'client':3 'current':8 'data':6,33,47,50 'etc':39 'financ':46 'follow':16 'frequent':20 'gui':44 'histor':35 'independ':2 'market':49 'market-data':48 'minor/patch':21 'nativ':28 'panda':24 'provid':23 'python':12 'refer':36 'releas':15 'requir':41 'semant':17 'servic':34 'support':11 'termin':43 'tick':37 'updat':22 'version':9,18 'without':40 'workflow':7 'wrapper':29 'xbbg':1","created_at":"2026-05-01T08:15:12.443909+00:00","updated_at":"2026-05-01T08:15:12.443909+00:00","problems":{"verify_error":"Traceback (most recent call last):\n  File \"/tmp/tmpieduo584/venv/lib/python3.12/site-packages/xbbg/__init__.py\", line 70, in _import_core\n    mod = importlib.import_module(\"xbbg._core\")\n          ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n  File \"/home/xor/anaconda3/lib/python3.12/importlib/__init__.py\","},"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":"1.3.0","cli_name":"","cli_version":null,"type":"library","homepage":"https://xbbg.org/","github":"https://github.com/alpha-xone/xbbg","docs":"https://xbbg.org/","changelog":null,"pypi":"https://pypi.org/project/xbbg/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["data"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"import_fail","verified_at":"2026-07-03","last_verified":"2026-07-03","next_check":"2026-07-10","install_tag":null}}