Equity Option API
getEquityOptionsThe getEquityOptions API provides intraday or end-of-day options data such as strike price, closing price, expiration date, volume and volatility, etc.
View All APIsunderlying_symbolsrequired
A valid equity symbol. A maximum of 5 tickers per request.
AAPLtypeoptional
The type of option desired, Call or Put.
CallstrikePriceoptional
The strike price of the option.
37.5expirationMonthoptional
The numeric representation of the expiration month.
05expirationDateoptional
The numeric date for of the expiration day.
2026-11-07optionTypeoptional
Type of option to be returned. Possible Values: Monthly, Weekly. By default both are returned.
Monthlyfieldsoptional
Additional fields requested.
bid,bidSize,ask,askSizeonlyStrikesoptional
To return only the strike prices.
1legacySymbolsoptional
Whether to return our new symbology (AAPL|20200417|250.00C) or legacy symbology (AAPL200417C00250000). Only applies to customers starting before April 13, 2020, newer customers should request the legacySymbol field.
returnActualLegacySymboloptional
Traditionally our legacy symbols have ignored ".X" or "-X" syntax from preferred equities. If you would like the options symbol to include it, please pass this parameter with a value of 1.
always returned
A sequence of characters. (example: GOOG)
always returned
A sequence of characters. (example: GOOG)
A sequence of characters. (example: GOOG)
always returned
A sequence of characters. (example: GOOG)
always returned
A sequence of characters. (example: GOOG)
always returned
A numeric type defining a number with fractional parts. (example: 2.14)
always returned
A date in the format of YYYY-MM-DD.
always returned
A sequence of characters. (example: GOOG)
always returned
A date in the format of YYYY-MM-DD.
A numeric type defining a number with fractional parts. (example: 2.14)
A numeric type defining a number with fractional parts. (example: 2.14)
A numeric type defining a number with fractional parts. (example: 2.14)
A numeric type defining a number with fractional parts. (example: 2.14)
A numeric type defining a number with fractional parts. (example: 2.14)
A numeric type defining a number with fractional parts. (example: 2.14)
A numeric type defining a number with fractional parts. (example: 2.14)
A numeric type defining a whole number. (example: 2)
A date in the format of YYYY-MM-DD.
A numeric type defining a number with fractional parts. (example: 2.14)
A numeric type defining a whole number. (example: 2)
A date in the format of YYYY-MM-DD.
always returned
A numeric type defining a number with fractional parts. (example: 2.14)
always returned
A numeric type defining a number with fractional parts. (example: 2.14)
always returned
A numeric type defining a number with fractional parts. (example: 2.14)
always returned
A numeric type defining a number with fractional parts. (example: 2.14)
always returned
A numeric type defining a number with fractional parts. (example: 2.14)
always returned
A numeric type defining a number with fractional parts. (example: 2.14)
always returned
A numeric type defining a number with fractional parts. (example: 2.14)
A numeric type defining a number with fractional parts. (example: 2.14)
A sequence of characters. (example: GOOG)
A numeric type defining a number with fractional parts. (example: 2.14)
A date in the format of YYYY-MM-DD.
A numeric type defining a whole number. (example: 2)
A numeric type defining a whole number. (example: 2)
A date and time in the format of YYYY-MM-DD HH:MI:SS<TIMEZONE_OFFSET>.
GET
GET https://ondemand.websol.barchart.com/getEquityOptions.json?apikey=YOUR_API_KEY&underlying_symbols=AAPL&type=Call&expirationMonth=05&optionType=Monthly&fields=bid%2CbidSize%2Cask%2CaskSize&onlyStrikes=1
Host: ondemand.websol.barchart.com
POST
POST https://ondemand.websol.barchart.com/getEquityOptions.json
Host: ondemand.websol.barchart.com
Content-Type: application/x-www-form-urlencoded
Content-Length: length
apikey=YOUR_API_KEY&underlying_symbols=AAPL&type=Call&expirationMonth=05&optionType=Monthly&fields=bid%2CbidSize%2Cask%2CaskSize&onlyStrikes=1
Response
{
"status": {
"code": 200,
"message": "Success."
},
"results": [
{
"underlying_symbol": "AAPL",
"symbol": "AAPL260515C00270000",
"exchange": "NASDAQ",
"type": "Call",
"strike": 270,
"expirationDate": "2026-05-15",
"bid": 18.85,
"bidSize": 10,
"ask": 19.05,
"askSize": 5
},
{
"underlying_symbol": "AAPL",
"symbol": "AAPL260515C00275000",
"exchange": "NASDAQ",
"type": "Call",
"strike": 275,
"expirationDate": "2026-05-15",
"bid": 16.05,
"bidSize": 21,
"ask": 16.3,
"askSize": 28
},
{
"underlying_symbol": "AAPL",
"symbol": "AAPL260515C00265000",
"exchange": "NASDAQ",
"type": "Call",
"strike": 265,
"expirationDate": "2026-05-15",
"bid": 21.55,
"bidSize": 22,
"ask": 22.15,
"askSize": 7
},
{
"underlying_symbol": "AAPL",
"symbol": "AAPL260515C00280000",
"exchange": "NASDAQ",
"type": "Call",
"strike": 280,
"expirationDate": "2026-05-15",
"bid": 13.6,
"bidSize": 14,
"ask": 13.8,
"askSize": 30
},
{
"underlying_symbol": "AAPL",
"symbol": "AAPL260515C00260000",
"exchange": "NASDAQ",
"type": "Call",
"strike": 260,
"expirationDate": "2026-05-15",
"bid": 25.05,
"bidSize": 20,
"ask": 25.4,
"askSize": 27
},
{
"underlying_symbol": "AAPL",
"symbol": "AAPL260515C00285000",
"exchange": "NASDAQ",
"type": "Call",
"strike": 285,
"expirationDate": "2026-05-15",
"bid": 11.25,
"bidSize": 24,
"ask": 11.6,
"askSize": 36
},
{
"underlying_symbol": "AAPL",
"symbol": "AAPL260515C00255000",
"exchange": "NASDAQ",
"type": "Call",
"strike": 255,
"expirationDate": "2026-05-15",
"bid": 28.2,
"bidSize": 52,
"ask": 28.9,
"askSize": 16
},
{
"underlying_symbol": "AAPL",
"symbol": "AAPL260515C00290000",
"exchange": "NASDAQ",
"type": "Call",
"strike": 290,
"expirationDate": "2026-05-15",
"bid": 9.4,
"bidSize": 36,
"ask": 9.6,
"askSize": 86
},
{
"underlying_symbol": "AAPL",
"symbol": "AAPL260515C00250000",
"exchange": "NASDAQ",
"type": "Call",
"strike": 250,
"expirationDate": "2026-05-15",
"bid": 32.2,
"bidSize": 12,
"ask": 32.55,
"askSize": 36
},
{
"underlying_symbol": "AAPL",
"symbol": "AAPL260515C00295000",
"exchange": "NASDAQ",
"type": "Call",
"strike": 295,
"expirationDate": "2026-05-15",
"bid": 7.75,
"bidSize": 30,
"ask": 7.95,
"askSize": 40
},
{
"underlying_symbol": "AAPL",
"symbol": "AAPL260515C00245000",
"exchange": "NASDAQ",
"type": "Call",
"strike": 245,
"expirationDate": "2026-05-15",
"bid": 36.05,
"bidSize": 15,
"ask": 36.5,
"askSize": 22
},
{
"underlying_symbol": "AAPL",
"symbol": "AAPL260515C00300000",
"exchange": "NASDAQ",
"type": "Call",
"strike": 300,
"expirationDate": "2026-05-15",
"bid": 6.3,
"bidSize": 39,
"ask": 6.5,
"askSize": 54
},
{
"underlying_symbol": "AAPL",
"symbol": "AAPL260515C00240000",
"exchange": "NASDAQ",
"type": "Call",
"strike": 240,
"expirationDate": "2026-05-15",
"bid": 39.9,
"bidSize": 33,
"ask": 40.4,
"askSize": 49
},
{
"underlying_symbol": "AAPL",
"symbol": "AAPL260515C00305000",
"exchange": "NASDAQ",
"type": "Call",
"strike": 305,
"expirationDate": "2026-05-15",
"bid": 5.1,
"bidSize": 42,
"ask": 5.3,
"askSize": 66
},
{
"underlying_symbol": "AAPL",
"symbol": "AAPL260515C00235000",
"exchange": "NASDAQ",
"type": "Call",
"strike": 235,
"expirationDate": "2026-05-15",
"bid": 44.15,
"bidSize": 5,
"ask": 44.7,
"askSize": 36
},
{
"underlying_symbol": "AAPL",
"symbol": "AAPL260515C00310000",
"exchange": "NASDAQ",
"type": "Call",
"strike": 310,
"expirationDate": "2026-05-15",
"bid": 4.1,
"bidSize": 51,
"ask": 4.25,
"askSize": 128
},
{
"underlying_symbol": "AAPL",
"symbol": "AAPL260515C00230000",
"exchange": "NASDAQ",
"type": "Call",
"strike": 230,
"expirationDate": "2026-05-15",
"bid": 48.1,
"bidSize": 15,
"ask": 48.8,
"askSize": 78
},
{
"underlying_symbol": "AAPL",
"symbol": "AAPL260515C00315000",
"exchange": "NASDAQ",
"type": "Call",
"strike": 315,
"expirationDate": "2026-05-15",
"bid": 3.3,
"bidSize": 19,
"ask": 3.45,
"askSize": 51
},
{
"underlying_symbol": "AAPL",
"symbol": "AAPL260515C00225000",
"exchange": "NASDAQ",
"type": "Call",
"strike": 225,
"expirationDate": "2026-05-15",
"bid": 52.75,
"bidSize": 10,
"ask": 53.3,
"askSize": 46
},
{
"underlying_symbol": "AAPL",
"symbol": "AAPL260515C00320000",
"exchange": "NASDAQ",
"type": "Call",
"strike": 320,
"expirationDate": "2026-05-15",
"bid": 2.65,
"bidSize": 5,
"ask": 2.72,
"askSize": 49
}
]
}
GET
GET https://ondemand.websol.barchart.com/getEquityOptions.xml?apikey=YOUR_API_KEY&underlying_symbols=AAPL&type=Call&expirationMonth=05&optionType=Monthly&fields=bid%2CbidSize%2Cask%2CaskSize&onlyStrikes=1
Host: ondemand.websol.barchart.com
POST
POST https://ondemand.websol.barchart.com/getEquityOptions.xml
Host: ondemand.websol.barchart.com
Content-Type: application/x-www-form-urlencoded
Content-Length: length
apikey=YOUR_API_KEY&underlying_symbols=AAPL&type=Call&expirationMonth=05&optionType=Monthly&fields=bid%2CbidSize%2Cask%2CaskSize&onlyStrikes=1
Response
<?xml version="1.0" encoding="utf-8"?>
<getEquityOptions>
<status>
<code>200</code>
<message>Success.</message>
</status>
<item>
<underlying_symbol>AAPL</underlying_symbol>
<symbol>AAPL260515C00270000</symbol>
<exchange>NASDAQ</exchange>
<type>Call</type>
<strike>270</strike>
<expirationDate>2026-05-15</expirationDate>
<bid>18.85</bid>
<bidSize>10</bidSize>
<ask>19.05</ask>
<askSize>5</askSize>
</item>
<item>
<underlying_symbol>AAPL</underlying_symbol>
<symbol>AAPL260515C00275000</symbol>
<exchange>NASDAQ</exchange>
<type>Call</type>
<strike>275</strike>
<expirationDate>2026-05-15</expirationDate>
<bid>16.05</bid>
<bidSize>21</bidSize>
<ask>16.3</ask>
<askSize>28</askSize>
</item>
<item>
<underlying_symbol>AAPL</underlying_symbol>
<symbol>AAPL260515C00265000</symbol>
<exchange>NASDAQ</exchange>
<type>Call</type>
<strike>265</strike>
<expirationDate>2026-05-15</expirationDate>
<bid>21.55</bid>
<bidSize>22</bidSize>
<ask>22.15</ask>
<askSize>7</askSize>
</item>
<item>
<underlying_symbol>AAPL</underlying_symbol>
<symbol>AAPL260515C00280000</symbol>
<exchange>NASDAQ</exchange>
<type>Call</type>
<strike>280</strike>
<expirationDate>2026-05-15</expirationDate>
<bid>13.6</bid>
<bidSize>14</bidSize>
<ask>13.8</ask>
<askSize>30</askSize>
</item>
<item>
<underlying_symbol>AAPL</underlying_symbol>
<symbol>AAPL260515C00260000</symbol>
<exchange>NASDAQ</exchange>
<type>Call</type>
<strike>260</strike>
<expirationDate>2026-05-15</expirationDate>
<bid>25.05</bid>
<bidSize>20</bidSize>
<ask>25.4</ask>
<askSize>27</askSize>
</item>
<item>
<underlying_symbol>AAPL</underlying_symbol>
<symbol>AAPL260515C00285000</symbol>
<exchange>NASDAQ</exchange>
<type>Call</type>
<strike>285</strike>
<expirationDate>2026-05-15</expirationDate>
<bid>11.25</bid>
<bidSize>24</bidSize>
<ask>11.6</ask>
<askSize>36</askSize>
</item>
<item>
<underlying_symbol>AAPL</underlying_symbol>
<symbol>AAPL260515C00255000</symbol>
<exchange>NASDAQ</exchange>
<type>Call</type>
<strike>255</strike>
<expirationDate>2026-05-15</expirationDate>
<bid>28.2</bid>
<bidSize>52</bidSize>
<ask>28.9</ask>
<askSize>16</askSize>
</item>
<item>
<underlying_symbol>AAPL</underlying_symbol>
<symbol>AAPL260515C00290000</symbol>
<exchange>NASDAQ</exchange>
<type>Call</type>
<strike>290</strike>
<expirationDate>2026-05-15</expirationDate>
<bid>9.4</bid>
<bidSize>36</bidSize>
<ask>9.6</ask>
<askSize>86</askSize>
</item>
<item>
<underlying_symbol>AAPL</underlying_symbol>
<symbol>AAPL260515C00250000</symbol>
<exchange>NASDAQ</exchange>
<type>Call</type>
<strike>250</strike>
<expirationDate>2026-05-15</expirationDate>
<bid>32.2</bid>
<bidSize>12</bidSize>
<ask>32.55</ask>
<askSize>36</askSize>
</item>
<item>
<underlying_symbol>AAPL</underlying_symbol>
<symbol>AAPL260515C00295000</symbol>
<exchange>NASDAQ</exchange>
<type>Call</type>
<strike>295</strike>
<expirationDate>2026-05-15</expirationDate>
<bid>7.75</bid>
<bidSize>30</bidSize>
<ask>7.95</ask>
<askSize>40</askSize>
</item>
<item>
<underlying_symbol>AAPL</underlying_symbol>
<symbol>AAPL260515C00245000</symbol>
<exchange>NASDAQ</exchange>
<type>Call</type>
<strike>245</strike>
<expirationDate>2026-05-15</expirationDate>
<bid>36.05</bid>
<bidSize>15</bidSize>
<ask>36.5</ask>
<askSize>22</askSize>
</item>
<item>
<underlying_symbol>AAPL</underlying_symbol>
<symbol>AAPL260515C00300000</symbol>
<exchange>NASDAQ</exchange>
<type>Call</type>
<strike>300</strike>
<expirationDate>2026-05-15</expirationDate>
<bid>6.3</bid>
<bidSize>39</bidSize>
<ask>6.5</ask>
<askSize>54</askSize>
</item>
<item>
<underlying_symbol>AAPL</underlying_symbol>
<symbol>AAPL260515C00240000</symbol>
<exchange>NASDAQ</exchange>
<type>Call</type>
<strike>240</strike>
<expirationDate>2026-05-15</expirationDate>
<bid>39.9</bid>
<bidSize>33</bidSize>
<ask>40.4</ask>
<askSize>49</askSize>
</item>
<item>
<underlying_symbol>AAPL</underlying_symbol>
<symbol>AAPL260515C00305000</symbol>
<exchange>NASDAQ</exchange>
<type>Call</type>
<strike>305</strike>
<expirationDate>2026-05-15</expirationDate>
<bid>5.1</bid>
<bidSize>42</bidSize>
<ask>5.3</ask>
<askSize>66</askSize>
</item>
<item>
<underlying_symbol>AAPL</underlying_symbol>
<symbol>AAPL260515C00235000</symbol>
<exchange>NASDAQ</exchange>
<type>Call</type>
<strike>235</strike>
<expirationDate>2026-05-15</expirationDate>
<bid>44.15</bid>
<bidSize>5</bidSize>
<ask>44.7</ask>
<askSize>36</askSize>
</item>
<item>
<underlying_symbol>AAPL</underlying_symbol>
<symbol>AAPL260515C00310000</symbol>
<exchange>NASDAQ</exchange>
<type>Call</type>
<strike>310</strike>
<expirationDate>2026-05-15</expirationDate>
<bid>4.1</bid>
<bidSize>51</bidSize>
<ask>4.25</ask>
<askSize>128</askSize>
</item>
<item>
<underlying_symbol>AAPL</underlying_symbol>
<symbol>AAPL260515C00230000</symbol>
<exchange>NASDAQ</exchange>
<type>Call</type>
<strike>230</strike>
<expirationDate>2026-05-15</expirationDate>
<bid>48.1</bid>
<bidSize>15</bidSize>
<ask>48.8</ask>
<askSize>78</askSize>
</item>
<item>
<underlying_symbol>AAPL</underlying_symbol>
<symbol>AAPL260515C00315000</symbol>
<exchange>NASDAQ</exchange>
<type>Call</type>
<strike>315</strike>
<expirationDate>2026-05-15</expirationDate>
<bid>3.3</bid>
<bidSize>19</bidSize>
<ask>3.45</ask>
<askSize>51</askSize>
</item>
<item>
<underlying_symbol>AAPL</underlying_symbol>
<symbol>AAPL260515C00225000</symbol>
<exchange>NASDAQ</exchange>
<type>Call</type>
<strike>225</strike>
<expirationDate>2026-05-15</expirationDate>
<bid>52.75</bid>
<bidSize>10</bidSize>
<ask>53.3</ask>
<askSize>46</askSize>
</item>
<item>
<underlying_symbol>AAPL</underlying_symbol>
<symbol>AAPL260515C00320000</symbol>
<exchange>NASDAQ</exchange>
<type>Call</type>
<strike>320</strike>
<expirationDate>2026-05-15</expirationDate>
<bid>2.65</bid>
<bidSize>5</bidSize>
<ask>2.72</ask>
<askSize>49</askSize>
</item>
</getEquityOptions>
GET
GET https://ondemand.websol.barchart.com/getEquityOptions.csv?apikey=YOUR_API_KEY&underlying_symbols=AAPL&type=Call&expirationMonth=05&optionType=Monthly&fields=bid%2CbidSize%2Cask%2CaskSize&onlyStrikes=1
Host: ondemand.websol.barchart.com
POST
POST https://ondemand.websol.barchart.com/getEquityOptions.csv
Host: ondemand.websol.barchart.com
Content-Type: application/x-www-form-urlencoded
Content-Length: length
apikey=YOUR_API_KEY&underlying_symbols=AAPL&type=Call&expirationMonth=05&optionType=Monthly&fields=bid%2CbidSize%2Cask%2CaskSize&onlyStrikes=1
Response
underlying_symbol,symbol,exchange,type,strike,expirationDate,bid,bidSize,ask,askSize
"AAPL","AAPL260515C00270000","NASDAQ","Call","270","2026-05-15","18.85","10","19.05","5"
"AAPL","AAPL260515C00275000","NASDAQ","Call","275","2026-05-15","16.05","21","16.3","28"
"AAPL","AAPL260515C00265000","NASDAQ","Call","265","2026-05-15","21.55","22","22.15","7"
"AAPL","AAPL260515C00280000","NASDAQ","Call","280","2026-05-15","13.6","14","13.8","30"
"AAPL","AAPL260515C00260000","NASDAQ","Call","260","2026-05-15","25.05","20","25.4","27"
"AAPL","AAPL260515C00285000","NASDAQ","Call","285","2026-05-15","11.25","24","11.6","36"
"AAPL","AAPL260515C00255000","NASDAQ","Call","255","2026-05-15","28.2","52","28.9","16"
"AAPL","AAPL260515C00290000","NASDAQ","Call","290","2026-05-15","9.4","36","9.6","86"
"AAPL","AAPL260515C00250000","NASDAQ","Call","250","2026-05-15","32.2","12","32.55","36"
"AAPL","AAPL260515C00295000","NASDAQ","Call","295","2026-05-15","7.75","30","7.95","40"
"AAPL","AAPL260515C00245000","NASDAQ","Call","245","2026-05-15","36.05","15","36.5","22"
"AAPL","AAPL260515C00300000","NASDAQ","Call","300","2026-05-15","6.3","39","6.5","54"
"AAPL","AAPL260515C00240000","NASDAQ","Call","240","2026-05-15","39.9","33","40.4","49"
"AAPL","AAPL260515C00305000","NASDAQ","Call","305","2026-05-15","5.1","42","5.3","66"
"AAPL","AAPL260515C00235000","NASDAQ","Call","235","2026-05-15","44.15","5","44.7","36"
"AAPL","AAPL260515C00310000","NASDAQ","Call","310","2026-05-15","4.1","51","4.25","128"
"AAPL","AAPL260515C00230000","NASDAQ","Call","230","2026-05-15","48.1","15","48.8","78"
"AAPL","AAPL260515C00315000","NASDAQ","Call","315","2026-05-15","3.3","19","3.45","51"
"AAPL","AAPL260515C00225000","NASDAQ","Call","225","2026-05-15","52.75","10","53.3","46"
"AAPL","AAPL260515C00320000","NASDAQ","Call","320","2026-05-15","2.65","5","2.72","49"
<?php
$ondemand = new SoapClient('https://ondemand.websol.barchart.com/service?wsdl');
$params = [
'apikey' => 'YOUR_API_KEY',
'underlying_symbols' => 'AAPL',
'type' => 'Call',
'expirationMonth' => '05',
'optionType' => 'Monthly',
'fields' => 'bid,bidSize,ask,askSize',
'onlyStrikes' => '1',
];
$result = $ondemand->getEquityOptions($params);
var_dump($result);
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.getEquityOptions("YOUR_API_KEY", "AAPL", "Call", "05", "Monthly", "bid,bidSize,ask,askSize", "1")
use SOAP::Lite;
use SOAP::WSDL;
my $ondemand = SOAP::Lite
-> service('https://ondemand.websol.barchart.com/service?wsdl');
my $result = $ondemand->getEquityOptions('YOUR_API_KEY', 'AAPL', 'Call', '05', 'Monthly', 'bid,bidSize,ask,askSize', '1');
print $result;
from suds.client import Client
ondemand = Client('https://ondemand.websol.barchart.com/service?wsdl')
result = ondemand.service.getEquityOptions('YOUR_API_KEY', 'AAPL', 'Call', '05', 'Monthly', 'bid,bidSize,ask,askSize', '1')
print(result)
require 'savon'
ondemand = Savon.client(wsdl: 'https://ondemand.websol.barchart.com/service?wsdl')
response = ondemand.call(
:getEquityOptions,
message: {
apikey: 'YOUR_API_KEY',
underlying_symbols: 'AAPL',
type: 'Call',
expirationMonth: '05',
optionType: 'Monthly',
fields: 'bid,bidSize,ask,askSize',
onlyStrikes: '1',
}
)
response.body