upcoming_auctions
Get marketable Treasury securities scheduled to be announced or auctioned in the coming week.
Examples
from openbb import obb
obb.ustreasury.upcoming_auctions(provider='us_treasury')
# Get only the upcoming bill auctions.
obb.ustreasury.upcoming_auctions(security_type='bill', provider='us_treasury')
Parameters
- standard
- us_treasury
security_type: str | None
Filter by the type of security.
Returns
results: UpcomingTreasuryAuctions
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
- us_treasury
auction_date: date
Date of the auction. Rows read soonest first.
security_type: str
Type of security - Bill, Note, Bond, CMB, FRN Note, or TIPS Note.
security_term: str
Term of the security. Reopenings carry the remaining term rather than the original term.
cusip: str
CUSIP of the security.
offering_amount: float | None
Offering amount, in dollars. None when the amount has not yet been announced.
reopening: bool
Whether the auction is a reopening of an existing security.
announcement_date: date
Date the terms and conditions notification is made public.
issue_date: date
Date the security is delivered to the investor in exchange for payment.
as_of_date: date
Date the published snapshot is current as of.