--- updatedAt: 2026-05-27T17:58:22.000Z agentTools: siteIndex: https://docs.alpaca.markets/llms.txt projectIndex: https://docs.alpaca.markets/us/llms.txt --- # Get Account Returns your account details. # OpenAPI definition ```json { "components": { "schemas": { "Account": { "description": "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 (trades_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.\n", "examples": [ { "account_blocked": false, "account_number": "010203ABCD", "balance_asof": "2023-09-27", "buying_power": "262113.632", "cash": "-23140.2", "created_at": "2019-06-12T22:47:07.99658Z", "currency": "USD", "equity": "103820.56", "id": "e6fe16f3-64a4-4921-8928-cadf02f92f98", "initial_margin": "63480.38", "intraday_adjustments": "0", "last_equity": "103529.24", "last_maintenance_margin": "38000.832", "long_market_value": "126960.76", "maintenance_margin": "38088.228", "multiplier": "4", "options_approved_level": 2, "options_buying_power": "40340.18", "options_trading_level": 1, "pending_reg_taf_fees": "0", "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": { "account_blocked": { "description": "If true, the account activity by user is prohibited.", "type": "boolean" }, "account_number": { "description": "Account number.", "type": [ "string", "null" ] }, "accrued_fees": { "description": "The fees collected.", "type": "string" }, "balance_asof": { "description": "The date of the snapshot for `last_*` fields", "example": "2021-04-01", "type": "string" }, "buying_power": { "description": "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", "type": "string" }, "cash": { "description": "Cash Balance\n", "type": "string" }, "created_at": { "description": "Timestamp this account was created at\n", "format": "date-time", "type": "string" }, "crypto_status": { "$ref": "#/components/schemas/AccountStatus" }, "currency": { "description": "USD\n", "example": "USD", "type": "string" }, "equity": { "description": "Cash + long_market_value + short_market_value", "type": "string" }, "id": { "description": "Account Id.\n", "format": "uuid", "type": "string" }, "initial_margin": { "description": "Reg T initial margin requirement (continuously updated value)", "type": "string" }, "intraday_adjustments": { "description": "The intraday adjustment by non_trade_activities such as fund deposit/withdraw.\n", "example": "0", "type": "string" }, "last_equity": { "description": "Equity as of previous trading day at 16:00:00 ET", "type": "string" }, "last_maintenance_margin": { "description": "Your maintenance margin requirement on the previous trading day", "type": "string" }, "long_market_value": { "description": "Real-time MtM value of all long positions held in the account\n", "type": "string" }, "maintenance_margin": { "description": "Maintenance margin requirement (continuously updated value)", "type": "string" }, "multiplier": { "description": "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)", "type": "string" }, "non_marginable_buying_power": { "description": "Current available non-margin dollar buying power", "type": "string" }, "options_approved_level": { "description": "The options trading level that was approved for this account.\n0=disabled, 1=Covered Call/Cash-Secured Put, 2=Long Call/Put, 3=Spreads/Straddles.\n", "enum": [ 0, 1, 2, 3 ], "example": 3, "type": "integer" }, "options_buying_power": { "description": "Your buying power for options trading\n", "type": "string" }, "options_trading_level": { "description": "The effective options trading level of the account.\nThis is the minimum between account options_approved_level and account configurations max_options_trading_level.\n0=disabled, 1=Covered Call/Cash-Secured Put, 2=Long Call/Put, 3=Spreads/Straddles.\n", "enum": [ 0, 1, 2, 3 ], "example": 3, "type": "integer" }, "pending_reg_taf_fees": { "description": "Pending regulatory fees for the account.\n", "type": "string" }, "pending_transfer_in": { "description": "Cash pending transfer in.", "type": "string" }, "pending_transfer_out": { "description": "Cash pending transfer out.", "type": "string" }, "portfolio_value": { "description": "Total value of cash + holding positions (This field is deprecated. It is equivalent to the equity field.)", "type": "string" }, "regt_buying_power": { "description": "Your buying power under Regulation T (your excess equity - equity minus margin value - times your margin multiplier)\n", "type": "string" }, "short_market_value": { "description": "Real-time MtM value of all short positions held in the account", "type": "string" }, "shorting_enabled": { "description": "Flag to denote whether or not the account is permitted to short", "type": "boolean" }, "sma": { "description": "Value of special memorandum account (will be used at a later date to provide additional buying_power)", "type": "string" }, "status": { "$ref": "#/components/schemas/AccountStatus" }, "trade_suspended_by_user": { "description": "User setting. If true, the account is not allowed to place orders.", "type": "boolean" }, "trading_blocked": { "description": "If true, the account is not allowed to place orders.\n", "type": "boolean" }, "transfers_blocked": { "description": "If true, the account is not allowed to request money transfers.", "type": "boolean" } }, "required": [ "id", "status" ], "title": "Account", "type": "object" }, "AccountStatus": { "description": "An enum representing the various possible account status values.\n\nMost 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.\n\n- ONBOARDING\n The account is onboarding.\n- SUBMISSION_FAILED\n The account application submission failed for some reason.\n- SUBMITTED\n The account application has been submitted for review.\n- ACCOUNT_UPDATED\n The account information is being updated.\n- APPROVAL_PENDING\n The final account approval is pending.\n- ACTIVE\n The account is active for trading.\n- REJECTED\n The account application has been rejected.", "enum": [ "INACTIVE", "PAPER_ONLY", "ONBOARDING", "SUBMISSION_FAILED", "SUBMITTED", "ACCOUNT_UPDATED", "APPROVAL_PENDING", "ACTIVE", "REJECTED", "ACCOUNT_CLOSED", "APPROVED", "ACCOUNT_CLOSED_PENDING", "ACTION_REQUIRED", "LIMITED" ], "example": "ACTIVE", "examples": [ "ACTIVE" ], "title": "AccountStatus", "type": "string" } }, "securitySchemes": { "API_Key": { "description": "", "in": "header", "name": "APCA-API-KEY-ID", "type": "apiKey" }, "API_Secret": { "description": "", "in": "header", "name": "APCA-API-SECRET-KEY", "type": "apiKey" } } }, "info": { "contact": { "email": "support@alpaca.markets", "name": "Alpaca Support", "url": "https://alpaca.markets/support" }, "description": "Alpaca's Trading API is a modern platform for algorithmic trading.", "termsOfService": "https://s3.amazonaws.com/files.alpaca.markets/disclosures/library/TermsAndConditions.pdf", "title": "Trading API", "version": "2.0.1" }, "openapi": "3.1.2", "paths": { "/v2/account": { "get": { "description": "Returns your account details.", "operationId": "getAccount", "responses": { "200": { "content": { "application/json": { "example": { "account_blocked": false, "account_number": "PALPACA_123", "accrued_fees": "0", "admin_configurations": {}, "balance_asof": "2023-09-27", "buying_power": "245432.61", "cash": "122086.5", "created_at": "2023-01-01T18:20:20.272275Z", "crypto_status": "ACTIVE", "crypto_tier": 1, "currency": "USD", "effective_buying_power": "245432.61", "equity": "123346.11", "id": "1d9eed04-be39-4e01-9b84-a48ac5bbafcf", "initial_margin": "629.8", "intraday_adjustments": "0", "last_equity": "122011.09751111286868", "last_maintenance_margin": "480.73", "long_market_value": "1259.61", "maintenance_margin": "377.88", "multiplier": "2", "non_marginable_buying_power": "122086.5", "options_buying_power": "122716.305", "options_trading_level": 2, "pending_reg_taf_fees": "0", "pending_transfer_in": "0", "portfolio_value": "123346.11", "position_market_value": "1259.61", "regt_buying_power": "245432.61", "short_market_value": "0", "shorting_enabled": true, "sma": "123369.74", "status": "ACTIVE", "trade_suspended_by_user": false, "trading_blocked": false, "transfers_blocked": false, "user_configurations": null }, "schema": { "$ref": "#/components/schemas/Account" } } }, "description": "OK" } }, "summary": "Get Account", "tags": [ "Accounts" ] } } }, "security": [ { "API_Key": [], "API_Secret": [] } ], "servers": [ { "description": "Paper", "url": "https://paper-api.alpaca.markets" }, { "description": "Live", "url": "https://api.alpaca.markets" } ], "tags": [ { "name": "Accounts" } ], "x-readme": { "explorer-enabled": true, "proxy-enabled": false } } ```