---
title: "Retrieve Trading Details for an Account"
method: GET
path: "/v1/trading/accounts/{account_id}/account"
tags: ["Accounts"]
---

# Retrieve Trading Details for an Account

`GET /v1/trading/accounts/{account_id}/account`

As a broker you can view more trading details about your users.

The response is a Trading Account model.

## Response `200`

OK

- TradeAccount — This is an extended version of the Account model found [in the trading api](https://alpaca.markets/docs/api-references/trading-api/account/#account-entity). Extra data has been added that would be useful for brokers.
  - `account_blocked` boolean, required — If true, the account activity by user is prohibited.
  - `account_number` string, nullable, required — The account number
  - `accrued_fees` string, decimal, required — Accrued fees
  - `admin_configurations` AdminConfigurations, required — These configurations show account properties that are overriden either by Alpaca Broker Operations or an automated process. These values cannot be modified by the Broker Partners. This schema represents the current, effective value of each configuration (e.g. as returned by the get trading account endpoint). For the shape of the payloads broadcast by the **events** streaming API when these values change, see [AdminConfigurationsEvent](#/components/schemas/AdminConfigurationsEvent).
    - `acct_daily_transfer_limit` string, decimal — Override the correspondent level daily transfer limits
    - `allow_instant_ach` boolean — If true, the account is allowed to perform instant ACH
    - `disable_algodash_access` boolean — If true, the account is allowed to access algo dash
    - `disable_api_key` boolean — If true, the account's API key will be disabled
    - `disable_crypto` boolean — If true, the account is not allowed to trade cryptos
    - `disable_day_trading` boolean — If true, the account is not allowed to day trade (e.g. buy and sell the same security on the same day)
    - `disable_fractional` boolean — If true, the account cannot create orders for fractional share positions
    - `disable_shorting` boolean — If true the account is not allowed to create short position orders
    - `incoming_transfers_blocked` boolean — If true, incoming transfers to this account are rejected
    - `max_margin_multiplier` string — The max margin multiplier set by admin for this account. Can be "1", "2", or "4".
    - `max_options_trading_level` 0 | 1 | 2 | 3 — The max options trading level set by admin for this account. 0=disabled, 1=Covered Call/Cash-Secured Put, 2=Long Call/Put, 3=Spreads/Straddles.
    - `outgoing_transfers_blocked` boolean — If true, outgoing transfers from this account are rejected
    - `restrict_to_liquidation_reasons` RestrictToLiquidationReasons — Reasons why the liquidation only flag was set
      - `ach_return` boolean — Set when an incoming ACH transfer gets rejected
      - `position_to_equity_ratio` boolean — Set when the position to equity ration exceeds the maximum limit
      - `unspecified` boolean — Default value for unknown reason
  - `balance_asof` string, required — The date of the snapshot for `last_*` fields
  - `buying_power` string, decimal, required — Current available cash buying power. If multiplier = 2 then buying_power = max(equity-initial_margin(0) * 2). If multiplier = 1 then buying_power = cash.
  - `cash` string, decimal, required — Cash balance
  - `cash_transferable` string — Cash available for transfer (JNLC)
  - `cash_withdrawable` string, decimal — Cash available for withdrawal
  - `clearing_broker` string — Clearing broker
  - `created_at` string, required — Timestamp this account was created at
  - `crypto_status` 'INACTIVE' | 'ONBOARDING' | 'SUBMITTED' | 'SUBMISSION_FAILED' | 'ACTION_REQUIRED' | 'ACCOUNT_UPDATED' | 'APPROVAL_PENDING' | 'APPROVED' | 'REJECTED' | 'ACTIVE' | 'ACCOUNT_CLOSED', 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 is being processed. - **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 progress. - **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.
  - `currency` string, required — Always USD
  - `effective_buying_power` string, decimal, required — Effective buying power (duplicate of buying power)
  - `equity` string, decimal, required — cash + long_market_value + short_market_value
  - `id` string, uuid, required — The account ID
  - `initial_margin` string, decimal, required — Reg T initial margin requirement (continuously updated value)
  - `intraday_adjustments` string — The intraday adjustment by non_trade_activities such as fund deposit/withdraw.
  - `last_buying_power` string — Value of buying_power as of previous trading day at 16:00:00 ET
  - `last_cash` string — Value of all cash as of previous trading day at 16:00:00 ET
  - `last_equity` string, decimal, required — Equity as of previous trading day at 16:00:00 ET
  - `last_initial_margin` string — Value of Reg T margin as of previous trading day at 16:00:00 ET
  - `last_long_market_value` string — Value of all long positions as of previous trading day at 16:00:00 ET
  - `last_maintenance_margin` string, decimal, required — Maintenance margin requirement on the previous trading day
  - `last_options_buying_power` string — Value of option buying power as of previous trading day at 16:00:00 ET
  - `last_regt_buying_power` string — Value of Reg T buying power as of previous trading day at 16:00:00 ET
  - `last_short_market_value` string — Value of all short positions as of previous trading day at 16:00:00 ET
  - `long_market_value` string, decimal, required — Real-time MtM value of all long positions held in the account
  - `maintenance_margin` string, decimal, required — Maintenance margin requirement (continuously updated value)
  - `memoposts` string — Outstanding memopost value
  - `multiplier` string, decimal, required — "1", "2", "3", or "4"
  - `non_marginable_buying_power` string, decimal, required — Non-marginable buying power (currently used for only crypto trading)
  - `options_approved_level` 0 | 1 | 2 | 3 — The options trading level that was approved for this account. 0=disabled, 1=Covered Call/Cash-Secured Put, 2=Long Call/Put, 3=Spreads/Straddles.
  - `options_buying_power` string, decimal — Your buying power for options trading
  - `options_trading_level` 0 | 1 | 2 | 3 — The effective options trading level of the account. This is the minimum between account options_approved_level and account configurations max_options_trading_level. 0=disabled, 1=Covered Call/Cash-Secured Put, 2=Long Call/Put, 3=Spreads/Straddles.
  - `pending_reg_taf_fees` string — Pending regulatory fees for the account.
  - `pending_transfer_out` string — Cash pending transfer out
  - `portfolio_value` string, decimal, required — Total value of cash + holding positions. (This field is deprecated. It is equivalent to the equity field.)
  - `position_market_value` string, decimal, required — Real-time MtM value of all the positions held in the account
  - `previous_close` string — Previous sessions close time
  - `regt_buying_power` string, decimal, required — User's buying power under Regulation T (excess equity - (equity - margin value) - * margin multiplier)
  - `short_market_value` string, decimal, required — Real-time MtM value of all short positions held in the account
  - `shorting_enabled` boolean, required — Flag to denote whether or not the account is permitted to short
  - `sma` string, decimal, required — Value of Special Memorandum Account (will be used at a later date to provide additional buying_power)
  - `status` 'INACTIVE' | 'ONBOARDING' | 'SUBMITTED' | 'SUBMISSION_FAILED' | 'ACTION_REQUIRED' | 'ACCOUNT_UPDATED' | 'APPROVAL_PENDING' | 'APPROVED' | 'REJECTED' | 'ACTIVE' | 'ACCOUNT_CLOSED', 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 is being processed. - **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 progress. - **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.
  - `trade_suspended_by_user` boolean, required — If true, the account is not allowed to place orders.
  - `trading_blocked` boolean, required — If true, the account is not allowed to place orders.
  - `transfers_blocked` boolean, required — If true, the account is not allowed to request money transfers.
  - `user_configurations` AccountConfigurations — Represents additional configuration settings for an account
    - `disable_overnight_trading` boolean — If true, overnight trading is disabled.
    - `fractional_trading` boolean — If true, account is able to participate in fractional trading
    - `max_margin_multiplier` string — Can be "1" or "2"
    - `max_options_trading_level` 0 | 1 | 2 | 3 — The desired maximum options trading level. 0=disabled, 1=Covered Call/Cash-Secured Put, 2=Long Call/Put, 3=Spreads/Straddles.
    - `no_shorting` boolean — If true, account becomes long-only mode.
    - `ptp_no_exception_entry` string — If set to true then Alpaca will accept orders for PTP symbols with no exception. Default is false.
    - `suspend_trade` boolean — If true, new orders are blocked.
    - `trade_confirm_email` 'all' | 'none' — all or none. If none, emails for order fills are not sent.

---

[API](https://skmtc.net/alpacahq/apis/gift-city-extensions-api.md) · [All operations](https://skmtc.net/alpacahq/apis/gift-city-extensions-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alpacahq/gift-city-extensions-api/revisions/62e3378bb273/schema)