Create an Account

Submit an account application with KYC information. This will create a trading account for the end user. The account status may or may not be ACTIVE immediately and you will receive account status updates on the event API.

Body Params
string
enum

Possible values are:

  • trading
  • custodial
  • donor_advised
  • ira
Allowed:
string
enum

IRA Account only

Possible values are:

  • traditional
  • roth
Allowed:
contact
object
required

Contact is the model for the account owner contact information.

identity
object
required

Identity is the model to provide account owner’s identity information.

disclosures
object
required

Disclosures fields denote if the account owner falls under each category defined by FINRA rule. The client has to ask questions for the end user and the values should reflect their answers. If one of the answers is true (yes), the account goes into ACTION_REQUIRED status.

agreements
array of objects
required

The client must present the Alpaca Account and Margin Agreements to the end user, and confirm they have read and agreed to the agreement.

agreements*
documents
array of objects
documents
trusted_contact
object

This model input is optional. However, the client should make reasonable effort to obtain the trusted contact information. See more details in FINRA Notice 17-11

Only one of the following is required:

  • email_address
  • phone_number
  • street_address
enabled_assets
array of objects

Will default to us_equity. Alpaca has the ability to update the default value upon request.

enabled_assets
beneficiaries
array of objects

IRA Account only. A user can submit max 6 beneficiaries.

beneficiaries
trading_configurations
object

Represents additional configuration settings for an account

cash_interest
object

The configuration of the account's USD cash interest program when creating an account. If cash_interest is not provided and there is a default APR tier defined, that tier will be used. To enroll the account in a non-default APR tier, provide the cash_interest object with the desired apr_tier_name. The status should not be specified on enrollment. The response will contain a status of PENDING_CHANGE. An event showing the status change to ACTIVE will be generated when the enrollment is complete.

fpsl
object

The account's Fully Paid Securities Lending (FPSL) configuration. To enroll the account for a market, specify the tier_id. The status should not be specified on enrollment. Currently only the US market is supported.

string
enum

The user's investment risk tolerance. This field should be used instead of the deprecated risk_tolerance under identity.

Allowed:
string
enum

The user's investment objective. This field should be used instead of the deprecated investment_objective under identity.

Allowed:
string
enum

The expected period of time the user plan to invest to achieve his/her financial goal(s). This field should be used instead of the deprecated investment_time_horizon under identity.

Allowed:
string
enum

The user's ability to quickly and easily convert to cash all or a portion of the investments in this account without experiencing significant loss in value. This field should be used instead of the deprecated liquidity_needs under identity.

Allowed:
Responses

409

There is already an existing account registered with the same email address.

Language
Credentials
Basic
base64
:
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json