Options Data API

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

View
https://eodhistoricaldata.com/api/options/AAPL.US?api_token={your_api_key}
Register to get your free API key or use demo key for AAPL and VTI:
OeAFFmMliFG5orCUuwAKQ8l4WWFQ67YX

Register & Get Data

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:

Apple Options Data API

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.

Register & Get Data

Check our other APIs like EOD Historical Data API or Fundamentals API.

Tagged:

Comments

  1. Reply
    Simon Monecke

    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?

    1. Reply
      EOD Historical Data Support Article Author

      Hello Robert,

      Yes, we have these plans, hope to add it this Spring, right after greeks.

  3. Reply
    John

    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

    1. Reply
      EOD Historical Data Support Article Author

      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.

  7. Reply
    Eldad Nahmany

    Hi,
    thanks for the service, do you have the EOD data (open , close ,high ,low) per option ?
    thanks

    1. Reply
      EOD Historical Data Support Article Author

      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.

  8. Reply
    Ryan Sandnes

    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.

  11. Reply
    Jeremy

    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.

    1. Reply
      EOD Historical Data Support Article Author

      Unfortunately, at the moment we do not provide intraday options and we have no this feature in near plans.

  14. Reply
    Joe

    Hi, what is the official timestamp for bid-ask price? and What does it mean by “lastTradeDateTime”: “0000-00-00 00:00:00”

  15. Reply
    Bill

    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.

    1. Reply
      EOD Historical Data Support Article Author

      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

  18. Reply
    Dmitry

    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.

    1. Reply
      EOD Historical Data Support Article Author

      We do not support EU options for the moment, but we have plans to implement them this year.

  20. Reply
    Li

    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?

Leave a Reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.