< 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

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>