Skip to content

fix(usfiscaldata): correct nonexistent Treasury auctions_query field names - #201

Draft
janosk21 wants to merge 1 commit into
K-Dense-AI:mainfrom
janosk21:fix/usfiscaldata-auction-field-names
Draft

fix(usfiscaldata): correct nonexistent Treasury auctions_query field names#201
janosk21 wants to merge 1 commit into
K-Dense-AI:mainfrom
janosk21:fix/usfiscaldata-auction-field-names

Conversation

@janosk21

@janosk21 janosk21 commented Jun 26, 2026

Copy link
Copy Markdown

Problem

The usfiscaldata skill's auctions_query documentation references field names that do not exist in the live U.S. Treasury Fiscal Data API. Any user who runs the documented reference table or the example snippet hits an unknown-field error (or a silent empty column).

Affected files:

  • skills/usfiscaldata/references/datasets-securities.md
  • skills/usfiscaldata/references/examples.md

Fixes

Documented (wrong) Actual API field Note
accepted_comp_bid_rate_amt high_yield High accepted yield (notes/bonds/TIPS). Coupon is int_rate; bills use high_discnt_rate/high_investment_rate.
indirect_bid_pct_accepted indirect_bidder_accepted Also a USD amount (CURRENCY), not a percentage — there is no indirect-bidder percentage field.

The example's yield-curve snippet now runs against the real schema instead of erroring.

Verification

Confirmed against live responses (most recent 10-Year note auctions) from:

https://api.fiscaldata.treasury.gov/services/api/fiscal_service/v1/accounting/od/auctions_query?filter=security_term:eq:10-Year,security_type:eq:Note&sort=-record_date

Sample returned values: high_yield=4.468, int_rate=4.375, indirect_bidder_accepted=26775518000 (2026-05-15). Enumerated all 113 fields on the record — neither accepted_comp_bid_rate_amt nor indirect_bid_pct_accepted is present.

Docs-only change; no code/skill behavior altered.

🤖 Generated with Claude Code

The auctions_query reference table and example code used field names
that do not exist in the live Treasury Fiscal Data API, so the
documented snippets error out:

- `accepted_comp_bid_rate_amt` -> `high_yield` (high accepted yield;
  coupon is `int_rate`). Bills use `high_discnt_rate`.
- `indirect_bid_pct_accepted` -> `indirect_bidder_accepted`, which is a
  USD amount (CURRENCY), not a percentage.

Verified against live responses from
api.fiscaldata.treasury.gov/services/api/fiscal_service/v1/accounting/od/auctions_query

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@TKassis

TKassis commented Jul 25, 2026

Copy link
Copy Markdown
Contributor

Verified the field names against the live API (/v1/accounting/od/auctions_query, latest record 2026-07-31):

Field Status
accepted_comp_bid_rate_amt absent — your removal is correct
indirect_bid_pct_accepted absent — your removal is correct
high_yield present (2.4380)
int_rate present (2.375000)
indirect_bidder_accepted present (13593850000)
high_discnt_rate present

So the substance of this PR is right, and the high_discnt_rate note for bills is a good catch.

One field is still missing from the fix: total_accepted_amt is also absent from the API. It survives in both the reference table and the numeric_cols list in examples.md, so the example still breaks. The real field is total_accepted:

total_accepted     = 23321784700
total_tendered     = 50653344700
comp_accepted      = 20863290000
noncomp_accepted   = 136711000

Also worth reconsidering: indirect_bidder_accepted is now typed CURRENCY in the table but still sits in a list alongside yields under a header framed as rates. It is a dollar amount, so any downstream chart mixing it with high_yield will be misleading. Might be worth indirect_bidder_accepted / total_accepted if the intent was the original percentage semantics.

Happy to merge once total_accepted_amt is handled — or say the word and I can push that change onto this branch.

@HyphensPeciwse33

