We provide stock options data for top US stocks from NYSE and NASDAQ, the data for Options starts with April 2018. Options data is updated on a daily basis, however, we do not provide a history for options contracts’ prices or other data. That means: for each contract, there is only the current price, bid/ask, etc. For example, for AAPL today (May 7th, 2021) we have 2439 PUT and CALL option contracts in our database.
Quick Start
To get the most recent historical stock price data use the following URL
OeAFFmMliFG5orCUuwAKQ8l4WWFQ67YX
Parameters
To get historic options data, including a “from” and “to” field in the request. This will return, for each option expiration date in the specified range, summary information covering all option contracts with that expiration date along with details of each option contract. These details include both basic option data and the greeks.
https://eodhistoricaldata.com/api/options/AAPL.US?api_token={your_api_key}&from=2018-05-01&to=2018-06-01
- [mandatory] symbol - In the example above 'AAPL.US'. Could be any supported symbol. No default value.
- [mandatory] api_token - your api token. No default value.
- [optional] from - filters OPTIONS by expirationDate. Default value: today.
- [optional] to - filters OPTIONS by expirationDate. Default value: '2100-01-01'.
- [optional] trade_date_from - filters OPTIONS by lastTradeDateTime. Default value: NONE.
- [optional] trade_date_to - filters OPTIONS by lastTradeDateTime. Default value: NONE.
- [optional] contract_name - returns only the data for particular contract.
Examples
For testing purposes you can try the following API Key (works only for AAPL.US ticker): OeAFFmMliFG5orCUuwAKQ8l4WWFQ67YX:
https://eodhistoricaldata.com/api/options/AAPL.US?api_token=OeAFFmMliFG5orCUuwAKQ8l4WWFQ67YX
if you need the data only for the particular contract, then the URL should be like this:
https://eodhistoricaldata.com/api/options/AAPL?contract_name=AAPL180420P00002500&api_token=OeAFFmMliFG5orCUuwAKQ8l4WWFQ67YX&from=2000-01-01
IMPORTANT! For backward compatibility, you should use ‘from=’ parameter with any value before the expiration date, we recommend ‘2000-01-01’.
Due to complex data structure we provide this data feed only on JSON format and as a result, you will get the following data:
For each Option we do provide the following information:
- Contract name
- Contract size
- Currency
- Type: PUT or CALL
- In the Money: TRUE or FALSE
- Last trade date
- Expiration date
- Strike
- Bid-Ask
- Last Price
- Change and change in percents
- Volume
- Open Interest
- Implied Volatility
- Theoretical
- Intrinsic Value
- Time Value
- Option Greeks
- Delta
- Gamma
- Theta
- Vega
- Rho
Note: option greeks and some additional value are available only for options with expiration date Feb 15, 2019, or later.
We have API limits 100 000 requests per day. Each symbol request costs 10 API call.
Check our other APIs like EOD Historical Data API or Fundamentals API.
This API is very useful to find options with a specified date. But it would be much better if it although delivers the greeks to filter out uninteresting options.
Do you plan to add these?
Hello, yes, we are working on extending our API and hope to add greeks soon.
Are you planning to add real time options pricing?
Hello Robert,
Yes, we have these plans, hope to add it this Spring, right after greeks.
That sounds great! It will be a super helpful feature to have.
Is there an update on real-time options data? Is that available now?
Not yet, we are still working on it.
Hello, today I made some calls to the API options 4 hours after the close of the market and there were still the values of the previous day, at what time do you update this endpoint? Thank you
Could you please send the request to support@eodhistoricaldata.com, we do not provide support via comments.
I found you from the wordpress plugins page and was wondering if options data could be imported into a wordpress website?
We have no special plugin for options data, but any plugin which able to download and parse JSON data for WP will work for you.
Has it been added yet?
I’m sorry, what do you mean here?
What time of the day is this dataset updated?
We update it on daily basis 2-3 hours after the market closing.
Hi,
thanks for the service, do you have the EOD data (open , close ,high ,low) per option ?
thanks
At the moment we have only the latest snapshot on the end of day for each option, more information with the live example for AAPL you can find on this page.
Why is it taking 10x longer to request a single contract vs requesting all for a given option? My guess is the database could make use of indexing/structure a bit better, but perhaps there is another reason? It is unfortunately much faster to request all and programmatically ignore the contracts I’m not looking for.
Do you have exact examples? I just checked and our queries work fast.
Is there a way to find all the symbols with options?
It’s all symbols traded on Nasdaq/NYSE
Is there an update on real-time options data? Is that available now?
No, it’s still not available, only the end of day options data.
I noticed in 2019 you indicated a plan to add real-time options data in spring 2019 after the greeks. I understand that it isn’t currently available but do you have a realistic expectation of adding it and if so what is your timeline goal? Would be helpful for us to decide is we should look for other solutions or wait a bit longer for you. Even an hourly update rate would be super helpful to look at trends throughout the day. Thanks in advance for your response.
Unfortunately, at the moment we do not provide intraday options and we have no this feature in near plans.
Do you provide options historical data yet?
Yes, we have historical data from April 2018 for options.
How to access historical data? For each call it seems the data is for end of day snapshot of the asset’s options.
Hi, what is the official timestamp for bid-ask price? and What does it mean by “lastTradeDateTime”: “0000-00-00 00:00:00”
It means that for a particular option there were no any trades.
The description says you don’t offer historical options data via API but do have that data. Are there any plans to make an endpoint for that? Would absolutely love to work with that.
Hello Bill, we have options from April 2018, but for each particular option, we have no history, only the latest data. We are working now for adding historical data within options.
Thank you
Hello! That’s great news, do you have a roadmap somewhere or an ETA on when that functionality will be available?
Please send all queries to support@eodhistoricaldata.com or webchat. Thank you!
Hello! It will be very nice, if you add option availability flag into exchange symbols API response. For now, someone have to query all symbols consistently to test, does it have options or not.
Thank you for the suggestion, please send the request to support@eodhistoricaldata.com, we will send you the file with list of tickers with options
Do you have options data for European stocks? If not then, do you have plans in future?
We do not support EU options for the moment, but we have plans to implement them this year.
is there a way to request multiple (up to 5) contract_name under the same symbol, instetad of call the API 5 times or retrieve all options? and do I understand correctly, call for a single contract name count 1 API call, call all options for the symbol count 10 API calls?
PLease send all requests to support@eodhistoricaldata.com or webchat.