为债券市场数据选择
免费固定收益数据 API

快速结论

用户搜索免费固定收益数据 API 时要完成什么

当前中文结果主要是 API 文档、免费试用产品页、官方市场数据源和接入指南。核心需求是找到可访问的接口，以程序方式获取当前或历史固定收益数据；次要需求是比较认证方式、额度、资产覆盖、证券标识、历史范围、许可和标准化 JSON。

排名页面反复覆盖的数据与功能

反复出现的实体和字段包括 FINRA、美国财政部、FRED、政府债与公司债、ISIN 与 CUSIP 标识、发行人、票息、到期日、价格、收益率、评级、久期、历史观测、REST 或 XML、JSON、API Key、额度、时间戳、许可和数据出处。

选择 API 前先明确固定收益数据层级

“债券数据”并不是一个单一数据集。国债曲线看板、公司债筛选器、组合估值引擎和成交监测流程需要的记录完全不同。应先明确应用要支持的决策，再确定能够回答该问题的数据层级，避免先选了方便的收益率序列接口，后来才发现产品真正需要逐券价格、赎回条款、应计利息或成交记录。

值得评估的免费固定收益数据接口

“免费”不代表条款完全相同。接入当天仍应核对各提供方文档，因为认证、额度、合理使用规则和数据集可用性可能变化。

如何用 Python 调用免费固定收益数据 API

1. 明确债券范围和必需字段

先明确政府债、公司债、市政债或证券化债务的范围，再列出应用真正需要的证券标识、发行人字段、票息、到期日、价格、收益率、评级、久期、币种、观测日期、频率和历史区间。

2. 检查元数据、认证和调用限制

确认证券或序列标识、币种、价格与收益率口径、日计数约定、更新方式、修订政策、API Key、限流、再使用许可与署名要求，再编写生产代码。

3. 小范围调用并验证响应

下面的示例无需 API Key，读取指定年份的美国财政部票面收益率观测。代码不会只返回一个没有语义的数字，而是保留观测日期、期限和来源。财政部对全历史 XML 下载另有分页说明，生产回填应遵循官方约定，不能猜测分页大小。

import requests
import xml.etree.ElementTree as ET

url = (
    "https://home.treasury.gov/resource-center/data-chart-center/"
    "interest-rates/pages/xml"
)
params = {
    "data": "daily_treasury_yield_curve",
    "field_tdr_date_value": "2025",
}

response = requests.get(url, params=params, timeout=30)
response.raise_for_status()
root = ET.fromstring(response.content)

ns = {
    "atom": "http://www.w3.org/2005/Atom",
    "m": "http://schemas.microsoft.com/ado/2007/08/dataservices/metadata",
    "d": "http://schemas.microsoft.com/ado/2007/08/dataservices",
}

records = []
for entry in root.findall("atom:entry", ns):
    props = entry.find("atom:content/m:properties", ns)
    if props is None:
        continue
    date = props.findtext("d:NEW_DATE", default="", namespaces=ns)
    ten_year = props.findtext("d:BC_10YEAR", default="", namespaces=ns)
    if date and ten_year:
        records.append({
            "observation_date": date,
            "tenor": "10Y",
            "par_yield_percent": float(ten_year),
            "source": "U.S. Department of the Treasury",
        })

assert records, "No Treasury observations returned"
print(records[-1])

4. 加入缓存、重试和出处记录

按发布日程缓存，遵循重试建议，记录抓取时间和序列元数据，保留来源 URL，并监控数据结构变化。

发布前验证固定收益数据 API 响应

HTTP 200 只说明服务器已响应。首先要确认证券身份：发行人、币种、票息、到期日、证券类型以及至少一个稳定标识必须一致。随后验证价格语义。98.40 可能是每 100 面值的净价、包含应计利息的全价、估值价、买价或历史成交价；4.6 的收益率也可能是百分数或小数、到期收益率或最差收益率。必须保存供应商字段定义，不能只凭列名推断。

最低限度的校验记录

每条发布记录至少保留：提供方、数据集、请求 URL 或操作、证券标识及其类型、币种、数值、单位、价格或收益率口径、观测时间、抓取时间、时区、延迟状态和更正状态。对于可赎回或可回售债券，还要保存分析指标使用的现金流计划与期权假设。无法解释的日期、重复主键、非除息规则下的负应计利息、比例未知的价格以及缺少复利约定的收益率都应拒绝进入成品数据。

官方数据源与固定收益数据聚合 API 怎么选

最重视权威性与直接出处时，美国财政部数据源是首选。它提供曲线观测与定义，但 XML 解析不如标准化 JSON 方便。聚合 API 可简化曲线快照、期限利差、跨国覆盖和 Agent 接入，但必须检查其转换逻辑和免费套餐条款。

