About YieldDocket and our methodology
YieldDocket is an automated, impersonal publication that reformats public government data on a fixed schedule: U.S. Treasury auction results, FDIC national deposit rates, and dividend changes from SEC filings. It does not rate, rank, or comment on any security, bank, or company.
Sources
- Treasury auctions — U.S. Department of the Treasury, Bureau of the Fiscal Service, Treasury Securities Auctions Data and Upcoming Auctions, via the Fiscal Data API (no key required). Treasury states that Fiscal Data is offered free and without restriction for commercial or non-commercial use. Each result row links to the official results PDF on TreasuryDirect.
- Deposit rates — FDIC, National Rates and Rate Caps, published monthly on the third Monday, and the FDIC's dated monthly pages for history. Only the FDIC's “National Deposit Rates” and “National Rate Cap” columns are shown. The FDIC name is used only to identify the source; no FDIC logo or sign is used.
- Dividend changes — SEC EDGAR full-text search and the EDGAR submissions API. Requests declare a User-Agent and stay under the SEC's fair-access limit of 10 requests per second.
How figures are produced
- Auction results are copied from the API fields as published: bills show the high investment rate (bond-equivalent) and high discount rate; notes and bonds show the high yield and interest rate; TIPS show the high real yield; FRNs show the high discount margin. “Change vs prior same-term auction” is the difference in the headline rate from the previous auction of the same security type and term (reopenings are compared with the original term), in basis points.
- Archive pages (weekly, per-security, and monthly pages) are built from the same official sources and only accumulate: past results are kept as published, and nothing is estimated or filled in.
- Upcoming auctions combine Treasury's upcoming-auction list (including tentative dates) with announced offering details. Treasury sets and can change these dates and amounts.
- FDIC rates are read from the FDIC table and compared with the FDIC's prior monthly page. Change is in percentage points.
- Dividend changes: 8-K filings that mention dividends (Item 8.01 or press-release exhibits) are downloaded and parsed for the change type (increase, decrease, suspension), new and prior per-share amounts, percent change, and record and payable dates. Each parse is scored. A filing is listed only when the parse is internally consistent, or when a human reviewer has confirmed it. Other filings are held for review and are not published. Company and ticker come from the SEC submissions API. Press-release text is not republished; only facts are listed, with a link to the filing.
Automated checks before each build
- Auction figures are cross-checked against TreasuryDirect's own securities data for each CUSIP and auction date.
- FDIC figures are cross-checked against the FDIC's dated monthly page.
- Published dividend amounts and dates are re-checked against the filing text.
- A wording check scans every page and email for advisory language and blocks the build if any is found.
Schedule
Data refreshes daily; the weekly issue is planned for a fixed day each week regardless of market events, and each issue is archived on the weekly issues page.
Data license
Compiled data (the tables on this site and the CSV downloads) is available under the Creative Commons Attribution 4.0 International license (CC BY 4.0); credit YieldDocket with a link to the source page. Underlying Treasury, FDIC, and SEC data are public domain U.S. government works.
Corrections and contact
Corrections and contact: [email protected]. The linked official source is authoritative in any discrepancy.
Affiliate disclosure
Affiliate disclosure (FTC): YieldDocket currently has no affiliate relationships and receives no compensation from any bank, broker, or company mentioned. If affiliate links are added in the future, they will be clearly disclosed next to the links, and compensation will not affect which data is shown.