Futures Options Expirations API

getFuturesOptionsExpirations

The getFuturesOptionsExpiration API provides last trade dates for options on futures contracts.

View All APIs

First Name^*

Last Name^*

Email Address^*

Phone^*

Company^*

Role^*

Industry^*

Country^*

What you are looking for?^*

Please provide as much information as possible (e.g. exchanges, markets or other data sources), the APIs you are interested in (e.g. getQuote, getHistory, getChart, getCorporateActions, etc.), and your use case.

Here are some examples: Example #1, Example #2, Example #3.

By submitting this form you are opting in to receive email communications from Barchart for related product, service or company information, updates and announcements. You can unsubscribe at anytime. View our Privacy Policy.

Inputs

roots^optional

A symbol or code that identifies a futures root. Multiple symbols separated by a comma may be used.

Type

list (A comma or semi-colon delimited string.)

Example

ZC,ZS

contracts^optional

A symbol or code that identifies a futures contract. Multiple symbols separated by a comma may be used.

Type

list (A comma or semi-colon delimited string.)

Example

ZCN14,ZCU14

symbols^optional

A symbol or code that identifies a futures option. Multiple symbols separated by a comma may be used.

Type

list (A comma or semi-colon delimited string.)

Example

ZCK210C,ZCK210P

Outputs

symbol
always returned

A symbol or code that identifies the futures symbol.

string
A sequence of characters. (example: GOOG)

exchange
always returned

The name of the exchange the instrument belongs to.

string
A sequence of characters. (example: GOOG)

underlyingContract
always returned

The contract the option belongs to.

string
A sequence of characters. (example: GOOG)

expirationDate
always returned

The expiration date.

date
A date in the format of YYYY-MM-DD.

Status Code Responses

200

Success

400

Bad Request

The request was invalid, please see the message for more information.

500

Internal Server Error

Something is not working correctly, please contact support.

JSON

GET

GET https://ondemand.websol.barchart.com/getFuturesOptionsExpirations.json?apikey=YOUR_API_KEY&roots=ZC%2CZS&contracts=ZCN14%2CZCU14&symbols=ZCK210C%2CZCK210P
Host: ondemand.websol.barchart.com

POST

POST https://ondemand.websol.barchart.com/getFuturesOptionsExpirations.json
Host: ondemand.websol.barchart.com
Content-Type: application/x-www-form-urlencoded
Content-Length: length

apikey=YOUR_API_KEY&roots=ZC%2CZS&contracts=ZCN14%2CZCU14&symbols=ZCK210C%2CZCK210P

Response

