book
Checkout our new book! Hands on AI Trading with Python, QuantConnect, and AWS Learn More arrow

QuantConnect

US Future Universe

Introduction

The US Future Universe dataset by QuantConnect lists the available US Future contracts. The data covers the 162 most liquid contracts, starts in May 2009, and is delivered on daily frequency. This dataset is created by monitoring the trading activity on the CFE, CBOT, CME, COMEX, NYMEX, and ICE*.

This dataset does not contain market data. For market data, see US Futures by AlgoSeek.

*See Data Summary.

For more information about the US Future Universe dataset, including CLI commands and pricing, see the dataset listing.

About the Provider

QuantConnect was founded in 2012 to serve quants everywhere with the best possible algorithmic trading technology. Seeking to disrupt a notoriously closed-source industry, QuantConnect takes a radically open-source approach to algorithmic trading. Through the QuantConnect web platform, more than 50,000 quants are served every month.

Getting Started

The following snippet demonstrates how to request data from the US Future Universe dataset:

Select Language: 
future = self.add_future(Futures.Metals.GOLD)
future.set_filter(0, 90)

Data Summary

The following table describes the dataset properties:

PropertyValue
Start DateMay 2009
Asset Coverage162 Futures
Data DensityDense
ResolutionDaily
Timezone
  • Chicago (CFE, CME or CBOT)
  • New York (ICE, NYMEX or COMEX)
Market HoursRegular and Extended

This dataset only includes Sugar (SB) from the ICE exchange.

Example Applications

The US Future Universe dataset enables you to accurately design Futures strategies. Examples include the following strategies:

  • Buying the Futures contract with the most open interest to reduce slippage and market impact
  • Trading bull calendar spreads to reduce volatility and margin requirements
  • Trading bull calendar spreads to speculate contango
p>For more example algorithms, see Examples.

Data Point Attributes

The US Future Universe dataset provides FutureFilterUniverse, and FuturesChain objects.

FutureFilterUniverse Attributes

FutureFilterUniverse objects have the following attributes:

FutureFilterUniverse Select Language:
    The local exchange current time
  • local_time: DateTime

FuturesChain Attributes

FuturesChain objects have the following attributes:

FuturesChain Select Language:
    Gets the most recent trade information for the underlying. This may be a QuantConnect.Data.Market.Tick or a QuantConnect.Data.Market.TradeBar
  • underlying: BaseData
    • Gets all ticks for every futures contract in this chain, keyed by symbol
  • ticks: Ticks
    • Gets all trade bars for every futures contract in this chain, keyed by symbol
  • trade_bars: TradeBars
    • Gets all quote bars for every futures contract in this chain, keyed by symbol
  • quote_bars: QuoteBars
    • Gets all contracts in the chain, keyed by symbol
  • contracts: FuturesContracts
    • Gets the set of symbols that passed the QuantConnect.Securities.Future.Future.ContractFilter
  • filtered_contracts: HashSet<Symbol>
    • Market Data Type of this data - does it come in individual price packets or is it grouped into OHLC.
  • data_type: MarketDataType
    • True if this is a fill forward piece of data
  • is_fill_forward: bool
    • Current time marker of this data packet.
  • time: DateTime
    • The end time of this data. Some data covers spans (trade bars) and as such we want to know the entire time span covered
  • end_time: DateTime
    • Symbol representation for underlying Security
  • symbol: Symbol
    • Value representation of this data packet. All data requires a representative value for this moment in time. For streams of data this is the price now, for OHLC packets this is the closing price.
  • value: decimal
    • As this is a backtesting platform we'll provide an alias of value as price.
  • price: decimal

Supported Assets

