Skip to main content

Bond data for the OpenBB Platform: search 162,000+ CUSIPs and ISINs, per-bond reference and price history, 72 sovereign yield curves, US corporate and municipal curves, sovereign ratings. No API key.

Project description

openbb-atlantis

Bond data for the OpenBB Platform, from Atlantis Data Solutions.

OpenBB ships 30+ provider extensions and none of them covers individual bonds. This one does:

  • Bond lookup across 162,000+ CUSIPs and ISINs: US Treasuries, corporates, municipals, sovereigns, European exchange listings, India G-secs and more
  • Yield curves: 72 sovereign curves (including India, Indonesia and Switzerland), US corporate rating band curves, US municipal state curves
  • Curve placement: every bond comes back with its fitted reference yield and its residual in basis points, so relative value is one call
  • Price and yield history: the most recent 12 observations per bond, with a link to the full multi-year series
  • Sovereign ratings (S&P long term foreign currency)

No API key required.

Install

pip install openbb-atlantis

Upgrading from 0.1.0? Run this once, otherwise the new commands will not appear:

import openbb; openbb.build()

OpenBB caches its generated interface and only rebuilds when the set of installed extensions changes, so an in-place version bump needs a nudge. Fresh installs build automatically and need nothing.

Use

from openbb import obb

# Find bonds by issuer name, CUSIP or ISIN fragment
obb.atlantis.bond_search(query="apple")

# One bond in full, including where it sits against its curve
obb.atlantis.bond_reference(symbol="037833BX7")

# Recent price and yield observations
obb.atlantis.bond_history(symbol="037833BX7")

# A country's government curve
obb.atlantis.yield_curve(country="India")

Sovereign curves are also available through OpenBB's own standard command, so you can compare providers side by side:

obb.fixedincome.government.yield_curve(provider="atlantis", country="India")

Why the atlantis namespace

Bond search, bond reference and bond history live under obb.atlantis.* rather than obb.fixedincome.* because the OpenBB Platform has no router command for them yet. It defines BondReference, BondPrices and BondTrades models in openbb-core, but nothing exposes them, so a provider has nothing to attach to. This package ships its own router alongside the provider so the data is usable today. We would rather these lived in the fixedincome router and are happy to contribute them upstream.

Fair use

Free for individual queries, with attribution. Rate limits apply per IP, and there are deliberately no bulk endpoints: this answers questions, it is not a feed. Higher limits come with an API key, included with an annual subscription. Full price histories and the downloadable universe live at atlantisdatasolutions.com/bond-lookup.

The underlying REST API is documented at atlantisdatasolutions.com/api and works from anything that speaks HTTP.

Data © Atlantis Data Solutions. Attribution required on redisplay.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

openbb_atlantis-0.2.0.tar.gz (5.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

openbb_atlantis-0.2.0-py3-none-any.whl (9.7 kB view details)

Uploaded Python 3

File details

Details for the file openbb_atlantis-0.2.0.tar.gz.

File metadata

  • Download URL: openbb_atlantis-0.2.0.tar.gz
  • Upload date:
  • Size: 5.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.12.10

File hashes

Hashes for openbb_atlantis-0.2.0.tar.gz
Algorithm Hash digest
SHA256 8f61323279ee92cc2a3f100fd33cbcfa473c136551289d37e4038e3420a2459c
MD5 af3ab72dbec19716c16abd3a1b0f75da
BLAKE2b-256 21120bec14b4950917f5ed423abfc6338ba4bc43c5a6253afa87fcf9b2cd6fe2

See more details on using hashes here.

File details

Details for the file openbb_atlantis-0.2.0-py3-none-any.whl.

File metadata

File hashes

Hashes for openbb_atlantis-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 73efa48c21912dd49ab925e15e4807852ffcb44b8e35fa163df81cfa9d554eaf
MD5 d6fc144f90eae3d38337182903577ffc
BLAKE2b-256 e01868dd57d62757f472215643306ec67a184d84e0f2813989ed6f304ce5c360

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page