什么时候更适合使用聚合 API

需要统一查询多个国家或提供方时，聚合 API 更适合原型、跨国看板和 Agent 工具，但不会取代原始机构的权威性。应保存提供方、数据集与序列 ID、单位、频率、抓取时间和来源 URL，并检查数值转换、更新延迟和许可；重要结果仍需与官方门户核对。

使用前验证元数据、修订与数据质量

不要把序列名称当作完整定义

同名字段可能衡量不同概念。“价格”可能是买价、卖价、中间价、最近成交价、综合价、估值净价或估值全价；“收益率”可能是当期收益率、到期收益率、赎回收益率、最差收益率、票面收益率、即期利率或指数收益率。入库前应保存计算方法、日计数约定、复利频率、结算日、应计利息处理、赎回假设、币种、最低面额与时间戳，并同时保留代码及可读标签。

把估值价、报价与成交视为不同证据

许多债券交易并不活跃。估值价可能综合成交、可比券、曲线和模型；报价表示交易意愿但不等于成交；TRACE 成交是可观察报告，但可能存在延迟、更正、规模封顶或传播规则。应保存价格来源类别和方法版本，让下游判断适用性。不能用上一期数值无标记地填补空缺，也不能为了曲线平滑而平均性质不同的证据。

只有统一计算约定后，债券分析指标才可比较

计算收益率前先构建完整现金流计划

到期收益率不能仅凭价格、票息和到期日安全还原。计算还需要结算日、付息频率、日计数基础、营业日规则、应计利息、偿还价值以及准确的未来现金流计划。零息债、浮息债、摊还债、通胀挂钩债和首尾票息不规则的债券需要不同处理；可赎回债券还要明确输出的是到期收益率、下次赎回收益率还是最差收益率。如果 API 给出收益率却不披露假设，应把它视为供应商计算指标，不能用另一套约定悄悄重算后直接比较。

久期、凸性与利差必须绑定有文档的曲线

修正久期取决于收益率约定和支付计划；有效久期还依赖定价模型与明确的曲线冲击。Z-spread 需要即期曲线，期权调整利差则需要利率模型与嵌入期权假设。因此，标准化数据结构不应只保留一个笼统的 duration 或 spread 字段，而要保存指标类型、曲线 ID、曲线日期、模型或方法、冲击幅度、复利基础、计算时间和提供方。比较两个 API 时，应先用少量普通固定票息债核对现金流与应计利息，再在可解释的容差内比较衍生指标。

构建可靠的生产级数据接入

分离发现、抓取、标准化与交付

数据管道应分离发现、抓取、标准化和交付。抓取阶段保存原始响应、HTTP 状态、请求参数和时间；标准化阶段统一日期、单位和缺失值，但保留原始表达；交付阶段再向看板、数据库、API 或 Agent 提供已验证数据。保留原始响应便于重新处理。

让轮询、缓存和重试匹配发布日程

基础条款、每日曲线、盘中报价、成交和评级的变化速度不同，应该按各数据源的生命周期轮询，而不是使用同一个全局定时器。缓存成功响应，在接口支持时使用条件请求，并以幂等方式处理更正。债券可能被赎回、到期、置换、违约、部分偿还或更换标识，证券主数据必须保存这些事件，不能直接删除旧记录。临时故障可有限重试，无效标识不能无限请求；还要监控时间戳陈旧、覆盖范围骤降、数据结构变化与空值率异常。

固定收益数据 API 的常见应用场景

研究、看板、提醒与 AI Agent

固定收益数据可用于曲线看板、期限与利差比较、信用筛选、组合现金流阶梯、久期与凸性报告、流动性监控、估值控制、回测和数据型 Agent。研究笔记可能只需日终观测，交易前流程则可能需要可执行报价与权限控制。组合估值必须具备完整持仓、应计利息和统一定价时点；风险报告还需要采用同一套有文档的计算约定。

面向 AI Agent 时，应把“按标识查询债券基础资料”“读取指定日期的曲线”“获取最近成交或估值”等任务封装成范围明确的操作，并说明参数、证券范围、价格口径、单位、错误和出处。Agent 输出应注明发布机构、证券或序列标识和观测日期，并区分检索到的事实与模型生成的解释。QVeris 可帮助调用和保留审计记录，原始机构仍是权威来源。

QVeris 如何帮助接入固定收益数据 API

• 使用 QVeris 工具查找器探索经济或金融数据相关能力。
• 在 Agent 调用前检查操作参数和响应结构。
• 在下游记录中保留提供方 URL、时间戳、序列 ID 和许可信息。

FAQ

外部参考链接