xbbg

library1.3.0pypypiunverified

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.

data

pip install xbbg

github ↗package ↗homepage ↗docs ↗

INSTALL

IMPORT

SIG · XBBG

xbbg

datapythonv1.3.0

Install

2.6s avg

Import

—

Disk

34MB

Pass rate

4/ 10

Env Coverage4 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v1.3.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

glibc

py 3.10

✕ build_error

✓ 2.7s

py 3.11

✕ build_error

✓ 2.55s

py 3.12

✕ build_error

✓ 2.45s

py 3.13

✕ build_error

✓ 2.6s

py 3.9

1/2 runs

34MB installed

● package 34MB

Code

Verified usage

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

Backend

✓ from xbbg import Backend

✗ from xbbg import blp

Engine

✓ from xbbg import Engine

ArrowTable

✓ from xbbg import ArrowTable

Fetch historical closing prices for Apple. Requires Bloomberg terminal or Bloomberg Server API (SAPI) running with necessary subscriptions.

from xbbg import blp df = blp.bdh( tickers=['AAPL US Equity'], flds=['PX_LAST'], start_date='2024-01-01', end_date='2024-01-10', ) print(df.head())

Debug

Known issues

gotchaAll 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(...).

fix

Use 'from xbbg import blp' and call blp.bdh(...).

affects: >=0.1.0

gotchaBloomberg 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.

fix

Always provide full Bloomberg ticker: 'TSLA US Equity', 'EURUSD Curncy', 'SPX Index'.

affects: >=0.1.0

deprecatedIn 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.

fix

Use Python xbbg directly or the JavaScript/NAPI bindings (js-xbbg, napi-xbbg).

affects: ~=1.0.0, <1.1.0

gotchabdh with per=ticker/security yields multi-index columns. Reshaping or indexing incorrectly leads to unexpected outputs.

fix

Set pivot='on' to get ticker-column format, or handle MultiIndex appropriately.

affects: >=0.1.0

gotchaBloomberg API (blpapi) must be installed separately and configured. xbbg does not bundle it; pip install blpapi is required for live data.

fix

Run 'pip install blpapi' and ensure Bloomberg services (bbcomm) are available.

affects: >=0.1.0

Upgrade

Version history

1.3.0latest on PyPI · released Jun 13, 2026

Audit

Dependencies

blpapirequiredBloomberg C++ SDK wrapper for live Bloomberg connectivity

pandasoptionalUsed for output DataFrame format

pyarrowoptionalUsed for output Table format

Agent activity

49 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/alpha-xone/xbbg ↗

packagehttps://pypi.org/project/xbbg/ ↗

homepagehttps://xbbg.org/ ↗

docshttps://xbbg.org/ ↗