{
    "status": {
        "code": 200,
        "message": "Success."
    },
    "results": [
        {
            "symbol": "ZCF24",
            "exchange": "CBOT",
            "underlyingContract": "ZCH24",
            "expirationDate": "2023-12-22"
        },
        {
            "symbol": "ZCG24",
            "exchange": "CBOT",
            "underlyingContract": "ZCH24",
            "expirationDate": "2024-01-26"
        },
        {
            "symbol": "ZCH24",
            "exchange": "CBOT",
            "underlyingContract": "ZCH24",
            "expirationDate": "2024-02-23"
        },
        {
            "symbol": "ZCH25",
            "exchange": "CBOT",
            "underlyingContract": "ZCH25",
            "expirationDate": "2025-02-21"
        },
        {
            "symbol": "ZCK24",
            "exchange": "CBOT",
            "underlyingContract": "ZCK24",
            "expirationDate": "2024-04-26"
        },
        {
            "symbol": "ZCK25",
            "exchange": "CBOT",
            "underlyingContract": "ZCK25",
            "expirationDate": "2025-04-25"
        },
        {
            "symbol": "ZCN24",
            "exchange": "CBOT",
            "underlyingContract": "ZCN24",
            "expirationDate": "2024-06-21"
        },
        {
            "symbol": "ZCN25",
            "exchange": "CBOT",
            "underlyingContract": "ZCN25",
            "expirationDate": "2025-06-20"
        },
        {
            "symbol": "ZCU24",
            "exchange": "CBOT",
            "underlyingContract": "ZCU24",
            "expirationDate": "2024-08-23"
        },
        {
            "symbol": "ZCZ24",
            "exchange": "CBOT",
            "underlyingContract": "ZCZ24",
            "expirationDate": "2024-11-22"
        },
        {
            "symbol": "ZCZ25",
            "exchange": "CBOT",
            "underlyingContract": "ZCZ25",
            "expirationDate": "2025-11-21"
        },
        {
            "symbol": "ZSF24",
            "exchange": "CBOT",
            "underlyingContract": "ZSF24",
            "expirationDate": "2023-12-22"
        },
        {
            "symbol": "ZSF25",
            "exchange": "CBOT",
            "underlyingContract": "ZSF25",
            "expirationDate": "2024-12-20"
        },
        {
            "symbol": "ZSG24",
            "exchange": "CBOT",
            "underlyingContract": "ZSH24",
            "expirationDate": "2024-01-26"
        },
        {
            "symbol": "ZSH24",
            "exchange": "CBOT",
            "underlyingContract": "ZSH24",
            "expirationDate": "2024-02-23"
        },
        {
            "symbol": "ZSH25",
            "exchange": "CBOT",
            "underlyingContract": "ZSH25",
            "expirationDate": "2025-02-21"
        },
        {
            "symbol": "ZSK24",
            "exchange": "CBOT",
            "underlyingContract": "ZSK24",
            "expirationDate": "2024-04-26"
        },
        {
            "symbol": "ZSN24",
            "exchange": "CBOT",
            "underlyingContract": "ZSN24",
            "expirationDate": "2024-06-21"
        },
        {
            "symbol": "ZSQ24",
            "exchange": "CBOT",
            "underlyingContract": "ZSQ24",
            "expirationDate": "2024-07-26"
        },
        {
            "symbol": "ZSU24",
            "exchange": "CBOT",
            "underlyingContract": "ZSU24",
            "expirationDate": "2024-08-23"
        },
        {
            "symbol": "ZSX24",
            "exchange": "CBOT",
            "underlyingContract": "ZSX24",
            "expirationDate": "2024-10-25"
        },
        {
            "symbol": "ZSX25",
            "exchange": "CBOT",
            "underlyingContract": "ZSX25",
            "expirationDate": "2025-10-24"
        }
    ]
}

XML

GET

GET https://ondemand.websol.barchart.com/getFuturesOptionsExpirations.xml?apikey=YOUR_API_KEY&roots=ZC%2CZS&contracts=ZCN14%2CZCU14&symbols=ZCK210C%2CZCK210P
Host: ondemand.websol.barchart.com

POST

POST https://ondemand.websol.barchart.com/getFuturesOptionsExpirations.xml
Host: ondemand.websol.barchart.com
Content-Type: application/x-www-form-urlencoded
Content-Length: length

apikey=YOUR_API_KEY&roots=ZC%2CZS&contracts=ZCN14%2CZCU14&symbols=ZCK210C%2CZCK210P

Response


