The accounts 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 (
trades_blocked flag) or for both
trades and transfers (
account_blocked flag) if Alpaca identifies the account to
engaging in any suspicious activity. Also, in accordance with FINRA’s pattern day
trading rule, an account may be flagged for pattern day trading
pattern_day_trader flag), which would inhibit an account from placing any
[GET] Get the account
Returns the account associated with the API key.
See Account Status
Tradable buying power
Total value of cash + holding positions (This field is deprecated. It is equivalent to the equity field.)
Whether or not the account has been flagged as a pattern day trader
User setting. If true, the account is not allowed to place orders.
If true, the account is not allowed to place orders.
If true, the account is not allowed to request money transfers.
If true, the account activity by user is prohibited.
Timestamp this account was created at
Flag to denote whether or not the account is permitted to short
Real-time MtM value of all long positions held in the account
Real-time MtM value of all short positions held in the account
Cash + long_market_value + short_market_value
Equity as of previous trading day at 16:00:00 ET
Buying power multiplier that represents account margin classification; valid values 1 (standard limited margin account with 1x buying power), 2 (reg T margin account with 2x intraday and overnight buying power; this is the default for all non-PDT accounts with $2,000 or more equity), 4 (PDT account with 4x intraday buying power and 2x reg T overnight buying power)
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
Reg T initial margin requirement (continuously updated value)
Maintenance margin requirement (continuously updated value)
value of special memorandum account (will be used at a later date to provide additional buying_power)
the current number of daytrades that have been made in the last 5 trading days (inclusive of today)
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.
The account is onboarding.
The account application submission failed for some reason.
The account application has been submitted for review.
The account information is being updated.
The final account approval is pending.
The account is active for trading.
The account application has been rejected.
Suggestions or questions?
We're always happy to hear from you. You can contribute to
these docs on GitHub
or you can join our Community Slack
to get help from other community members and the Alpaca team.