OptionContract

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/alpaca/json-schema/alpaca-option-contract-schema.json",
  "title": "OptionContract",
  "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/OptionContract",
  "properties": {
    "close_price": {
      "description": "The close price of the option contract.",
      "type": "string"
    },
    "close_price_date": {
      "description": "The date of the close price data.",
      "format": "date",
      "type": "string"
    },
    "deliverables": {
      "description": "Represents the deliverables tied to the option contract. While standard contracts entail a single deliverable, non-standard ones can encompass multiple deliverables, each potentially customized with distinct parameters.\nThis array is included in the list contracts response only if the query parameter show_deliverables=true is provided.\n",
      "items": {
        "$ref": "#/$defs/OptionDeliverable"
      },
      "type": "array"
    },
    "expiration_date": {
      "description": "The expiration date of the option contract.",
      "format": "date",
      "type": "string"
    },
    "id": {
      "description": "The unique identifier of the option contract.",
      "format": "uuid",
      "type": "string"
    },
    "multiplier": {
      "description": "The multiplier of the option contract is crucial for calculating both the trade premium and the extended strike price. In standard contracts, the multiplier is always set to 100.\nFor instance, if a contract is traded at $1.50 and the multiplier is 100, the total amount debited when buying the contract would be $150.00.\nSimilarly, when exercising a call contract, the total cost will be equal to the strike price times the multiplier.",
      "format": "decimal",
      "type": "string"
    },
    "name": {
      "description": "The name of the option contract.",
      "type": "string"
    },
    "open_interest": {
      "description": "The open interest of the option contract.",
      "type": "string"
    },
    "open_interest_date": {
      "description": "The date of the open interest data.",
      "format": "date",
      "type": "string"
    },
    "ppind": {
      "description": "The ppind (Penny Program Indicator) field indicates whether an option contract is eligible for penny price increments,\nwith `true` meaning it is part of the Penny Program and `false` meaning it is not.",
      "type": "boolean"
    },
    "root_symbol": {
      "description": "The root symbol of the option contract.",
      "type": "string"
    },
    "size": {
      "description": "Represents the number of underlying shares to be delivered in case the contract is exercised/assigned. For standard contracts, this is always 100.\nThis field should **not** be used as a multiplier, specially for non-standard contracts.",
      "type": "string"
    },
    "status": {
      "description": "The status of the option contract.",
      "enum": [
        "active",
        "inactive"
      ],
      "type": "string"
    },
    "strike_price": {
      "description": "The strike price of the option contract.",
      "format": "decimal",
      "type": "string"
    },
    "style": {
      "$ref": "#/$defs/OptionContractStyle"
    },
    "symbol": {
      "description": "The symbol representing the option contract.",
      "type": "string"
    },
    "tradable": {
      "description": "Indicates whether the option contract is tradable.",
      "type": "boolean"
    },
    "type": {
      "$ref": "#/$defs/OptionContractType"
    },
    "underlying_asset_id": {
      "description": "The unique identifier of the underlying asset.",
      "format": "uuid",
      "type": "string"
    },
    "underlying_symbol": {
      "description": "The underlying symbol of the option contract.",
      "type": "string"
    }
  },
  "required": [
    "id",
    "symbol",
    "name",
    "status",
    "tradable",
    "expiration_date",
    "underlying_symbol",
    "underlying_asset_id",
    "type",
    "style",
    "strike_price",
    "multiplier",
    "size",
    "ppind"
  ],
  "type": "object",
  "$defs": {
    "OptionContractStyle": {
      "description": "The style of the option contract.",
      "enum": [
        "american",
        "european"
      ],
      "type": "string"
    },
    "OptionContractType": {
      "description": "The type of the option contract.",
      "enum": [
        "call",
        "put"
      ],
      "type": "string"
    },
    "OptionDeliverable": {
      "properties": {
        "allocation_percentage": {
          "description": "Cost allocation percentage of the deliverable.\nThis is used to determine the cost basis of the equity shares received from the exercise, specially for non-standard contracts with multiple deliverables.\n",
          "type": "string"
        },
        "amount": {
          "description": "The deliverable amount. For cash deliverables, this is the cash amount.\nFor standard contract, this is always 100.\nWhen deliverable settlement is delayed and the amount is not yet determined, this value is \"0\" and delayed_settlement is true.\n",
          "type": "string"
        },
        "asset_id": {
          "description": "Unique identifier of the deliverable asset. For standard contracts, this is equivalent to underlying_asset_id of the contracts.\nThis field is not returned for cash deliverables.\n",
          "format": "uuid",
          "type": "string"
        },
        "delayed_settlement": {
          "description": "If true, the settlement of the deliverable will be delayed.\nFor instance, in the event of a contract with a delayed deliverable being exercised, both the availability of the deliverable and its settlement may be postponed beyond the typical timeframe.\n",
          "type": "boolean"
        },
        "settlement_method": {
          "description": "Indicates the settlement method that will be used:\n- **BTOB**: Broker to Broker\n- **CADF**: Cash Difference\n- **CAFX**: Cash Fixed\n- **CCC**: Correspondent Clearing Corp\n",
          "enum": [
            "BTOB",
            "CADF",
            "CAFX",
            "CCC"
          ],
          "type": "string"
        },
        "settlement_type": {
          "description": "Indicates when the deliverable will be settled if the contract is exercised/assigned.\n",
          "enum": [
            "T+0",
            "T+1",
            "T+2",
            "T+3",
            "T+4",
            "T+5"
          ],
          "type": "string"
        },
        "symbol": {
          "description": "Symbol of the deliverable. For standard contracts, this is equivalent to the underlying symbol of the contract.\n",
          "type": "string"
        },
        "type": {
          "description": "Type of deliverable, indicating whether it's cash or equity. For standard contracts, it is always \"equity\".\n",
          "enum": [
            "cash",
            "equity"
          ],
          "type": "string"
        }
      },
      "required": [
        "type",
        "symbol",
        "amount",
        "allocation_percentage",
        "settlement_type",
        "settlement_method",
        "delayed_settlement"
      ],
      "type": "object"
    }
  }
}