Sign in

v57

latestOpenAPI 3.1.0Proprietaryraw.githubusercontent.com2026-07-2161198428.4 KB
Instruments

Get Option Contracts

List options contracts.

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

get/v1/instruments/options/contracts

Query parameters

underlierstring

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

string uuid

Instrument identifier

OR
string

Symbol (symbol for equities, OSI for options)

Instrument identifier or symbol of the underlying equity/index

expirystring date

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

contract_type'CALL' | 'PUT'

The type of options contract

Filter by contract type: CALL or PUT

page_sizeinteger

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

page_tokenstring byte

Base64URL-encoded pagination token

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

Response

List of options contracts

Example response

{
  "error": {
    "code": 400,
    "message": "Order quantity must be greater than zero"
  },
  "data": [
    {
      "currency": "USD",
      "exchange": "BATO",
      "expiry": "2026-03-18",
      "id": "b6f4b5e2-94a8-4fe4-9a85-2b4a81d30cc5",
      "is_tradable": true,
      "multiplier": "100",
      "strike_price": "150.00",
      "symbol": "AAPL  251219C00150000"
    }
  ]
}