Introduction

01/31/2000 — 04/30/2024Released MonthlyLast Updated 04/11/2024

The Electronic Securities Transactions dataset details how many of each type of Treasury bonds are issued, redeemed, or outstanding from Fiscal Year (FY) 2002 until present. Outstanding bonds refer to those which are still in circulation, and have not yet been redeemed. The number of outstanding Treasury bonds is determined by taking the difference between the numbers of Treasury bonds issued and redeemed. This dataset does not contain any information on the values or yields of the Treasury bonds.

Dataset Properties

Data Table Name	Field Name	Display Name	Description	Data Type	Is Required
Sales	record_date	Record Date	The date that data was published.	DATE	1
Sales	security_type_desc	Security Type Description	Tier one of a two-tier hierarchy for categorizing Treasury securities. Indicates whether a security is marketable or a savings bond.	STRING	1
Sales	security_class_desc	Security Class Description	Tier two of a two-tier hierarchy for categorizing Treasury securities. Indicates whether a marketable security is a bill, note, bond or Treasury Inflation-Protected Securities (TIPS), or whether a savings bond is series E, EE, or I.	STRING	1
Sales	securities_sold_cnt	Securities Sold Count	The number of securities sold in TreasuryDirect for a given month.	NUMBER	1
Sales	gross_sales_amt	Gross Sales Amount	Gross dollar value of securities sold in TreasuryDirect for a given month.	CURRENCY	1

Showing 1 - 5 rows of rows

API Quick Guide

Endpoints

BASE URL:

https://api.fiscaldata.treasury.gov/services/api/fiscal_service/

Table Name	Endpoint

Showing 1 - 8 rows of 8 rows

FULL URL:

https://api.fiscaldata.treasury.gov/services/api/fiscal_service/

Fields

Refer to Dataset Properties above for a data dictionary with field names and descriptions, as well as notes and known limitations. known limitations.

Field Name	Display Name	Data Type	Data Table Name

Showing 1 - 5 rows of 103 rows

Data Types

All data is returned as a string, including nulls. Refer to the chart above for the intended data type of each field.

Parameters

Refer to Dataset Properties above for a data dictionary with field names and descriptions as well as notes and known limitations

Fields

Parameter: fields=
Definition: The fields parameter allows you to select which field(s) should be included in the response.
Accepts: The fields= parameter accepts a comma-separated list of field names (no parentheses).
Required: No, specifying fields is not required to make an API request.
Default: If desired fields are not specified, all fields will be returned.
Notes: When a field named passed to the fields= parameter is not available for the endpoint accessed, an error will occur. Note that omitting fields can result in automatically aggregated and summed data results. For more information, view the full documentation on Aggregation and Sums.

EXAMPLE

?fields=

Filters

Sorting

Format

Pagination

Methods

Our APIs accept the GET method, one of the most common HTTP methods.

Example Request & Response

In this example, we are...

Specifying the endpoint
Requesting the JSON response format
Sorting the data by in descending order
Setting pagination parameters

EXAMPLE REQUEST

https://api.fiscaldata.treasury.gov/services/api/fiscal_service/undefined?sort=-undefined&format=json&page[number]=1&page[size]=1

EXPECTED RESPONSE

Loading...

Electronic Securities Transactions

Introduction

Preview

Dataset Properties

Notes & Known Limitations

API Quick Guide

For More API Information

Electronic Securities Transactions

Introduction

Preview

Dataset Properties

Notes & Known Limitations

API Quick Guide

Related Datasets