Overview
Returns a list of the expiration dates for options that have the specified underlier.
Description

Returns a list of dates suitable for structuring an option table display. The dates are used to group option data (returned by the optionchains method) for a specified underlier, creating a table display.

URL
https://etws.etrade.com/market/rest/optionexpiredate
HTTP Method: GET
Request Parameters
Parameter Type Required? Description
underlier string required The symbol for the underlying instrument for this option
Response Properties
Property Type Description
ExpirationDate complex Container for information on a single expiration date. There will be one of these for each date in the response.
day integer The day (1-31) the option will expire
month integer The month (1-12) the option will expire
year integer The 4-digit year the option will expire
expiryType string Expiry type of the option. Possible values are: QUARTERLY, MONTHLY, or WEEKLY.
Sample Request
GET https://etws.etrade.com/market/rest/optionexpiredate?underlier=ABC
Sample Response - XML
<OptionExpireDateGetResponse>
  <ExpirationDate>
    <day>22</day>
    <month>1</month>
    <year>2011</year>
    <expiryType>MONTHLY</expiryType>
  </ExpirationDate>
  <ExpirationDate>
    <day>19</day>
    <month>2</month>
    <year>2011</year>
    <expiryType>MONTHLY</expiryType>
  </ExpirationDate>
</OptionExpireDateGetResponse>
Sample response - JSON
{
  "OptionExpireDateGetResponse": {
    "ExpirationDate": [
      {
        "day": "22",
        "month": "1",
        "year": "2011",
        "expiryType": "MONTHLY"
      },
      {
        "day": "19",
        "month": "2",
        "year": "2011",
        "expiryType": "MONTHLY"
      }
    ]
  }
}
Notes
  • To create an option chain display, group the option chain data by dates, which are supplied by the Get Option Expire Dates API.
Sample use cases
Purpose Workflow Related APIs
Options display Create a table of options for a desired security by requesting option data (with Get Option Chains), grouping it by dates (from Get Option Expire Dates), sorting each group, and displaying the result. May enhance display by using streaming quote updates for the symbol. Get Option Chains, Get Option Expire Dates, Get Quote, Streaming API
Sandbox Samples

The following shows a typical request and response in the sandbox environment.

Request
GET https://etwssandbox.etrade.com/market/sandbox/rest/optionexpiredate.json?underlier=IBM
Response
{
  "optionExpireDateGetResponse":{
    "expireDates":[
      {
        "day":22,
        "month":1,
        "year":2011,
        "expiryType":"MONTHLY"
      },
      {
        "day":19,
        "month":2,
        "year":2011,
        "expiryType":"MONTHLY"
      },
      {
        "day":19,
        "month":3,
        "year":2011,
        "expiryType":"MONTHLY"
      },
      {
        "day":18,
        "month":6,
        "year":2011,
        "expiryType":"MONTHLY"
      },
      {
        "day":21,
        "month":1,
        "year":2012,
        "expiryType":"MONTHLY"
      },
      {
        "day":19,
        "month":1,
        "year":2013,
        "expiryType":"MONTHLY"
      }
    ]
  }
}
Related APIs
PLEASE READ THE IMPORTANT DISCLOSURES BELOW

By using E*TRADE API ("API") and accepting the terms of the Application Programming Interface License Agreement and the Application Programming Interface User Agreement, you agree that API may employ security policies, procedures and systems of Third Party providers which may or may not be less stringent and secure than the policies, procedures and systems of E*TRADE Securities LLC ("E*TRADE") or its affiliates. Material provided on API may have been produced by independent third parties not affiliated or endorsed by E*TRADE or its affiliates ("Third Party"). To the extent that API or Third Party providers express opinions or make recommendations, you understand that such opinions or recommendations are expressed by the Third Party provider and are not the opinions or recommendations of E*TRADE or its affiliates. E*TRADE is not responsible for the accuracy of market data displayed on API or made available by Third Party providers. There may be latency between the time an order (or other information) is submitted from API and the time the order is received by E*TRADE. The E*TRADE Two Second Execution Guarantee or any similar guarantee does not apply for orders placed through API and Third Party provider web sites. The E*TRADE CompleteTM Protection Guarantee does not apply. Orders created and submitted through API are not vetted until they are received by E*TRADE. It is possible that E*TRADE may reject an order placed through API. Please see the Application Programming Interface License Agreement and the Application Programming Interface User Agreement for more information.


The E*TRADE family of companies provides financial services including trading, investing, and related banking products and services to retail investors.


Securities products and services offered by E*TRADE Securities LLC, Member FINRA/SIPC.


System response and account access times may vary due to a variety of factors, including trading volumes, market conditions, system performance, and other factors.