<?xml version="1.0" encoding="utf-8"?>
 <getFuturesOptionsExpirations>
  <status>
   <code>200</code>
   <message>Success.</message>
  </status>
  <item>
   <symbol>ZCF24</symbol>
   <exchange>CBOT</exchange>
   <underlyingContract>ZCH24</underlyingContract>
   <expirationDate>2023-12-22</expirationDate>
  </item>
  <item>
   <symbol>ZCG24</symbol>
   <exchange>CBOT</exchange>
   <underlyingContract>ZCH24</underlyingContract>
   <expirationDate>2024-01-26</expirationDate>
  </item>
  <item>
   <symbol>ZCH24</symbol>
   <exchange>CBOT</exchange>
   <underlyingContract>ZCH24</underlyingContract>
   <expirationDate>2024-02-23</expirationDate>
  </item>
  <item>
   <symbol>ZCH25</symbol>
   <exchange>CBOT</exchange>
   <underlyingContract>ZCH25</underlyingContract>
   <expirationDate>2025-02-21</expirationDate>
  </item>
  <item>
   <symbol>ZCK24</symbol>
   <exchange>CBOT</exchange>
   <underlyingContract>ZCK24</underlyingContract>
   <expirationDate>2024-04-26</expirationDate>
  </item>
  <item>
   <symbol>ZCK25</symbol>
   <exchange>CBOT</exchange>
   <underlyingContract>ZCK25</underlyingContract>
   <expirationDate>2025-04-25</expirationDate>
  </item>
  <item>
   <symbol>ZCN24</symbol>
   <exchange>CBOT</exchange>
   <underlyingContract>ZCN24</underlyingContract>
   <expirationDate>2024-06-21</expirationDate>
  </item>
  <item>
   <symbol>ZCN25</symbol>
   <exchange>CBOT</exchange>
   <underlyingContract>ZCN25</underlyingContract>
   <expirationDate>2025-06-20</expirationDate>
  </item>
  <item>
   <symbol>ZCU24</symbol>
   <exchange>CBOT</exchange>
   <underlyingContract>ZCU24</underlyingContract>
   <expirationDate>2024-08-23</expirationDate>
  </item>
  <item>
   <symbol>ZCZ24</symbol>
   <exchange>CBOT</exchange>
   <underlyingContract>ZCZ24</underlyingContract>
   <expirationDate>2024-11-22</expirationDate>
  </item>
  <item>
   <symbol>ZCZ25</symbol>
   <exchange>CBOT</exchange>
   <underlyingContract>ZCZ25</underlyingContract>
   <expirationDate>2025-11-21</expirationDate>
  </item>
  <item>
   <symbol>ZSF24</symbol>
   <exchange>CBOT</exchange>
   <underlyingContract>ZSF24</underlyingContract>
   <expirationDate>2023-12-22</expirationDate>
  </item>
  <item>
   <symbol>ZSF25</symbol>
   <exchange>CBOT</exchange>
   <underlyingContract>ZSF25</underlyingContract>
   <expirationDate>2024-12-20</expirationDate>
  </item>
  <item>
   <symbol>ZSG24</symbol>
   <exchange>CBOT</exchange>
   <underlyingContract>ZSH24</underlyingContract>
   <expirationDate>2024-01-26</expirationDate>
  </item>
  <item>
   <symbol>ZSH24</symbol>
   <exchange>CBOT</exchange>
   <underlyingContract>ZSH24</underlyingContract>
   <expirationDate>2024-02-23</expirationDate>
  </item>
  <item>
   <symbol>ZSH25</symbol>
   <exchange>CBOT</exchange>
   <underlyingContract>ZSH25</underlyingContract>
   <expirationDate>2025-02-21</expirationDate>
  </item>
  <item>
   <symbol>ZSK24</symbol>
   <exchange>CBOT</exchange>
   <underlyingContract>ZSK24</underlyingContract>
   <expirationDate>2024-04-26</expirationDate>
  </item>
  <item>
   <symbol>ZSN24</symbol>
   <exchange>CBOT</exchange>
   <underlyingContract>ZSN24</underlyingContract>
   <expirationDate>2024-06-21</expirationDate>
  </item>
  <item>
   <symbol>ZSQ24</symbol>
   <exchange>CBOT</exchange>
   <underlyingContract>ZSQ24</underlyingContract>
   <expirationDate>2024-07-26</expirationDate>
  </item>
  <item>
   <symbol>ZSU24</symbol>
   <exchange>CBOT</exchange>
   <underlyingContract>ZSU24</underlyingContract>
   <expirationDate>2024-08-23</expirationDate>
  </item>
  <item>
   <symbol>ZSX24</symbol>
   <exchange>CBOT</exchange>
   <underlyingContract>ZSX24</underlyingContract>
   <expirationDate>2024-10-25</expirationDate>
  </item>
  <item>
   <symbol>ZSX25</symbol>
   <exchange>CBOT</exchange>
   <underlyingContract>ZSX25</underlyingContract>
   <expirationDate>2025-10-24</expirationDate>
  </item>
 </getFuturesOptionsExpirations>

CSV

GET

