{ "opencollection": "1.0.0", "info": { "name": "Theta Data v3 At-Time History API", "version": "3.0.0" }, "items": [ { "info": { "name": "History", "type": "folder" }, "items": [ { "info": { "name": "End of Day", "type": "http" }, "http": { "method": "GET", "url": "http://127.0.0.1:25503/v3/stock/history/eod", "params": [ { "name": "symbol", "value": "", "type": "query", "description": "The stock or index symbol, or underlying symbol for options." }, { "name": "start_date", "value": "", "type": "query", "description": "The start date (inclusive)." }, { "name": "end_date", "value": "", "type": "query", "description": "The end date (inclusive)." }, { "name": "format", "value": "", "type": "query", "description": "The format of the data when returned to the user." } ] }, "docs": "\nSince [the equity SIPs](/Articles/Data-And-Requests/The-SIPs.html) only generate a partial EOD report, Theta Data generates a national EOD report at 17:15 ET each day. ``created`` represents the datetime the report was generated and ``last_trade`` represents the datetime of the last trade. The quote in the response represents the last NBBO reported by [CTA or UTP](/Articles/Data-And-Requests/The-SIPs.html) at the time of report generation. You can read more about EOD & OHLC data [here](/Article" }, { "info": { "name": "Open High Low Close", "type": "http" }, "http": { "method": "GET", "url": "http://127.0.0.1:25503/v3/stock/history/ohlc", "params": [ { "name": "symbol", "value": "", "type": "query", "description": "The stock or index symbol, or underlying symbol for options." }, { "name": "date", "value": "", "type": "query", "description": "The date to fetch data for. If present, this overrides start_date and end_date." }, { "name": "interval", "value": "", "type": "query", "description": "The size of the time interval must be one of the available options listed below. Intervals less than 1m are available only for single-day requests." }, { "name": "start_time", "value": "", "type": "query", "description": "The start time (inclusive) in the specified day (format 24-hour HH:MM:SS.SSS)." }, { "name": "end_time", "value": "", "type": "query", "description": "The end time (inclusive) in the specified day (format 24-hour HH:MM:SS.SSS)." }, { "name": "venue", "value": "", "type": "query", "description": "Used to specify the venue of the real time or historic request. ``nqb`` = Nasdaq Basic; ``utp_cta`` = merged UTP & CTA." }, { "name": "format", "value": "", "type": "query", "description": "The format of the data when returned to the user." }, { "name": "start_date", "value": "", "type": "query", "description": "The start date (inclusive)." }, { "name": "end_date", "value": "", "type": "query", "description": "The end date (inclusive)." } ] }, "docs": "- Aggregated OHLC bars that use [SIP rules](/Articles/Data-And-Requests/OHLC-EOD.html) for each bar. Time timestamp of the bar represents the opening time of the bar. For a trade to be part of the bar: ``bar time`` <= ``trade time`` < ``bar timestamp + ivl``, where ivl is the specified interval size in milliseconds. \n- Set the ``venue`` parameter to ``nqb`` to access current-day real-time historic data from the [Nasdaq Basic feed](/Articles/Data-And-Requests/The-SIPs) if the account has a [stoc" }, { "info": { "name": "Trade", "type": "http" }, "http": { "method": "GET", "url": "http://127.0.0.1:25503/v3/stock/history/trade", "params": [ { "name": "symbol", "value": "", "type": "query", "description": "The stock or index symbol, or underlying symbol for options." }, { "name": "date", "value": "", "type": "query", "description": "The date to fetch data for. If present, this overrides start_date and end_date." }, { "name": "start_time", "value": "", "type": "query", "description": "The start time (inclusive) in the specified day (format 24-hour HH:MM:SS.SSS)." }, { "name": "end_time", "value": "", "type": "query", "description": "The end time (inclusive) in the specified day (format 24-hour HH:MM:SS.SSS)." }, { "name": "venue", "value": "", "type": "query", "description": "Used to specify the venue of the real time or historic request. ``nqb`` = Nasdaq Basic; ``utp_cta`` = merged UTP & CTA." }, { "name": "format", "value": "", "type": "query", "description": "The format of the data when returned to the user." }, { "name": "start_date", "value": "", "type": "query", "description": "The start date (inclusive)." }, { "name": "end_date", "value": "", "type": "query", "description": "The end date (inclusive)." } ] }, "docs": "Returns every trade reported by [UTP & CTA](/Articles/Data-And-Requests/The-SIPs). Set the ``venue`` parameter to ``nqb`` to access current-day real-time historic data from the [Nasdaq Basic feed](/Articles/Data-And-Requests/The-SIPs) if the account has a [stocks standard or pro subscription](https://www.thetadata.net/subscribe.html#stocks).\n- Multi-day requests are limited to 1 month of data.\n" }, { "info": { "name": "Quote", "type": "http" }, "http": { "method": "GET", "url": "http://127.0.0.1:25503/v3/stock/history/quote", "params": [ { "name": "symbol", "value": "", "type": "query", "description": "The stock or index symbol, or underlying symbol for options." }, { "name": "date", "value": "", "type": "query", "description": "The date to fetch data for. If present, this overrides start_date and end_date." }, { "name": "interval", "value": "", "type": "query", "description": "The size of the time interval must be one of the available options listed below. Intervals less than 1m are available only for single-day requests." }, { "name": "start_time", "value": "", "type": "query", "description": "The start time (inclusive) in the specified day (format 24-hour HH:MM:SS.SSS)." }, { "name": "end_time", "value": "", "type": "query", "description": "The end time (inclusive) in the specified day (format 24-hour HH:MM:SS.SSS)." }, { "name": "venue", "value": "", "type": "query", "description": "Used to specify the venue of the real time or historic request. ``nqb`` = Nasdaq Basic; ``utp_cta`` = merged UTP & CTA." }, { "name": "format", "value": "", "type": "query", "description": "The format of the data when returned to the user." }, { "name": "start_date", "value": "", "type": "query", "description": "The start date (inclusive)." }, { "name": "end_date", "value": "", "type": "query", "description": "The end date (inclusive)." } ] }, "docs": "- Returns every NBBO quote reported by [UTP and CTA](/Articles/Data-And-Requests/The-SIPs). \n- If the ``interval`` parameter is specified, the quote for each interval represents the last quote prior to the interval's timestamp. \n- Set the ``venue`` parameter to ``nqb`` to access current-day real-time historic data from the [Nasdaq Basic feed](/Articles/Data-And-Requests/The-SIPs) if the account has a [stocks standard or pro subscription](https://www.thetadata.net/subscribe.html#stocks).\n- Multi-" }, { "info": { "name": "Trade Quote", "type": "http" }, "http": { "method": "GET", "url": "http://127.0.0.1:25503/v3/stock/history/trade_quote", "params": [ { "name": "symbol", "value": "", "type": "query", "description": "The stock or index symbol, or underlying symbol for options." }, { "name": "date", "value": "", "type": "query", "description": "The date to fetch data for. If present, this overrides start_date and end_date." }, { "name": "start_time", "value": "", "type": "query", "description": "The start time (inclusive) in the specified day (format 24-hour HH:MM:SS.SSS)." }, { "name": "end_time", "value": "", "type": "query", "description": "The end time (inclusive) in the specified day (format 24-hour HH:MM:SS.SSS)." }, { "name": "exclusive", "value": "", "type": "query", "description": "If you prefer to match quotes with timestamps that are < the trade timestamp." }, { "name": "venue", "value": "", "type": "query", "description": "Used to specify the venue of the real time or historic request. ``nqb`` = Nasdaq Basic; ``utp_cta`` = merged UTP & CTA." }, { "name": "format", "value": "", "type": "query", "description": "The format of the data when returned to the user." }, { "name": "start_date", "value": "", "type": "query", "description": "The start date (inclusive)." }, { "name": "end_date", "value": "", "type": "query", "description": "The end date (inclusive)." } ] }, "docs": "Returns every trade reported by [UTP & CTA](/Articles/Data-And-Requests/The-SIPs) paired with the last BBO quote reported by [UTP or CTA](/Articles/Data-And-Requests/The-SIPs) at the time of trade. A quote is matched with a trade if its timestamp ``<=`` the trade timestamp. If you prefer to match quotes with timestamps that are ``<`` the trade timestamp, specify the ``exclusive`` parameter to ``true``. Set the ``venue`` parameter to ``nqb`` to access current-day real-time historic data from the " }, { "info": { "name": "End of Day", "type": "http" }, "http": { "method": "GET", "url": "http://127.0.0.1:25503/v3/option/history/eod", "params": [ { "name": "start_date", "value": "", "type": "query", "description": "The start date (inclusive)." }, { "name": "end_date", "value": "", "type": "query", "description": "The end date (inclusive)." }, { "name": "symbol", "value": "", "type": "query", "description": "The stock or index symbol, or underlying symbol for options." }, { "name": "expiration", "value": "", "type": "query", "description": "The expiration of the contract in `YYYY-MM-DD` or `YYYYMMDD` format, or `*` for all expirations." }, { "name": "strike", "value": "", "type": "query", "description": "The strike price of the contract in dollars (ie `100.00` for `$100.00`), or `*` for all strikes." }, { "name": "right", "value": "", "type": "query", "description": "The right (call or put) of the contract." }, { "name": "max_dte", "value": "", "type": "query", "description": "If specified, only contracts with a full calendar day 'Days to Expiration' (DTE) less than or equal to this number will be returned." }, { "name": "strike_range", "value": "", "type": "query", "description": "Limits the number of contracts returned relative to the underlying's spot price. For a specified value 'n', this returns 'n' strikes above and 'n' strikes below the spot price, plus one at-the-money (ATM) strike (where spot price = strike price), if available. This results in a maximum of `2n + 1` strikes." }, { "name": "format", "value": "", "type": "query", "description": "The format of the data when returned to the user." } ] }, "docs": "- Since [OPRA](/Articles/Data-And-Requests/The-SIPs.html) does not provide a national EOD report for options, Theta Data generates a national EOD report at 17:15 ET each day.\n- ``created`` represents the datetime the report was generated and ``last_trade`` represents the datetime of the last trade. \n- The quote in the response represents the last NBBO reported by OPRA at the time of report generation. \n- You can read more about EOD & OHLC data [here](/Articles/Data-And-Requests/OHLC-EOD.html).\n" }, { "info": { "name": "Open High Low Close", "type": "http" }, "http": { "method": "GET", "url": "http://127.0.0.1:25503/v3/option/history/ohlc", "params": [ { "name": "date", "value": "", "type": "query", "description": "The date to fetch data for. If present, this overrides start_date and end_date." }, { "name": "symbol", "value": "", "type": "query", "description": "The stock or index symbol, or underlying symbol for options." }, { "name": "expiration", "value": "", "type": "query", "description": "The expiration of the contract in `YYYY-MM-DD` or `YYYYMMDD` format." }, { "name": "strike", "value": "", "type": "query", "description": "The strike price of the contract in dollars (ie `100.00` for `$100.00`), or `*` for all strikes." }, { "name": "right", "value": "", "type": "query", "description": "The right (call or put) of the contract." }, { "name": "interval", "value": "", "type": "query", "description": "The size of the time interval must be one of the available options listed below. Intervals less than 1m are available only for single-day requests." }, { "name": "start_time", "value": "", "type": "query", "description": "The start time (inclusive) in the specified day (format 24-hour HH:MM:SS.SSS)." }, { "name": "end_time", "value": "", "type": "query", "description": "The end time (inclusive) in the specified day (format 24-hour HH:MM:SS.SSS)." }, { "name": "strike_range", "value": "", "type": "query", "description": "Limits the number of contracts returned relative to the underlying's spot price. For a specified value 'n', this returns 'n' strikes above and 'n' strikes below the spot price, plus one at-the-money (ATM) strike (where spot price = strike price), if available. This results in a maximum of `2n + 1` strikes." }, { "name": "format", "value": "", "type": "query", "description": "The format of the data when returned to the user." }, { "name": "start_date", "value": "", "type": "query", "description": "The start date (inclusive)." }, { "name": "end_date", "value": "", "type": "query", "description": "The end date (inclusive)." } ] }, "docs": "- Aggregated OHLC bars that use [SIP rules](/Articles/Data-And-Requests/OHLC-EOD.html) for each bar. \n- Time timestamp of the bar represents the opening time of the bar. For a trade to be part of the bar: ``bar timestamp`` <= ``trade time`` < ``bar timestamp + interval``.\n- Multi-day requests are limited to 1 month of data.\n" }, { "info": { "name": "Trade", "type": "http" }, "http": { "method": "GET", "url": "http://127.0.0.1:25503/v3/option/history/trade", "params": [ { "name": "date", "value": "", "type": "query", "description": "The date to fetch data for. If present, this overrides start_date and end_date." }, { "name": "symbol", "value": "", "type": "query", "description": "The stock or index symbol, or underlying symbol for options." }, { "name": "expiration", "value": "", "type": "query", "description": "The expiration of the contract in `YYYY-MM-DD` or `YYYYMMDD` format, or `*` for all expirations." }, { "name": "strike", "value": "", "type": "query", "description": "The strike price of the contract in dollars (ie `100.00` for `$100.00`), or `*` for all strikes." }, { "name": "right", "value": "", "type": "query", "description": "The right (call or put) of the contract." }, { "name": "start_time", "value": "", "type": "query", "description": "The start time (inclusive) in the specified day (format 24-hour HH:MM:SS.SSS)." }, { "name": "end_time", "value": "", "type": "query", "description": "The end time (inclusive) in the specified day (format 24-hour HH:MM:SS.SSS)." }, { "name": "max_dte", "value": "", "type": "query", "description": "If specified, only contracts with a full calendar day 'Days to Expiration' (DTE) less than or equal to this number will be returned." }, { "name": "strike_range", "value": "", "type": "query", "description": "Limits the number of contracts returned relative to the underlying's spot price. For a specified value 'n', this returns 'n' strikes above and 'n' strikes below the spot price, plus one at-the-money (ATM) strike (where spot price = strike price), if available. This results in a maximum of `2n + 1` strikes." }, { "name": "format", "value": "", "type": "query", "description": "The format of the data when returned to the user." }, { "name": "start_date", "value": "", "type": "query", "description": "The start date (inclusive)." }, { "name": "end_date", "value": "", "type": "query", "description": "The end date (inclusive)." } ] }, "docs": "- Returns every trade reported by [OPRA](/Articles/Data-And-Requests/The-SIPs.html). \n- Trade condition mappings can be found [here](/Articles/Errors-Exchanges-Conditions/Trade-Conditions.html).\n- Extended trade conditions are not reported by [OPRA](/Articles/Data-And-Requests/The-SIPs.html) for options, so they can be ignored.\n- Multi-day requests are limited to 1 month of data, and must specify an expiration.\n" }, { "info": { "name": "Quote", "type": "http" }, "http": { "method": "GET", "url": "http://127.0.0.1:25503/v3/option/history/quote", "params": [ { "name": "date", "value": "", "type": "query", "description": "The date to fetch data for. If present, this overrides start_date and end_date." }, { "name": "symbol", "value": "", "type": "query", "description": "The stock or index symbol, or underlying symbol for options." }, { "name": "expiration", "value": "", "type": "query", "description": "The expiration of the contract in `YYYY-MM-DD` or `YYYYMMDD` format, or `*` for all expirations." }, { "name": "strike", "value": "", "type": "query", "description": "The strike price of the contract in dollars (ie `100.00` for `$100.00`), or `*` for all strikes." }, { "name": "right", "value": "", "type": "query", "description": "The right (call or put) of the contract." }, { "name": "start_time", "value": "", "type": "query", "description": "The start time (inclusive) in the specified day (format 24-hour HH:MM:SS.SSS)." }, { "name": "end_time", "value": "", "type": "query", "description": "The end time (inclusive) in the specified day (format 24-hour HH:MM:SS.SSS)." }, { "name": "interval", "value": "", "type": "query", "description": "The size of the time interval must be one of the available options listed below. Intervals less than 1m are available only for single-day requests." }, { "name": "max_dte", "value": "", "type": "query", "description": "If specified, only contracts with a full calendar day 'Days to Expiration' (DTE) less than or equal to this number will be returned." }, { "name": "strike_range", "value": "", "type": "query", "description": "Limits the number of contracts returned relative to the underlying's spot price. For a specified value 'n', this returns 'n' strikes above and 'n' strikes below the spot price, plus one at-the-money (ATM) strike (where spot price = strike price), if available. This results in a maximum of `2n + 1` strikes." }, { "name": "format", "value": "", "type": "query", "description": "The format of the data when returned to the user." }, { "name": "start_date", "value": "", "type": "query", "description": "The start date (inclusive)." }, { "name": "end_date", "value": "", "type": "query", "description": "The end date (inclusive)." } ] }, "docs": "- Returns every NBBO quote reported by [OPRA](/Articles/Data-And-Requests/The-SIPs.html). \n- If the ``interval`` parameter is specified, the quote for each interval represents the last quote at the interval's timestamp.\n- Multi-day requests are limited to 1 month of data, and must specify an expiration.\n" }, { "info": { "name": "Trade Quote", "type": "http" }, "http": { "method": "GET", "url": "http://127.0.0.1:25503/v3/option/history/trade_quote", "params": [ { "name": "date", "value": "", "type": "query", "description": "The date to fetch data for. If present, this overrides start_date and end_date." }, { "name": "symbol", "value": "", "type": "query", "description": "The stock or index symbol, or underlying symbol for options." }, { "name": "expiration", "value": "", "type": "query", "description": "The expiration of the contract in `YYYY-MM-DD` or `YYYYMMDD` format, or `*` for all expirations." }, { "name": "strike", "value": "", "type": "query", "description": "The strike price of the contract in dollars (ie `100.00` for `$100.00`), or `*` for all strikes." }, { "name": "right", "value": "", "type": "query", "description": "The right (call or put) of the contract." }, { "name": "start_time", "value": "", "type": "query", "description": "The start time (inclusive) in the specified day (format 24-hour HH:MM:SS.SSS)." }, { "name": "end_time", "value": "", "type": "query", "description": "The end time (inclusive) in the specified day (format 24-hour HH:MM:SS.SSS)." }, { "name": "exclusive", "value": "", "type": "query", "description": "If you prefer to match quotes with timestamps that are < the trade timestamp." }, { "name": "max_dte", "value": "", "type": "query", "description": "If specified, only contracts with a full calendar day 'Days to Expiration' (DTE) less than or equal to this number will be returned." }, { "name": "strike_range", "value": "", "type": "query", "description": "Limits the number of contracts returned relative to the underlying's spot price. For a specified value 'n', this returns 'n' strikes above and 'n' strikes below the spot price, plus one at-the-money (ATM) strike (where spot price = strike price), if available. This results in a maximum of `2n + 1` strikes." }, { "name": "format", "value": "", "type": "query", "description": "The format of the data when returned to the user." }, { "name": "start_date", "value": "", "type": "query", "description": "The start date (inclusive)." }, { "name": "end_date", "value": "", "type": "query", "description": "The end date (inclusive)." } ] }, "docs": "- Returns every [trade](/operations/option_history_trade.html) reported by [OPRA](/Articles/Data-And-Requests/The-SIPs.html) paired with the last NBBO quote reported by [OPRA](/Articles/Data-And-Requests/The-SIPs.html) at the time of trade.\n- A quote is matched with a trade if its timestamp ``<=`` the trade timestamp. \n- To match trades with quotes timestamps that are ``<`` the trade timestamp, specify the ``exclusive``parameter to ``true``. After thorough testing, we have determined that using " }, { "info": { "name": "Open Interest", "type": "http" }, "http": { "method": "GET", "url": "http://127.0.0.1:25503/v3/option/history/open_interest", "params": [ { "name": "date", "value": "", "type": "query", "description": "The date to fetch data for. If present, this overrides start_date and end_date." }, { "name": "symbol", "value": "", "type": "query", "description": "The stock or index symbol, or underlying symbol for options." }, { "name": "expiration", "value": "", "type": "query", "description": "The expiration of the contract in `YYYY-MM-DD` or `YYYYMMDD` format, or `*` for all expirations." }, { "name": "strike", "value": "", "type": "query", "description": "The strike price of the contract in dollars (ie `100.00` for `$100.00`), or `*` for all strikes." }, { "name": "right", "value": "", "type": "query", "description": "The right (call or put) of the contract." }, { "name": "max_dte", "value": "", "type": "query", "description": "If specified, only contracts with a full calendar day 'Days to Expiration' (DTE) less than or equal to this number will be returned." }, { "name": "strike_range", "value": "", "type": "query", "description": "Limits the number of contracts returned relative to the underlying's spot price. For a specified value 'n', this returns 'n' strikes above and 'n' strikes below the spot price, plus one at-the-money (ATM) strike (where spot price = strike price), if available. This results in a maximum of `2n + 1` strikes." }, { "name": "format", "value": "", "type": "query", "description": "The format of the data when returned to the user." }, { "name": "start_date", "value": "", "type": "query", "description": "The start date (inclusive)." }, { "name": "end_date", "value": "", "type": "query", "description": "The end date (inclusive)." } ] }, "docs": "- Open Interest is normally reported once per day by [OPRA](/Articles/Data-And-Requests/The-SIPs.html) at approximately 06:30 ET.\n- A new open interest message might not be sent by [OPRA](/Articles/Data-And-Requests/The-SIPs.html) if there is no open interest for the option contract.\n- The reported open interest represents the open interest at the end of the previous trading day.\n" }, { "info": { "name": "End of Day Greeks", "type": "http" }, "http": { "method": "GET", "url": "http://127.0.0.1:25503/v3/option/history/greeks/eod", "params": [ { "name": "symbol", "value": "", "type": "query", "description": "The stock or index symbol, or underlying symbol for options." }, { "name": "expiration", "value": "", "type": "query", "description": "The expiration of the contract in `YYYY-MM-DD` or `YYYYMMDD` format, or `*` for all expirations." }, { "name": "strike", "value": "", "type": "query", "description": "The strike price of the contract in dollars (ie `100.00` for `$100.00`), or `*` for all strikes." }, { "name": "right", "value": "", "type": "query", "description": "The right (call or put) of the contract." }, { "name": "start_date", "value": "", "type": "query", "description": "The start date (inclusive)." }, { "name": "end_date", "value": "", "type": "query", "description": "The end date (inclusive)." }, { "name": "annual_dividend", "value": "", "type": "query", "description": "The annualized expected dividend amount to be used in Greeks calculations." }, { "name": "rate_type", "value": "", "type": "query", "description": "The interest rate type to be used in a Greeks calculation." }, { "name": "rate_value", "value": "5", "type": "query", "description": "The interest rate, as a percent, to be used in a Greeks calculation." }, { "name": "version", "value": "", "type": "query", "description": "Used to adjust Greeks calculation methodology. \"1\" uses a fixed .15 DTE for 0DTE; \"latest\" uses real TTE (down to a minimum of 1 hour)" }, { "name": "underlyer_use_nbbo", "value": "", "type": "query", "description": "Used to select underlyer pricing for Greeks calculation. \"true\" uses the midpoint of the NBBO; \"false\" uses the last trade price." }, { "name": "max_dte", "value": "", "type": "query", "description": "If specified, only contracts with a full calendar day 'Days to Expiration' (DTE) less than or equal to this number will be returned." }, { "name": "strike_range", "value": "", "type": "query", "description": "Limits the number of contracts returned relative to the underlying's spot price. For a specified value 'n', this returns 'n' strikes above and 'n' strikes below the spot price, plus one at-the-money (ATM) strike (where spot price = strike price), if available. This results in a maximum of `2n + 1` strikes." }, { "name": "format", "value": "", "type": "query", "description": "The format of the data when returned to the user." } ] }, "docs": "- Returns the data for all contracts that share the same provided symbol and expiration. \n- Uses Theta Data's EOD reports that get generated at 17:15 ET each day. The closing option price and closing underlying price are used for the greeks calculation.\n- **Set `expiration` to ``*`` if you want to retrieve data for every option that shares the same ``symbol``. (note: Any ``expiration=*`` must be requested day by day)**\n" }, { "info": { "name": "All Greeks", "type": "http" }, "http": { "method": "GET", "url": "http://127.0.0.1:25503/v3/option/history/greeks/all", "params": [ { "name": "date", "value": "", "type": "query", "description": "The date to fetch data for. If present, this overrides start_date and end_date." }, { "name": "symbol", "value": "", "type": "query", "description": "The stock or index symbol, or underlying symbol for options." }, { "name": "expiration", "value": "", "type": "query", "description": "The expiration of the contract in `YYYY-MM-DD` or `YYYYMMDD` format." }, { "name": "strike", "value": "", "type": "query", "description": "The strike price of the contract in dollars (ie `100.00` for `$100.00`), or `*` for all strikes." }, { "name": "right", "value": "", "type": "query", "description": "The right (call or put) of the contract." }, { "name": "start_time", "value": "", "type": "query", "description": "The start time (inclusive) in the specified day (format 24-hour HH:MM:SS.SSS)." }, { "name": "end_time", "value": "", "type": "query", "description": "The end time (inclusive) in the specified day (format 24-hour HH:MM:SS.SSS)." }, { "name": "interval", "value": "", "type": "query", "description": "The size of the time interval must be one of the available options listed below. Intervals less than 1m are available only for single-day requests." }, { "name": "annual_dividend", "value": "", "type": "query", "description": "The annualized expected dividend amount to be used in Greeks calculations." }, { "name": "rate_type", "value": "", "type": "query", "description": "The interest rate type to be used in a Greeks calculation." }, { "name": "rate_value", "value": "5", "type": "query", "description": "The interest rate, as a percent, to be used in a Greeks calculation." }, { "name": "version", "value": "", "type": "query", "description": "Used to adjust Greeks calculation methodology. \"1\" uses a fixed .15 DTE for 0DTE; \"latest\" uses real TTE (down to a minimum of 1 hour)" }, { "name": "strike_range", "value": "", "type": "query", "description": "Limits the number of contracts returned relative to the underlying's spot price. For a specified value 'n', this returns 'n' strikes above and 'n' strikes below the spot price, plus one at-the-money (ATM) strike (where spot price = strike price), if available. This results in a maximum of `2n + 1` strikes." }, { "name": "format", "value": "", "type": "query", "description": "The format of the data when returned to the user." }, { "name": "start_date", "value": "", "type": "query", "description": "The start date (inclusive)." }, { "name": "end_date", "value": "", "type": "query", "description": "The end date (inclusive)." } ] }, "docs": "- Returns the data for all contracts that share the same provided symbol and expiration. \n- Calculated using the option and underlying midpoint price. If an interval size is specified (*highly recommended*), the option quote used in the calculation follows the same rules as the [quote](/operations/option_history_quote.html) endpoint. \n- The underlying price represents whatever the last underlying price was at the ``timestamp`` field. You can read more about how Theta Data calculates greeks [here" }, { "info": { "name": "All Trade Greeks", "type": "http" }, "http": { "method": "GET", "url": "http://127.0.0.1:25503/v3/option/history/trade_greeks/all", "params": [ { "name": "date", "value": "", "type": "query", "description": "The date to fetch data for. If present, this overrides start_date and end_date." }, { "name": "symbol", "value": "", "type": "query", "description": "The stock or index symbol, or underlying symbol for options." }, { "name": "expiration", "value": "", "type": "query", "description": "The expiration of the contract in `YYYY-MM-DD` or `YYYYMMDD` format, or `*` for all expirations." }, { "name": "strike", "value": "", "type": "query", "description": "The strike price of the contract in dollars (ie `100.00` for `$100.00`), or `*` for all strikes." }, { "name": "right", "value": "", "type": "query", "description": "The right (call or put) of the contract." }, { "name": "start_time", "value": "", "type": "query", "description": "The start time (inclusive) in the specified day (format 24-hour HH:MM:SS.SSS)." }, { "name": "end_time", "value": "", "type": "query", "description": "The end time (inclusive) in the specified day (format 24-hour HH:MM:SS.SSS)." }, { "name": "annual_dividend", "value": "", "type": "query", "description": "The annualized expected dividend amount to be used in Greeks calculations." }, { "name": "rate_type", "value": "", "type": "query", "description": "The interest rate type to be used in a Greeks calculation." }, { "name": "rate_value", "value": "5", "type": "query", "description": "The interest rate, as a percent, to be used in a Greeks calculation." }, { "name": "version", "value": "", "type": "query", "description": "Used to adjust Greeks calculation methodology. \"1\" uses a fixed .15 DTE for 0DTE; \"latest\" uses real TTE (down to a minimum of 1 hour)" }, { "name": "max_dte", "value": "", "type": "query", "description": "If specified, only contracts with a full calendar day 'Days to Expiration' (DTE) less than or equal to this number will be returned." }, { "name": "strike_range", "value": "", "type": "query", "description": "Limits the number of contracts returned relative to the underlying's spot price. For a specified value 'n', this returns 'n' strikes above and 'n' strikes below the spot price, plus one at-the-money (ATM) strike (where spot price = strike price), if available. This results in a maximum of `2n + 1` strikes." }, { "name": "format", "value": "", "type": "query", "description": "The format of the data when returned to the user." }, { "name": "start_date", "value": "", "type": "query", "description": "The start date (inclusive)." }, { "name": "end_date", "value": "", "type": "query", "description": "The end date (inclusive)." } ] }, "docs": "- Returns the data for all contracts that share the same provided symbol and expiration. \n- Calculates greeks for every trade reported by [OPRA](/Articles/Data-And-Requests/The-SIPs.html).\n- The underlying price represents whatever the last underlying price was at the ``timestamp`` field. You can read more about how Theta Data calculates greeks [here](/Articles/Data-And-Requests/Option-Greeks.html).\n- Multi-day requests are limited to 1 month of data, and must specify an expiration.\n" }, { "info": { "name": "First Order Greeks", "type": "http" }, "http": { "method": "GET", "url": "http://127.0.0.1:25503/v3/option/history/greeks/first_order", "params": [ { "name": "date", "value": "", "type": "query", "description": "The date to fetch data for. If present, this overrides start_date and end_date." }, { "name": "symbol", "value": "", "type": "query", "description": "The stock or index symbol, or underlying symbol for options." }, { "name": "expiration", "value": "", "type": "query", "description": "The expiration of the contract in `YYYY-MM-DD` or `YYYYMMDD` format." }, { "name": "strike", "value": "", "type": "query", "description": "The strike price of the contract in dollars (ie `100.00` for `$100.00`), or `*` for all strikes." }, { "name": "right", "value": "", "type": "query", "description": "The right (call or put) of the contract." }, { "name": "start_time", "value": "", "type": "query", "description": "The start time (inclusive) in the specified day (format 24-hour HH:MM:SS.SSS)." }, { "name": "end_time", "value": "", "type": "query", "description": "The end time (inclusive) in the specified day (format 24-hour HH:MM:SS.SSS)." }, { "name": "interval", "value": "", "type": "query", "description": "The size of the time interval must be one of the available options listed below. Intervals less than 1m are available only for single-day requests." }, { "name": "annual_dividend", "value": "", "type": "query", "description": "The annualized expected dividend amount to be used in Greeks calculations." }, { "name": "rate_type", "value": "", "type": "query", "description": "The interest rate type to be used in a Greeks calculation." }, { "name": "rate_value", "value": "5", "type": "query", "description": "The interest rate, as a percent, to be used in a Greeks calculation." }, { "name": "version", "value": "", "type": "query", "description": "Used to adjust Greeks calculation methodology. \"1\" uses a fixed .15 DTE for 0DTE; \"latest\" uses real TTE (down to a minimum of 1 hour)" }, { "name": "strike_range", "value": "", "type": "query", "description": "Limits the number of contracts returned relative to the underlying's spot price. For a specified value 'n', this returns 'n' strikes above and 'n' strikes below the spot price, plus one at-the-money (ATM) strike (where spot price = strike price), if available. This results in a maximum of `2n + 1` strikes." }, { "name": "format", "value": "", "type": "query", "description": "The format of the data when returned to the user." }, { "name": "start_date", "value": "", "type": "query", "description": "The start date (inclusive)." }, { "name": "end_date", "value": "", "type": "query", "description": "The end date (inclusive)." } ] }, "docs": "- Returns the data for all contracts that share the same provided symbol and expiration. \n- Calculated using the option and underlying midpoint price. If an interval size is specified (*highly recommended*), the option quote used in the calculation follows the same rules as the [quote](/operations/option_history_quote.html) endpoint. \n- The underlying price represents whatever the last underlying price was at the ``timestamp`` field. You can read more about how Theta Data calculates greeks [here" }, { "info": { "name": "First Order Trade Greeks", "type": "http" }, "http": { "method": "GET", "url": "http://127.0.0.1:25503/v3/option/history/trade_greeks/first_order", "params": [ { "name": "date", "value": "", "type": "query", "description": "The date to fetch data for. If present, this overrides start_date and end_date." }, { "name": "symbol", "value": "", "type": "query", "description": "The stock or index symbol, or underlying symbol for options." }, { "name": "expiration", "value": "", "type": "query", "description": "The expiration of the contract in `YYYY-MM-DD` or `YYYYMMDD` format, or `*` for all expirations." }, { "name": "strike", "value": "", "type": "query", "description": "The strike price of the contract in dollars (ie `100.00` for `$100.00`), or `*` for all strikes." }, { "name": "right", "value": "", "type": "query", "description": "The right (call or put) of the contract." }, { "name": "start_time", "value": "", "type": "query", "description": "The start time (inclusive) in the specified day (format 24-hour HH:MM:SS.SSS)." }, { "name": "end_time", "value": "", "type": "query", "description": "The end time (inclusive) in the specified day (format 24-hour HH:MM:SS.SSS)." }, { "name": "annual_dividend", "value": "", "type": "query", "description": "The annualized expected dividend amount to be used in Greeks calculations." }, { "name": "rate_type", "value": "", "type": "query", "description": "The interest rate type to be used in a Greeks calculation." }, { "name": "rate_value", "value": "5", "type": "query", "description": "The interest rate, as a percent, to be used in a Greeks calculation." }, { "name": "version", "value": "", "type": "query", "description": "Used to adjust Greeks calculation methodology. \"1\" uses a fixed .15 DTE for 0DTE; \"latest\" uses real TTE (down to a minimum of 1 hour)" }, { "name": "max_dte", "value": "", "type": "query", "description": "If specified, only contracts with a full calendar day 'Days to Expiration' (DTE) less than or equal to this number will be returned." }, { "name": "strike_range", "value": "", "type": "query", "description": "Limits the number of contracts returned relative to the underlying's spot price. For a specified value 'n', this returns 'n' strikes above and 'n' strikes below the spot price, plus one at-the-money (ATM) strike (where spot price = strike price), if available. This results in a maximum of `2n + 1` strikes." }, { "name": "format", "value": "", "type": "query", "description": "The format of the data when returned to the user." }, { "name": "start_date", "value": "", "type": "query", "description": "The start date (inclusive)." }, { "name": "end_date", "value": "", "type": "query", "description": "The end date (inclusive)." } ] }, "docs": "- Returns the data for all contracts that share the same provided symbol and expiration.\n- Calculates greeks for every trade reported by [OPRA](/Articles/Data-And-Requests/The-SIPs.html).\n- The underlying price represents whatever the last underlying price was at the ``timestamp`` field. You can read more about how Theta Data calculates greeks [here](/Articles/Data-And-Requests/Option-Greeks.html).\n- Multi-day requests are limited to 1 month of data, and must specify an expiration.\n" }, { "info": { "name": "Second Order Greeks", "type": "http" }, "http": { "method": "GET", "url": "http://127.0.0.1:25503/v3/option/history/greeks/second_order", "params": [ { "name": "date", "value": "", "type": "query", "description": "The date to fetch data for. If present, this overrides start_date and end_date." }, { "name": "symbol", "value": "", "type": "query", "description": "The stock or index symbol, or underlying symbol for options." }, { "name": "expiration", "value": "", "type": "query", "description": "The expiration of the contract in `YYYY-MM-DD` or `YYYYMMDD` format." }, { "name": "strike", "value": "", "type": "query", "description": "The strike price of the contract in dollars (ie `100.00` for `$100.00`), or `*` for all strikes." }, { "name": "right", "value": "", "type": "query", "description": "The right (call or put) of the contract." }, { "name": "start_time", "value": "", "type": "query", "description": "The start time (inclusive) in the specified day (format 24-hour HH:MM:SS.SSS)." }, { "name": "end_time", "value": "", "type": "query", "description": "The end time (inclusive) in the specified day (format 24-hour HH:MM:SS.SSS)." }, { "name": "interval", "value": "", "type": "query", "description": "The size of the time interval must be one of the available options listed below. Intervals less than 1m are available only for single-day requests." }, { "name": "annual_dividend", "value": "", "type": "query", "description": "The annualized expected dividend amount to be used in Greeks calculations." }, { "name": "rate_type", "value": "", "type": "query", "description": "The interest rate type to be used in a Greeks calculation." }, { "name": "rate_value", "value": "5", "type": "query", "description": "The interest rate, as a percent, to be used in a Greeks calculation." }, { "name": "version", "value": "", "type": "query", "description": "Used to adjust Greeks calculation methodology. \"1\" uses a fixed .15 DTE for 0DTE; \"latest\" uses real TTE (down to a minimum of 1 hour)" }, { "name": "strike_range", "value": "", "type": "query", "description": "Limits the number of contracts returned relative to the underlying's spot price. For a specified value 'n', this returns 'n' strikes above and 'n' strikes below the spot price, plus one at-the-money (ATM) strike (where spot price = strike price), if available. This results in a maximum of `2n + 1` strikes." }, { "name": "format", "value": "", "type": "query", "description": "The format of the data when returned to the user." }, { "name": "start_date", "value": "", "type": "query", "description": "The start date (inclusive)." }, { "name": "end_date", "value": "", "type": "query", "description": "The end date (inclusive)." } ] }, "docs": "- Returns the data for all contracts that share the same provided symbol and expiration. \n- Calculated using the option and underlying midpoint price. If an interval size is specified (*highly recommended*), the option quote used in the calculation follows the same rules as the [quote](/operations/option_history_quote.html) endpoint. \n- The underlying price represents whatever the last underlying price was at the ``timestamp`` field. You can read more about how Theta Data calculates greeks [here" }, { "info": { "name": "Second Order Trade Greeks", "type": "http" }, "http": { "method": "GET", "url": "http://127.0.0.1:25503/v3/option/history/trade_greeks/second_order", "params": [ { "name": "date", "value": "", "type": "query", "description": "The date to fetch data for. If present, this overrides start_date and end_date." }, { "name": "symbol", "value": "", "type": "query", "description": "The stock or index symbol, or underlying symbol for options." }, { "name": "expiration", "value": "", "type": "query", "description": "The expiration of the contract in `YYYY-MM-DD` or `YYYYMMDD` format, or `*` for all expirations." }, { "name": "strike", "value": "", "type": "query", "description": "The strike price of the contract in dollars (ie `100.00` for `$100.00`), or `*` for all strikes." }, { "name": "right", "value": "", "type": "query", "description": "The right (call or put) of the contract." }, { "name": "start_time", "value": "", "type": "query", "description": "The start time (inclusive) in the specified day (format 24-hour HH:MM:SS.SSS)." }, { "name": "end_time", "value": "", "type": "query", "description": "The end time (inclusive) in the specified day (format 24-hour HH:MM:SS.SSS)." }, { "name": "annual_dividend", "value": "", "type": "query", "description": "The annualized expected dividend amount to be used in Greeks calculations." }, { "name": "rate_type", "value": "", "type": "query", "description": "The interest rate type to be used in a Greeks calculation." }, { "name": "rate_value", "value": "5", "type": "query", "description": "The interest rate, as a percent, to be used in a Greeks calculation." }, { "name": "version", "value": "", "type": "query", "description": "Used to adjust Greeks calculation methodology. \"1\" uses a fixed .15 DTE for 0DTE; \"latest\" uses real TTE (down to a minimum of 1 hour)" }, { "name": "max_dte", "value": "", "type": "query", "description": "If specified, only contracts with a full calendar day 'Days to Expiration' (DTE) less than or equal to this number will be returned." }, { "name": "strike_range", "value": "", "type": "query", "description": "Limits the number of contracts returned relative to the underlying's spot price. For a specified value 'n', this returns 'n' strikes above and 'n' strikes below the spot price, plus one at-the-money (ATM) strike (where spot price = strike price), if available. This results in a maximum of `2n + 1` strikes." }, { "name": "format", "value": "", "type": "query", "description": "The format of the data when returned to the user." }, { "name": "start_date", "value": "", "type": "query", "description": "The start date (inclusive)." }, { "name": "end_date", "value": "", "type": "query", "description": "The end date (inclusive)." } ] }, "docs": "- Returns the data for all contracts that share the same provided symbol and expiration.\n- Calculates greeks for every trade reported by [OPRA](/Articles/Data-And-Requests/The-SIPs.html).\n- The underlying price represents whatever the last underlying price was at the ``timestamp`` field. You can read more about how Theta Data calculates greeks [here](/Articles/Data-And-Requests/Option-Greeks.html).\n- Multi-day requests are limited to 1 month of data, and must specify an expiration.\n" }, { "info": { "name": "Third Order Greeks", "type": "http" }, "http": { "method": "GET", "url": "http://127.0.0.1:25503/v3/option/history/greeks/third_order", "params": [ { "name": "date", "value": "", "type": "query", "description": "The date to fetch data for. If present, this overrides start_date and end_date." }, { "name": "symbol", "value": "", "type": "query", "description": "The stock or index symbol, or underlying symbol for options." }, { "name": "expiration", "value": "", "type": "query", "description": "The expiration of the contract in `YYYY-MM-DD` or `YYYYMMDD` format." }, { "name": "strike", "value": "", "type": "query", "description": "The strike price of the contract in dollars (ie `100.00` for `$100.00`), or `*` for all strikes." }, { "name": "right", "value": "", "type": "query", "description": "The right (call or put) of the contract." }, { "name": "start_time", "value": "", "type": "query", "description": "The start time (inclusive) in the specified day (format 24-hour HH:MM:SS.SSS)." }, { "name": "end_time", "value": "", "type": "query", "description": "The end time (inclusive) in the specified day (format 24-hour HH:MM:SS.SSS)." }, { "name": "interval", "value": "", "type": "query", "description": "The size of the time interval must be one of the available options listed below. Intervals less than 1m are available only for single-day requests." }, { "name": "annual_dividend", "value": "", "type": "query", "description": "The annualized expected dividend amount to be used in Greeks calculations." }, { "name": "rate_type", "value": "", "type": "query", "description": "The interest rate type to be used in a Greeks calculation." }, { "name": "rate_value", "value": "5", "type": "query", "description": "The interest rate, as a percent, to be used in a Greeks calculation." }, { "name": "version", "value": "", "type": "query", "description": "Used to adjust Greeks calculation methodology. \"1\" uses a fixed .15 DTE for 0DTE; \"latest\" uses real TTE (down to a minimum of 1 hour)" }, { "name": "strike_range", "value": "", "type": "query", "description": "Limits the number of contracts returned relative to the underlying's spot price. For a specified value 'n', this returns 'n' strikes above and 'n' strikes below the spot price, plus one at-the-money (ATM) strike (where spot price = strike price), if available. This results in a maximum of `2n + 1` strikes." }, { "name": "format", "value": "", "type": "query", "description": "The format of the data when returned to the user." }, { "name": "start_date", "value": "", "type": "query", "description": "The start date (inclusive)." }, { "name": "end_date", "value": "", "type": "query", "description": "The end date (inclusive)." } ] }, "docs": "- Returns the data for all contracts that share the same provided symbol and expiration. \n- Calculated using the option and underlying midpoint price. If an interval size is specified (*highly recommended*), the option quote used in the calculation follows the same rules as the [quote](/operations/option_history_quote.html) endpoint. \n- The underlying price represents whatever the last underlying price was at the ``timestamp`` field. You can read more about how Theta Data calculates greeks [here" }, { "info": { "name": "Third Order Trade Greeks", "type": "http" }, "http": { "method": "GET", "url": "http://127.0.0.1:25503/v3/option/history/trade_greeks/third_order", "params": [ { "name": "date", "value": "", "type": "query", "description": "The date to fetch data for. If present, this overrides start_date and end_date." }, { "name": "symbol", "value": "", "type": "query", "description": "The stock or index symbol, or underlying symbol for options." }, { "name": "expiration", "value": "", "type": "query", "description": "The expiration of the contract in `YYYY-MM-DD` or `YYYYMMDD` format, or `*` for all expirations." }, { "name": "strike", "value": "", "type": "query", "description": "The strike price of the contract in dollars (ie `100.00` for `$100.00`), or `*` for all strikes." }, { "name": "right", "value": "", "type": "query", "description": "The right (call or put) of the contract." }, { "name": "start_time", "value": "", "type": "query", "description": "The start time (inclusive) in the specified day (format 24-hour HH:MM:SS.SSS)." }, { "name": "end_time", "value": "", "type": "query", "description": "The end time (inclusive) in the specified day (format 24-hour HH:MM:SS.SSS)." }, { "name": "annual_dividend", "value": "", "type": "query", "description": "The annualized expected dividend amount to be used in Greeks calculations." }, { "name": "rate_type", "value": "", "type": "query", "description": "The interest rate type to be used in a Greeks calculation." }, { "name": "rate_value", "value": "5", "type": "query", "description": "The interest rate, as a percent, to be used in a Greeks calculation." }, { "name": "version", "value": "", "type": "query", "description": "Used to adjust Greeks calculation methodology. \"1\" uses a fixed .15 DTE for 0DTE; \"latest\" uses real TTE (down to a minimum of 1 hour)" }, { "name": "max_dte", "value": "", "type": "query", "description": "If specified, only contracts with a full calendar day 'Days to Expiration' (DTE) less than or equal to this number will be returned." }, { "name": "strike_range", "value": "", "type": "query", "description": "Limits the number of contracts returned relative to the underlying's spot price. For a specified value 'n', this returns 'n' strikes above and 'n' strikes below the spot price, plus one at-the-money (ATM) strike (where spot price = strike price), if available. This results in a maximum of `2n + 1` strikes." }, { "name": "format", "value": "", "type": "query", "description": "The format of the data when returned to the user." }, { "name": "start_date", "value": "", "type": "query", "description": "The start date (inclusive)." }, { "name": "end_date", "value": "", "type": "query", "description": "The end date (inclusive)." } ] }, "docs": "- Returns the data for all contracts that share the same provided symbol and expiration.\n- Calculates greeks for every trade reported by [OPRA](/Articles/Data-And-Requests/The-SIPs.html).\n- The underlying price represents whatever the last underlying price was at the ``timestamp`` field. You can read more about how Theta Data calculates greeks [here](/Articles/Data-And-Requests/Option-Greeks.html).\n- Multi-day requests are limited to 1 month of data, and must specify an expiration.\n" }, { "info": { "name": "Implied Volatility", "type": "http" }, "http": { "method": "GET", "url": "http://127.0.0.1:25503/v3/option/history/greeks/implied_volatility", "params": [ { "name": "date", "value": "", "type": "query", "description": "The date to fetch data for. If present, this overrides start_date and end_date." }, { "name": "symbol", "value": "", "type": "query", "description": "The stock or index symbol, or underlying symbol for options." }, { "name": "expiration", "value": "", "type": "query", "description": "The expiration of the contract in `YYYY-MM-DD` or `YYYYMMDD` format." }, { "name": "strike", "value": "", "type": "query", "description": "The strike price of the contract in dollars (ie `100.00` for `$100.00`), or `*` for all strikes." }, { "name": "right", "value": "", "type": "query", "description": "The right (call or put) of the contract." }, { "name": "start_time", "value": "", "type": "query", "description": "The start time (inclusive) in the specified day (format 24-hour HH:MM:SS.SSS)." }, { "name": "end_time", "value": "", "type": "query", "description": "The end time (inclusive) in the specified day (format 24-hour HH:MM:SS.SSS)." }, { "name": "interval", "value": "", "type": "query", "description": "The size of the time interval must be one of the available options listed below. Intervals less than 1m are available only for single-day requests." }, { "name": "annual_dividend", "value": "", "type": "query", "description": "The annualized expected dividend amount to be used in Greeks calculations." }, { "name": "rate_type", "value": "", "type": "query", "description": "The interest rate type to be used in a Greeks calculation." }, { "name": "rate_value", "value": "5", "type": "query", "description": "The interest rate, as a percent, to be used in a Greeks calculation." }, { "name": "version", "value": "", "type": "query", "description": "Used to adjust Greeks calculation methodology. \"1\" uses a fixed .15 DTE for 0DTE; \"latest\" uses real TTE (down to a minimum of 1 hour)" }, { "name": "strike_range", "value": "", "type": "query", "description": "Limits the number of contracts returned relative to the underlying's spot price. For a specified value 'n', this returns 'n' strikes above and 'n' strikes below the spot price, plus one at-the-money (ATM) strike (where spot price = strike price), if available. This results in a maximum of `2n + 1` strikes." }, { "name": "format", "value": "", "type": "query", "description": "The format of the data when returned to the user." }, { "name": "start_date", "value": "", "type": "query", "description": "The start date (inclusive)." }, { "name": "end_date", "value": "", "type": "query", "description": "The end date (inclusive)." } ] }, "docs": "- Returns implied volatilies calculated using the national best bid, mid, and ask price of the option respectively. \n- The underlying price represents whatever the last underlying price was at the ``timestamp`` field. You can read more about how Theta Data calculates greeks [here](/Articles/Data-And-Requests/Option-Greeks.html).\n- Multi-day requests are limited to 1 month of data.\n" }, { "info": { "name": "Trade Implied Volatility", "type": "http" }, "http": { "method": "GET", "url": "http://127.0.0.1:25503/v3/option/history/trade_greeks/implied_volatility", "params": [ { "name": "date", "value": "", "type": "query", "description": "The date to fetch data for. If present, this overrides start_date and end_date." }, { "name": "symbol", "value": "", "type": "query", "description": "The stock or index symbol, or underlying symbol for options." }, { "name": "expiration", "value": "", "type": "query", "description": "The expiration of the contract in `YYYY-MM-DD` or `YYYYMMDD` format, or `*` for all expirations." }, { "name": "strike", "value": "", "type": "query", "description": "The strike price of the contract in dollars (ie `100.00` for `$100.00`), or `*` for all strikes." }, { "name": "right", "value": "", "type": "query", "description": "The right (call or put) of the contract." }, { "name": "start_time", "value": "", "type": "query", "description": "The start time (inclusive) in the specified day (format 24-hour HH:MM:SS.SSS)." }, { "name": "end_time", "value": "", "type": "query", "description": "The end time (inclusive) in the specified day (format 24-hour HH:MM:SS.SSS)." }, { "name": "annual_dividend", "value": "", "type": "query", "description": "The annualized expected dividend amount to be used in Greeks calculations." }, { "name": "rate_type", "value": "", "type": "query", "description": "The interest rate type to be used in a Greeks calculation." }, { "name": "rate_value", "value": "5", "type": "query", "description": "The interest rate, as a percent, to be used in a Greeks calculation." }, { "name": "version", "value": "", "type": "query", "description": "Used to adjust Greeks calculation methodology. \"1\" uses a fixed .15 DTE for 0DTE; \"latest\" uses real TTE (down to a minimum of 1 hour)" }, { "name": "max_dte", "value": "", "type": "query", "description": "If specified, only contracts with a full calendar day 'Days to Expiration' (DTE) less than or equal to this number will be returned." }, { "name": "strike_range", "value": "", "type": "query", "description": "Limits the number of contracts returned relative to the underlying's spot price. For a specified value 'n', this returns 'n' strikes above and 'n' strikes below the spot price, plus one at-the-money (ATM) strike (where spot price = strike price), if available. This results in a maximum of `2n + 1` strikes." }, { "name": "format", "value": "", "type": "query", "description": "The format of the data when returned to the user." }, { "name": "start_date", "value": "", "type": "query", "description": "The start date (inclusive)." }, { "name": "end_date", "value": "", "type": "query", "description": "The end date (inclusive)." } ] }, "docs": "- Returns implied volatilies calculated using the trade reported by [OPRA](/Articles/Data-And-Requests/The-SIPs.html). \n- The underlying price represents whatever the last underlying price was at the ``timestamp`` field. You can read more about how Theta Data calculates greeks [here](/Articles/Data-And-Requests/Option-Greeks.html).\n- Multi-day requests are limited to 1 month of data, and must specify an expiration.\n" }, { "info": { "name": "End of Day", "type": "http" }, "http": { "method": "GET", "url": "http://127.0.0.1:25503/v3/index/history/eod", "params": [ { "name": "symbol", "value": "", "type": "query", "description": "The stock or index symbol, or underlying symbol for options." }, { "name": "start_date", "value": "", "type": "query", "description": "The start date (inclusive)." }, { "name": "end_date", "value": "", "type": "query", "description": "The end date (inclusive)." }, { "name": "format", "value": "", "type": "query", "description": "The format of the data when returned to the user." } ] }, "docs": "- Since [the indices feeds](/Articles/Data-And-Requests/The-SIPs.html) do not provide a national EOD report, Theta Data generates a national EOD report at 17:15 each day.\n" }, { "info": { "name": "Open High Low Close", "type": "http" }, "http": { "method": "GET", "url": "http://127.0.0.1:25503/v3/index/history/ohlc", "params": [ { "name": "symbol", "value": "", "type": "query", "description": "The stock or index symbol, or underlying symbol for options." }, { "name": "start_date", "value": "", "type": "query", "description": "The start date (inclusive)." }, { "name": "end_date", "value": "", "type": "query", "description": "The end date (inclusive)." }, { "name": "interval", "value": "", "type": "query", "description": "The size of the time interval must be one of the available options listed below. Intervals less than 1m are available only for single-day requests." }, { "name": "start_time", "value": "", "type": "query", "description": "The start time (inclusive) in the specified day (format 24-hour HH:MM:SS.SSS)." }, { "name": "end_time", "value": "", "type": "query", "description": "The end time (inclusive) in the specified day (format 24-hour HH:MM:SS.SSS)." }, { "name": "format", "value": "", "type": "query", "description": "The format of the data when returned to the user." } ] }, "docs": "- Aggregated OHLC bars that use [SIP rules](/Articles/Data-And-Requests/OHLC-EOD.html) for each bar.\n- Time timestamp of the bar represents the opening time of the bar. For a trade to be part of the bar: ``bar timestamp`` <= ``trade time`` < ``bar timestamp + interval``.\n- [Exchanges](/Articles/Data-And-Requests/The-SIPs.html) typically generate a price report every second for popular indices like SPX.\n" }, { "info": { "name": "Price", "type": "http" }, "http": { "method": "GET", "url": "http://127.0.0.1:25503/v3/index/history/price", "params": [ { "name": "date", "value": "", "type": "query", "description": "The date to fetch data for. If present, this overrides start_date and end_date." }, { "name": "symbol", "value": "", "type": "query", "description": "The stock or index symbol, or underlying symbol for options." }, { "name": "start_time", "value": "", "type": "query", "description": "The start time (inclusive) in the specified day (format 24-hour HH:MM:SS.SSS)." }, { "name": "end_time", "value": "", "type": "query", "description": "The end time (inclusive) in the specified day (format 24-hour HH:MM:SS.SSS)." }, { "name": "interval", "value": "", "type": "query", "description": "The size of the time interval must be one of the available options listed below. Intervals less than 1m are available only for single-day requests." }, { "name": "format", "value": "", "type": "query", "description": "The format of the data when returned to the user." }, { "name": "start_date", "value": "", "type": "query", "description": "The start date (inclusive)." }, { "name": "end_date", "value": "", "type": "query", "description": "The end date (inclusive)." } ] }, "docs": "- Retrieves historical indices price reports. [Exchanges](/Articles/Data-And-Requests/The-SIPs.html) typically generate a price report every second for popular indices like SPX.\n- When the ``interval`` parameter is specified, the returned data represents the price at the exact time of each timestamp. If the timestamp in the response is 10:30:00, the price field represents the price at that exact time of the day.\n- A price update from the exchange is omitted if the price remained the same from th" }, { "info": { "name": "End of Day", "type": "http" }, "http": { "method": "GET", "url": "http://127.0.0.1:25503/v3/interest_rate/history/eod", "params": [ { "name": "symbol", "value": "", "type": "query", "description": "The stock or index symbol, or underlying symbol for options." }, { "name": "start_date", "value": "", "type": "query", "description": "The start date (inclusive)." }, { "name": "end_date", "value": "", "type": "query", "description": "The end date (inclusive)." }, { "name": "format", "value": "", "type": "query", "description": "The format of the data when returned to the user." } ] }, "docs": "- Returns the interest rate reported. Depending on the rate, reports can occur in the morning or the afternoon.\n" } ] } ], "bundled": true }