< API Reference
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

NameDescriptionTypeAdditional information
symbols

Comma-separated list of underlying symbols

string

Required

Response Information

Resource Description

Collection of SymbolExpirations

NameDescriptionTypeAdditional information
expirations

Expirations per symbol

Collection of string

None.

symbol

Symbol

string

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>