Friends Data API独立数据服务

DECISION MODEL DATA · 宏观、统计与监管

US Treasury

美国国债拍卖、联邦债务与月度收支统计。

API 调用说明

能回答的问题

  • 联邦债务由哪些部分组成?
  • 月度收入、支出与赤字如何变化?

状态与已知缺口

部分可用

已有拍卖样本、债务历史和月度财政表,存量与流量分开说明。

  • 部分拍卖尚未举行,结果字段可能为空。
  • 债务余额不能作为赤字流量。

提供方

PRODUCT

美国国债拍卖原始样本

treasury_auction_native

每行是一条 Treasury 拍卖记录,含公告、拍卖、发行与到期日期以及可用结果;未来拍卖结果可为空。

粒度
每拍卖记录每快照一行
时间范围
2026-09-29 ~ 2026-10-08 · auction_date 拍卖日期
采集时间
2026-10-04T07:55:19.249038Z ~ 2026-10-04T07:55:19.249038Z
记录数
10

API 调用示例

使用现有 Friends API Key;分页时将响应的 next_cursor 作为 cursor 继续读取。

HTTP · GET
/api/v1/data/datasets/decision_model/records/rows?product=treasury_auction_native&limit=100

字段表 · 114 个字段

字段名中文说明
accrued_int_per100每 100 面值应计利息
accrued_int_per1000每 1000 面值应计利息
adj_accrued_int_per1000每 1000 面值调整后应计利息
adj_price调整后价格
allocation_pctage分配百分比
allocation_pctage_decimals分配百分比小数位
announcemt_date拍卖公告日期
announcemtd_cusip公告中的 CUSIP
auction_date拍卖日期
auction_format拍卖形式
avg_med_discnt_margin来源平均或中位贴现利差
avg_med_discnt_rate来源平均或中位贴现率
avg_med_investment_rate来源平均或中位投资收益率
avg_med_price来源平均或中位价格
avg_med_yield来源平均或中位收益率
back_dated回溯起息标记
back_dated_date回溯起息日期
bid_to_cover_ratio投标覆盖倍数
call_date可赎回日期
callable是否可赎回
called_date赎回日期
cash_management_bill_cmb现金管理国库券标记
closing_time_comp竞争性投标截止时间
closing_time_noncomp非竞争性投标截止时间
comp_accepted竞争性投标接受金额
comp_bid_decimals竞争性报价小数位数
comp_tendered竞争性投标金额
comp_tenders_accepted来源竞争性接受投标统计
corpus_cusip原始本金分拆 CUSIP
cpi_base_reference_periodCPI 基准参考期
currently_outstanding当前未偿标记
cusip国债 CUSIP 标识
dated_date证券起息日期
direct_bidder_accepted直接投标者接受金额
direct_bidder_tendered直接投标者投标金额
est_pub_held_mat_by_type_amt按证券类型列出的公众持有到期金额估计
fima_included原始 FIMA 纳入标记
fima_noncomp_accepted原始 FIMA 非竞争性接受金额
fima_noncomp_tendered原始 FIMA 非竞争性投标金额
first_int_payment_date首次付息日期
first_int_period首次付息期间
floating_rate浮息标记
frn_index_determination_date浮息基准确定日期
frn_index_determination_rate浮息基准确定利率
high_discnt_margin原始最高贴现利差
high_discnt_rate原始最高贴现率
high_investment_rate原始最高投资收益率
high_price原始最高价格
high_yield原始最高收益率
index_ratio_on_issue_date发行日指数比率
indirect_bidder_accepted间接投标者接受金额
indirect_bidder_tendered间接投标者投标金额
inflation_index_security通胀挂钩证券标记
int_payment_frequency付息频率
int_rate票息利率
issue_date发行日期
low_discnt_margin原始最低贴现利差
low_discnt_rate原始最低贴现率
low_investment_rate原始最低投资收益率
low_price原始最低价格
low_yield原始最低收益率
mat_date来源另列的到期日期
maturity_date到期日期
max_comp_award竞争性投标最大分配参数
max_noncomp_award非竞争性投标最大分配参数
max_single_bid单笔最大投标参数
min_bid_amt最小投标金额
min_strip_amt最小分拆金额
min_to_issue最小发行金额参数
multiples_to_bid投标金额单位倍数
multiples_to_issue发行金额单位倍数
nlp_exclusion_amt原始 NLP 排除金额
nlp_reporting_threshold原始 NLP 报告阈值
noncomp_accepted非竞争性投标接受金额
noncomp_tenders_accepted来源非竞争性接受投标统计
offering_amt发行规模金额
original_cusip原始证券 CUSIP
original_dated_date原始起息日期
original_issue_date原始发行日期
original_security_term原始证券期限
pdf_filenm_announcemt原始拍卖公告 PDF 文件名
pdf_filenm_comp_results竞争性拍卖结果 PDF 文件名
pdf_filenm_noncomp_results非竞争性拍卖结果 PDF 文件名
pdf_filenm_spec_announcemt特殊公告 PDF 文件名
price_per100每 100 面值价格
primary_dealer_accepted一级交易商接受金额
primary_dealer_tendered一级交易商投标金额
record_date原始记录日期
ref_cpi_on_dated_date起息日参考 CPI
ref_cpi_on_issue_date发行日参考 CPI
reopening续发行标记
security_term证券期限
security_term_day_month证券期限的日或月标签
security_term_week_year证券期限的周或年标签
security_type证券类型
series来源系列名称
soma_accepted原始 SOMA 接受金额
soma_holdings原始 SOMA 持有金额
soma_included原始 SOMA 纳入标记
soma_tendered原始 SOMA 投标金额
spread原始利差或价差,按对应产品口径解释
std_int_payment_per1000每 1000 面值标准利息支付额
strippable是否可分拆
tiin_conversion_factor_per1000每 1000 面值原始转换因子
tint_cusip_1原始利息分拆 CUSIP 1
tint_cusip_2原始利息分拆 CUSIP 2
total_accepted总接受金额
total_tendered总投标金额
treas_retail_acceptedTreasury 零售投标接受金额
treas_retail_tenders_acceptedTreasury 零售接受投标统计
unadj_accrued_int_per1000每 1000 面值未调整应计利息
unadj_price未调整价格
xml_filenm_announcemt原始拍卖公告 XML 文件名
xml_filenm_comp_results竞争性拍卖结果 XML 文件名

