bond_historical
Get the daily end-of-day TRACE price and yield of bonds.
Examples
from openbb import obb
# Five years of end-of-day prices and yields for a bond.
obb.finra.fixedincome.bond_historical(cusip='037833EH9', provider='finra')
# A window of history for a bond by its FINRA symbol.
obb.finra.fixedincome.bond_historical(cusip='AAPL5231623', start_date='2026-01-01', end_date='2026-06-30', provider='finra')
Parameters
- standard
- finra
cusip: str | list[str]
The CUSIP or FINRA symbol of the bond. Multiple items allowed.
start_date: date | None | str
The first trade date. Five years before the end date when empty.
end_date: date | None | str
The last trade date. Today when empty.
Returns
results: FinraBondHistorical
Serializable results.
provider: str | None
Provider name.
warnings: Optional[list[Warning_]]
List of warnings.
chart: Optional[Chart]
Chart object.
extra: dict[str, Any]
Extra info.
Data
- standard
- finra
date: date | str
The trade date.
cusip: str
The CUSIP of the bond.
symbol: str | None
The FINRA symbol of the bond.
finra_security_id: str | None
The FINRA security identifier.
product_type: str | None
The TRACE product - Corporate and Agency, Securitized Products, or U.S. Treasury.
price: float | None
The price of the last sale of the day.
last_sale_yield: float | None
The yield of the last sale of the day, as a percent.
yield_direction: str | None
The direction of the day's yield change.