Skip Navigation

Web APIs Securities

Treasury Security Information

Base URL:

https://www.treasurydirect.gov/TA_WS/

All of the content, documentation, code, and related materials made available to you through the API are subject to these terms. Access to use of the API or its content constitutes acceptance of this Agreement.

Security Endpoint

/securities/Cusip(9#)/Date(MM/DD/YYYY)

You may use any of the Fiscal Service APIs to develop a service or services to search, display, analyze, retrieve, view, and otherwise “get” information from Fiscal Service data.

Parameters

Parameters Values Allowed Example Description
callback All alpha-numeric myCallback Used by JSONP to wrap function
format xhtml, json, jsonp xhtml Determines the format that will be returned in the response

This URL returns data about a specific security identified by CUSIP and issue a date

Example

https://www.treasurydirect.gov/TA_WS/securities/announced?format=html&type=FRN

Auctioned Endpoint

Parameters

Parameters Values Allowed Example Description
callback All alpha-numeric myCallback Used by JSONP to wrap function
format xhtml, json, jsonp xhtml Determines the format that will be returned in the response
pagesize Numeric only 2 Maximum number of results to return
type Bill, Note, Bond, CMB, TIPS, FRN Bill Used to only display securities of a particular type
days Numeric only 7 How many days ago you want results for? (Note: days=0 will give you today’s results only)
reopening Yes, No Yes Used to filter securities by reopening status

This URL returns data about auctioned securities. Max 250 results. Ordered by auction date (descending), issue date (descending), security term length (ascending)

Example

https://www.treasurydirect.gov/TA_WS/securities/auctioned?format=html&type=FRN

Type Endpoint

/securities/Type(Bill,Note,Bond,CMB,TIPS,FRN)

Parameters

Parameters Values Allowed Example Description
callback All alpha-numeric myCallback Used by JSONP to wrap function
format xhtml, json, jsonp xhtml Determines the format that will be returned in the response

This URL returns data about securities of a particular type

Example

https://www.treasurydirect.gov/TA_WS/securities/FRN?format=html

Search Endpoint

/securities/search

Parameters

Parameters Values Allowed Example Description
cusip 9-characters, alpha-numeric 912796CJ6 Cusip is represented by 9 character alpha-numeric value.
startDate Numeric date in format: MM/DD/YYYY 01/01/1980 Start date for date field designated by dateFieldName parameter.
endDate Numeric date in format: MM/DD/YYYY 01/31/1980 End date for date field designated by dateFieldName parameter.
dateFieldName All alpha-numeric issueDate Determines which date field to use for startDate and endDate
callback All alpha-numeric myCallback Used by JSONP to wrap function
format json, jsonp, rss, xhtml xhtml Determines the format that will be returned in the response
pagesize Numeric only 2 Maximum number of results to return; you must also include pagenum when using pagesize
pagenum Numeric only 1 The first page number to display results for; used in combination with page size
type Bill, Note, Bond, CMB, TIPS, FRN Bill Used to only display securities of a particular type
days Numeric only 7 How many days ago you want results for? (Note: days=0 will give you today’s results only)
reopening Yes, No Yes Used to filter securities by reopening status

Notes:

Accepts parameter names that match camel cased variable names, for example auctionDate=2013-05-25&interestRate=7.5

When using variable names as parameters you can supply a value of notNull, for example auctionDate=notNull

Dates accept a value of "today" without quotes, for example issueDate=today

This URL returns data based on the parameters passed. By default it will display all securities. The list of fields which can be used as parameter names is as follows (when passing parameters remember to make the first letter lower case):

Example

https://www.treasurydirect.gov/TA_WS/securities/search?cusip= 912796CH0&format=html+

Fields

  1. Cusip
  2. IssueDate
  3. SecurityType
  4. SecurityTerm
  5. MaturityDate
  6. InterestRate
  7. RefCpiOnIssueDate
  8. AnnouncementDate
  9. AuctionDate
  10. XmlFilenameCompetitiveResults
  11. DatedDate
  12. RefCpiOnDatedDate
  13. AccruedInterestPer1000
  14. AccruedInterestPer100
  15. AdjustedAccruedInterestPer1000
  16. AdjustedPrice
  17. AllocationPercentage
  18. AllocationPercentageDecimals
  19. AnnouncedCusip
  20. AuctionFormat
  21. AverageMedianDiscountRate
  22. AverageMedianInvestmentRate
  23. AverageMedianPrice
  24. AverageMedianDiscountMargin
  25. AverageMedianYield
  26. BackDated
  27. BackDatedDate
  28. BidToCoverRatio
  29. CallDate
  30. Callable
  31. CalledDate
  32. CashManagementBillCMB
  33. ClosingTimeCompetitive
  34. ClosingTimeNoncompetitive
  35. CompetitiveAccepted
  36. CompetitiveBidDecimals
  37. CompetitiveTendered
  38. CompetitiveTendersAccepted
  39. CorpusCusip
  40. CpiBaseReferencePeriod
  41. CurrentlyOutstanding
  42. DirectBidderAccepted
  43. DirectBidderTendered
  44. EstimatedAmountOfPubliclyHeldMaturingSecuritiesByType
  45. FimaIncluded
  46. FimaNoncompetitiveAccepted
  47. FimaNoncompetitiveTendered
  48. FirstInterestPeriod
  49. FirstInterestPaymentDate
  50. FloatingRate
  51. FrnIndexDeterminationDate
  52. FrnIndexDeterminationRate
  53. HighDiscountRate
  54. HighInvestmentRate
  55. HighPrice
  56. HighDiscountMargin
  57. HighYield
  58. IndexRatioOnIssueDate
  1. IndirectBidderAccepted
  2. IndirectBidderTendered
  3. InterestPaymentFrequency
  4. LowDiscountRate
  5. LowInvestmentRate
  6. LowPrice
  7. LowDiscountMargin
  8. LowYield
  9. MaturingDate
  10. MaximumCompetitiveAward
  11. MaximumNoncompetitiveAward
  12. MaximumSingleBid
  13. MinimumBidAmount
  14. MinimumStripAmount
  15. MinimumToIssue
  16. MultiplesToBid
  17. MultiplesToIssue
  18. NlpExclusionAmount
  19. NlpReportingThreshold
  20. NoncompetitiveAccepted
  21. NoncompetitiveTendersAccepted
  22. OfferingAmount
  23. OriginalCusip
  24. OriginalDatedDate
  25. OriginalIssueDate
  26. OriginalSecurityTerm
  27. PdfFilenameAnnouncement
  28. PdfFilenameCompetitiveResults
  29. PdfFilenameNoncompetitiveResults
  30. PdfFilenameSpecialAnnouncement
  31. PricePer100
  32. PrimaryDealerAccepted
  33. PrimaryDealerTendered
  34. Reopening
  35. SecurityTermDayMonth
  36. SecurityTermWeekYear
  37. Series
  38. SomaAccepted
  39. SomaHoldings
  40. SomaIncluded
  41. SomaTendered
  42. Spread
  43. StandardInterestPaymentPer1000
  44. Strippable
  45. Term
  46. TiinConversionFactorPer1000
  47. Tips
  48. TotalAccepted
  49. TotalTendered
  50. TreasuryRetailAccepted
  51. TreasuryRetailTendersAccepted
  52. Type
  53. UnadjustedAccruedInterestPer1000
  54. UnadjustedPrice
  55. UpdatedTimestamp
  56. XmlFilenameAnnouncement
  57. XmlFilenameSpecialAnnouncement
  58. AuctionDateYear

Sample JSON output

[{"cusip":"912796QQQ","issueDate":"2014-02-14T00:00:00","securityType":"Bill","securityTerm":"2-Day","maturityDate":"2014-02-19T00:00:00","interestRate":"","refCpiOnIssueDate":"","refCpiOnDatedDate":"","announcementDate":"2014-02-11T00:00:00","auctionDate":"2014-02-14T00:00:00","auctionDateYear":"2014","datedDate":"","accruedInterestPer1000":"","accruedInterestPer100":"","adjustedAccruedInterestPer1000":"","adjustedPrice":"","allocationPercentage":"31.680000","allocationPercentageDecimals":"2","announcedCusip":"","auctionFormat":"Single-Price","averageMedianDiscountRate":"0.000000","averageMedianInvestmentRate":"","averageMedianPrice":"","averageMedianDiscountMargin":"","averageMedianYield":"","backDated":"","backDatedDate":"","bidToCoverRatio":"3.050000","callDate":"","callable":"","calledDate":"","cashManagementBillCMB":"Yes","closingTimeCompetitive":"11:30  AM","closingTimeNoncompetitive":"11:00 AM","competitiveAccepted":"9897800000","competitiveBidDecimals":"3","competitiveTendered":"30424000000","competitiveTendersAccepted":"Yes","corpusCusip":"","cpiBaseReferencePeriod":"","currentlyOutstanding":"","directBidderAccepted":"1002000000","directBidderTendered":"1006000000","estimatedAmountOfPubliclyHeldMaturingSecuritiesByType":"","fimaIncluded":"Yes","fimaNoncompetitiveAccepted":"3000000","fimaNoncompetitiveTendered":"3000000","firstInterestPeriod":"","firstInterestPaymentDate":"","floatingRate":"No","frnIndexDeterminationDate":"","frnIndexDeterminationRate":"","highDiscountRate":"0.005000","highInvestmentRate":"0.005000","highPrice":"99.999931","highDiscountMargin":"","highYield":"","indexRatioOnIssueDate":"","indirectBidderAccepted":"5626600000","indirectBidderTendered":"22416000000","interestPaymentFrequency":"None","lowDiscountRate":"0.000000","lowInvestmentRate":"","lowPrice":"","lowDiscountMargin":"","lowYield":"","maturingDate":"2014-02-14T00:00:00","maximumCompetitiveAward":"3500000000","maximumNoncompetitiveAward":"5000000","maximumSingleBid":"3500000000","minimumBidAmount":"100","minimumStripAmount":"","minimumToIssue":"100","multiplesToBid":"100","multiplesToIssue":"100","nlpExclusionAmount":"0","nlpReportingThreshold":"3500000000","noncompetitiveAccepted":"100000000","noncompetitiveTendersAccepted":"Yes","offeringAmount":"10000000000","originalCusip":"","originalDatedDate":"","originalIssueDate":"","originalSecurityTerm":"2-Day","pdfFilenameAnnouncement":"A_20140124_3.pdf","pdfFilenameCompetitiveResults":"R_20140127_7.pdf","pdfFilenameNoncompetitiveResults":"","pdfFilenameSpecialAnnouncement":"","pricePer100":"99.999931","primaryDealerAccepted":"3269200000","primaryDealerTendered":"7002000000","reopening":"No","securityTermDayMonth":"2-Day","securityTermWeekYear":"0-Week","series":"","somaAccepted":"0","somaHoldings":"0","somaIncluded":"No","somaTendered":"0","spread":"","standardInterestPaymentPer1000":"","strippable":"","term":"","tiinConversionFactorPer1000":"","tips":"No","totalAccepted":"10000800000","totalTendered":"30527000000","treasuryDirectAccepted":"0","treasuryDirectTendersAccepted":"No","type":"CMB","unadjustedAccruedInterestPer1000":"","unadjustedPrice":"","updatedTimestamp":"2014-02-14T11:30:40","xmlFilenameAnnouncement":"A_20140214_2CMB  2day.xml","xmlFilenameCompetitiveResults":"R_20140127_7CMB2dayretry.xml","xmlFilenameSpecialAnnouncement":""}]

Sample XHTML output

Securities
CusipIssueDateSecurityTypeSecurityTermMaturityDateInterestRateRefCpiOnIssueDateAnnouncementDateAuctionDateAuctionDateYearDatedDateRefCpiOnDatedDateAccruedInterestPer1000AccruedInterestPer100AdjustedAccruedInterestPer1000AdjustedPriceAllocationPercentageAllocationPercentageDecimalsAnnouncedCusipAuctionFormatAverageMedianDiscountRateAverageMedianInvestmentRateAverageMedianPriceAverageMedianDiscountMarginAverageMedianYieldBackDatedBackDatedDateBidToCoverRatioCallDateCallableCalledDateCashManagementBillCMBClosingTimeCompetitiveClosingTimeNoncompetitiveCompetitiveAcceptedCompetitiveBidDecimalsCompetitiveTenderedCompetitiveTendersAcceptedCorpusCusipCpiBaseReferencePeriodCurrentlyOutstandingDirectBidderAcceptedDirectBidderTenderedEstimatedAmountOfPubliclyHeldMaturingSecuritiesByTypeFimaIncludedFimaNoncompetitiveAcceptedFimaNoncompetitiveTenderedFirstInterestPeriodFirstInterestPaymentDateFloatingRateFrnIndexDeterminationDateFrnIndexDeterminationRateHighDiscountRateHighInvestmentRateHighPriceHighDiscountMarginHighYieldIndexRatioOnIssueDateIndirectBidderAcceptedIndirectBidderTenderedInterestPaymentFrequencyLowDiscountRateLowInvestmentRateLowPriceLowDiscountMarginLowYieldMaturingDateMaximumCompetitiveAwardMaximumNoncompetitiveAwardMaximumSingleBidMinimumBidAmountMinimumStripAmountMinimumToIssueMultiplesToBidMultiplesToIssueNlpExclusionAmountNlpReportingThresholdNoncompetitiveAcceptedNoncompetitiveTendersAcceptedOfferingAmountOriginalCusipOriginalDatedDateOriginalIssueDateOriginalSecurityTermPdfFilenameAnnouncementPdfFilenameCompetitiveResultsPdfFilenameNoncompetitiveResultsPdfFilenameSpecialAnnouncementPricePer100PrimaryDealerAcceptedPrimaryDealerTenderedReopeningSecurityTermDayMonthSecurityTermWeekYearSeriesSomaAcceptedSomaHoldingsSomaIncludedSomaTenderedSpreadStandardInterestPaymentPer1000StrippableTermTiinConversionFactorPer1000TipsTotalAcceptedTotalTenderedTreasuryDirectAcceptedTreasuryDirectTendersAcceptedTypeUnadjustedAccruedInterestPer1000UnadjustedPriceXmlFilenameAnnouncementXmlFilenameCompetitiveResultsXmlFilenameSpecialAnnouncement
912796QQQ2014-02-14T00:00:00Bill2-Day2014-02-19T00:00:002014-02-11T00:00:002014-02-14T00:00:00201431.6800002Single-Price0.0000003.050000Yes11:30 AM11:00 AM9897800000330424000000Yes10020000001006000000Yes30000003000000No0.0050000.00500099.999931562660000022416000000None0.0000002014-02-14T00:00:0035000000005000000350000000010010010010003500000000100000000Yes100000000002-DayA_20140124_3.pdfR_20140127_7.pdf99.99993132692000007002000000No2-Day0-Week00No0No10000800000305270000000NoCMBA_20140214_2CMB 2day.xmlR_20140127_7CMB2dayretry.xml