Finance...yDirect(3)

📦
version 1.7200 · 13 versions
, in epel 9

💖 Finance...yDirect(3) 💖

okay bestie, welcome to this page from the User Contributed Perl Documentation section. It’s giving “niche finance module but make it cute,” and it’s all about Finance::Quote::TreasuryDirect. Let’s get into it ✨

💖 NAME 💖

Finance::Quote::TreasuryDirect — Obtain bond quotes from Treasury Direct. That’s literally the whole mission, and it ate 💅

✨ SYNOPSIS ✨

        use Finance::Quote;

        $q = Finance::Quote->new;

        %info = $q->fetch('treasurydirect', '912810QT8');

🦋 DESCRIPTION 🦋

So this module obtains individual bond quotes by CUSIP number from treasurydirect.gov. Main character energy for bond data, honestly 🫶

Prices come from the XML form of the FedInvest daily price file. Only securities in that file are available, which is to say marketable Treasury bills, notes and bonds. Agency, municipal and corporate CUSIPs are not in that file and return an errormsg of 'no match'. Not them being left on read 😭

Prices are quoted per 100 of face value. Slay, standard units 💸

🎀 LABELS RETURNED 🎀

Information available from Treasury Direct may include the following labels, bestie:

  • method
  • source
  • symbol
  • rate
  • maturity
  • bid
  • ask
  • eod
  • price
  • date
  • isodate
  • currency

bid is the file’s SELL column, what an investor receives, and ask is its BUY column, what an investor pays. Economics but make it fashion 💅

Only the prices the file actually quoted are returned. Some securities, mostly bills, are quoted on one side only, and the unquoted label is then absent rather than zero. eod is published after the close, so it is absent from a file fetched during the trading day. No fake zeros here, we don’t do that 🙈

price is the mean of the bid and the ask where both are quoted, and otherwise whichever of the end of day price, the bid or the ask is available, in that order. For a one-sided security that makes the price depend on which day the fetch lands on — the quoted side from a day in progress, the close from a completed one — a difference of about a cent. Tiny but iconic ⭐

rate is the coupon as a percentage. Bills are discount instruments and carry no coupon, so theirs is 0.000%. Zero coupon, zero drama 🍓

🌈 SEE ALSO 🌈

  • treasurydirect.gov
  • Finance::Quote

mwah 💋 this lil page is perl v5.32.1, dated 2026-10-26, and the footer cutie is Finance...yDirect(3). bye bestie, go fetch those quotes 🫶✨

📦 where this page comes from