Create an Account

post https://broker-api.sandbox.alpaca.markets/v1/accounts

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

account_type

string

Possible values are:

trading
custodial
donor_advised
ira

account_sub_type

string

IRA Account only

Possible values are:

traditional
roth

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 strings

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

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.

Responses

Response body

object

string

required

UUID that identifies the account for later reference

account_number

string | null

required

A human-readable account number that can be shown to the end user

account_type

string

Possible values are:

trading
custodial
donor_advised
ira

trading custodial donor_advised ira

status

string

required

Designates the current status of this account

Possible Values:

INACTIVE
Account not set to trade given asset.
ONBOARDING
An application is expected for this user, but has not been submitted yet.
SUBMITTED
The application has been submitted and in process.
SUBMISSION_FAILED
Used to display if failure on submission
ACTION_REQUIRED
The application requires manual action.
ACCOUNT_UPDATED
Used to display when Account has been modified by user
APPROVAL_PENDING
Initial value. The application approval process is in process.
APPROVED
The account application has been approved, and waiting to be ACTIVE
REJECTED
The account application is rejected for some reason
ACTIVE
The account is fully active. Trading and funding are processed under this status.
ACCOUNT_CLOSED
The account is closed.

INACTIVE ONBOARDING SUBMITTED SUBMISSION_FAILED ACTION_REQUIRED ACCOUNT_UPDATED APPROVAL_PENDING APPROVED REJECTED ACTIVE ACCOUNT_CLOSED

crypto_status

string

Designates the current status of this account

Possible Values:

INACTIVE
Account not set to trade given asset.
ONBOARDING
An application is expected for this user, but has not been submitted yet.
SUBMITTED
The application has been submitted and in process.
SUBMISSION_FAILED
Used to display if failure on submission
ACTION_REQUIRED
The application requires manual action.
ACCOUNT_UPDATED
Used to display when Account has been modified by user
APPROVAL_PENDING
Initial value. The application approval process is in process.
APPROVED
The account application has been approved, and waiting to be ACTIVE
REJECTED
The account application is rejected for some reason
ACTIVE
The account is fully active. Trading and funding are processed under this status.
ACCOUNT_CLOSED
The account is closed.

INACTIVE ONBOARDING SUBMITTED SUBMISSION_FAILED ACTION_REQUIRED ACCOUNT_UPDATED APPROVAL_PENDING APPROVED REJECTED ACTIVE ACCOUNT_CLOSED

currency

string

required

"USD" // US Dollar
"JPY" // Japanese Yen
"EUR" // Euro
"CAD" // Canadian Dollar
"GBP" // British Pound Sterling
"CHF" // Swiss Franc
"TRY" // Turkish Lira
"AUD" // Australian Dollar
"CZK" // Czech Koruna
"SEK" // Swedish Krona
"DKK" // Danish Krone
"SGD" // Singapore Dollar
"HKD" // Hong Kong Dollar
"HUF" // Hungarian Forint
"NZD" // New Zealand Dollar
"NOK" // Norwegian Krone
"PLN" // Poland Złoty

created_at

date-time

required

Timestamp (RFC3339) of account creation.

last_equity

string

required

EOD equity calculation (cash + long market value + short market value)

enabled_assets

array of strings

Assets the user has enabled and is able to trade once status and/or crypto_status are ACTIVE

enabled_assets

contact

object

Contact is the model for the account owner contact information.

email_address

string

required

phone_number

string

required

Phone number should include the country code, format: “+15555555555”

street_address

array of strings

required

The user's street address. If multiple lines in address, pass in as additional array elements. Maximum of 3 objects in array

street_address*

unit

string

The specific apartment number if applicable

city

string

required

state

string

Required if the country or country_of_tax_residence (in the identity model below) is 'USA'.

country

string

country code in ISO 3166-1 alpha-3 format, representing the country the person/entity resides in.

postal_code

string

identity

object

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

given_name

string

required

The first/given name of the user.

family_name

string

required

The last name (surname) of the user.

middle_name

string

The middle name of the user.

date_of_birth

date

required

The date of birth in "YYYY-MM-DD" format.

tax_id

string

Required if tax_id_type is set.

tax_id_type

string

required

Required if tax_id is set.

An Enum of the various kinds of Tax ID formats Alpaca supports.

Possible Values are:

