GET allaccess/reference/expirations?symbols={symbols}

GET

/allaccess/reference/expirations?symbols={symbols}

Get current expiration dates for an underlying security. Expirations can be used as an optional parameter for other API methods, including Market at a Glance option-and-underlying-quotes and Time and Sales option-trades.

Example URI

Live (1 points)


https://api.livevol.com/v1/live/allaccess/reference/expirations?symbols=CBOE,AAPL

Delayed (1 points)


https://api.livevol.com/v1/delayed/allaccess/reference/expirations?symbols=CBOE,AAPL

Request Information

URI Parameters

Name	Description	Type	Additional information
symbols	Comma-separated list of underlying symbols	string	Required

Response Information

Resource Description

Collection of SymbolExpirations

Name	Description	Type	Additional information	SIP Provider
expirations	Expirations per symbol	Collection of string	None	None
symbol	Symbol	string	None	None

Response Formats

application/json, text/json

Sample:

[
  {
    "expirations": [
      "2020-10-02",
      "2020-10-09",
      "2020-10-16"
    ],
    "symbol": "CBOE"
  },
  {
    "expirations": [
      "2020-10-02",
      "2020-10-09",
      "2020-10-16"
    ],
    "symbol": "AAPL"
  }
]

application/xml, text/xml

Sample:

<symbols_expirations xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <symbol_expirations>
    <expirations>
      <expiration>2020-10-02</expiration>
      <expiration>2020-10-09</expiration>
      <expiration>2020-10-16</expiration>
    </expirations>
    <symbol>CBOE</symbol>
  </symbol_expirations>
  <symbol_expirations>
    <expirations>
      <expiration>2020-10-02</expiration>
      <expiration>2020-10-09</expiration>
      <expiration>2020-10-16</expiration>
    </expirations>
    <symbol>AAPL</symbol>
  </symbol_expirations>
</symbols_expirations>