The following list shows the available (162) Futures:

  • Futures.Currencies.AUD: Australian Dollar Futures (CME: 6A)
  • Futures.Currencies.AUDCAD: Australian Dollar/Canadian Dollar Futures (CME: ACD)
  • Futures.Currencies.AUDJPY: Australian Dollar/Japanese Yen Futures (CME: AJY)
  • Futures.Currencies.AUDNZD: Australian Dollar/New Zealand Dollar Futures (CME: ANE)
  • Futures.Currencies.BRL: Brazillian Real Futures (CME: 6L)
  • Futures.Currencies.BTC: Bitcoin Futures (CME: BTC)
  • Futures.Currencies.CAD: Canadian Dollar Futures (CME: 6C)
  • Futures.Currencies.CADJPY: Canadian Dollar/Japanese Yen Futures (CME: CJY)
  • Futures.Currencies.CHF: Swiss Franc Futures (CME: 6S)
  • Futures.Currencies.ETH: Ether Futures (CME: ETH)
  • Futures.Currencies.EUR: Euro FX Futures (CME: 6E)
  • Futures.Currencies.EURAUD: Euro/Australian Dollar Futures (CME: EAD)
  • Futures.Currencies.EURCAD: Euro/Canadian Dollar Futures (CME: ECD)
  • Futures.Currencies.EURO_FX_EMINI: E-mini Euro FX Futures (CME: E7)
  • Futures.Currencies.EURSEK: Euro/Swedish Krona Futures (CME: ESK)
  • Futures.Currencies.GBP: British Pound Futures (CME: 6B)
  • Futures.Currencies.JAPANESE_YEN_EMINI: E-mini Japanese Yen Futures (CME: J7)
  • Futures.Currencies.JPY: Japanese Yen Futures (CME: 6J)
  • Futures.Currencies.MICRO_AUD: Micro AUD/USD Futures (CME: M6A)
  • Futures.Currencies.MICRO_BTC: Micro Bitcoin Futures (CME: MBT)
  • Futures.Currencies.MICRO_CAD: Micro USD/CAD Futures (CME: M6C)
  • Futures.Currencies.MICRO_CADUSD: Micro CAD/USD Futures (CME: MCD)
  • Futures.Currencies.MICRO_CHF: Micro CHF/USD Futures (CME: MSF)
  • Futures.Currencies.MICRO_ETHER: Micro Ether Futures (CME: MET)
  • Futures.Currencies.MICRO_EUR: Micro EUR/USD Futures (CME: M6E)
  • Futures.Currencies.MICRO_GBP: Micro GBP/USD Futures (CME: M6B)
  • Futures.Currencies.MICRO_INRUSD: Micro INR/USD Futures (CME: MIR)
  • Futures.Currencies.MICRO_JPY: Micro JPY/USD Futures (CME: MJY)
  • Futures.Currencies.MICRO_USDCHF: Micro USD/CHF Futures (CME: M6S)
  • Futures.Currencies.MICRO_USDCNH: Micro USD/CNH Futures (CME: MNH)
  • Futures.Currencies.MICRO_USDJPY: Micro USD/JPY Futures (CME: M6J)
  • Futures.Currencies.MXN: Mexican Peso Futures (CME: 6M)
  • Futures.Currencies.NZD: New Zealand Dollar Futures (CME: 6N)
  • Futures.Currencies.RUB: Russian Ruble Futures (CME: 6R)
  • Futures.Currencies.STANDARD_SIZE_USD_OFFSHORE_RMBCNH: Standard-Size USD/Offshore RMB (CNH) Futures (CME: CNH)
  • Futures.Currencies.ZAR: South African Rand Futures (CME: 6Z)
  • Futures.Dairy.CASH_SETTLED_BUTTER: Cash-settled Butter Futures (CME: CB)
  • Futures.Dairy.CASH_SETTLED_CHEESE: Cash-settled Cheese Futures (CME: CSC)
  • Futures.Dairy.CLASS_III_MILK: Class III Milk Futures (CME: DC)
  • Futures.Dairy.CLASS_IV_MILK: Class IV Milk Futures (CME: GDK)
  • Futures.Dairy.DRY_WHEY: Dry Whey Futures (CME: DY)
  • Futures.Dairy.NONFAT_DRY_MILK: Non-fat Dry Milk Futures (CME: GNF)
  • Futures.Energy.ARGUS_LL_SVS_WTI_ARGUS_TRADE_MONTH: Argus LLS vs. WTI (Argus) Trade Month Futures (NYMEX: AE5)
  • Futures.Energy.ARGUS_PROPANE_FAR_EAST_INDEX: Argus Propane Far East Index Futures (NYMEX: A7E)
  • Futures.Energy.ARGUS_PROPANE_SAUDI_ARAMCO: Argus Propane (Saudi Aramco) Futures (NYMEX: A9N)
  • Futures.Energy.BRENT_CRUDE_OIL_VS_DUBAI_CRUDE_OIL_PLATTS: Brent Crude Oil vs. Dubai Crude Oil (Platts) Futures (NYMEX: ADB)
  • Futures.Energy.BRENT_LAST_DAY_FINANCIAL: Brent Last Day Financial Futures (NYMEX: BZ)
  • Futures.Energy.CHICAGO_ETHANOL_PLATTS: Chicago Ethaanol (Platts) Futures (NYMEX: CU)
  • Futures.Energy.CLEARBROOK_BAKKEN_SWEET_CRUDE_OIL_MONTHLY_INDEX_NET_ENERGY: Clearbrook Bakken Sweet Crude Oil Monthly Index (Net Energy) Futures (NYMEX: CSW)
  • Futures.Energy.CONWAY_PROPANE_OPIS: Conway Propane (OPIS) Futures (NYMEX: A8K)
  • Futures.Energy.CRUDE_OIL_WTI: Crude Oil WTI Futures (NYMEX: CL)
  • Futures.Energy.DUBAI_CRUDE_OIL_PLATTS_FINANCIAL: Dubai Crude Oil (Platts) Financial Futures (NYMEX: DCB)
  • Futures.Energy.EAST_WEST_GASOLINE_SPREAD_PLATTS_ARGUS: East-West Gasoline Spread (Platts-Argus) Futures (NYMEX: EWG)
  • Futures.Energy.EAST_WEST_NAPHTHA_JAPAN_C_FVS_CARGOES_CIFNWE_SPREAD_PLATTS: East-West Naphtha: Japan C&F vs. Cargoes CIF NWE Spread (Platts) Futures (NYMEX: EWN)
  • Futures.Energy.ETHANOL: Ethanol Futures (CBOT: EH)
  • Futures.Energy.ETHANOL_T_2_FOB_RDAM_INCLUDING_DUTY_PLATTS: Ethanol T2 FOB Rdam Including Duty (Platts) Futures (NYMEX: AZ1)
  • Futures.Energy.EUROPEAN_NAPHTHA_PLATTS_CRACK_SPREAD: European Naphtha (Platts) Crack Spread Futures (NYMEX: EN)
  • Futures.Energy.EUROPEAN_PROPANE_CIFARA_ARGUS: European Propane CIF ARA (Argus) Futures (NYMEX: APS)
  • Futures.Energy.EUROPEAN_PROPANE_CIFARA_ARGUS_VS_NAPHTHA_CARGOES_CIFNWE_PLATTS: European Propane CIF ARA (Argus) vs. Naphtha Cargoes CIF NWE (Platts) Futures (NYMEX: EPN)
  • Futures.Energy.FREIGHT_ROUTE_TC_14_BALTIC: Freight Route TC14 (Baltic) Futures (NYMEX: FRC)
  • Futures.Energy.GASOLINE: Gasoline RBOB Futures (NYMEX: RB)
  • Futures.Energy.GASOLINE_EUROBOB_OXY_NWE_BARGES_ARGUS: Gasoline Euro-bob Oxy NWE Barges (Argus) Futures (NYMEX: B7H)
  • Futures.Energy.GROUP_THREE_SUBOCTANE_GASOLINE_PLATTS_VS_RBOB: Group Three Sub-octane Gasoliine (Platts) vs. RBOB Futures (NYMEX: AA8)
  • Futures.Energy.GROUP_THREE_ULSD_PLATTS_VS_NY_HARBOR_ULSD: Group Three ULSD (Platts) vs. NY Harbor ULSD Futures (NYMEX: AA6)
  • Futures.Energy.GULF_COAST_CBOB_GASOLINE_A_2_PLATTS_VS_RBOB_GASOLINE: Gulf Coast CBOB Gasoline A2 (Platts) vs. RBOB Gasoline Futures (NYMEX: CRB)
  • Futures.Energy.GULF_COAST_HSFO_PLATTS_VS_EUROPEAN_THREE_POINT_FIVE_PERCENT_FUEL_OIL_BARGES_FOB_RDAM_PLATTS: Gulf Coast HSFO (Platts) vs. European 3.5% Fuel Oil Barges FOB Rdam (Platts) Futures (NYMEX: GCU)
  • Futures.Energy.HEATING_OIL: Heating Oil Futures (NYMEX: HO)
  • Futures.Energy.LOS_ANGELES_CARBOB_GASOLINE_OPI_SVS_RBOB_GASOLINE: Los Angeles CARBOB Gasoline (OPIS) vs. RBOB Gasoline Futures (NYMEX: AJL)
  • Futures.Energy.LOS_ANGELES_CARB_DIESEL_OPI_SVS_NY_HARBOR_ULSD: Los Angeles CARB Diesel (OPIS) vs. NY Harbor ULSD Futures (NYMEX: AKL)
  • Futures.Energy.LOS_ANGELES_JET_OPI_SVS_NY_HARBOR_ULSD: Los Angeles Jet (OPIS) vs. NY Harbor ULSD Futures (NYMEX: AJS)
  • Futures.Energy.MARS_ARGUS_VS_WTI_FINANCIAL: Mars (Argus) vs. WTI Financial Futures (NYMEX: AYX)
  • Futures.Energy.MARS_ARGUS_VS_WTI_TRADE_MONTH: Mars (Argus) vs. WTI Trade Month Futures (NYMEX: AYV)
  • Futures.Energy.MICRO_CRUDE_OIL_WTI: Micro WTI Crude Oil Futures (NYMEX: MCL)
  • Futures.Energy.MICRO_EUROPEAN_FOB_RDAM_MARINE_FUEL_ZERO_POINT_FIVE_PERCENT_BARGES_PLATTS: Micro European FOB Rdam Marine Fuel 0.5% Barges (Platts) Futures (NYMEX: R5O)
  • Futures.Energy.MICRO_EUROPEAN_THREE_POINT_FIVE_PERCENT_OIL_BARGES_FOB_RDAM_PLATTS: Micro European 3.5% Fuel Oil Barges FOB Rdam (Platts) Futures (NYMEX: MEF)
  • Futures.Energy.MICRO_GASOIL_ZERO_POINT_ONE_PERCENT_BARGES_FOBARA_PLATTS: Micro Gasoil 0.1% Barges FOB ARA (Platts) Futures (NYMEX: M1B)
  • Futures.Energy.MICRO_SINGAPORE_FOB_MARINE_FUEL_ZERO_POINT_FIVE_PERCET_PLATTS: Micro Singapore FOB Marine Fuel 0.5% (Platts) Futures (NYMEX: S5O)
  • Futures.Energy.MICRO_SINGAPORE_FUEL_OIL_380_CST_PLATTS: Micro Singapore Fuel Oil 380CST (Platts) Futures (NYMEX: MAF)
  • Futures.Energy.MINI_EUROPEAN_THREE_POINT_PERCENT_FIVE_FUEL_OIL_BARGES_PLATTS: Mini European 3.5% Fuel Oil Barges FOB Rdam (Platts) Futures (NYMEX: A0D)
  • Futures.Energy.MINI_SINGAPORE_FUEL_OIL_180_CST_PLATTS: Mini Singapore Fuel Oil 180 cst (Platts) Futures (NYMEX: A0F)
  • Futures.Energy.MONT_BELVIEU_ETHANE_OPIS: Mont Belvieu Ethane (OPIS) Futures (NYMEX: AC0)
  • Futures.Energy.MONT_BELVIEU_LDH_PROPANE_OPIS: Mont Belvieu LDH Propane (OPIS) Futures (NYMEX: B0)
  • Futures.Energy.MONT_BELVIEU_NATURAL_GASOLINE_OPIS: Mont Belvieu Natural Gasoline (OPIS) Futures (NYMEX: A7Q)
  • Futures.Energy.MONT_BELVIEU_NORMAL_BUTANE_OPIS: Mont Belvieu Normal Butane (OPIS) Futures (NYMEX: AD0)
  • Futures.Energy.NATURAL_GAS: Natural Gas Futures (NYMEX: NG)
  • Futures.Energy.NATURAL_GAS_HENRY_HUB_LAST_DAY_FINANCIAL: Natural Gas (Henry Hub) Last-day Financial Futures (NYMEX: HH)
  • Futures.Energy.NATURAL_GAS_HENRY_HUB_PENULTIMATE_FINANCIAL: Natural Gas (Henry Hub) Penultimate Financial Futures (NYMEX: HP)
  • Futures.Energy.ONE_PERCENT_FUEL_OIL_CARGOES_FOBNWE_PLATTS_VS_THREE_POINT_FIVE_PERCENT_FUEL_OIL_BARGES_FOB_RDAM_PLATTS: 1% Fuel Oil Cargoes FOB NWE (Platts) vs. 3.5% Fuel Oil Barges FOB Rdam (Platts) Futures (NYMEX: FSS)
  • Futures.Energy.PREMIUM_UNLEADED_GASOLINE_10_PPM_FOBMED_PLATTS: Premium Unleaded Gasoline 10 ppm FOB MED (Platts) Futures (NYMEX: A3G)
  • Futures.Energy.PROPANE_NON_LDH_MONT_BELVIEU_OPIS: Propane Non-LDH Mont Belvieu (OPIS) Futures (NYMEX: A1R)
  • Futures.Energy.RBOB_GASOLINE_CRACK_SPREAD: RBOB Gasoline Crack Spread Futures (NYMEX: ARE)
  • Futures.Energy.RBOB_GASOLINE_VS_EUROBOB_OXY_NWE_BARGES_ARGUS_THREE_HUNDRED_FIFTY_THOUSAND_GALLONS: RBOB Gasoline vs. Euro-bob Oxy NWE Barges (Argus) (350,000 gallons) Futures (NYMEX: EXR)
  • Futures.Energy.SINGAPORE_FUEL_OIL_380_CST_PLATTS_VS_EUROPEAN_THREE_POINT_FIVE_PERCENT_FUEL_OIL_BARGES_FOB_RDAM_PLATTS: Singapore Fuel Oil 380 cst (Platts) vs. European 3.5% Fuel Oil Barges FOB Rdam (Platts) Futures (NYMEX: EVC)
  • Futures.Energy.SINGAPORE_GASOIL_PLATTS_VS_LOW_SULPHUR_GASOIL_FUTURES: Singapore Gasoil (Platts) vs. Low Sulphur Gasoil Futures (NYMEX: AGA)
  • Futures.Energy.SINGAPORE_MOGAS_92_UNLEADED_PLATTS_BRENT_CRACK_SPREAD: Singapore Mogas 92 Unleaded (Platts) Brent Crack Spread Futures (NYMEX: D1N)
  • Futures.Energy.THREE_POINT_FIVE_PERCENT_FUEL_OIL_BARGES_FOB_RDAM_PLATTS_CRACK_SPREAD: 3.5% Fuel Oil Barges FOB Rdam (Platts) Crack Spread Futures (NYMEX: FO)
  • Futures.Energy.THREE_POINT_FIVE_PERCENT_FUEL_OIL_BARGES_FOB_RDAM_PLATTS_CRACK_SPREAD_1000_MT: 3.5% Fuel Oil Barges FOB Rdam (Platts) Crack Spread (1000mt) Futures (NYMEX: BOO)
  • Futures.Energy.WTI_BRENT_FINANCIAL: WTI-Brent Financial Futures (NYMEX: BK)
  • Futures.Energy.WTI_FINANCIAL: WTI Financial Futures (NYMEX: CSX)
  • Futures.Energy.WTI_HOUSTON_ARGUS_VS_WTI_TRADE_MONTH: WTI Houston (Argus) vs. WTI Trade Month Futures (NYMEX: HTT)
  • Futures.Energy.WTI_HOUSTON_CRUDE_OIL: WTI Houston Crude Oil Futures (NYMEX: HCL)
  • Futures.Financials.EURO_DOLLAR: EuroDollar Futures (CME: GE)
  • Futures.Financials.FIVE_YEAR_USDMAC_SWAP: 5-Year USD MAC Swap Futures (CBOT: F1U)
  • Futures.Financials.MICRO_Y_10_TREASURY_NOTE: Micro 10-Year Yield Futures (CBOT: 10Y)
  • Futures.Financials.MICRO_Y_2_TREASURY_BOND: Micro 2-Year Yield Futures (CBOT: 2YY)
  • Futures.Financials.MICRO_Y_30_TREASURY_BOND: Micro 30-Year Yield Futures (CBOT: 30Y)
  • Futures.Financials.MICRO_Y_5_TREASURY_BOND: Micro 5-Year Yield Futures (CBOT: 5YY)
  • Futures.Financials.ULTRA_TEN_YEAR_US_TREASURY_NOTE: Ultra 10-Year U.S. Treasury Note Futures (CBOT: TN)
  • Futures.Financials.ULTRA_US_TREASURY_BOND: Ultra U.S. Treasury Bond Futures (CBOT: UB)
  • Futures.Financials.Y_10_TREASURY_NOTE: 10Y U.S. Treasury Note Futures (CBOT: ZN)
  • Futures.Financials.Y_2_TREASURY_NOTE: 2Y U.S. Treasury Note Futures (CBOT: ZT)
  • Futures.Financials.Y_30_TREASURY_BOND: 30Y U.S. Treasury Bond Futures (CBOT: ZB)
  • Futures.Financials.Y_5_TREASURY_NOTE: 5Y U.S. Treasury Note Futures (CBOT: ZF)
  • Futures.Forestry.LUMBER: Lumber Futures (CME: LBR)
  • Futures.Forestry.RANDOM_LENGTH_LUMBER: Random Length Lumber Futures (CME: LBS)
  • Futures.Grains.BLACK_SEA_CORN_FINANCIALLY_SETTLED_PLATTS: Black Sea Corn Financially Settled (Platts) Futures (CBOT: BCF)
  • Futures.Grains.BLACK_SEA_WHEAT_FINANCIALLY_SETTLED_PLATTS: Black Sea Wheat Financially Settled (Platts) Futures (CBOT: BWF)
  • Futures.Grains.CORN: Corn Futures (CBOT: ZC)
  • Futures.Grains.HRW_WHEAT: KC HRW Wheat Futures (CBOT: KE)
  • Futures.Grains.OATS: Oats Futures (CBOT: ZO)
  • Futures.Grains.SOYBEANS: Soybeans Futures (CBOT: ZS)
  • Futures.Grains.SOYBEAN_MEAL: Soybean Meal Futures (CBOT: ZM)
  • Futures.Grains.SOYBEAN_OIL: Soybean Oil Futures (CBOT: ZL)
  • Futures.Grains.WHEAT: Default wheat contract is SRWWheat (CBOT: ZW)
  • Futures.Indices.BLOOMBERG_COMMODITY_INDEX: Bloomberg Commodity Index Futures (CBOT: AW)
  • Futures.Indices.DOW_30_E_MINI: E-mini Dow Indu 30 Futures (CBOT: YM)
  • Futures.Indices.DOW_JONES_REAL_ESTATE: (CME: RX)
  • Futures.Indices.FTSE_EMERGING_EMINI: E-mini FTSE Emerging Index Futures (CME: EI)
  • Futures.Indices.MICRO_DOW_30_E_MINI: Micro E-mini Dow Jones Industrial Average Index Futures (CBOT: MYM)
  • Futures.Indices.MICRO_NASDAQ_100_E_MINI: Micro E-mini Nasdaq-100 Index Futures (CME: MNQ)
  • Futures.Indices.MICRO_RUSSELL_2000_E_MINI: Micro E-mini Russell 2000 Index Futures (CME: M2K)
  • Futures.Indices.MICRO_SP_500_E_MINI: Micro E-mini S&P 500 Index Futures (CME: MES)
  • Futures.Indices.NASDAQ_100_BIOTECHNOLOGY_E_MINI: E-mini Nasdaq-100 Biotechnology Index Futures (CME: BIO)
  • Futures.Indices.NASDAQ_100_E_MINI: E-mini NASDAQ 100 Futures (CME: NQ)
  • Futures.Indices.NIKKEI_225_DOLLAR: Nikkei-225 Dollar Futures (CME: NKD)
  • Futures.Indices.NIKKEI_225_YEN_CME: Nikkei-225 Yen denominated Futures on CME (CME: NIY)
  • Futures.Indices.RUSSELL_1000_E_MINI: (CME: RS1)
  • Futures.Indices.RUSSELL_2000_E_MINI: E-mini Russell 2000 Futures (CME: RTY)
  • Futures.Indices.SPGSCI_COMMODITY: S&P-GSCI Commodity Index Futures (CME: GD)
  • Futures.Indices.SP_400_MID_CAP_EMINI: E-mini S&P MidCap 400 Futures (CME: EMD)
  • Futures.Indices.SP_500_ANNUAL_DIVIDEND_INDEX: (CME: SDA)
  • Futures.Indices.SP_500_E_MINI: E-mini S&P 500 Futures (CME: ES)
  • Futures.Indices.TOPIXYEN: (CME: TPY)
  • Futures.Indices.USD_DENOMINATED_IBOVESPA: USD-Denominated Ibovespa Index Futures (CME: IBV)
  • Futures.Indices.VIX: CBOE Volatility Index Futures (CFE: VX)
  • Futures.Meats.FEEDER_CATTLE: Feeder Cattle Futures (CME: GF)
  • Futures.Meats.LEAN_HOGS: Lean Hogs Futures (CME: HE)
  • Futures.Meats.LIVE_CATTLE: Live Cattle Futures (CME: LE)
  • Futures.Metals.ALUMINIUM_EUROPEAN_PREMIUM_DUTY_PAID_METAL_BULLETIN: Aluminium European Premium Duty-Paid (Metal Bulletin) Futures (COMEX: EDP)
  • Futures.Metals.ALUMINUM_MWUS_TRANSACTION_PREMIUM_PLATTS_25_MT: Aluminum MW U.S. Transaction Premium Platts (25MT) Futures (COMEX: AUP)
  • Futures.Metals.COPPER: Copper Futures (COMEX: HG)
  • Futures.Metals.GOLD: Gold Futures (COMEX: GC)
  • Futures.Metals.MICRO_GOLD: Micro Gold Futures (COMEX: MGC)
  • Futures.Metals.MICRO_GOLD_TAS: Micro Gold TAS Futures (COMEX: MGT)
  • Futures.Metals.MICRO_PALLADIUM: Micro Palladium Futures (NYMEX: PAM)
  • Futures.Metals.MICRO_SILVER: Micro Silver Futures (COMEX: SIL)
  • Futures.Metals.PALLADIUM: Palladium Futures (NYMEX: PA)
  • Futures.Metals.PLATINUM: Platinum Futures (NYMEX: PL)
  • Futures.Metals.SILVER: Silver Futures (COMEX: SI)
  • Futures.Metals.US_MIDWEST_DOMESTIC_HOT_ROLLED_COIL_STEEL_CRU_INDEX: U.S. Midwest Domestic Hot-Rolled Coil Steel (CRU) Index Futures (NYMEX: HRC)
  • Futures.Softs.SUGAR_11: Sugar #11 Futures ICE (ICE: SB)
  • Futures.Softs.SUGAR_11_CME: Sugar #11 Futures CME (NYMEX: YO)

