用途：通过 Alpaca Broker API 在终端用户账户与外部银行之间划转资金。使用前需先阅读 alpaca-broker-integration，采用 Broker API 与 HTTP Basic 认证；账户间内部资金移动属于另一机制，见 alpaca-broker-journals。
主要能力：三条通道——ACH（ach，INCOMING/OUTGOING，美国境内，通过 Plaid processor_token 建立 ACH relationship）、电汇（wire，仅 OUTGOING，支持境内与 SWIFT 国际，使用 bank relationship/bank_id）、资金钱包（独立 /v1beta API，多币种，方向为小写 incoming/outgoing）。模型分为持久性的银行链接（relationship）与实际资金移动（transfer），一个 relationship 可支撑多笔 transfer。
使用方式：ACH 关系端点 /v1/accounts/{id}/ach_relationships；电汇收款银行 /v1/accounts/{id}/recipient_banks（旧 /banks 为别名）；创建转账 POST /v1/accounts/{id}/transfers，必填 transfer_type、amount（十进制字符串且大于 0）、direction，ACH 需 relationship_id，wire 需 bank_id，二者互斥；wire 可传 fee_payment_method（user 或 invoice）与 additional_information（非 wire 传会返回 422）。收款银行必填 name、bank_code、bank_code_type（ABA 或 BIC）、account_number；BIC 时还需 country、city、state_province、postal_code、street_address，新银行初始为 QUEUED，需 APPROVED 后电汇才能推进。
状态与事件：经典转账状态为 QUEUED→APPROVAL_PENDING→PENDING→SENT_TO_CLEARING→(APPROVED)→COMPLETE，失败出口含 REJECTED/CANCELED/RETURNED；资金钱包状态为 PENDING、EXECUTED、COMPLETE、CANCELED、FAILED。经典转账可用 SSE GET /v2/events/funding/status（统一 Transfer、BankRelationship、WireBank、FundingWallet，支持 since/until 或 since_id/until_id 重放）；资金钱包单笔状态似乎不推送，需轮询。建议按通道决定消费 SSE 或轮询，并建立状态对账轮询器。
限制与注意：电汇自 2022-06-01 起收费；入账电汇需 FFC 指令才能自动入账；所有入账存款需提供汇款人信息（Travel Rule）；ACH 账户类型仅 CHECKING/SAVINGS；immediate 已弃用（2026-08-26 日落）应停止发送；权限不足返回 403，入账电汇尝试、ID 缺失或不匹配、低于最低金额返回 422；沙箱电汇异步且仅工作日自动完成，ACH 沙箱即时结算。omnibus/sweep 模式需 Alpaca 审核并可能需本地汇款牌照，应咨询法律顾问。