- Category: commerce
- Auth: API_KEY, OAUTH2
- Composio-managed OAuth available? No
- Tools: 100
- Triggers: 0
- Slug:
ALPACA - Version: 20261101_00
Tools
Add Asset to Watchlist
Add Asset to Watchlist
Add Asset to Watchlist by Name
Add Asset to Watchlist by Name
ALPACA_ADD_ASSET_TO_WATCHLIST_BY_NAMEAdd an asset to a watchlist by name. Use when you need to add a symbol to a specific watchlist identified by its name. If a watchlist with the specified name does not exist, it will be created automatically and the symbol will be added to it. The asset will be appended to the end of the watchlist’s asset list.Input Parameters
Output
Create Watchlist
Create Watchlist
ALPACA_CREATE_WATCHLISTCreates a new watchlist for the authenticated account. Use this action when you need to: - Create a new watchlist to track specific securities - Set up initial symbols for a watchlist at creation time - Organize tracked symbols under a named watchlist Note: This action creates a watchlist at the account level (using v2 API). The name must be unique within the account and contain only alphanumeric characters, spaces, hyphens, and underscores (up to 64 characters).Input Parameters
Output
Create Watchlist
Create Watchlist
Delete All Open Positions
Delete All Open Positions
ALPACA_DELETE_ALL_OPEN_POSITIONSLiquidates all open positions at market, with an option to cancel open orders first. Results report individual liquidation attempts; partial success is possible. With Alpaca’s standard live API configuration, the target is the paper account.Input Parameters
Output
Delete All Orders for Account
Delete All Orders for Account
ALPACA_DELETE_ALL_ORDERS_FOR_ACCOUNTAttempts to cancel all open orders for a specified trading account and returns per-order results when provided. A 404 response is returned as an empty results list with HTTP status 404; successfully cancelled orders cannot be restored.Input Parameters
Output
Delete Unsubscribe Account
Delete Unsubscribe Account
ALPACA_DELETE_UNSUBSCRIBE_ACCOUNTDelete a rebalancing subscription to unsubscribe an account. This action permanently removes the specified subscription. Use when you need to unsubscribe an account from rebalancing services. This action is irreversible once executed. Note: If the subscription_id is invalid, a 400 error is returned. If the subscription does not exist, a 404 error is returned.Input Parameters
Output
Delete Watchlist By ID
Delete Watchlist By ID
ALPACA_DELETE_WATCHLIST_BY_IDDelete a watchlist by its unique identifier. Use when you need to remove an entire watchlist that is no longer needed. This action is irreversible once executed — the watchlist and all its contents cannot be recovered. Note: If the watchlist_id is invalid or does not exist, a 404 error is returned.Input Parameters
Output
Get Account
Get Account
ALPACA_GET_ACCOUNTRetrieves account information for the authenticated Alpaca account. Use this action when you need to check account status, available buying power, cash balance, equity, margin information, day trade count, or other account details. This is a read-only operation that returns the current state of the authenticated account. The response includes important account flags such as trading_blocked, account_blocked, pattern_day_trader, and shorting_enabled which indicate any restrictions on the account’s trading capabilities.Output
Get Account Activities
Get Account Activities
ALPACA_GET_ACCOUNT_ACTIVITIESRetrieves account activities for the authenticated Alpaca account. Use this action when you need to retrieve transaction history, dividend payments, interest payments, fees, transfers, or other account-related activities. Supports filtering by date range, account ID, and sorting direction. Results are paginated using page_token for efficient retrieval of large datasets.Input Parameters
Output
Get Account Activities V2
Get Account Activities V2
ALPACA_GET_ACCOUNT_ACTIVITIES2Retrieves account activities for the authenticated Alpaca account using the v2 API, including trade fills and non-trade activities. Supports date range and activity type filters, sorting, and page-token pagination; multiple activity types can be requested.Input Parameters
Output
Get Account Activities By Activity Type
Get Account Activities By Activity Type
ALPACA_GET_ACCOUNT_ACTIVITIES_BY_ACTIVITY_TYPERetrieves account activities of a specific type for the authenticated Alpaca account. Use when you need to filter account activities by a specific type such as trade fills, dividends, interest payments, fees, or transfers. Supports date range filtering, pagination, and sorting. This endpoint is useful for retrieving a specific category of account transactions rather than all activities. Note: date parameter cannot be used with ‘after’ parameter. Use ‘date’ for a single day or ‘until’/‘after’ for date ranges.Input Parameters
Output
Get Account Configurations
Get Account Configurations
ALPACA_GET_ACCOUNT_CONFIGRetrieves the current trading account configuration settings for the authenticated Alpaca account. Use this action when you need to check the current trading account settings such as day-trading margin call (DTMC) checks, fractional trading status, shorting permissions, trade suspension status, and trade confirmation email preferences. This is a read-only operation that returns the current configuration without any modifications. The account is determined from the authentication credentials.Output
Get Account Portfolio History
Get Account Portfolio History
ALPACA_GET_ACCOUNT_PORTFOLIO_HISTORYRetrieves the portfolio history statistics for an Alpaca trading account. Portfolio history provides a time series of equity values, profit/loss metrics, and other performance data over a specified time period. Use when you need to analyze account performance over time, track equity curves, or review historical P&L. Note: The timeframe parameter auto-selects based on the period: 1Min for <7 days, 15Min for <30 days, or 1D otherwise.Input Parameters
Output
Get Account Portfolio History
Get Account Portfolio History
ALPACA_GET_ACCOUNT_PORTFOLIO_HISTORY1Retrieves the portfolio history statistics for a trading account. Portfolio history provides a time series of equity values, profit/loss metrics, and optionally cashflow data over a specified time period. Use when you need to analyze account performance over time, track equity curves, or review historical P&L. Note: The timeframe parameter auto-selects based on the period: 1Min for <7 days, 15Min for <30 days, or 1D otherwise.Input Parameters
Output
Get All Account Positions
Get All Account Positions
ALPACA_GET_ACCOUNTS_POSITIONSBulk fetches all open positions for the authenticated account. Use when you need to retrieve all current positions, monitor overall portfolio holdings, or check unrealized P&L across the entire account. This action does not require an account_id parameter as it automatically uses the account associated with the API credentials. Note: This action returns positions for the account associated with the authenticated API key. Use this read-only action to get a complete view of the account’s open positions.Output
Get All Open Positions
Get All Open Positions
Get All Orders
Get All Orders
ALPACA_GET_ALL_ORDERSRetrieves all orders for an account based on specified filter criteria. Returns a list of orders with their current status, filled quantity, prices, and any nested legs for complex orders. Use when you need to query historical or current orders for a trading account, such as checking open positions or reviewing trade history. By default, only open orders are returned. Use status=‘all’ to include closed orders, or status=‘closed’ for only closed/canceled orders.Input Parameters
Output
Get Historical Crypto US Bars
Get Historical Crypto US Bars
ALPACA_GET_ALPACA_DATA_CRYPTO_US_BARSRetrieves historical OHLCV bars for crypto symbols at a selected location, aggregated by the specified timeframe. Results are sorted by symbol, then timestamp.Input Parameters
Output
Get Crypto Bars for Multiple Symbols
Get Crypto Bars for Multiple Symbols
ALPACA_GET_BARS_FOR_MULTIPLE_CRYPTO_SYMBOLSRetrieves historical OHLCV bars for multiple crypto symbols from the US market data location. Results are sorted by symbol and then timestamp; use the returned next page token to continue through available bars.Input Parameters
Output
Get Stock Bars for Multiple Symbols
Get Stock Bars for Multiple Symbols
ALPACA_GET_BARS_FOR_MULTIPLE_STOCK_SYMBOLSRetrieves OHLCV (Open, High, Low, Close, Volume) bars for multiple stock symbols. Use this action when you need to: - Get historical price data for multiple stock symbols - Analyze price trends over a specific timeframe - Fetch aggregated bar data for stock analysis - Backtest trading strategies on multiple stocks Results are sorted by symbol first, then by bar timestamp. If the limit is reached for one symbol, subsequent requests with the next_page_token will retrieve bars for remaining symbols. Note: This endpoint uses the data.alpaca.markets base URL and requires appropriate data subscriptions for SIP and OTC feeds.Input Parameters
Output
Get Historical Bars for Stock Symbol
Get Historical Bars for Stock Symbol
ALPACA_GET_BARS_FOR_STOCK_SYMBOLRetrieves historical OHLCV (Open, High, Low, Close, Volume) bars for a single stock symbol. Use this action when you need to analyze historical price movements and trading activity for a specific stock ticker over a given timeframe. The bars are aggregated based on the specified timeframe (e.g., 1 minute, 15 minutes, 1 hour, 1 day). Note: This endpoint uses the data.alpaca.markets base URL.Input Parameters
Output
Get Historical Stock Bars
Get Historical Stock Bars
ALPACA_GET_BARS_STOCKSRetrieves historical OHLCV (Open, High, Low, Close, Volume) bars for a single stock symbol. Use this action when you need to analyze historical price movements and trading activity for a specific stock ticker over a given timeframe. The bars are aggregated based on the specified timeframe (e.g., 1 minute, 15 minutes, 1 hour, 1 day). Results are sorted by timestamp and support pagination via the next_page_token field when the limit is reached and more data is available. Note: This endpoint uses the data.alpaca.markets base URL and requires appropriate data subscriptions for SIP and OTC feeds.Input Parameters
Output
Get Calendar
Get Calendar
ALPACA_GET_CALENDARRetrieves market calendar information for trading days from the Alpaca Trading API. Use this action when you need to: - Get market open and close times for specific dates - Check trading session times - Verify market operating hours for date ranges - Plan trading activities around market hours This is a read-only operation that returns market calendar data.Input Parameters
Output
Get Clock
Get Clock
ALPACA_GET_CLOCKRetrieves the current market clock information from the Alpaca Trading API. Use this action when you need to: - Check if the market is currently open - Determine when the next market open or close will occur - Plan trading activities based on market hours - Verify server time for timestamp-sensitive operations This is a read-only operation that returns the current state of the market clock including whether the market is open and the timestamps for the next open and close.Output
Get Stock Conditions
Get Stock Conditions
ALPACA_GET_CONDITIONSRetrieves the mapping of condition codes to their names from Alpaca Markets API for the specified type (trade or quote conditions) and tape. Use this action when you need to: - Decode condition codes from stock market data - Get the list of all valid condition codes and their meanings for a specific type - Translate raw condition code integers to human-readable names - Understand the meaning of condition codes from trade or quote data This is a read-only action that queries the stocks meta conditions endpoint.Input Parameters
Output
Get Crypto Latest Quotes
Get Crypto Latest Quotes
ALPACA_GET_CRYPTO_LATEST_QUOTESRetrieves the latest bid and ask prices for specified crypto symbols at a specific location. Use when you need real-time quote data for cryptocurrency trading, such as checking current market prices before placing orders or monitoring price movements.Input Parameters
Output
Get Crypto Perp Latest Bars
Get Crypto Perp Latest Bars
ALPACA_GET_CRYPTO_PERP_LATEST_BARSRetrieves the latest OHLCV (Open, High, Low, Close, Volume) bars for crypto perpetual futures symbols. Use this action when you need real-time or near real-time price data for crypto perpetual futures contracts for a specific location (e.g., ‘global’). Returns the most recent bar for each requested symbol, including open, high, low, close prices, volume, trade count, and volume-weighted average price.Input Parameters
Output
Get Crypto Perp Latest Orderbooks
Get Crypto Perp Latest Orderbooks
ALPACA_GET_CRYPTO_PERP_LATEST_ORDER_BOOKSRetrieves the latest bid and ask orderbook data for specified crypto perpetual futures symbols. Use when you need real-time orderbook data for crypto perpetual futures trading, such as checking current market depth before placing orders or analyzing liquidity. Returns the most recent orderbook for each requested symbol, including bid and ask price levels with their sizes.Input Parameters
Output
Get Crypto Perp Latest Pricing
Get Crypto Perp Latest Pricing
ALPACA_GET_CRYPTO_PERP_LATEST_PRICINGRetrieves the latest pricing data for specified crypto perpetual futures symbols. Use when you need real-time pricing data for crypto perpetual futures trading, such as checking current market prices, index prices, mark prices, funding rates, or open interest before placing orders or analyzing the market. Returns the most recent pricing data for each requested symbol, including timestamp, funding timestamp, open interest, index price, mark price, and funding rate.Input Parameters
Output
Get Crypto Perp Latest Quotes
Get Crypto Perp Latest Quotes
ALPACA_GET_CRYPTO_PERP_LATEST_QUOTESRetrieves the latest bid and ask prices for specified crypto perpetual futures symbols for a specific location. Use when you need real-time quote data for crypto perpetual futures trading, such as checking current market prices before placing orders or monitoring price movements.Input Parameters
Output
Get Crypto Perp Latest Trades
Get Crypto Perp Latest Trades
ALPACA_GET_CRYPTO_PERP_LATEST_TRADESRetrieves the latest trade data for specified crypto perpetual futures symbols. Use when you need real-time trade data for crypto perpetual futures trading, such as monitoring recent trades, analyzing price movements, or tracking trading volume. Returns the most recent trade for each requested symbol, including price, size, timestamp, and tick direction.Input Parameters
Output
Get Crypto Perps Global Latest Bars
Get Crypto Perps Global Latest Bars
Get Crypto Perps Global Latest Pricing
Get Crypto Perps Global Latest Pricing
ALPACA_GET_CRYPTO_PERPS_GLOBAL_LATEST_PRICINGRetrieves the latest global pricing data for crypto perpetual futures symbols, including mark price, index price, open interest, and funding rate.Input Parameters
Output
Get Crypto Perps Global Latest Quotes
Get Crypto Perps Global Latest Quotes
ALPACA_GET_CRYPTO_PERPS_GLOBAL_LATEST_QUOTESRetrieves the latest global bid and ask quotes for specified crypto perpetual futures symbols. Use for current market prices or monitoring price movements.Input Parameters
Output
Get Crypto Perps Global Latest Trades
Get Crypto Perps Global Latest Trades
ALPACA_GET_CRYPTO_PERPS_GLOBAL_LATEST_TRADESRetrieves the latest trade data for specified crypto perpetual futures symbols. Use when you need real-time trade data for crypto perpetual futures trading, such as monitoring recent trades, analyzing price movements, or tracking trading volume.Input Parameters
Output
Get Crypto Snapshots
Get Crypto Snapshots
ALPACA_GET_CRYPTO_SNAPSHOTSRetrieves snapshots (latest trade, latest quote, minute bar, daily bar, and previous daily bar) for multiple cryptocurrency symbols in a specific location. Use this action when you need comprehensive real-time market data for crypto symbols, such as building a crypto dashboard, checking current market conditions across multiple assets, or analyzing price movements before trading. Note: This endpoint uses the data.alpaca.markets base URL for crypto market data.Input Parameters
Output
Get Crypto US Latest Bars
Get Crypto US Latest Bars
ALPACA_GET_CRYPTO_US_LATEST_BARSRetrieves the latest OHLCV (Open, High, Low, Close, Volume) bars for US crypto symbols. Use this action when you need real-time or near real-time price data for multiple crypto trading pairs. Returns the most recent bar for each requested symbol, including open, high, low, close prices, volume, trade count, and volume-weighted average price.Input Parameters
Output
Get Crypto US Latest Orderbooks
Get Crypto US Latest Orderbooks
ALPACA_GET_CRYPTO_US_LATEST_ORDER_BOOKSRetrieves the latest bid and ask orderbook data for specified crypto symbols in the US market. Use when you need real-time orderbook data for cryptocurrency trading in the US market, such as checking current market depth before placing orders or analyzing liquidity. Returns the most recent orderbook for each requested symbol, including bid and ask price levels with their sizes.Input Parameters
Output
Get Crypto US Latest Quotes
Get Crypto US Latest Quotes
ALPACA_GET_CRYPTO_US_LATEST_QUOTESRetrieves the latest bid and ask prices for specified crypto symbols in the US location. Use when you need real-time quote data for cryptocurrency trading in the US market, such as checking current market prices before placing orders or monitoring price movements.Input Parameters
Output
Get Crypto US Latest Trades
Get Crypto US Latest Trades
Get Crypto US Historical Quotes
Get Crypto US Historical Quotes
ALPACA_GET_CRYPTO_US_QUOTESRetrieves historical bid and ask quotes for specified crypto symbols in the US location, sorted by symbol and then timestamp. Use the data to analyze spreads, backtest strategies, or study market microstructure.Input Parameters
Output
Get Crypto US Snapshots
Get Crypto US Snapshots
ALPACA_GET_CRYPTO_US_SNAPSHOTSRetrieves snapshots (latest trade, latest quote, minute bar, daily bar, and previous daily bar) for multiple cryptocurrency symbols in the US market location. Use this action when you need comprehensive real-time market data for multiple crypto symbols in the US market, such as building a crypto dashboard, checking current market conditions across multiple assets, or analyzing price movements before trading.Input Parameters
Output
Get Crypto US Trades
Get Crypto US Trades
ALPACA_GET_CRYPTO_US_TRADESRetrieves historical trade data for specified US crypto symbols. Use when you need to: - Get historical trade data for US crypto symbols at once - Analyze trading volume and price movements over time - Build datasets for backtesting or research - Query trades within a specific time range Results are sorted by symbol first, then by trade timestamp. If the response contains more data than the limit allows, use the next_page_token to continue fetching.Input Parameters
Output
Get Exchanges
Get Exchanges
ALPACA_GET_EXCHANGESRetrieves a list of supported stock exchanges with their short codes and full names from the Alpaca Market Data API. Use this action when you need to: - Get the mapping between exchange codes and full names - Understand what exchange codes like ‘Z’, ‘V’, ‘N’ mean in market data - Parse exchange identifiers in trading data responses This is a read-only operation that queries the stocks meta exchanges endpoint.Output
Get Latest Bar for Stock Symbol
Get Latest Bar for Stock Symbol
ALPACA_GET_LATEST_BAR_FOR_STOCK_SYMBOLRetrieves the latest OHLCV (Open, High, Low, Close, Volume) bar for a single stock symbol. Use this action when you need real-time or near real-time price bar data for a specific stock trading symbol. This is useful for dashboards, price monitoring, and triggering alerts based on current market conditions. Returns the most recent bar including open, high, low, close prices, volume, trade count, and volume-weighted average price.Input Parameters
Output
Get Latest Bars For Crypto Symbol
Get Latest Bars For Crypto Symbol
ALPACA_GET_LATEST_BARS_FOR_CRYPTO_SYMBOLRetrieves the latest OHLCV bar for a cryptocurrency pair in Alpaca’s US location. The bar includes opening, high, low and closing prices, volume, trade count and volume-weighted average price.Input Parameters
Output
Get Latest Bars for Crypto Symbols
Get Latest Bars for Crypto Symbols
ALPACA_GET_LATEST_BARS_FOR_CRYPTO_SYMBOLSRetrieves the latest OHLCV (Open, High, Low, Close, Volume) bars for multiple crypto symbols. Use this action when you need real-time or near real-time price bar data for multiple cryptocurrency pairs simultaneously. This is useful for dashboards, price monitoring, and triggering alerts based on current market conditions. The response includes the most recent bar for each requested symbol, containing open, high, low, close prices, volume, trade count, and volume-weighted average price.Input Parameters
Output
Get Latest Bars for Multiple Stock Symbols
Get Latest Bars for Multiple Stock Symbols
ALPACA_GET_LATEST_BARS_FOR_MULTIPLE_STOCK_SYMBOLSRetrieves the latest OHLCV (Open, High, Low, Close, Volume) bars for multiple stock symbols. Use this action when you need real-time or near real-time price bar data for multiple stock trading symbols simultaneously. This is useful for dashboards, price monitoring, and triggering alerts based on current market conditions. The response includes the most recent bar for each requested symbol, containing open, high, low, close prices, volume, trade count, and volume-weighted average price.Input Parameters
Output
Get Crypto Latest Orderbooks
Get Crypto Latest Orderbooks
ALPACA_GET_LATEST_ORDER_BOOKS_FOR_CRYPTORetrieves the latest bid and ask orderbook data for specified crypto symbols. Use when you need real-time orderbook data for cryptocurrency trading, such as checking current market depth before placing orders or analyzing liquidity. Returns the most recent orderbook for each requested symbol, including bid and ask price levels with their sizes.Input Parameters
Output
Get Crypto Latest Quote
Get Crypto Latest Quote
ALPACA_GET_LATEST_QUOTE_FOR_CRYPTO_SYMBOLRetrieves the latest bid and ask prices for a specified crypto symbol. Use when you need real-time quote data for a specific cryptocurrency, such as checking current market prices before placing an order or monitoring price movements.Input Parameters
Output
Get Latest Quote for Stock Symbol
Get Latest Quote for Stock Symbol
ALPACA_GET_LATEST_QUOTE_FOR_STOCK_SYMBOLRetrieves the latest NBBO (National Best Bid and Offer) quote for a single stock symbol. Use this action when you need real-time or near real-time bid and ask prices for a specific stock trading symbol. This is useful for checking market conditions before placing an order or monitoring price movements for a single symbol. Note: This endpoint uses the data.alpaca.markets base URL for stock data.Input Parameters
Output
Get Crypto Latest Quotes
Get Crypto Latest Quotes
ALPACA_GET_LATEST_QUOTES_FOR_MULTIPLE_CRYPTO_SYMBOLSRetrieves the latest bid and ask prices for specified crypto symbols. Use when you need real-time quote data for cryptocurrency trading, such as checking current market prices before placing orders or monitoring price movements.Input Parameters
Output
Get Latest Quotes for Multiple Stock Symbols
Get Latest Quotes for Multiple Stock Symbols
ALPACA_GET_LATEST_QUOTES_FOR_MULTIPLE_STOCK_SYMBOLSRetrieves the latest NBBO (National Best Bid and Offer) quotes for multiple stock symbols. Use this action when you need real-time or near real-time bid and ask prices for multiple stock trading symbols simultaneously. This is useful for checking market conditions before placing orders, monitoring price movements, or evaluating spread opportunities. The response includes the most recent quote for each requested symbol, containing bid price, ask price, bid size, ask size, and exchange information.Input Parameters
Output
Get Latest Trade for Stock Symbol
Get Latest Trade for Stock Symbol
ALPACA_GET_LATEST_TRADE_FOR_STOCK_SYMBOLRetrieves the latest trade data for a single stock symbol. Use this action when you need the most recent trade information for a specific stock ticker, such as checking current market price and volume before placing an order or monitoring real-time price movements for a single symbol. This provides the single most recent trade including price, size, exchange, and timestamp. Note: This endpoint uses the data.alpaca.markets base URL for stock market data.Input Parameters
Output
Get Latest Crypto Trades
Get Latest Crypto Trades
ALPACA_GET_LATEST_TRADES_FOR_MULTIPLE_CRYPTO_SYMBOLSRetrieves the latest trade data for specified crypto symbols. Use when you need real-time trade data for cryptocurrency trading, such as monitoring recent trades, analyzing price movements, or tracking trading volume.Input Parameters
Output
Get Latest Trades for Multiple Stock Symbols
Get Latest Trades for Multiple Stock Symbols
ALPACA_GET_LATEST_TRADES_FOR_MULTIPLE_STOCK_SYMBOLSRetrieves the latest trade data for multiple stock symbols. Use this action when you need real-time or near real-time trade data for multiple stock trading symbols simultaneously. This is useful for dashboards, trade monitoring, and triggering alerts based on current market conditions. The response includes the most recent trade for each requested symbol, containing price, size, timestamp, exchange, and trade conditions.Input Parameters
Output
Get Market Calendar
Get Market Calendar
ALPACA_GET_MARKET_CALENDARRetrieves market calendar information for a specific exchange from the Alpaca Trading API. Use this action when you need to: - Get market open and close times for a specific exchange (NYSE, NASDAQ, etc.) - Check trading session times for a particular market - Verify market operating hours for specific date ranges - Plan trading activities around specific market hours This is a read-only operation that returns market calendar data for the specified exchange.Input Parameters
Output
Get Meta Exchanges
Get Meta Exchanges
Get Most Active Stocks
Get Most Active Stocks
ALPACA_GET_MOST_ACTIVESRetrieves the most active stocks by trading volume or trade count. Use this action when you need to: - Fetch top traded stocks for the current period - Monitor market liquidity and activity - Build trading signals based on volume or trade frequency - Analyze market breadth through most active stocks Note: This endpoint uses data.alpaca.markets base URL and provides real-time SIP data for US stock markets.Input Parameters
Output
Get News
Get News
ALPACA_GET_NEWSRetrieves news articles for specified crypto symbols from the Alpaca Market Data API. Use this action when you need to: - Fetch the latest news for crypto assets (BTCUSD, ETHUSD, etc.) - Monitor news sentiment for trading decisions - Build news-based signals or alerts - Get historical news for specific time periods Note: The data.alpaca.markets endpoint is used for news API requests.Input Parameters
Output
Get Open Position
Get Open Position
ALPACA_GET_OPEN_POSITIONFetches a single open position by symbol or asset ID. Use when you need to retrieve detailed information about a specific position, including cost basis, shares traded, market value, and unrealized P&L. This action is useful for checking the current status of a particular holding, monitoring P&L for a specific symbol, or verifying position details after placing or closing orders. Returns real-time updated information as price data changes. Note: The position must be currently open to be retrieved through this endpoint. Once closed, the position will no longer be queryable.Input Parameters
Output
Get Options Historical Bars
Get Options Historical Bars
ALPACA_GET_OPTION_BARSRetrieves historical OHLCV (Open, High, Low, Close, Volume) bars for options contracts. Use this action when you need to analyze historical price movements and trading activity for specific option contracts over a given timeframe. The bars are aggregated based on the specified timeframe (e.g., 1 minute, 5 minutes, 1 hour, 1 day). Results are sorted by symbol first, then by timestamp.Input Parameters
Output
Get Option Chain
Get Option Chain
ALPACA_GET_OPTION_CHAINRetrieves option-chain snapshots for an underlying symbol, with optional type, strike and expiration filters. Snapshots may include quotes and Greeks; the response can include a next-page token.Input Parameters
Output
Get Option Contract
Get Option Contract
Get Option Latest Quotes
Get Option Latest Quotes
ALPACA_GET_OPTION_LATEST_QUOTESRetrieves the latest bid and ask prices for specified option symbols. Use when you need real-time quote data for options trading, such as checking current market prices before placing orders or monitoring price movements.Input Parameters
Output
Get Options Meta Conditions
Get Options Meta Conditions
ALPACA_GET_OPTION_META_CONDITIONSRetrieves the mapping of condition codes to their names from Alpaca Markets API for the specified tick type (trade or quote conditions). Use this action when you need to: - Decode condition codes from options market data - Get the list of all valid condition codes and their meanings for a specific tick type - Translate raw condition code integers to human-readable names This is a read-only action that queries the options meta conditions endpoint.Input Parameters
Output
Get Option Contracts
Get Option Contracts
ALPACA_GET_OPTIONS_CONTRACTSRetrieve option contracts from Alpaca Markets API (BETA). Use this action when you need to: - Search for option contracts by underlying symbol - Filter contracts by expiration date, strike price, type (call/put), or style - Get a paginated list of all available option contracts - Find contracts eligible for penny price increments By default, only active contracts expiring before the upcoming weekend are returned.Input Parameters
Output
Get Options Latest Trades
Get Options Latest Trades
ALPACA_GET_OPTIONS_LATEST_TRADESRetrieves the latest trade for each requested option contract symbol. Use this action when you need to: - Get the most recent trade price and size for specific option contracts - Check the last traded time for option symbols before trading - Monitor real-time trading activity for option positions This endpoint requires market data subscription and uses the data.alpaca.markets base URL.Input Parameters
Output
Get Options Meta Conditions Trade
Get Options Meta Conditions Trade
ALPACA_GET_OPTIONS_META_CONDITIONS_TRADERetrieves the mapping of trade condition codes to their names from Alpaca Markets API. Use this action when you need to: - Decode trade condition codes from options market data - Get the list of all valid trade condition codes and their meanings - Translate raw condition code integers to human-readable names This is a read-only action that queries the options meta conditions endpoint.Output
Get Options Snapshots
Get Options Snapshots
ALPACA_GET_OPTION_SNAPSHOTSRetrieves snapshots (latest trade, latest quote, minute bar, daily bar, and previous daily bar) for multiple option contract symbols. Use this action when you need comprehensive real-time market data for option contracts, such as building an option price dashboard, checking current bid/ask prices across multiple option strikes, or analyzing intraday price movements before trading. Note: This endpoint requires market data subscription and uses the data.alpaca.markets base URL.Input Parameters
Output
Get Options Snapshots by Underlying Symbol
Get Options Snapshots by Underlying Symbol
ALPACA_GET_OPTIONS_SNAPSHOTS_UNDERLYING_SYMBOLRetrieves a page of option chain snapshots for an underlying symbol, with optional contract filters. Snapshots may include latest trades, quotes, Greeks, and implied volatility; use the pagination token to retrieve further results.Input Parameters
Output
Get Options Historical Trades
Get Options Historical Trades
ALPACA_GET_OPTION_TRADESRetrieves historical trade data for option contracts. Use this action when you need to: - Analyze historical trade activity for option contracts - Review past trades for specific option symbols - Calculate volume patterns and trading activity - Track price movements over specific time periods Note: This endpoint uses the data.alpaca.markets base URL and requires market data subscription.Input Parameters
Output
Get PDT Status
Get PDT Status
List account positions
List account positions
Get Quotes for Multiple Stock Symbols
Get Quotes for Multiple Stock Symbols
ALPACA_GET_QUOTES_FOR_MULTIPLE_STOCK_SYMBOLSRetrieves historical quote (bid/ask) data for multiple stock symbols. Use this action when you need historical quote data including bid and ask prices for multiple stock trading symbols. This is useful for trading analysis, backtesting strategies, and monitoring price spreads. Note: Results are sorted by symbol first, then by timestamp. If you hit the limit for one symbol, subsequent symbols won’t appear in the response - use next_page_token to get more results.Input Parameters
Output
Get Quotes for Stock Symbol
Get Quotes for Stock Symbol
ALPACA_GET_QUOTES_FOR_STOCK_SYMBOLRetrieves historical NBBO (National Best Bid and Offer) quotes for a specific stock symbol. Use this action when you need historical quote data for a single stock symbol, such as for analysis, backtesting trading strategies, or research purposes. You can filter results by time range using start and end parameters. The response includes an array of quotes with bid/ask prices, sizes, and exchange information. Pagination is supported via the page_token parameter when results exceed the limit.Input Parameters
Output
Get Stock Snapshot for Symbol
Get Stock Snapshot for Symbol
ALPACA_GET_SNAPSHOT_FOR_STOCK_SYMBOLRetrieves a snapshot (latest trade, latest quote, minute bar, daily bar, and previous daily bar) for a single stock symbol. Use this action when you need comprehensive real-time market data for a single stock symbol, such as checking current market conditions, displaying price information, or analyzing price movements before trading. This endpoint requires the data.alpaca.markets API.Input Parameters
Output
Get Crypto Snapshots
Get Crypto Snapshots
ALPACA_GET_SNAPSHOTS_FOR_MULTIPLE_CRYPTO_SYMBOLSRetrieves snapshots (latest trade, latest quote, minute bar, daily bar, and previous daily bar) for multiple cryptocurrency symbols. Use this action when you need comprehensive real-time market data for multiple crypto symbols, such as building a crypto dashboard, checking current market conditions across multiple assets, or analyzing price movements before trading.Input Parameters
Output
Get Stock Snapshots for Multiple Symbols
Get Stock Snapshots for Multiple Symbols
ALPACA_GET_SNAPSHOTS_FOR_MULTIPLE_STOCK_SYMBOLSRetrieves snapshots (latest trade, latest quote, minute bar, daily bar, and previous daily bar) for multiple stock symbols. Use this action when you need comprehensive real-time market data for multiple stock symbols, such as building a stock dashboard, checking current market conditions across multiple stocks, or analyzing price movements before trading. This endpoint requires the data.alpaca.markets API.Input Parameters
Output
Get Specific Announcement
Get Specific Announcement
ALPACA_GET_SPECIFIC_ANNOUNCEMENTRetrieves a specific corporate action announcement by its unique identifier. Use this action when you need to fetch detailed information about a corporate action such as dividends, stock splits, mergers, spinoffs, or other corporate events. This is a read-only operation that returns the complete announcement details including the corporate action type, relevant dates (ex-date, record date, payable date), and any associated values (cash amounts, split ratios, etc.). The response includes the announcement ID which can be used for reference or correlation with other systems.Input Parameters
Output
Get Stock Auctions
Get Stock Auctions
ALPACA_GET_STOCK_AUCTIONSRetrieves historical auction data for specified stock symbols. Use this action when you need to: - Analyze opening and closing auction prices for stocks - Study pre-market and post-market auction behavior - Understand auction volume and price discovery - Monitor auction-based market data for trading decisions Results are sorted by timestamp in descending order (most recent first). Pagination is supported via the page_token field. Note: This endpoint uses the data.alpaca.markets base URL and requires appropriate data subscriptions for SIP and OTC feeds.Input Parameters
Output
Get Stock Auctions for Symbol
Get Stock Auctions for Symbol
ALPACA_GET_STOCK_AUCTION_SINGLERetrieves historical auction (opening/closing print) data for a single stock symbol. Use this action when you need to analyze auction-related price and volume data for a specific stock ticker. This is useful for: - Understanding opening and closing auction prices - Analyzing auction volume and liquidity - Studying price discovery at market open and close - Trading strategies based on auction data Note: This endpoint uses the data.alpaca.markets base URL and requires appropriate data subscriptions for SIP and OTC feeds.Input Parameters
Output
Get Stocks Meta Conditions Trade
Get Stocks Meta Conditions Trade
ALPACA_GET_STOCKS_META_CONDITIONS_TRADERetrieves stock trade condition code names for a specified tape. Use it to decode trade condition codes from stock market data.Input Parameters
Output
Get Subscription
Get Subscription
ALPACA_GET_SUBSCRIPTIONRetrieves a rebalancing subscription by its unique ID. Returns complete subscription details including the associated account ID, portfolio ID, creation timestamp, and last rebalancing timestamp. Use when you need to fetch subscription information for an existing rebalancing setup. Note: If the subscription_id is invalid or malformed, a 400 error is returned. If the subscription does not exist, a 404 error is returned.Input Parameters
Output
Get Top Movers By Market Type
Get Top Movers By Market Type
ALPACA_GET_TOP_MOVERS_BY_MARKET_TYPERetrieves the top market movers (gainers and losers) for a specified market type. Use this action when you need to: - Fetch top gainers and losers for stock market analysis - Get cryptocurrency movers for crypto trading strategies - Identify assets with significant price movements - Build market sentiment indicators Note: The screener endpoint uses data.alpaca.markets, not api.alpaca.markets.Input Parameters
Output
Get Trades for Multiple Crypto Symbols
Get Trades for Multiple Crypto Symbols
ALPACA_GET_TRADES_FOR_MULTIPLE_CRYPTO_SYMBOLSRetrieves historical trade data for specified crypto symbols. Use when you need to: - Get historical trade data for multiple crypto symbols at once - Analyze trading volume and price movements over time - Build datasets for backtesting or research - Monitor trades across different exchanges Results are sorted by symbol first, then by trade timestamp. If the response contains more data than the limit allows, use the next_page_token to continue fetching.Input Parameters
Output
Get Trades for Multiple Stock Symbols
Get Trades for Multiple Stock Symbols
ALPACA_GET_TRADES_FOR_MULTIPLE_STOCK_SYMBOLSRetrieves historical trade data for multiple stock symbols. Use this action when you need: - Historical trade data for multiple stock symbols at once - Analyze trading volume and price movements over time - Build datasets for backtesting or research - Monitor trades across different exchanges Results are sorted by symbol first, then by trade timestamp. If the response contains more data than the limit allows, use the next_page_token to continue fetching. Note: This endpoint uses the data.alpaca.markets base URL and requires appropriate data subscriptions for SIP and OTC feeds.Input Parameters
Output
Get Historical Trades for Stock Symbol
Get Historical Trades for Stock Symbol
ALPACA_GET_TRADES_FOR_STOCK_SYMBOLRetrieves historical trade data for a single stock symbol from Alpaca’s market data API. Trade records include price, size, exchange and timestamp, and may include trade conditions.Input Parameters
Output
Get Watchlist By ID
Get Watchlist By ID
ALPACA_GET_WATCHLIST_BY_IDRetrieves a single watchlist by its unique identifier. Use when you need to view the details of a specific watchlist, including its name, associated assets, and timestamps. This endpoint provides direct access to a watchlist using its ID rather than requiring account-level traversal. This is a read-only operation that does not modify any data.Input Parameters
Output
Get Watchlist By Name
Get Watchlist By Name
ALPACA_GET_WATCHLIST_BY_NAMERetrieves a specific watchlist by its name. Use when you need to find a particular watchlist without knowing its ID, such as when managing watchlists for display or modification. Returns the watchlist details including all contained symbols. If multiple watchlists share the same name, the API may return the first match.Input Parameters
Output
Get Watchlists
Get Watchlists
ALPACA_GET_WATCHLISTSRetrieves all watchlists associated with the authenticated account. Use this action when you need to: - View all watchlists for an account - Find a specific watchlist by name - Check what symbols are being tracked before adding or removing symbols - Get watchlist IDs for subsequent operations This is a read-only operation that returns the current state of all watchlists including their metadata (ID, name, timestamps) and the assets contained within each.Output
Update Account Configurations
Update Account Configurations
ALPACA_PATCH_ACCOUNT_CONFIGURATIONSUpdate the trading account configuration settings for the authenticated account. Use when you need to modify account-level trading settings such as day-trading buying power checks, fractional trading permissions, margin multiplier limits, shorting restrictions, or trade confirmation email preferences. Supports partial updates - only specify the settings you want to change. Settings not included in the request remain unchanged. This action operates on the currently authenticated account and does not require an account_id parameter.Input Parameters
Output
Remove Asset From Watchlist
Remove Asset From Watchlist
ALPACA_REMOVE_ASSET_FROM_WATCHLISTRemoves a symbol from an existing watchlist in Alpaca. Use this action when you need to delete a ticker symbol from a watchlist that is no longer being tracked. The action returns the updated watchlist after the symbol has been removed. This action is irreversible - once a symbol is removed from a watchlist, it cannot be recovered through this API. You would need to re-add it using a separate add-to-watchlist action if available.Input Parameters
Output
Remove Symbol From Watchlist
Remove Symbol From Watchlist
ALPACA_REMOVE_SYMBOL_FROM_WATCHLISTTool to remove a symbol from an existing watchlist in Alpaca. Use when you need to delete a ticker symbol from a watchlist that is no longer being tracked. This action is irreversible - once a symbol is removed from a watchlist, it cannot be recovered through this API. You would need to re-add it using ALPACA_ADD_ASSET_TO_WATCHLIST.Input Parameters
Output
Update Trading Configurations
Update Trading Configurations
ALPACA_UPDATE_TRADING_CONFIGURATIONSUpdates trading account configurations for an Alpaca trading account. Use when you need to modify account-level trading settings such as day-trading buying power checks, trade confirmation email preferences, or trading restrictions. Supports partial updates - only specify the settings you want to change. Settings not included in the request remain unchanged. This action requires the ‘account:write’ scope.Input Parameters
Output
Update Watchlist By ID
Update Watchlist By ID
ALPACA_UPDATE_WATCHLIST_BY_IDUpdates an existing watchlist by ID, supplying its name and optionally a replacement list of symbols. When provided, the symbols replace the existing symbols in the watchlist.Input Parameters
Output
Update Watchlist By Name
Update Watchlist By Name
ALPACA_UPDATE_WATCHLIST_BY_NAMEUpdates an existing watchlist by its name. Use when you need to modify the symbols in a watchlist or rename it. The action allows partial updates - you can provide only symbols to update the watchlist contents, only a new_name to rename it, or both to update both. At least one of new_name or symbols must be provided. Note: The name parameter identifies which watchlist to update (case-insensitive).Input Parameters
Output
Update Watchlist By Name (v2)
Update Watchlist By Name (v2)
ALPACA_UPDATE_WATCHLIST_BY_NAME2Updates an existing watchlist by its name. Use when you need to modify the symbols in a watchlist or rename it. The action allows partial updates - you can provide only symbols to update the watchlist contents, only a new_name to rename it, or both to update both. At least one of new_name or symbols must be provided. Note: The name parameter identifies which watchlist to update (case-insensitive).Input Parameters
Output
Upload Account CIP Information
Upload Account CIP Information
ALPACA_UPLOAD_ACCOUNT_CIPUpload CIP (Customer Identification Program) information for an account to complete identity verification. Use when you need to submit identity information for a new Alpaca trading account as part of the account onboarding process. This action is typically called after account creation to provide the required identity verification data including citizenship, tax ID, and name.