Requesting Data

To add US Future Universe data to your algorithm, call the add_future method. To define which contracts should be in your universe, specify the filter when requesting the Future data.

The add_future method provides a daily stream of Future chain data. To get the most recent daily chain, call the future_chains method with the underlying Future Symbol in the Slice object received in the on_data event handler.

Select Language: 
class USFutureDataAlgorithm(QCAlgorithm):

    def initialize(self) -> None:
        self.set_start_date(2020, 6, 1)
        self.set_end_date(2021, 6, 1)
        self.set_cash(100000)
        self.universe_settings.asynchronous = True
        
        # Request the Future data and add a filter for universe selection.
        self.future = self.add_future(Futures.Metals.GOLD, Resolution.MINUTE)
        self.future.set_filter(lambda universe: universe.standards_only().front_month())

    def on_data(self, slice: Slice) -> None:
        chain = slice.future_chains.get(self.future.symbol)

For more information about creating US Future Universes, see Futures.

Accessing Data

For information about accessing US Future Universe data, see Futures.

Historical Data

You can get historical US Future Universe data in an algorithm and the Research Environment.

Historical Data In Algorithms

To get historical US Future Universe data in an algorithm, call the history method with the list Future contract Symbol objects. You may obtain all available Future contracts on a date by calling the futures_chain method. Note that this method will return all available contracts despite your previous filter. If there is no data for the period you requested, the history result is empty.

