技能介绍

解决资金进出券商账户的集成难题

在为券商终端用户提供入金与出金功能时，开发者常面临外部银行系统对接复杂、状态管理混乱的问题。Alpaca Broker API 的资金划转（Funding & Transfers）机制将这一过程抽象为清晰的资金通道，专门用于处理外部世界与用户账户之间的资金流动，帮助团队快速构建合规的充值与提现链路。

核心模型与工作流

该技能基于两个核心概念：银行链接（Relationship） 和 转账（Transfer）。

银行链接：作为持久化的外部银行账户绑定关系，它本身不移动资金，但拥有独立的状态机。对于电汇（Wire）等特定通道，链接必须处于 APPROVED 状态才能发起转账。
转账记录：代表实际的资金移动动作。每次转账都会通过 ID 引用一个已建立的银行链接，且同一个链接可以支撑多次转账请求。

在实际开发中，建议先参照 alpaca-broker-integration 完成基础的 HTTP Basic auth 鉴权配置，再调用 /v1/accounts/{account_id}/transfers 端点推进资金流转。

适用边界与注意事项

需要特别注意的是，该机制仅适用于外部银行与券商账户之间的资金划转。如果你的需求是在同一主账户（Omnibus）下的不同子账户之间进行内部资金调拨，请使用 alpaca-broker-journals 机制，两者在底层实现和合规逻辑上完全不同。此外，电汇类转账对银行链接的审核状态有严格要求，未审批通过的链接会导致转账请求失败。