{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/alpaca/json-schema/alpaca-assets-schema.json",
  "title": "Assets",
  "description": "The assets API serves as the master list of assets available for trade and data consumption from Alpaca. Assets are sorted by asset class, exchange and symbol. Some assets are only available for data consumption via Polygon, and are not tradable with Alpaca. These assets will be marked with the flag tradable=false.\n",
  "x-generated": "2026-11-05",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/alpaca-us-trading-api-openapi.yml#/components/schemas/Assets",
  "properties": {
    "attributes": {
      "items": {
        "$ref": "#/$defs/AssetAttribute"
      },
      "type": "array"
    },
    "borrow_status": {
      "description": "Borrow status for US equity assets. This field is omitted for non-US-equity assets.",
      "enum": [
        "easy_to_borrow",
        "hard_to_borrow"
      ],
      "type": "string"
    },
    "class": {
      "$ref": "#/$defs/AssetClass"
    },
    "cusip": {
      "description": "The CUSIP identifier for the asset (US Equities only).\nTo request a specific CUSIP, please reach out to Alpaca support.\n",
      "type": [
        "string",
        "null"
      ]
    },
    "exchange": {
      "$ref": "#/$defs/Exchange"
    },
    "fractionable": {
      "description": "Asset is fractionable or not",
      "type": "boolean"
    },
    "id": {
      "description": "Asset ID",
      "format": "uuid",
      "type": "string"
    },
    "maintenance_margin_requirement": {
      "deprecated": true,
      "description": "**deprecated**: Please use margin_requirement_long or margin_requirement_short instead. Note that these fields are of type string.\nShows the margin requirement percentage for the asset (equities only).\n",
      "type": "number"
    },
    "margin_requirement_long": {
      "description": "The margin requirement percentage for the asset's long positions (equities only), encoded as a decimal string.",
      "format": "decimal",
      "type": "string"
    },
    "margin_requirement_short": {
      "description": "The margin requirement percentage for the asset's short positions (equities only), encoded as a decimal string.",
      "format": "decimal",
      "type": "string"
    },
    "marginable": {
      "description": "Asset is marginable or not",
      "type": "boolean"
    },
    "min_order_size": {
      "description": "Minimum order size. Field available for crypto only.",
      "format": "decimal",
      "type": "string"
    },
    "min_trade_increment": {
      "description": "Amount a trade quantity can be incremented by. Field available for crypto only.",
      "format": "decimal",
      "type": "string"
    },
    "name": {
      "description": "The official name of the asset",
      "minLength": 1,
      "type": "string"
    },
    "price_increment": {
      "description": "Amount the price can be incremented by. Field available for crypto only.",
      "format": "decimal",
      "type": "string"
    },
    "shortable": {
      "description": "Asset is shortable or not",
      "type": "boolean"
    },
    "status": {
      "description": "active or inactive",
      "enum": [
        "active",
        "inactive"
      ],
      "type": "string"
    },
    "symbol": {
      "description": "The symbol of the asset",
      "type": "string"
    },
    "tradable": {
      "description": "Asset is tradable on Alpaca or not",
      "type": "boolean"
    }
  },
  "required": [
    "id",
    "class",
    "exchange",
    "symbol",
    "name",
    "status",
    "tradable",
    "marginable",
    "shortable",
    "fractionable"
  ],
  "type": "object",
  "$defs": {
    "AssetAttribute": {
      "description": "Unique characteristic of an asset. Supported values:\n- `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.\n- `ptp_with_exception`: Users can open positions in these PTPs without general restrictions.\n- `ipo`: Accepting limit orders only before the stock begins trading on the secondary market.\n- `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.\n- `options_late_close`: Indicates the underlying asset's options contracts close at 4:15pm ET instead of the standard 4:00pm ET.\n- `fractional_eh_enabled`: Indicates the asset accepts fractional orders during extended hours sessions (pre-market, post-market, and overnight if enabled).\n- `overnight_tradable`: Asset is eligible for overnight (24x5) trading in supported venues on the platform.\n- `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.",
      "enum": [
        "ptp_no_exception",
        "ptp_with_exception",
        "ipo",
        "has_options",
        "options_late_close",
        "fractional_eh_enabled",
        "overnight_tradable",
        "overnight_halted"
      ],
      "type": "string"
    },
    "AssetClass": {
      "description": "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/orders. This `asset_class: ipo` value is distinct from the assets API `attributes: [\"ipo\"]` flag.",
      "enum": [
        "us_equity",
        "us_option",
        "crypto",
        "crypto_perp",
        "treasury",
        "corporate",
        "global_equity",
        "us_index",
        "us_equity_chain",
        "ipo"
      ],
      "title": "AssetClass",
      "type": "string"
    },
    "Exchange": {
      "description": "Represents the current exchanges Alpaca supports. List is currently:\n\nUS equities:\n- AMEX\n- ARCA\n- BATS\n- NYSE\n- NASDAQ\n- NYSEARCA\n- OTC\n- TXSE\n\nCrypto:\n- CRYPTO\n- ERSX\n- CRXL\n\nCrypto perpetuals:\n- ASCX\n\nIndex symbols:\n- INDEX\n\nINDEX is the artificial exchange for index symbols such as SPX.",
      "enum": [
        "AMEX",
        "ARCA",
        "BATS",
        "NYSE",
        "NASDAQ",
        "NYSEARCA",
        "OTC",
        "CRYPTO",
        "TXSE",
        "ERSX",
        "CRXL",
        "ASCX",
        "INDEX"
      ],
      "title": "Exchange",
      "type": "string"
    }
  }
}