固定收益
机器翻译译自英文(docs.alpaca.markets)本页 82 段已全部译完
固定收益产品概述
Alpaca 为 Broker API 合作伙伴提供日益增多的固定收益证券。这些产品为最终用户提供了通过债务工具分散投资组合的方式。
产品类别
- 美国国债:由美国政府发行的主权债务证券。我们目前支持短期国库券(T-Bills),并将扩展到中期国债(T-Notes)和长期国债(T-Bonds)。
- 美国公司债:由美国公司发行的债务证券。我们支持多种投资级和高收益债券。
主要功能
- API 驱动的交易:所有交易和数据检索均通过 Broker API 执行。
- 最优价格执行:Alpaca 汇总多个流动性提供商的报价,以确保在美国债券市场交易时段内具有竞争力的定价。
- 广泛准入:面向所有 Broker API 合作伙伴及其最终用户开放。
- 全额面值:证券以全额面值交易,通常以 1,000 美元面值为增量。不足整单位面额的交易计划在未来版本中推出。
交易与订单
所有固定收益产品的下单和管理订单的核心机制是一致的。
市场时段
- 常规时段:美国东部时间上午 9:30 - 下午 4:00。
- 盘前和盘后队列:在美国东部时间下午 4:00 至次日上午 9:30 之间提交的订单将排队,并在市场开盘时发送执行。对于周末,在周五下午 4:00 至周一美国东部时间上午 9:30 之间提交的订单将排队,并在周一市场开盘时执行。
订单管理
- 下单:所有订单均通过 API 提交。目前支持订单有效期为 day 的市价单和限价单。
- 订单排队:在市场时段之外下的订单将获得已接受(accepted)状态,并在市场重新开盘时执行。
- 取消:
- 市场时段内:取消请求立即发送至执行场所。
- 市场时段外:状态为 accepted 的订单立即取消。已发送至场所的订单将变为 pending_cancel,直到市场重新开盘。
订单规模
- 最小订单规模:1,000 美元面值。
- 最大订单规模:1,000,000 美元面值。
定价、加价和费用
- 净价:价格以债券面值的百分比报价。这是“净价”,不包括应计利息。最终结算金额将包括附息债券的任何应计利息。
- 加价:Alpaca 和/或合作伙伴的加价包含在最终执行价格中。
- 监管费用:美国国债的销售需向交易报告与合规引擎(TRACE)报告,并产生少量监管费用。
美国国债 API 参考
美国短期国库券(T-Bills)是期限为一年或更短的短期政府债务证券。它们以折价发行,到期按面值赎回,没有定期息票支付。
列出美国国债
获取可用的美国国债证券列表。
- 端点:GET /v1/assets/fixed_income/us_treasuries
- 沙盒 URL:https://broker-api.sandbox.alpaca.markets/v1/assets/fixed_income/us_treasuries
- 生产 URL:https://broker-api.alpaca.markets/v1/assets/fixed_income/us_treasuries
查询参数:
| 参数 | 类型 | 描述 |
|---|---|---|
| subtype | string | (可选)按类型筛选:bill、note、bond、strips、tips、floating。 |
| bond_status | string | (可选)按状态筛选:outstanding、matured、pre_issuance。 |
| cusips | string | (可选)最多 1000 个 CUSIP 的逗号分隔列表。 |
| isins | string | (可选)最多 1000 个 ISIN 的逗号分隔列表。 |
示例响应:
JSON
{
"us_treasuries": [
{
"cusip": "912797MU8",
"isin": "US912797MU86",
"bond_status": "outstanding",
"tradable": true,
"subtype": "bill",
"issue_date": "2025-02-13",
"maturity_date": "2025-03-27",
"description": "United States Treasury 0.0%, 03/27/2025",
"description_short": "UST 0.0% 03/27/2025",
"close_price": 99.6839,
"close_price_date": "2025-02-27",
"close_yield_to_maturity": 4.214,
"close_yield_to_worst": 4.214,
"coupon": 0,
"coupon_type": "zero",
"coupon_frequency": "zero"
}
]
}
获取最新价格
获取指定美国国债的最新实时价格。
- 端点:GET /v1/assets/fixed_income/us_treasuries/prices
查询参数:
| 参数 | 类型 | 描述 |
|---|---|---|
| isins | string | (必填)最多 1000 个 ISIN 的逗号分隔列表。 |
示例响应:
JSON
{
"prices": {
"US912797KJ59": {
"t": "2025-02-14T20:58:00.648Z",
"p": 99.6459,
"ytm": 4.249,
"ytw": 4.249
},
"US912797KS58": {
"t": "2025-02-14T20:58:00.648Z",
"p": 99.3193,
"ytm": 4.2245,
"ytw": 4.2245
}
}
}
美国公司债 API 参考
公司债是由公司发行的债务工具。它们通常支付定期利息(息票)并在到期时偿还本金。Alpaca 目前支持非可回售、非 Reg S、非 144A 公司债,但正在努力尽快添加更多类型。
列出美国公司债
获取可用的美国公司债列表。
- 端点:GET /v1/assets/fixed_income/us_corporates
- 沙盒 URL:https://broker-api.sandbox.alpaca.markets/v1/assets/fixed_income/us_corporates
- 生产 URL:https://broker-api.alpaca.markets/v1/assets/fixed_income/us_corporates
查询参数:
| 参数 | 类型 | 描述 |
|---|---|---|
| bond_status | string | (可选)按状态筛选:outstanding、matured、pre_issuance。 |
| cusips | string | (可选)最多 1000 个 CUSIP 的逗号分隔列表。 |
| isins | string | (可选)最多 1000 个 ISIN 的逗号分隔列表。 |
| ticker | string | (可选)最多 1000 个发行人股票代码的逗号分隔列表。 |
示例响应:
JSON
{
"us_corporates": [
{
"cusip": "00138CAU2",
"isin": "US00138CAU27",
"bond_status": "outstanding",
"tradable": true,
"ticker": "AIG",
"issue_date": "2023-07-03",
"maturity_date": "2026-07-02",
"issuer": "Corebridge Global Funding",
"description": "Corebridge Global Funding 5.75%, 07/02/2026",
"coupon": 5.75,
"coupon_type": "fixed",
"coupon_frequency": "semi_annual",
"close_price": 101.2792,
"close_price_date": "2025-08-13",
"close_yield_to_maturity": 4.252774,
"close_yield_to_worst": 4.252774
}
]
}
获取最新价格
此端点与国债相同,可用于使用 ISIN 查询公司债的价格。
通用交易端点
这些端点用于美国国债和公司债的交易和头寸管理。
创建订单
- 端点:POST /v1/accounts/
{account_id}/orders
路径参数:
| 参数 | 类型 | 描述 |
|---|---|---|
| account_id | string | (必填)要为其下单的账户 ID。 |
请求体参数:
| 参数 | 类型 | 描述 |
|---|---|---|
| symbol | string | (必填)证券标识符(CUSIP 或 ISIN)。 |
| qty | string | (必填)要交易的债券面值。 |
| side | string | (必填)buy 或 sell。 |
| type | string | (必填)可以是 market 或 limit。注意:对于限价单,你还必须添加 limit_price 参数。 |
| time_in_force | string | (必填)必须为 day。 |
示例请求(国债):
JSON
{
"symbol": "912797MU8",
"qty": "1000",
"side": "buy",
"type": "market",
"time_in_force": "day"
}
示例请求(公司债):
JSON
{
"symbol": "06050WFN0",
"qty": "1000",
"side": "buy",
"type": "market",
"time_in_force": "day"
}
示例响应(订单确认):
JSON
{
"id": "7b08df51-c1ac-453c-99f9-323a5f075f0d",
"client_order_id": "5680c4bc-9ac1-4a12-a44c-df427ba53032",
"created_at": "2025-03-26T14:13:02.790553657Z",
"symbol": "912797MU8",
"asset_class": "treasury", // Will be "corporate" for corporate bonds
"qty": "1000",
"filled_qty": "0",
"type": "market",
"side": "buy",
"time_in_force": "day",
"status": "pending_new",
...
}
列出未平仓头寸
- 端点:GET /v1/accounts/
{account_id}/positions
示例响应(国债头寸):
JSON
[
{
"asset_id": "904837e3-3b76-47ec-b432-046db621571b",
"symbol": "912797MU8",
"asset_class": "treasury",
"avg_entry_price": "98.0",
"qty": "2000",
"market_value": "1980.0",
"cost_basis": "1960.0",
"current_price": "99.0"
}
]
交易事件(服务器发送事件)
接收订单状态(包括成交)的实时更新。有关事件状态的更多详细信息,请参阅订单生命周期指南。
示例响应(已成交订单):
JSON
{
"account_id": "529248ad-c4cc-4a50-bea4-6bfd2953f83a",
"at": "2022-04-19T14:12:30.656741Z",
"event": "fill",
"order": {
"id": "edada91a-8b55-4916-a153-8c7a9817e708",
"symbol": "912797MU8",
"asset_class": "treasury",
"side": "buy",
"status": "filled",
"filled_qty": "1000",
"filled_avg_price": "98.72",
"filled_at": "2022-04-19T10:12:30.609783218-04:00"
...
}
}
托管、结算和合规
证券标识符
我们为所有固定收益证券支持 CUSIP(9 个字符)和 ISIN(12 个字符)标识符。
可交易性
要确定债券是否可交易,请检查从 /assets 端点返回的资产对象中的 tradable 布尔字段。如果为 true,则该证券可交易。
托管
- 美国国债:由我们的合作伙伴 BMO 托管。
- 公司债:由 Alpaca 在存管信托公司(DTC)以类似股票的方式自行托管。
结算周期
- 美国短期国库券:按 T+1 结算(交易日期 + 1 个工作日)。
- 公司债:按 T+2 结算(交易日期 + 2 个工作日)。
合规
- 最终用户:无需额外的适当性评估或协议。
- 合作伙伴:在生产环境中启用固定收益产品之前需要技术签核。
- 确认:所有交易确认和报表均符合 SEC Rule 10b-10。
本演示文稿的内容仅供一般信息参考,截至发布之日被认为是准确的,但可能会发生变化。
固定收益证券在利率上升时可能面临更大的本金损失风险。这些投资还受到其他风险的影响,包括信用质量波动、市场波动性、流动性限制、提前还款或提前赎回、公司行动、税务影响以及其他影响因素。
所有投资均涉及风险,证券或金融产品的过往表现不保证未来结果或回报。不保证任何投资策略都能实现其目标。请注意,分散投资并不能确保盈利,也不能防止亏损。投资证券或其他金融产品时始终存在亏损的可能性。投资者在投资前应仔细考虑其投资目标和风险。
证券经纪服务由 Alpaca Securities LLC(“Alpaca Securities”)提供,其为 FINRA/SIPC 成员,是 AlpacaDB, Inc. 的全资子公司。技术和服务由 AlpacaDB, Inc. 提供。
本内容并非出售要约、要约邀请或买卖证券的建议,也不构成在任何 Alpaca Securities 未注册或未获许可的司法管辖区开设经纪账户的建议(如适用)。