GET https://ondemand.websol.barchart.com/getFuturesOptionsExpirations.csv?apikey=YOUR_API_KEY&roots=ZC%2CZS&contracts=ZCN14%2CZCU14&symbols=ZCK210C%2CZCK210P
Host: ondemand.websol.barchart.com

POST

POST https://ondemand.websol.barchart.com/getFuturesOptionsExpirations.csv
Host: ondemand.websol.barchart.com
Content-Type: application/x-www-form-urlencoded
Content-Length: length

apikey=YOUR_API_KEY&roots=ZC%2CZS&contracts=ZCN14%2CZCU14&symbols=ZCK210C%2CZCK210P

Response

symbol,exchange,underlyingContract,expirationDate
"ZCF24","CBOT","ZCH24","2023-12-22"
"ZCG24","CBOT","ZCH24","2024-01-26"
"ZCH24","CBOT","ZCH24","2024-02-23"
"ZCH25","CBOT","ZCH25","2025-02-21"
"ZCK24","CBOT","ZCK24","2024-04-26"
"ZCK25","CBOT","ZCK25","2025-04-25"
"ZCN24","CBOT","ZCN24","2024-06-21"
"ZCN25","CBOT","ZCN25","2025-06-20"
"ZCU24","CBOT","ZCU24","2024-08-23"
"ZCZ24","CBOT","ZCZ24","2024-11-22"
"ZCZ25","CBOT","ZCZ25","2025-11-21"
"ZSF24","CBOT","ZSF24","2023-12-22"
"ZSF25","CBOT","ZSF25","2024-12-20"
"ZSG24","CBOT","ZSH24","2024-01-26"
"ZSH24","CBOT","ZSH24","2024-02-23"
"ZSH25","CBOT","ZSH25","2025-02-21"
"ZSK24","CBOT","ZSK24","2024-04-26"
"ZSN24","CBOT","ZSN24","2024-06-21"
"ZSQ24","CBOT","ZSQ24","2024-07-26"
"ZSU24","CBOT","ZSU24","2024-08-23"
"ZSX24","CBOT","ZSX24","2024-10-25"
"ZSX25","CBOT","ZSX25","2025-10-24"

PHP

<?php

$ondemand = new SoapClient('https://ondemand.websol.barchart.com/service?wsdl');

$params = [
    'apikey' => 'YOUR_API_KEY',
    'roots' => 'ZC,ZS',
    'contracts' => 'ZCN14,ZCU14',
    'symbols' => 'ZCK210C,ZCK210P',
];

$result = $ondemand->getFuturesOptionsExpirations($params);
var_dump($result);

Classic ASP

Dim ondemand
Dim result

Set ondemand = Server.CreateObject("MSSOAP.SoapClient30")
ondemand.ClientProperty("ServerHTTPRequest") = True
ondemand.MSSoapInit("https://ondemand.websol.barchart.com/service?wsdl")

Set result = ondemand.getFuturesOptionsExpirations("YOUR_API_KEY", "ZC,ZS", "ZCN14,ZCU14", "ZCK210C,ZCK210P")

Perl

use SOAP::Lite;
use SOAP::WSDL;

my $ondemand = SOAP::Lite
    -> service('https://ondemand.websol.barchart.com/service?wsdl');

my $result = $ondemand->getFuturesOptionsExpirations('YOUR_API_KEY', 'ZC,ZS', 'ZCN14,ZCU14', 'ZCK210C,ZCK210P');

print $result;

Python

from suds.client import Client
ondemand = Client('https://ondemand.websol.barchart.com/service?wsdl')

result = ondemand.service.getFuturesOptionsExpirations('YOUR_API_KEY', 'ZC,ZS', 'ZCN14,ZCU14', 'ZCK210C,ZCK210P')

print(result)

Ruby

require 'savon'

ondemand = Savon.client(wsdl: 'https://ondemand.websol.barchart.com/service?wsdl')

response = ondemand.call(
    :getFuturesOptionsExpirations,
    message: {
        apikey: 'YOUR_API_KEY',
        roots: 'ZC,ZS',
        contracts: 'ZCN14,ZCU14',
        symbols: 'ZCK210C,ZCK210P',
    }
)

response.body