v1

latestOpenAPI 3.0.02026-07-26166415635.8 KB

Assets

Retrieve an Asset by ID

Returns the requested asset, if found

get/v1/assets/{symbol_or_asset_id}

Response

Returns asset

attributesstring[]

Unique characteristics of the asset. Supported values:

ptp_no_exception: Asset is a Publicly Traded Partnership (PTP) without a qualified notice; non-U.S. customers may incur 10% withholding on gross proceeds as per IRS guidance, and are blocked from being purchased by default.
ptp_with_exception: Users can open positions in these PTPs without general restrictions.
ipo: Accepting limit orders only before the stock begins trading on the secondary market.
has_options: The underlying equity has listed options available on the platform. Note: if the equity had inactive/expired contracts in the past, this will still show up.
options_late_close: Indicates the underlying asset's options contracts close at 4:15pm ET instead of the standard 4:00pm ET.
fractional_eh_enabled: Indicates the asset accepts fractional orders during extended hours sessions (pre-market, post-market, and overnight if enabled).
overnight_tradable: Asset is eligible for overnight (24x5) trading in supported venues on the platform.
overnight_halted: Asset is eligible for overnight trading but is currently halted/blocked for overnight sessions due to risk, corporate action, compliance, or venue constraints.

borrow_status'easy_to_borrow' | 'hard_to_borrow'

Borrow status for US equity assets. This field is omitted for non-US-equity assets.

class'us_equity' | 'us_option' | 'crypto' | 'ipo' required

This represents the category to which the asset belongs to. It serves to identify the nature of the financial instrument, with options including "us_equity" for U.S. equities, "us_option" for U.S. options, "crypto" for cryptocurrencies, and "ipo" for IPO indications of interest. This asset_class: ipo value is distinct from the assets API attributes: ["ipo"] flag.

easy_to_borrowboolean

deprecated: Please use borrow_status instead. Asset is easy-to-borrow or not (filtering for easy_to_borrow = True is the best way to check whether the name is currently available to short at Alpaca).

Represents the exchange where an asset is traded.

For Stocks:

AMEX
ARCA
BATS
NYSE
NASDAQ
NYSEARCA
OTC

For Crypto:

CRYPTO

fractionableboolean required

Asset is fractionable or not

idstring uuid required

Asset ID

maintenance_margin_requirementnumber

deprecated: Please use margin_requirement_long or margin_requirement_short instead. Note that these fields are of type string. Shows the margin requirement percentage for the asset (equities only).

margin_requirement_longstring required

The margin requirement percentage for the asset's long positions (equities only).

margin_requirement_shortstring required

The margin requirement percentage for the asset's short positions (equities only).

marginableboolean required

Asset is marginable or not

min_order_sizestring

Minimum order size. Field available for crypto only.

min_trade_incrementstring

Amount a trade quantity can be incremented by. Field available for crypto only.

namestring required

The official name of the asset

price_incrementstring

Amount the price can be incremented by. Field available for crypto only.

shortableboolean required

Asset is shortable or not

status'active' | 'inactive' required

active or inactive

symbolstring required

The symbol of the asset

tradableboolean required

Asset is tradable on Alpaca or not

Example response

{
  "attributes": [
    "ptp_no_exception",
    "ipo"
  ],
  "borrow_status": "easy_to_borrow",
  "easy_to_borrow": true,
  "exchange": "NASDAQ",
  "fractionable": true,
  "id": "904837e3-3b76-47ec-b432-046db621571b",
  "marginable": true,
  "name": "Apple Inc. Common Stock",
  "shortable": true,
  "status": "active",
  "symbol": "AAPL",
  "tradable": true
}