USA_SSN
USA Social Security Number
ARG_AR_CUIT
Argentina CUIT
AUS_TFN
Australian Tax File Number
AUS_ABN
Australian Business Number
BOL_NIT
Bolivia NIT
BRA_CPF
Brazil CPF
CHL_RUT
Chile RUT
COL_NIT
Colombia NIT
CRI_NITE
Costa Rica NITE
DEU_TAX_ID
Germany Tax ID (Identifikationsnummer)
DOM_RNC
Dominican Republic RNC
ECU_RUC
Ecuador RUC
FRA_SPI
France SPI (Reference Tax Number)
GBR_UTR
UK UTR (Unique Taxpayer Reference)
GBR_NINO
UK NINO (National Insurance Number)
GTM_NIT
Guatemala NIT
HND_RTN
Honduras RTN
HUN_TIN
Hungary TIN Number
IDN_KTP
Indonesia KTP
IND_PAN
India PAN Number
ISR_TAX_ID
Israel Tax ID (Teudat Zehut)
ITA_TAX_ID
Italy Tax ID (Codice Fiscale)
JPN_TAX_ID
Japan Tax ID (Koijin Bango)
MEX_RFC
Mexico RFC
NIC_RUC
Nicaragua RUC
NLD_TIN
Netherlands TIN Number
PAN_RUC
Panama RUC
PER_RUC
Peru RUC
PRY_RUC
Paraguay RUC
SGP_NRIC
Singapore NRIC
SGP_FIN
Singapore FIN
SGP_ASGD
Singapore ASGD
SGP_ITR
Singapore ITR
SLV_NIT
El Salvador NIT
SWE_TAX_ID
Sweden Tax ID (Personnummer)
URY_RUT
Uruguay RUT
VEN_RIF
Venezuela RIF
NATIONAL_ID
National ID number, if a tax ID number is not available
PASSPORT
Passport number, if a tax ID number is not available
PERMANENT_RESIDENT
Permanent resident number, if a tax ID number is not available
DRIVER_LICENSE
Drivers license number, if a tax ID number is not available
OTHER_GOV_ID
Other government issued identifier, if a tax ID number is not available
NOT_SPECIFIED
Other Tax IDs

USA_SSN ARG_AG_CUIT AUS_TFN AUS_ABN BOL_NIT BRA_CPF CHL_RUT COL_NIT CRI_NITE DEU_TAX_ID DOM_RNC ECU_RUC FRA_SPI GBR_UTR GBR_NINO GTM_NIT HND_RTN HUN_TIN IDN_KTP IND_PAN ISR_TAX_ID ITA_TAX_ID JPN_TAX_ID MEX_RFC NIC_RUC NLD_TIN PAN_RUC PER_RUC PRY_RUC SGP_NRIC SGP_FIN SGP_ASGD SGP_ITR SLV_NIT SWE_TAX_ID URY_RUT VEN_RIF NATIONAL_ID PASSPORT PERMANENT_RESIDENT DRIVER_LICENSE OTHER_GOV_ID NOT_SPECIFIED

country_of_citizenship

string

ISO 3166-1 alpha-3.

country_of_birth

string

ISO 3166-1 alpha-3.

country_of_tax_residence

string

required

ISO 3166-1 alpha-3.

funding_source

array of strings

required

Can be one or more of the following: employment_income, investments, inheritance, business_income, savings, family.

funding_source*

liquidity_needs

string

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.

very_important important somewhat_important does_not_matter

investment_experience_with_stocks

string

The user's level of expertise and familiarity with investing in US Equities.

none 1_to_5_years over_5_years

investment_experience_with_options

string

The user's level of expertise and familiarity with investing in Options.

none 1_to_5_years over_5_years

risk_tolerance

string

The user's investment risk tolerance.

conservative moderate significant_risk

investment_objective

string

The user's investment objective.

generate_income preserve_wealth market_speculation growth balance_preserve_wealth_with_growth

investment_time_horizon

string

The expected period of time the user plan to invest to achieve his/her financial goal(s)

less_than_1_year 1_to_2_years 3_to_5_years 6_to_10_years more_than_10_years

annual_income_min

number

The lower bound of the user's annual income.

annual_income_max

number

The upper bound of the user's annual income.

liquid_net_worth_min

number

The lower bound of the user's liquid net worth.

liquid_net_worth_max

number

The upper bound of the user's liquid net worth.

total_net_worth_min

number

The lower bound of the user's total net worth.

total_net_worth_max

number

The upper bound of the user's total net worth.

visa_type

string

Only used to collect visa types for users residing in the USA.

visa_expiration_date

date

Required if visa_type is set.

date_of_departure_from_usa

date

Required if visa_type = B1 or B2

permanent_resident

boolean

Only used to collect permanent residence status in the USA.

marital_status

string

The marital status of the user.

SINGLE MARRIED DIVORCED WIDOWED

number_of_dependents

integer

The number of dependents the user has.

disclosures

object

employment_status

string

One of the following: employed, unemployed, retired, or student.

unemployed employed student retired

employer_name

string

The name of the employer if the user is employed.

employer_address

string

The employer's address if the user is employed.

employment_position

string

The user's position if they are employed.

is_control_person

boolean

required

Whether user holds a controlling position in a publicly traded company, member of the board of directors or has policy making abilities in a publicly traded company.

is_affiliated_exchange_or_finra

boolean

required

Whether user is affiliated with any exchanges or FINRA.

is_politically_exposed

boolean

required

Whether the user is politically exposed.

immediate_family_exposed

boolean

required

If your user’s immediate family member (sibling, husband/wife, child, parent) is either politically exposed or holds a control position.

context

array of objects | null

Array of annotations describing the rational for marking is_control_person, is_affiliated_exchange_or_finra, and/or immediate_family_exposed as true

context

object

context_type

string

required

Specifies the type of disclosure annotation. Valid types are FINRA affiliations, for users affiliated with or employed by a FINRA member firm, a Stock Exchange Member, FINRA, Registered Investment Advisor, or a Municipal Securities Broker/Dealer; Company control relationships, for senior executives, and 10% or greater shareholders, of a publicly traded company; and immediate family members of politically exposed individuals.

CONTROLLED_FIRM IMMEDIATE_FAMILY_EXPOSED AFFILIATE_FIRM

company_name

string