Select Language: 
# Subscribe to the underlying Future and save a reference to the Symbol.
symbol = self.add_future(Futures.Metals.GOLD).symbol
# Get the contracts available on this day.
contracts = [x.symbol for x in self.futures_chain(symbol)]

# Request the historical data to obtain the data.
# DataFrame objects
history_df = self.history(contracts, 10, Resolution.DAILY, flatten=True)
open_interest = self.history(OpenInterest, contracts, 10, Resolution.DAILY, flatten=True)

# Open Interest objects
open_interest = self.history[OpenInterest](contracts, 10, Resolution.DAILY)

For more information about historical data in algorithms, see History Requests.

Historical Data In Research

To get historical US Future Universe data in the Research Environment for an entire Futures chain, call the future_history method with the canonical Future Symbol.

Select Language: 
qb = QuantBook()
future = qb.add_future(Futures.Metals.GOLD) 
future.set_filter(0, 90)
history = qb.future_history(future.symbol, datetime(2020, 6, 1), datetime(2020, 6, 5), Resolution.DAILY)
history_df = history.data_frame
all_history = history.get_all_data()
expiries = history.get_expiry_dates()

You can also do similar in the research environment like in the algorithm to obtain the price and open interest data.

Select Language: 
qb = QuantBook()
end = datetime(2020, 6, 5)
qb.set_start_date(end)
symbol = qb.add_future(Futures.Metals.GOLD).symbol
# Get the contracts available on this day.
contracts = [x.symbol for x in qb.futures_chain(symbol)]

# Request the historical data to obtain the data.
history_df = qb.history(contracts, datetime(2020, 6, 1), end, Resolution.DAILY, flatten=True)
open_interest = qb.history(OpenInterest, contracts, datetime(2020, 6, 1), end, Resolution.DAILY, flatten=True)
For more information about historical data in the Research Environment, see Futures.

Example Applications

The US Future Universe dataset enables you to accurately design Futures strategies. Examples include the following strategies:

  • Buying the Futures contract with the most open interest to reduce slippage and market impact
  • Trading bull calendar spreads to reduce volatility and margin requirements
  • Trading bull calendar spreads to speculate contango
p>For more example algorithms, see Examples.

You can also see our Videos. You can also get in touch with us via Discord.

Did you find this page helpful?

Contribute to the documentation: