Trading Account #
The account API serves important information related to an account,
including account status, funds available for trade, funds available for
withdrawal, and various flags relevant to an account’s ability to trade.
An account maybe be blocked for just for trades (trading_blocked
flag) or for both
trades and transfers (account_blocked
flag) if Alpaca identifies the account to
engaging in any suspicious activity. Please note that cryptocurrencies are not eligible assets to be
used as collateral for margin accounts and will require the asset be traded using
cash only.
Get the account
GET /v2/account
Response
Account objectAccount Model #
Example #
{
"account_blocked": false,
"account_number": "010203ABCD",
"crypto_status": "PAPER_ONLY",
"buying_power": "262113.632",
"cash": "-23140.2",
"created_at": "2019-06-12T22:47:07.99658Z",
"currency": "USD",
"crypto_status": "ACTIVE",
"non_marginable_buying_power": "7386.56",
"accrued_fees": "0",
"pending_transfer_in": "0",
"pending_transfer_out": "0",
"daytrade_count": "0",
"daytrading_buying_power": "262113.632",
"equity": "103820.56",
"id": "e6fe16f3-64a4-4921-8928-cadf02f92f98",
"initial_margin": "63480.38",
"last_equity": "103529.24",
"last_maintenance_margin": "38000.832",
"long_market_value": "126960.76",
"maintenance_margin": "38088.228",
"multiplier": "4",
"pattern_day_trader": false,
"portfolio_value": "103820.56",
"regt_buying_power": "80680.36",
"short_market_value": "0",
"shorting_enabled": true,
"sma": "0",
"status": "ACTIVE",
"trade_suspended_by_user": false,
"trading_blocked": false,
"transfers_blocked": false
}
Properties #
Attribute | Type | Description |
---|---|---|
id |
string<uuid> | Account ID. |
account_number |
string | Account number. |
status |
string<account_status> | See detailed account statuses below |
crypto_status |
string<crypto_status> | The current status of the crypto enablement. See detailed crypto statuses below. |
currency |
string | “USD” |
cash |
string<number> | Cash balance |
portfolio_value |
string<number> | [Deprecated] Total value of cash + holding positions (Equivalent to the equity field) |
non_marginable_buying_power |
string<number> | Current available non-margin dollar buying power |
accrued_fees |
string<number> | The fees collected. |
pending_transfer_in |
string<number> | Cash pending transfer in. |
pending_transfer_out |
string<number> | Cash pending transfer out |
pattern_day_trader |
boolean | Whether or not the account has been flagged as a pattern day trader |
trade_suspended_by_user |
boolean | User setting. If true , the account is not allowed to place orders. |
trading_blocked |
boolean | If true , the account is not allowed to place orders. |
transfers_blocked |
boolean | If true , the account is not allowed to request money transfers. |
account_blocked |
boolean | If true , the account activity by user is prohibited. |
created_at |
string<timestamp> | Timestamp this account was created at |
shorting_enabled |
boolean | Flag to denote whether or not the account is permitted to short |
long_market_value |
string<number> | Real-time MtM value of all long positions held in the account |
short_market_value |
string<number> | Real-time MtM value of all short positions held in the account |
equity |
string<number> | Cash + long_market_value + short_market_value |
last_equity |
string<number> | Equity as of previous trading day at 16:00:00 ET |
multiplier |
string<number> | Buying power (BP) multiplier that represents account margin classification Valid values: 1 (standard limited margin account with 1x BP), 2 (reg T margin account with 2x intraday and overnight BP; this is the default for all non-PDT accounts with $2,000 or more equity), 4 (PDT account with 4x intraday BP and 2x reg T overnight BP) |
buying_power |
string<number> | Current available $ buying power; If multiplier = 4, this is your daytrade buying power which is calculated as (last_equity - (last) maintenance_margin) * 4; If multiplier = 2, buying_power = max(equity – initial_margin,0) * 2; If multiplier = 1, buying_power = cash |
initial_margin |
string<number> | Reg T initial margin requirement (continuously updated value) |
maintenance_margin |
string<number> | Maintenance margin requirement (continuously updated value) |
sma |
string<number> | Value of special memorandum account (will be used at a later date to provide additional buying_power) |
daytrade_count |
int | The current number of daytrades that have been made in the last 5 trading days (inclusive of today) |
last_maintenance_margin |
string<number> | Your maintenance margin requirement on the previous trading day |
daytrading_buying_power |
string<number> | Your buying power for day trades (continuously updated value) |
regt_buying_power |
string<number> | Your buying power under Regulation T (your excess equity - equity minus margin value - times your margin multiplier) |
Account Status #
The following are the possible account status values. Most likely, the
account status is ACTIVE
unless there is any problem. The account status
may get in ACCOUNT_UPDATED
when personal information is being updated
from the dashboard, in which case you may not be allowed trading for
a short period of time until the change is approved.
ONBOARDING
The account is onboarding.SUBMISSION_FAILED
The account application submission failed for some reason.SUBMITTED
The account application has been submitted for review.ACCOUNT_UPDATED
The account information is being updated.APPROVAL_PENDING
The final account approval is pending.ACTIVE
The account is active for trading.REJECTED
The account application has been rejected.
Crypto Status #
The following are the possible account status values.
-
PAPER_ONLY
Is used to display when account has not yet been approved for crypto. -
SUBMITTED
The account’s crypto trading application has been submitted for review. -
ACTIVE
The account is active for crypto trading.