Alpaca券商账簿划转

解决了什么问题

在 Alpaca 券商的 omnibus 账户体系里，资金常需在主账户、预注资账户、客户子账户之间流转——比如客户触发即时注资时从公司总账户划款到其子账户，或是发放返现、股票奖励时把金额转入目标账户。原生 Broker API 的 journals 接口分散在不同文档页，字段参数、账户 ID 格式、划转方向（from/to）的规则不够直观，手动对接容易出错，且每次业务场景都要重复编写认证和请求逻辑。

技能的核心能力

该技能封装了 Alpaca Broker API 的 Journals 划转端点，核心能力包括：

• 定义 omnibus 内部两账户间的资金转移规则，支持指定 from_account_id（资金来源账户）和 to_account_id（资金接收账户）
• 覆盖即时注资、返现发放、股票奖励入账等典型场景的资金划转逻辑
• 简化 Broker API 的认证流程（HTTP Basic auth），无需手动处理 token 传递

关键步骤如下：

1. 通过 Broker API 的认证机制获取访问权限
2. 调用 journals 端点，传入账户 ID 和划转金额等参数
3. 处理接口响应，确认资金划转状态

适用边界与注意点

• 仅限 omnibus 内部：仅支持同一 Alpaca omnibus 体系下的账户间划转，不涉及外部银行系统（外部转账需使用 alpaca-broker-funding-transfers 技能）
• 使用前需先掌握 alpaca-broker-integration 技能的 Broker API 基础逻辑和认证方式
• 划转账户需为自有或授权管理的 omnibus 账户，需确保账户 ID 格式符合 Alpaca 规范

参考资料

• 官方指南：https://docs.alpaca.markets/docs/funding-via-journals
• API 参考：https://docs.alpaca.markets/reference/createjournal
• 实时 schema：通过 alpaca-docs MCP 获取端点 /v1/journals 的详细定义