PRODUCT

美国联邦债务余额历史

treasury_debt_history

每行是指定日期的联邦债务总余额、公众持有和政府内部持有金额,单位美元。

粒度
每参考日每来源快照一行
时间范围
1993-04-01 ~ 2026-10-02 · record_date 参考日期
采集时间
2026-10-04T07:55:42.897874Z ~ 2026-10-06T04:28:29.498829Z
记录数
8,426

API 调用示例

使用现有 Friends API Key;分页时将响应的 next_cursor 作为 cursor 继续读取。

HTTP · GET
/api/v1/data/datasets/decision_model/records/rows?product=treasury_debt_history&limit=100

字段表 · 11 个字段

字段名中文说明
debt_held_public_amt公众持有债务金额,美元
intragov_hold_amt政府内部持有债务金额,美元
record_calendar_day记录参考日期的公历日
record_calendar_month记录参考日期的公历月
record_calendar_quarter记录参考日期的公历季度
record_calendar_year记录参考日期的公历年
record_date原始记录日期
record_fiscal_quarter记录参考日期的财政季度
record_fiscal_year记录参考日期的财政年
src_line_nbr来源记录行编号
tot_pub_debt_out_amt联邦债务总余额,美元

PRODUCT

美国财政月度收支表

treasury_monthly_statement

每行是月度财政表的一个分类或行项目,保留层级、收入、支出和盈余/赤字字段及原始单位口径。

粒度
每参考月分类项目一行
时间范围
2015-03-31 ~ 2026-08-31 · record_date 与财政年月字段
采集时间
2026-10-06T04:28:31.490721Z ~ 2026-10-06T04:28:31.490721Z
记录数
3,117

API 调用示例

使用现有 Friends API Key;分页时将响应的 next_cursor 作为 cursor 继续读取。

HTTP · GET
/api/v1/data/datasets/decision_model/records/rows?product=treasury_monthly_statement&limit=100

字段表 · 21 个字段

字段名中文说明
classification_desc财政项目分类描述
classification_id财政项目分类编号
current_month_dfct_sur_amt当月赤字或盈余金额,结合原表单位及符号解读
current_month_gross_outly_amt当月支出金额,结合原表单位解读
current_month_gross_rcpt_amt当月收入金额,结合原表单位解读
data_type_cd原始数据类型代码
line_code_nbr财政行项目代码
parent_id财政项目上级分类标识
print_order_nbr原始显示次序
record_calendar_day记录参考日期的公历日
record_calendar_month记录参考日期的公历月
record_calendar_quarter记录参考日期的公历季度
record_calendar_year记录参考日期的公历年
record_date原始记录日期
record_fiscal_quarter记录参考日期的财政季度
record_fiscal_year记录参考日期的财政年
record_type_cd原始记录类型代码
sequence_level_nbr财政层级序号
sequence_number_cd财政排序序号
src_line_nbr来源记录行编号
table_nbr财政表号

数据观测时间 2026-10-06T17:38:47.854586Z