Skip to main content
GET
/
v1
/
options
/
contracts
List Options Contracts
curl --request GET \
  --url https://data-tools.prd.arrays.org/api/v1/options/contracts \
  --header 'X-API-Key: <api-key>'
{
  "data": [
    {
      "cfi": "<string>",
      "contract_type": "<string>",
      "exercise_style": "<string>",
      "expiration_date": "<string>",
      "is_expired": true,
      "options_ticker": "<string>",
      "primary_exchange": "<string>",
      "shares_per_contract": 123,
      "strike_price": 123,
      "underlying_symbol": "<string>"
    }
  ],
  "error": {
    "code": "RESOURCE_NOT_FOUND",
    "details": [
      {
        "field": "<string>",
        "got": "<string>",
        "reason": "<string>"
      }
    ],
    "docs_url": "<string>",
    "examples": [
      "<string>"
    ],
    "hint": "<string>",
    "message": "The requested resource was not found.",
    "suggestions": [
      "<string>"
    ]
  },
  "pagination": {
    "cursor": "<string>",
    "has_more": true,
    "limit": 123
  },
  "request_id": "<string>",
  "success": true
}

Authorizations

X-API-Key
string
header
required

API Key authentication. Example: "your-api-key-here"

Query Parameters

symbol
string
required

Underlying symbol (e.g. SPY, AAPL)

options_ticker
string

Exact options contract ticker

is_expired
enum<string>

Expired filter: false (default), true, or all

Available options:
true,
false,
all
contract_type
enum<string>

Contract type

Available options:
call,
put
expiration_date_min
string

Min expiration date (YYYY-MM-DD)

expiration_date_max
string

Max expiration date (YYYY-MM-DD)

strike_price_min
number

Min strike price

strike_price_max
number

Max strike price

exercise_style
enum<string>

Exercise style

Available options:
american,
european
sort_by
enum<string>

Sort field

Available options:
expiration_date,
strike_price,
options_ticker
sort_order
enum<string>

Sort direction

Available options:
asc,
desc
cursor
string

Pagination cursor from previous response

limit
integer

Results per page (default 100, max 1000)

Response

Contract list

data
object[]
error
object
pagination
object
request_id
string
success
boolean