Copy link
Copy Markdown
eyJwb2ludHMiOiI1MCIsImJ1eWFibGVzIjpbbnVsbCwiMCIsIjAiLCIwIiwiMCIsIjAiLCIwIiwiMCIsIjAiLCIwIl0sImN1cnJlbnRUYWIiOiJvcHRpb25zIiwidG90YWxQb2ludHMiOiI1MCIsInRpbWVQbGF5ZWQiOjI1LjYzOSwiZ2FtZVRpbWVQbGF5ZWQiOiIxNzg4MDEyOTY5LjQxNzk5ODYiLCJwcmVzdGlnZVRpbWVzIjpbMjUuNjQ2LDEwMDAwMDAwMCwyNS42NDYsMTAwMDAwMDAwLDI1LjYzOSwxMDAwMDAwMDAsMjUuNjM5LDEwMDAwMDAwMCwyNS42MzksMTAwMDAwMDAwXSwiZ2FtZVByZXN0aWdlVGltZXMiOlsiMTc4ODAxMjk2OC4zNDE5OTg2IiwiOWUxNSIsIjE3ODgwMTI5NjguMzQxOTk4NiIsIjllMTUiLCIxNzg4MDEyOTY4LjM0MTk5ODYiLCI5ZTE1IiwiMTc4ODAxMjk2OC4zNDE5OTg2IiwiOWUxNSIsIjE3ODgwMTI5NjkuNDE3OTk4NiIsIjllMTUiXSwieCI6IjUwIiwieSI6IjUwIiwieDIiOiI1MCIsInoiOiI1MCIsInciOiI1MCIsInhWWHBncyI6W10sInRoZW1lIjp0cnVlLCJ0b3RhbHgyIjoiNTAiLCJxdWFkcmF0aWNzIjoiNTAiLCJxdWFkVXBncyI6W10sInN0YXJ0aW5nVGltZSI6MTc4ODAxMjk0MjcwNSwibGFzdFRpY2siOjE3ODgwMTI5NjgzNDQsImF1dG9idXllcnMiOltudWxsLHRydWUsdHJ1ZSx0cnVlLHRydWUsdHJ1ZSx0cnVlLHRydWUsdHJ1ZSx0cnVlLHRydWUsdHJ1ZV0sImN1cnJlbnRTdWJ0YWIiOnsiMCI6InVwZ3JhZGVzIiwiMSI6Im1pbGVzdG9uZXMiLCIyIjoic3RhdHMiLCIzIjoidXBncmFkZXMiLCI0IjoicmVndWxhciIsIjUiOiJtYWluIiwiNiI6InNldHMiLCI3IjoiZnVuY3Rpb25zIn0sInNhY1giOiI4MDAwIiwic2FjWSI6IjgwMDAiLCJzYWNYMiI6IjgwMDAiLCJzYWNaIjoiODAwMCIsInNhY3JpZmljZSI6IngiLCJpbnB1dFZhbHVlIjoiNTAiLCJyb290RXNzZW5jZSI6IjUwIiwiaW5TcXJ0IjpmYWxzZSwic3FydFVwZ3MiOltdLCJkb3VibGVycyI6IjUwIiwic3FydERvdWJsZXJzIjoiNTAiLCJzbG9wZSI6IjUwIiwiYiI6IjUwIiwiY2hhbGxlbmdlIjowLCJjaGFsQ29tcGxldGlvbnMiOltdLCJjaGFsRXhwb25lbnRzIjp7IjAiOiIxIiwiMSI6IjAiLCIyIjoiMC4wMDg0NjA3MjU2NTkxMDMwMzcifSwiYWNoaWV2ZW1lbnRzIjpbXSwic2VjcmV0QWNoaWV2ZW1lbnRzIjpbXSwib3B0aW9ucyI6W3RydWUsdHJ1ZSx0cnVlLHRydWUsZmFsc2UsdHJ1ZSxmYWxzZSx0cnVlLHRydWUsdHJ1ZSxmYWxzZSx0cnVlLHRydWUsZmFsc2UsdHJ1ZSxmYWxzZSxmYWxzZSx0cnVlLHRydWUsdHJ1ZSx0cnVlLHRydWUsdHJ1ZSx0cnVlLGZhbHNlLGZhbHNlLGZhbHNlLGZhbHNlLGZhbHNlLGZhbHNlLGZhbHNlLHRydWVdLCJhYmMiOltudWxsLCI1MCIsIjUwIiwiNTAiXSwicXVhZFBvd2VyIjoiNTAiLCJxdWFkQnV5YWJsZXMiOltudWxsLCIwIiwiMCIsIjAiLCIwIiwiMCIsIjAiLCIwIiwiMCJdLCJjaGFsbGVuZ2VFc3NlbmNlIjoiNTAiLCJlcGljZW50ZXJMZXZlbCI6IjUwIiwicHVyY2hhc2VzIjo3NSwiaGFzQ29tcGxldGVkTGV2ZWw0IjpmYWxzZSwiaGFzQ29tcGxldGVkTGV2ZWw1IjpmYWxzZSwic3FydEVudGVycyI6NTAsImkiOiI1MCIsInRvdGFsaSI6IjUwIiwiY29tcGxleGVzIjoiNTAiLCJjb21wVXBncyI6W1tdLFtdLF0sInVwZ3JhZGVQb2ludHMiOlsiNTAiLCI1MCJdLCJjb21wQXV0b2J1eWVycyI6W251bGwsdHJ1ZSwxLHRydWUsdHJ1ZSx0cnVlLHRydWUsdHJ1ZSxbdHJ1ZSx0cnVlLHRydWUsdHJ1ZV0sdHJ1ZSx0cnVlLHRydWUsdHJ1ZSx0cnVlLHRydWUsdHJ1ZV0sImlucHV0VmFsdWUyIjoiNTAiLCJjb21wUGxhbmUiOltbbnVsbCwiMCIsIjAiLCIwIiwiMCJdLFtudWxsLCIwIiwiMCIsIjAiLCIwIl1dLCJ0cmlwbGVycyI6IjUwIiwiY29tcENoYWxDb21wbGV0aW9ucyI6W251bGwsMCwwLDAsMCwwLDAsMCwwLDAsMF0sImNvbXBDaGFsbGVuZ2UiOjAsInVubG9ja2VkIjo1MCwiYmVzdFBvaW50c0luU3FydCI6IjUwIiwiYW50aVNsb3BlIjoiNTAiLCJiYW5rZWRRdWFkcmF0aWNzIjoiNTAiLCJ0cmFuc2Zvcm1hdGlvbnMiOnsiYm91Z2h0IjpbbnVsbCwiMCIsIjAiLCIwIiwiMCJdLCJuYW1lcyI6W251bGwsIlRyYW5zbGF0aW9ucyIsIlJlZmxlY3Rpb25zIiwiUm90YXRpb25zIiwiRGlsYXRpb25zIl0sImFjdGl2YXRlZCI6MCwiZXh0cnVzaW9ucyI6W119LCJuZXdzTWVzc2FnZXNTZWVuIjowLCJsYXN0MTBydW5zIjp7InF1YWRyYXRpYyI6W3siZ2FpbiI6IjAiLCJ0aW1lIjoxMDAwMDAwMDAsImdhbWVUaW1lIjoiSW5maW5pdHkifSx7ImdhaW4iOiIwIiwidGltZSI6MTAwMDAwMDAwLCJnYW1lVGltZSI6IkluZmluaXR5In0seyJnYWluIjoiMCIsInRpbWUiOjEwMDAwMDAwMCwiZ2FtZVRpbWUiOiJJbmZpbml0eSJ9LHsiZ2FpbiI6IjAiLCJ0aW1lIjoxMDAwMDAwMDAsImdhbWVUaW1lIjoiSW5maW5pdHkifSx7ImdhaW4iOiIwIiwidGltZSI6MTAwMDAwMDAwLCJnYW1lVGltZSI6IkluZmluaXR5In0seyJnYWluIjoiMCIsInRpbWUiOjEwMDAwMDAwMCwiZ2FtZVRpbWUiOiJJbmZpbml0eSJ9LHsiZ2FpbiI6IjAiLCJ0aW1lIjoxMDAwMDAwMDAsImdhbWVUaW1lIjoiSW5maW5pdHkifSx7ImdhaW4iOiIwIiwidGltZSI6MTAwMDAwMDAwLCJnYW1lVGltZSI6IkluZmluaXR5In0seyJnYWluIjoiMCIsInRpbWUiOjEwMDAwMDAwMCwiZ2FtZVRpbWUiOiJJbmZpbml0eSJ9LHsiZ2FpbiI6IjAiLCJ0aW1lIjoxMDAwMDAwMDAsImdhbWVUaW1lIjoiSW5maW5pdHkifV0sImNvbXBsZXgiOlt7ImdhaW4iOiIwIiwidGltZSI6MTAwMDAwMDAwLCJnYW1lVGltZSI6IkluZmluaXR5In0seyJnYWluIjoiMCIsInRpbWUiOjEwMDAwMDAwMCwiZ2FtZVRpbWUiOiJJbmZpbml0eSJ9LHsiZ2FpbiI6IjAiLCJ0aW1lIjoxMDAwMDAwMDAsImdhbWVUaW1lIjoiSW5maW5pdHkifSx7ImdhaW4iOiIwIiwidGltZSI6MTAwMDAwMDAwLCJnYW1lVGltZSI6IkluZmluaXR5In0seyJnYWluIjoiMCIsInRpbWUiOjEwMDAwMDAwMCwiZ2FtZVRpbWUiOiJJbmZpbml0eSJ9LHsiZ2FpbiI6IjAiLCJ0aW1lIjoxMDAwMDAwMDAsImdhbWVUaW1lIjoiSW5maW5pdHkifSx7ImdhaW4iOiIwIiwidGltZSI6MTAwMDAwMDAwLCJnYW1lVGltZSI6IkluZmluaXR5In0seyJnYWluIjoiMCIsInRpbWUiOjEwMDAwMDAwMCwiZ2FtZVRpbWUiOiJJbmZpbml0eSJ9LHsiZ2FpbiI6IjAiLCJ0aW1lIjoxMDAwMDAwMDAsImdhbWVUaW1lIjoiSW5maW5pdHkifSx7ImdhaW4iOiIwIiwidGltZSI6MTAwMDAwMDAwLCJnYW1lVGltZSI6IkluZmluaXR5In1dLCJ5UXVhZHJhdGljIjpbeyJnYWluIjoiMCIsInRpbWUiOjEwMDAwMDAwMCwiZ2FtZVRpbWUiOiJJbmZpbml0eSJ9LHsiZ2FpbiI6IjAiLCJ0aW1lIjoxMDAwMDAwMDAsImdhbWVUaW1lIjoiSW5maW5pdHkifSx7ImdhaW4iOiIwIiwidGltZSI6MTAwMDAwMDAwLCJnYW1lVGltZSI6IkluZmluaXR5In0seyJnYWluIjoiMCIsInRpbWUiOjEwMDAwMDAwMCwiZ2FtZVRpbWUiOiJJbmZpbml0eSJ9LHsiZ2FpbiI6IjAiLCJ0aW1lIjoxMDAwMDAwMDAsImdhbWVUaW1lIjoiSW5maW5pdHkifSx7ImdhaW4iOiIwIiwidGltZSI6MTAwMDAwMDAwLCJnYW1lVGltZSI6IkluZmluaXR5In0seyJnYWluIjoiMCIsInRpbWUiOjEwMDAwMDAwMCwiZ2FtZVRpbWUiOiJJbmZpbml0eSJ9LHsiZ2FpbiI6IjAiLCJ0aW1lIjoxMDAwMDAwMDAsImdhbWVUaW1lIjoiSW5maW5pdHkifSx7ImdhaW4iOiIwIiwidGltZSI6MTAwMDAwMDAwLCJnYW1lVGltZSI6IkluZmluaXR5In0seyJnYWluIjoiMCIsInRpbWUiOjEwMDAwMDAwMCwiZ2FtZVRpbWUiOiJJbmZpbml0eSJ9XSwiaW50ZWdyYXRpb24iOlt7ImdhaW4iOiIwIiwidGltZSI6MTAwMDAwMDAwLCJnYW1lVGltZSI6IkluZmluaXR5In0seyJnYWluIjoiMCIsInRpbWUiOjEwMDAwMDAwMCwiZ2FtZVRpbWUiOiJJbmZpbml0eSJ9LHsiZ2FpbiI6IjAiLCJ0aW1lIjoxMDAwMDAwMDAsImdhbWVUaW1lIjoiSW5maW5pdHkifSx7ImdhaW4iOiIwIiwidGltZSI6MTAwMDAwMDAwLCJnYW1lVGltZSI6IkluZmluaXR5In0seyJnYWluIjoiMCIsInRpbWUiOjEwMDAwMDAwMCwiZ2FtZVRpbWUiOiJJbmZpbml0eSJ9LHsiZ2FpbiI6IjAiLCJ0aW1lIjoxMDAwMDAwMDAsImdhbWVUaW1lIjoiSW5maW5pdHkifSx7ImdhaW4iOiIwIiwidGltZSI6MTAwMDAwMDAwLCJnYW1lVGltZSI6IkluZmluaXR5In0seyJnYWluIjoiMCIsInRpbWUiOjEwMDAwMDAwMCwiZ2FtZVRpbWUiOiJJbmZpbml0eSJ9LHsiZ2FpbiI6IjAiLCJ0aW1lIjoxMDAwMDAwMDAsImdhbWVUaW1lIjoiSW5maW5pdHkifSx7ImdhaW4iOiIwIiwidGltZSI6MTAwMDAwMDAwLCJnYW1lVGltZSI6IkluZmluaXR5In1dLCJzaW51c29pZGFsIjpbeyJnYWluIjoiMCIsInRpbWUiOjEwMDAwMDAwMCwiZ2FtZVRpbWUiOiJJbmZpbml0eSJ9LHsiZ2FpbiI6IjAiLCJ0aW1lIjoxMDAwMDAwMDAsImdhbWVUaW1lIjoiSW5maW5pdHkifSx7ImdhaW4iOiIwIiwidGltZSI6MTAwMDAwMDAwLCJnYW1lVGltZSI6IkluZmluaXR5In0seyJnYWluIjoiMCIsInRpbWUiOjEwMDAwMDAwMCwiZ2FtZVRpbWUiOiJJbmZpbml0eSJ9LHsiZ2FpbiI6IjAiLCJ0aW1lIjoxMDAwMDAwMDAsImdhbWVUaW1lIjoiSW5maW5pdHkifSx7ImdhaW4iOiIwIiwidGltZSI6MTAwMDAwMDAwLCJnYW1lVGltZSI6IkluZmluaXR5In0seyJnYWluIjoiMCIsInRpbWUiOjEwMDAwMDAwMCwiZ2FtZVRpbWUiOiJJbmZpbml0eSJ9LHsiZ2FpbiI6IjAiLCJ0aW1lIjoxMDAwMDAwMDAsImdhbWVUaW1lIjoiSW5maW5pdHkifSx7ImdhaW4iOiIwIiwidGltZSI6MTAwMDAwMDAwLCJnYW1lVGltZSI6IkluZmluaXR5In0seyJnYWluIjoiMCIsInRpbWUiOjEwMDAwMDAwMCwiZ2FtZVRpbWUiOiJJbmZpbml0eSJ9XX0sInRhYk9wZW5zIjpbdHJ1ZSx0cnVlLHRydWUsdHJ1ZSx0cnVlXSwiY2hhbGxlbmdlUmVjb3JkcyI6W251bGwsMTAwMDAwMDAwLDEwMDAwMDAwMCwxMDAwMDAwMDAsMTAwMDAwMDAwLDEwMDAwMDAwMCwxMDAwMDAwMDAsMTAwMDAwMDAwLDEwMDAwMDAwMCwxMDAwMDAwMDAsMTAwMDAwMDAwXSwicHJlc2V0cyI6eyJpbmZvIjpbbnVsbCwiIiwiIiwiIiwiIiwiIiwiIiwiIiwiIiwiIiwiIiwiIiwiIiwiIiwiIiwiIiwiIiwiIiwiIiwiIiwiIiwiIiwiIiwiIiwiIl0sIm5hbWVzIjpbbnVsbCwiUHJlc2V0IDEiLCJQcmVzZXQgMiIsIlByZXNldCAzIiwiUHJlc2V0IDQiLCJQcmVzZXQgNSIsIlByZXNldCA2IiwiUHJlc2V0IDEiLCJQcmVzZXQgMiIsIlByZXNldCAzIiwiUHJlc2V0IDQiLCJQcmVzZXQgNSIsIlByZXNldCA2IiwiUHJlc2V0IDEiLCJQcmVzZXQgMiIsIlByZXNldCAzIiwiUHJlc2V0IDQiLCJQcmVzZXQgNSIsIlByZXNldCA2IiwiUHJlc2V0IDEiLCJQcmVzZXQgMiIsIlByZXNldCAzIiwiUHJlc2V0IDQiLCJQcmVzZXQgNSIsIlByZXNldCA2Il0sInNlbGVjdGVkIjowLCJzZWxlY3RlZDIiOjAsInNlbGVjdGVkMyI6MH0sInRhYkRpc3BsYXlzIjpbbnVsbCx0cnVlLHRydWUsdHJ1ZSx0cnVlLHRydWUsdHJ1ZSx0cnVlLHRydWUsdHJ1ZSx0cnVlLHRydWUsdHJ1ZV0sInN1YnRhYkRpc3BsYXlzIjp7IjAiOlt0cnVlLHRydWUsdHJ1ZSx0cnVlLHRydWVdLCIxIjpbdHJ1ZSx0cnVlLHRydWUsdHJ1ZSx0cnVlLHRydWVdLCIyIjpbdHJ1ZSx0cnVlLHRydWUsdHJ1ZV0sIjMiOlt0cnVlLHRydWUsdHJ1ZSx0cnVlXSwiNCI6W3RydWUsdHJ1ZSx0cnVlXSwiNSI6W3RydWUsdHJ1ZV0sIjYiOlt0cnVlLHRydWUsdHJ1ZSx0cnVlLHRydWUsdHJ1ZSx0cnVlXSwiNyI6W3RydWUsdHJ1ZSx0cnVlLHRydWVdfSwielVubG9ja2VkIjpmYWxzZSwieTIiOiI1MCIsInRvdGFseTIiOiI1MCIsInlRdWFkcmF0aWNzIjoiNTAiLCJ5UXVhZFVwZ3MiOltbXSxbXV0sInpsYWIiOnsienBvd2VyIjoiNTAiLCJsZXZlbHMiOltudWxsLDAsMCwwLDAsMF0sInBhcnRpY2xlcyI6W251bGwsIjAiLCIwIiwiMCIsIjAiLCIwIl0sImVtcG93ZXJtZW50cyI6IjUwIiwiY2hhcmdlZCI6MH0sImltYWdQb3dlciI6IjUwIiwidmFyU3ludGgiOnsidW5sb2NrZWQiOltmYWxzZSxmYWxzZSxmYWxzZSxmYWxzZV0sInh5IjoiNTAiLCJ0b3RhbHh5IjoiNTAifX0K

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants