## Get Option Contracts

**get** `/v1/instruments/options/contracts`

List options contracts.

Returns options contracts for a given underlier with options-specific metadata.
Exactly one underlier identifier must be provided.

### Query Parameters

- `contract_type: optional ContractType`

  Filter by contract type: CALL or PUT

  - `"CALL"`

  - `"PUT"`

- `expiry: optional string`

  Filter to contracts expiring on this date (YYYY-MM-DD)

- `page_size: optional number`

  The number of items to return per page. Only used when page_token is not provided.

- `page_token: optional string`

  Token for retrieving the next or previous page of results. Contains encoded pagination state; when provided, page_size is ignored.

- `underlier: optional string`

  Underlier symbol (e.g., AAPL, SPX)

- `underlying_instrument_id: optional InstrumentIDOrSymbol`

  OEMS instrument UUID or symbol of the underlying equity/index

### Returns

- `data: OptionsContractList`

  - `id: string`

    OEMS instrument identifier

  - `contract_type: ContractType`

    Whether this is a CALL or PUT

    - `"CALL"`

    - `"PUT"`

  - `currency: string`

    ISO currency code

  - `exchange: string`

    MIC code of the primary listing venue

  - `exercise_style: ExerciseStyle`

    Exercise style

    - `"AMERICAN"`

    - `"EUROPEAN"`

  - `expiry: string`

    Expiration date

  - `is_liquidation_only: boolean`

    Whether the contract is liquidation-only

  - `is_marginable: boolean`

    Whether the contract is marginable

  - `is_restricted: boolean`

    Whether the contract is restricted from trading

  - `listing_type: ListingType`

    Listing type

    - `"STANDARD"`

    - `"FLEX"`

    - `"OTC"`

  - `multiplier: string`

    Contract multiplier (100 for standard options)

  - `strike_price: string`

    Strike price

  - `symbol: string`

    OSI symbol (e.g. "AAPL  251219C00150000")

  - `open_interest: optional number`

    Open interest (number of outstanding contracts), if available

  - `underlying_instrument_id: optional string`

    OEMS instrument ID of the underlying instrument, if resolvable

### Example

```http
curl https://api.clearstreet.com/v1/instruments/options/contracts \
    -H "Authorization: Bearer $API_KEY"
```

#### Response

```json
{
  "data": [
    {
      "contract_type": "CALL",
      "currency": "USD",
      "exchange": "BATO",
      "exercise_style": "AMERICAN",
      "expiry": "2026-03-20",
      "id": "b6f4b5e2-94a8-4fe4-9a85-2b4a81d30cc5",
      "is_liquidation_only": false,
      "is_marginable": true,
      "is_restricted": false,
      "is_tradable": true,
      "listing_type": "STANDARD",
      "multiplier": "100",
      "strike_price": "180",
      "symbol": "AAPL  260320C00180000",
      "underlying_instrument_id": "a1a2a3a4-b1b2-c1c2-d1d2-d3d4d5d6d7d8"
    },
    {
      "contract_type": "PUT",
      "currency": "USD",
      "exchange": "BATO",
      "exercise_style": "AMERICAN",
      "expiry": "2026-03-20",
      "id": "c7e5c6f3-a5b9-5gf5-0b96-3c5b92e41dd6",
      "is_liquidation_only": false,
      "is_marginable": true,
      "is_restricted": false,
      "is_tradable": true,
      "listing_type": "STANDARD",
      "multiplier": "100",
      "strike_price": "180",
      "symbol": "AAPL  260320P00180000",
      "underlying_instrument_id": "a1a2a3a4-b1b2-c1c2-d1d2-d3d4d5d6d7d8"
    }
  ],
  "metadata": {
    "page_number": 1,
    "request_id": "c2d0429d-c629-4ee1-b719-df007157f3bb",
    "total_items": 2,
    "total_pages": 1
  }
}
```