Option Expirations

Introduction

This API call is used to retrieve the expiration dates for a given underlying asset as of a specified date. The API call takes in the underlying asset symbol, the quotedate, and the format (JSON or CSV) as parameters and returns a list of expiration dates for the underlying asset. The expiration dates are sorted in ascending order.

The data returned includes the expiration date and the underlying asset symbol. The data can be returned in either JSON or CSV format.

Endpoint

/option-expirations/:underlying/:quotedate/:format

Parameters

• underlying (string, required) – The symbol of the underlying asset.
• quotedate (date, required) – The date for which to retrieve expiration dates. Format: ‘yyyy-mm-dd’.
• format (string, required) – The format to return the data in. Valid options: ‘json’ or ‘csv’.

Examples

List of several example calls, URLs, and responses to show users how to interact with the API call. These examples should include a variety of input parameters to demonstrate the different scenarios that the API call can handle.

• https://api.deltaneutral.net/option-expirations/META/2023-05-04/json?apikey=DEMOAPIKEY
• https://api.deltaneutral.net/option-expirations/TSLA/2023-05-04/csv?apikey=DEMOAPIKEY

Related Calls

Use this call first to get the list of expirations. Then call the /eod-options-details

Error Handling

If no data comes back, please check for valid input parameters.

Example Response

    [
      {"underlying":"META","Expiration":"2023-05-05"},
      {"underlying":"META","Expiration":"2023-05-12"},
      {"underlying":"META","Expiration":"2023-05-19"},
      {"underlying":"META","Expiration":"2023-05-26"},
      {"underlying":"META","Expiration":"2023-06-02"},
      {"underlying":"META","Expiration":"2023-06-09"},
      {"underlying":"META","Expiration":"2023-06-16"},
      {"underlying":"META","Expiration":"2023-06-23"},
      {"underlying":"META","Expiration":"2023-07-21"},
      {"underlying":"META","Expiration":"2023-08-18"},
      {"underlying":"META","Expiration":"2023-09-15"},
      {"underlying":"META","Expiration":"2023-10-20"},
      {"underlying":"META","Expiration":"2023-11-17"},
      {"underlying":"META","Expiration":"2023-12-15"},
      {"underlying":"META","Expiration":"2024-01-19"},
      {"underlying":"META","Expiration":"2024-02-16"},
      {"underlying":"META","Expiration":"2024-03-15"},
      {"underlying":"META","Expiration":"2024-06-21"},
      {"underlying":"META","Expiration":"2025-01-17"},
      {"underlying":"META","Expiration":"2025-06-20"},
      {"underlying":"META","Expiration":"2025-12-19"}
    ]