Strikes

Get a list of current or historical options strikes for an underlying symbol. If no optional parameters are used, the endpoint returns the strikes for every expiration in the chain.

Endpoint

https://api.marketdata.app/options/strikes/{underlyingSymbol}/

Method

GET

Request Example

HTTP

GET https://api.marketdata.app/v1/options/strikes/AAPL/?date=2023-01-03&expiration=2023-01-20

NodeJS

app.js

fetch(
  "https://api.marketdata.app/v1/options/strikes/AAPL/?date=2023-01-03&expiration=2023-01-20"
)
  .then((res) => {
    console.log(res);
  })
  .catch((err) => {
    console.log(err);
  });

Python

app.py

import requests

url = "https://api.marketdata.app/v1/options/strikes/AAPL/?date=2023-01-03&expiration=2023-01-20"

response = requests.request("GET", url)

print(response.text)

Go

optionStrikes.go

import (
  "fmt"

  api "github.com/MarketDataApp/sdk-go"
)

func ExampleOptionsStrikesRequest() {
	expirations, err := OptionsStrikes().UnderlyingSymbol("AAPL").Date("2023-01-03").Expiration("2023-01-20").Get()
	if err != nil {
		fmt.Print(err)
		return
	}

	for _, expiration := range expirations {
		fmt.Println(expiration)
	}
}

Response Example

{
  "s": "ok",
  "updated": 1663704000,
  "2023-01-20": [
    30.0, 35.0, 40.0, 50.0, 55.0, 60.0, 65.0, 70.0, 75.0, 80.0, 85.0, 90.0,
    95.0, 100.0, 105.0, 110.0, 115.0, 120.0, 125.0, 130.0, 135.0, 140.0, 145.0,
    150.0, 155.0, 160.0, 165.0, 170.0, 175.0, 180.0, 185.0, 190.0, 195.0, 200.0,
    205.0, 210.0, 215.0, 220.0, 225.0, 230.0, 235.0, 240.0, 245.0, 250.0, 260.0,
    270.0, 280.0, 290.0, 300.0
  ]
}

Request Parameters

Required

• underlyingSymbol string

  The underlying ticker symbol for the options chain you wish to lookup.

Optional

• expiration date

  Limit the lookup of strikes to options that expire on a specific expiration date. Accepted date inputs: ISO 8601, unix, spreadsheet.

• date date

  • Use to lookup a historical list of strikes from a specific previous trading day.
  • If date is omitted the expiration dates will be from the current trading day during market hours or from the last trading day when the market is closed.
  • Accepted date inputs: ISO 8601, unix, spreadsheet.

Response Attributes

Success

• s string

  Status will always be ok when there is strike data for the underlying/expirations requested.

• dates array[number]

  The expiration dates requested for the underlying with the option strikes for each expiration.

• updated array[number]

  The date and time of this list of options strikes was updated in Unix time. For historical strikes, this number should match the date parameter.

No Data

• s string

  Status will be no_data if no data is found for the request.

• nextTime number optional

  Unix time of the next quote if there is no data in the requested period, but there is data in a subsequent period.

• prevTime number optional

  Unix time of the previous quote if there is no data in the requested period, but there is data in a previous period.

Error

• s string

  Status will be error if the request produces an error response.

• errmsg string An error message.