托管账户 | Alpaca 简体中文

托管账户使成年人能够代表未成年人开立账户，而未成年人本身不具备签订开立经纪账户法律合同的能力。Alpaca 目前支持两种托管账户类型：Uniform Transfers to Minors Act（UTMA）和 Uniform Gifts to Minors Act（UGMA）。作为该服务的一部分，Alpaca 将托管账户、生成月度托管账户对账单，并处理所有年度税务申报。请注意，所有税务申报都将基于未成年人的信息。此外，未成年人不能使用或交易托管账户，因为他们只是受益人。托管账户不支持卖空、保证金或日内交易。每个开户步骤与 Alpaca 提供的标准经纪账户相同，任何 KYC 检查都将针对成年人进行。本文档旨在突出开户流程之间的任何显著差异。

托管账户对象

属性	说明
account_type	指定要在 Alpaca 开立哪种类型的账户 - 传入 'custodial' 将创建托管账户。
contact	有关用户的联系信息。
identity	有关用户的 KYC 信息。
disclosures	有关用户的必需披露。
documents	需要上传的任何文件（例如护照、签证……）。
trusted_contact	用户的可信联系人联系信息，以备需要账户恢复时使用。
minor_identity	与该账户关联的未成年人的信息。当 account_type 为 'custodial' 时，此对象中的所有字段都是必需的。

未成年人身份对象

属性	类型
given_name	string
family_name	string
email	string
date_of_birth	date
tax_id	string
tax_id_type	ENUM.TaxIdType
country_of_citizenship	string
country_of_birth	string
country_of_tax_residence	string
state	string

创建托管账户

POST /v1/accounts

托管人或与账户关联的成年人将提交包含所需信息的账户申请以及已签署的托管人客户协议。这将代表未成年人为该成年人创建一个托管账户，未成年人的信息将在 minor_identity 部分提交。

如果你使用 Alpaca 进行 KYCaaS，我们将执行必要的检查，并在确定托管人信息合法后批准账户。请参阅 Events API 了解账户状态变更以及任何需要你采取进一步行动的 KYC 更新。

注意：所有账户状态及其定义可在这里找到。

示例请求

{
  "account_type": "custodial",
  "contact": {
    "email_address": "cool_alpaca@example.com",
    "phone_number": "555-676-7788",
    "street_address": ["20 N San Mateo Dr"],
    "city": "San Mateo",
    "state": "CA",
    "postal_code": "94401",
    "country": "USA"
  },
  "identity": {
    "given_name": "John",
    "family_name": "Doe",
    "date_of_birth": "1990-01-01",
    "tax_id": "676-55-4321",
    "tax_id_type": "USA_SSN",
    "country_of_citizenship": "USA",
    "country_of_birth": "USA",
    "country_of_tax_residence": "USA",
    "funding_source": ["employment_income"],
    "annual_income_min": "30000",
    "annual_income_max": "50000",
    "liquid_net_worth_min": "100000",
    "liquid_net_worth_max": "150000",
    "total_net_worth_min": "10000",
    "total_net_worth_max": "10000",
    "liquidity_needs": "does_not_matter",
    "investment_experience_with_stocks": "over_5_years",
    "investment_experience_with_options": "over_5_years",
    "risk_tolerance": "conservative",
    "investment_objective": "market_speculation",
    "investment_time_horizon": "more_than_10_years",
    "marital_status": "MARRIED",
    "middle_name": "M",
    "number_of_dependents": 5
  },
  "disclosures": {
    "is_control_person": false,
    "is_affiliated_exchange_or_finra": false,
    "is_politically_exposed": false,
    "immediate_family_exposed": false
  },
  "agreements": [

         {
      "agreement": "customer_agreement",
      "signed_at": "2025-09-11T18:13:44Z",
      "ip_address": "185.13.21.99"

   }
  ],
  "documents": [
    {
      "document_type": "identity_verification",
      "document_sub_type": "passport",
      "content": "/9j/Cg==",
      "mime_type": "image/jpeg"
    }
  ],
  "trusted_contact": {
    "given_name": "Jane",
    "family_name": "Doe",
    "email_address": "jane.doe@example.com"
  },
  "minor_identity": {
    "given_name": "Jimmy",
    "family_name": "Doe",
    "email": "foo@bar.com",
    "date_of_birth": "2015-01-01",
    "tax_id": "676-54-4321",
    "tax_id_type": "USA_SSN",
    "country_of_citizenship": "USA",
    "country_of_birth": "USA",
    "country_of_tax_residence": "USA",
    "state": "CA"
  }
}

托管人客户协议和托管账户披露的副本可应要求提供 - 请联系 Alpaca 了解更多信息。

注意：修订版本遵循 RR.MM.YYYY 格式（RR 表示修订号）；请求载荷必须包含最新的 customer_agreement（修订版 ≥ 18），并明确指定修订版本。

响应模型

属性	类型	说明
id	string/UUID	用于后续引用的账户标识 UUID
account_number	string	可向最终用户显示的可读账号
status	ENUM.AccountStatus
currency	string	始终为 USD
last_equity	string	日终权益计算（现金 + 多头市值 + 空头市值）
created_at	string	RFC3339 格式

{
  "account": {
    "id": "0d18ae51-3c94-4511-b209-101e1666416b",
    "account_number": "9034005019",
    "status": "ACTIVE",
    "currency": "USD",
    "last_equity": "1500.65",
    "created_at": "2019-09-30T23:55:31.185998Z"
  }
}

错误代码

错误代码	描述
400	Bad Request：请求中的正文无效
409	Conflict：已存在使用相同电子邮件地址注册的账户。
422	Unprocessable Entity：输入值无效。
500	Internal Server Error：发生了某些服务器错误。请联系 Alpaca。

更新账户

PATCH /v1/accounts/{account_id}

此操作更新托管账户信息。除了传统经纪账户所列内容之外，未成年人身份信息也可修改。

响应参数

属性	要求
contact	可选
identity	可选
disclosures	可选
documents	可选
trusted_contact	可选
minor_identity	可选

未成年人身份参数

属性	类型	要求	说明
given_name	string	可选
family_name	string	可选
email	string	可选
date_of_birth	date	可选	RFC3339 格式
tax_id	string	可选
tax_id_type	ENUM.TaxIdType	必填	必须为 'USA_SSN'
country_of_citizenship	string	必填	必须为 'USA'
country_of_birth	string	必填	可接受 3 字母国家代码
country_of_tax_residence	string	必填	必须为 'USA'
state	string	必填	仅接受两字母州代码

响应

如果所有参数有效且已进行更新，则返回状态码 200。响应为账户模型。

错误代码

错误代码	描述
400	Bad Request：请求中的正文无效
422	Unprocessable Entity：请求正文包含不允许更新的属性。
500	Internal Server Error：发生了某些服务器错误。请联系 Alpaca。

附录

月度对账单示例：