AlgoSeek

US Futures

Introduction

The US Futures dataset by AlgoSeek provides Futures data, including price, volume, open interest, and expiry. The data covers the 75 most liquid contracts, starts in May 2009, and is delivered on any frequency from tick to daily. This dataset is created by monitoring the trading activity on the CFE, CBOT, NYMEX, ICE*, SGX, India, and COMEX markets.

This dataset does not include ICE Futures, except for Sugar until July 2021.

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

About the Provider

AlgoSeek is a leading historical intraday US market data provider offering the most comprehensive and detailed market data and analytics products in the financial industry covering equities, futures, options, cash forex, and cryptocurrencies. AlgoSeek data is built for quantitative trading and machine learning. For more information about AlgoSeek, visit algoseek.com.

Getting Started

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

from QuantConnect.DataSource import *

future = self.add_future(Futures.metals.gold)
future.set_filter(0, 90)
using QuantConnect.DataSource;

var future = AddFuture(Futures.Metals.Gold);
future.SetFilter(0, 90);

Data Summary

The following table describes the dataset properties:

PropertyValue
Start DateMay 2009
Asset Coverage75 Futures
Data DensityDense
ResolutionTick, Second, Minute, Hour, & Daily
Timezone
  • Chicago (CME or CBOT)
  • New York (NYMEX or COMEX)
  • Singapore time (SGX)
  • Indian Standard Time (India)
Market HoursRegular and Extended

This dataset includes Sugar ICE Futures until July 2021.

Volume Discrepancies

The volume of the daily trade bars from this dataset is different from the daily volume that CME and other platforms like Yahoo Finance report because the CME includes pit trades in their daily volume calculation. In contrast, the volume of the daily trade bars in this dataset (from AlgoSeek) doesn't include pit trades because pit trades are over-the-counter, which algorithms can't trade.

Another discrepancy occurs from the start and end times of the daily bars. Daily bars from the CME and Yahoo Finance span from 5 PM Central Time (CT) to 4 PM CT on the following day. In contrast, QuantConnect consolidates daily bars from from 12 AM CT to 12 AM CT the following day. Therefore, to calculate the daily volume in the same way that CME does (excluding the pit trades), sum the volume of intraday bars that span 5 PM CT to 4 PM CT on the following day.

Example Applications

The US Futures 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

Data Point Attributes

The US Futures dataset provides FuturesChain, Future, and OpenInterest objects. To configure the continuous Future settings, use the DataNormalizationMode and DataMappingMode enumerations.

DataNormalizationMode Values

The DataNormalizationMode enumeration has the following values:

DataMappingMode Values

The DataMappingMode enumeration has the following values:

Future Attributes

Future objects have the following attributes:

FuturesChain Attributes

FuturesChain objects have the following attributes:

OpenInterest Attributes

OpenInterest objects have the following attributes:

Supported Assets

The following table shows the available Futures:

Name
SymbolMarketAccessor Code
Australian Dollar Futures
6ACMEFutures.Currencies.AUD
British Pound Futures
6BCMEFutures.Currencies.GBP
Canadian Dollar Futures
6CCMEFutures.Currencies.CAD
Euro FX Futures
6ECMEFutures.Currencies.EUR
Japanese Yen Futures
6JCMEFutures.Currencies.JPY
Brazilian Real Futures
6LCMEFutures.Currencies.BRL
Mexican Peso Futures
6MCMEFutures.Currencies.MXN
New Zealand Dollar Futures
6NCMEFutures.Currencies.NZD
Russian Ruble Futures
6RCMEFutures.Currencies.RUB
Swiss Franc Futures
6SCMEFutures.Currencies.CHF
South African Rand Futures
6ZCMEFutures.Currencies.ZAR
Australian Dollar/Canadian Dollar Futures
ACDCMEFutures.Currencies.AUDCAD
Australian Dollar/Japanese Yen Futures
AJYCMEFutures.Currencies.AUDJPY
Australian Dollar/New Zealand Dollar Futures
ANECMEFutures.Currencies.AUDNZD
Bitcoin Futures
BTCCMEFutures.Currencies.BTC
Canadian Dollar/Japanese Yen Futures
CJYCMEFutures.Currencies.CADJPY
Standard-Size USD/Offshore RMB (CNH) Futures
CNHCMEFutures.Currencies.StandardSizeUSDOffshoreRMBCNH
US Dollar Index Futures
DXICEFutures.Currencies.USD
E-mini Euro FX Futures
E7CMEFutures.Currencies.EuroFXEmini
Euro/Australian Dollar Futures
EADCMEFutures.Currencies.EURAUD
Euro/Canadian Dollar Futures
ECDCMEFutures.Currencies.EURCAD
Euro/Swedish Krona Futures
ESKCMEFutures.Currencies.EURSEK
Ether Futures
ETHCMEFutures.Currencies.ETH
E-mini Japanese Yen Futures
J7CMEFutures.Currencies.JapaneseYenEmini
Micro Australian Dollar/U.S. Dollar (AUD/USD) Futures
M6ACMEFutures.Currencies.MicroAUD
Micro British Pound Sterling/U.S. Dollar (GBP/USD) Futures
M6BCMEFutures.Currencies.MicroGBP
Micro USD/CAD Futures
M6CCMEFutures.Currencies.MicroCAD
Micro Euro/U.S. Dollar (EUR/USD) Futures
M6ECMEFutures.Currencies.MicroEUR
Micro USD/JPY Futures
M6JCMEFutures.Currencies.MicroUSDJPY
Micro USD/CHF Futures
M6SCMEFutures.Currencies.MicroUSDCHF
Micro Bitcoin Futures
MBTCMEFutures.Currencies.MicroBTC
Micro Canadian Dollar/U.S.Dollar(CAD/USD) Futures
MCDCMEFutures.Currencies.MicroCADUSD
Micro Ether Futures
METCMEFutures.Currencies.MicroEther
Micro INR/USD Futures
MIRCMEFutures.Currencies.MicroINRUSD
Micro Japanese Yen/U.S. Dollar (JPY/USD) Futures
MJYCMEFutures.Currencies.MicroJPY
Micro USD/CNH Futures
MNHCMEFutures.Currencies.MicroUSDCNH
Micro Swiss Franc/U.S. Dollar (CHF/USD) Futures
MSFCMEFutures.Currencies.MicroCHF
Cash-settled Butter Futures
CBCMEFutures.Dairy.CashSettledButter
Cash-Settled Cheese Futures
CSCCMEFutures.Dairy.CashSettledCheese
Class III Milk Futures
DCCMEFutures.Dairy.ClassIIIMilk
Dry Whey Futures
DYCMEFutures.Dairy.DryWhey
Class IV Milk Futures
GDKCMEFutures.Dairy.ClassIVMilk
Nonfat Dry Milk Futures
GNFCMEFutures.Dairy.NonfatDryMilk
Propane Non-LDH Mont Belvieu (OPIS) BALMO Futures
1SNYMEXFutures.Energies.PropaneNonLDHMontBelvieu
Argus Propane Far East Index BALMO Futures
22NYMEXFutures.Energies.ArgusPropaneFarEastIndexBALMO
Mini European 3.5% Fuel Oil Barges FOB Rdam (Platts) Futures
A0DNYMEXFutures.Energies.MiniEuropeanThreePointPercentFiveFuelOilBargesPlatts
Mini Singapore Fuel Oil 180 cst (Platts) Futures
A0FNYMEXFutures.Energies.MiniSingaporeFuelOil180CstPlatts
Gulf Coast ULSD (Platts) Up-Down BALMO Futures
A1LNYMEXFutures.Energies.GulfCoastULSDPlattsUpDownBALMO
Gulf Coast Jet (Platts) Up-Down BALMO Futures
A1MNYMEXFutures.Energies.GulfCoastJetPlattsUpDownBALMO
Propane Non-LDH Mont Belvieu (OPIS) Futures
A1RNYMEXFutures.Energies.PropaneNonLDHMontBelvieuOPIS
European Propane CIF ARA (Argus) BALMO Futures
A32NYMEXFutures.Energies.EuropeanPropaneCIFARAArgusBALMO
Premium Unleaded Gasoline 10 ppm FOB MED (Platts) Futures
A3GNYMEXFutures.Energies.PremiumUnleadedGasoline10ppmFOBMEDPlatts
Argus Propane Far East Index Futures
A7ENYMEXFutures.Energies.ArgusPropaneFarEastIndex
Gasoline Euro-bob Oxy NWE Barges (Argus) Crack Spread BALMO Futures
A7INYMEXFutures.Energies.GasolineEurobobOxyNWEBargesArgusCrackSpreadBALMO
Mont Belvieu Natural Gasoline (OPIS) Futures
A7QNYMEXFutures.Energies.MontBelvieuNaturalGasolineOPIS
Mont Belvieu Normal Butane (OPIS) BALMO Futures
A8JNYMEXFutures.Energies.MontBelvieuNormalButaneOPISBALMO
Conway Propane (OPIS) Futures
A8KNYMEXFutures.Energies.ConwayPropaneOPIS
Mont Belvieu LDH Propane (OPIS) BALMO Futures
A8ONYMEXFutures.Energies.MontBelvieuLDHPropaneOPISBALMO
Argus Propane Far East Index vs. European Propane CIF ARA (Argus) Futures
A91NYMEXFutures.Energies.ArgusPropaneFarEastIndexVsEuropeanPropaneCIFARAArgus
Argus Propane (Saudi Aramco) Futures
A9NNYMEXFutures.Energies.ArgusPropaneSaudiAramco
Group Three ULSD (Platts) vs. NY Harbor ULSD Futures
AA6NYMEXFutures.Energies.GroupThreeULSDPlattsVsNYHarborULSD
Group Three Sub-octane Gasoline (Platts) vs. RBOB Futures
AA8NYMEXFutures.Energies.GroupThreeSuboctaneGasolinePlattsVsRBOB
Singapore Fuel Oil 180 cst (Platts) BALMO Futures
ABSNYMEXFutures.Energies.SingaporeFuelOil180cstPlattsBALMO
Singapore Fuel Oil 380 cst (Platts) BALMO Futures
ABTNYMEXFutures.Energies.SingaporeFuelOil380cstPlattsBALMO
Mont Belvieu Ethane (OPIS) Futures
AC0NYMEXFutures.Energies.MontBelvieuEthaneOPIS
Mont Belvieu Normal Butane (OPIS) Futures
AD0NYMEXFutures.Energies.MontBelvieuNormalButaneOPIS
Brent Crude Oil vs. Dubai Crude Oil (Platts) Futures
ADBNYMEXFutures.Energies.BrentCrudeOilVsDubaiCrudeOilPlatts
Argus LLS vs. WTI (Argus) Trade Month Futures
AE5NYMEXFutures.Energies.ArgusLLSvsWTIArgusTradeMonth
Singapore Gasoil (Platts) vs. Low Sulphur Gasoil Futures
AGANYMEXFutures.Energies.SingaporeGasoilPlattsVsLowSulphurGasoilFutures
Los Angeles CARBOB Gasoline (OPIS) vs. RBOB Gasoline Futures
AJLNYMEXFutures.Energies.LosAngelesCARBOBGasolineOPISvsRBOBGasoline
Los Angeles Jet (OPIS) vs. NY Harbor ULSD Futures
AJSNYMEXFutures.Energies.LosAngelesJetOPISvsNYHarborULSD
Los Angeles CARB Diesel (OPIS) vs. NY Harbor ULSD Futures
AKLNYMEXFutures.Energies.LosAngelesCARBDieselOPISvsNYHarborULSD
European Naphtha (Platts) BALMO Futures
AKZNYMEXFutures.Energies.EuropeanNaphthaPlattsBALMO
European Propane CIF ARA (Argus) Futures
APSNYMEXFutures.Energies.EuropeanPropaneCIFARAArgus
Mont Belvieu Natural Gasoline (OPIS) BALMO Futures
AR0NYMEXFutures.Energies.MontBelvieuNaturalGasolineOPISBALMO
RBOB Gasoline Crack Spread Futures
ARENYMEXFutures.Energies.RBOBGasolineCrackSpread
Gulf Coast HSFO (Platts) BALMO Futures
AVZNYMEXFutures.Energies.GulfCoastHSFOPlattsBALMO
Mars (Argus) vs. WTI Trade Month Futures
AYVNYMEXFutures.Energies.MarsArgusVsWTITradeMonth
Mars (Argus) vs. WTI Financial Futures
AYXNYMEXFutures.Energies.MarsArgusVsWTIFinancial
Ethanol T2 FOB Rdam Including Duty (Platts) Futures
AZ1NYMEXFutures.Energies.EthanolT2FOBRdamIncludingDutyPlatts
Brent Crude Futures
BICEFutures.Energies.BrentCrude
Mont Belvieu LDH Propane (OPIS) Futures
B0NYMEXFutures.Energies.MontBelvieuLDHPropaneOPIS
Gasoline Euro-bob Oxy NWE Barges (Argus) Futures
B7HNYMEXFutures.Energies.GasolineEurobobOxyNWEBargesArgus
WTI-Brent Financial Futures
BKNYMEXFutures.Energies.WTIBrentFinancial
3.5% Fuel Oil Barges FOB Rdam (Platts) Crack Spread (1000mt) Futures
BOONYMEXFutures.Energies.ThreePointFivePercentFuelOilBargesFOBRdamPlattsCrackSpread1000mt
Gasoline Euro-bob Oxy NWE Barges (Argus) BALMO Futures
BR7NYMEXFutures.Energies.GasolineEurobobOxyNWEBargesArgusBALMO
Brent Last Day Financial Futures
BZNYMEXFutures.Energies.BrentLastDayFinancial
Crude Oil Futures
CLNYMEXFutures.Energies.CrudeOilWTI
Gulf Coast CBOB Gasoline A2 (Platts) vs. RBOB Gasoline Futures
CRBNYMEXFutures.Energies.GulfCoastCBOBGasolineA2PlattsVsRBOBGasoline
Clearbrook Bakken Sweet (NE2) Monthly Index Futures
CSWNYMEXFutures.Energies.ClearbrookBakkenSweetCrudeOilMonthlyIndexNetEnergy
WTI Financial Futures
CSXNYMEXFutures.Energies.WTIFinancial
Chicago Ethanol (Platts) Futures
CUNYMEXFutures.Energies.ChicagoEthanolPlatts
Singapore Mogas 92 Unleaded (Platts) Brent Crack Spread Futures
D1NNYMEXFutures.Energies.SingaporeMogas92UnleadedPlattsBrentCrackSpread
Dubai Crude Oil (Platts) Financial Futures
DCBNYMEXFutures.Energies.DubaiCrudeOilPlattsFinancial
Japan C&F Naphtha (Platts) BALMO Futures
E6NYMEXFutures.Energies.JapanCnFNaphthaPlattsBALMO
Ethanol Futures
EHCBOTFutures.Energies.Ethanol
European Naphtha (Platts) Crack Spread Futures
ENNYMEXFutures.Energies.EuropeanNaphthaPlattsCrackSpread
European Propane CIF ARA (Argus) vs. Naphtha Cargoes CIF NWE (Platts) Futures
EPNNYMEXFutures.Energies.EuropeanPropaneCIFARAArgusVsNaphthaCargoesCIFNWEPlatts
Singapore Fuel Oil 380 cst (Platts) vs. European 3.5% Fuel Oil Barges FOB Rdam (Platts) Futures
EVCNYMEXFutures.Energies.SingaporeFuelOil380cstPlattsVsEuropeanThreePointFivePercentFuelOilBargesFOBRdamPlatts
East-West Gasoline Spread (Platts-Argus) Futures
EWGNYMEXFutures.Energies.EastWestGasolineSpreadPlattsArgus
East-West Naphtha: Japan C&F vs. Cargoes CIF NWE Spread (Platts) Futures
EWNNYMEXFutures.Energies.EastWestNaphthaJapanCFvsCargoesCIFNWESpreadPlatts
RBOB Gasoline vs. Euro-bob Oxy NWE Barges (Argus) (350000 gallons) Futures
EXRNYMEXFutures.Energies.RBOBGasolineVsEurobobOxyNWEBargesArgusThreeHundredFiftyThousandGallons
3.5% Fuel Oil Barges FOB Rdam (Platts) Crack Spread Futures
FONYMEXFutures.Energies.ThreePointFivePercentFuelOilBargesFOBRdamPlattsCrackSpread
Freight Route TC14 (Baltic) Futures
FRCNYMEXFutures.Energies.FreightRouteTC14Baltic
1% Fuel Oil Cargoes FOB NWE (Platts) vs. 3.5% Fuel Oil Barges FOB Rdam (Platts) Futures
FSSNYMEXFutures.Energies.OnePercentFuelOilCargoesFOBNWEPlattsVsThreePointFivePercentFuelOilBargesFOBRdamPlatts
Low Sulfur Gasoil
GICEFutures.Energies.LowSulfurGasoil
Gulf Coast HSFO (Platts) vs. European 3.5% Fuel Oil Barges FOB Rdam (Platts) Futures
GCUNYMEXFutures.Energies.GulfCoastHSFOPlattsVsEuropeanThreePointFivePercentFuelOilBargesFOBRdamPlatts
WTI Houston Crude Oil Futures
HCLNYMEXFutures.Energies.WTIHoustonCrudeOil
Natural Gas (Henry Hub) Last-day Financial Futures
HHNYMEXFutures.Energies.NaturalGasHenryHubLastDayFinancial
NY Harbor ULSD Futures
HONYMEXFutures.Energies.HeatingOil
Natural Gas (Henry Hub) Penultimate Financial Futures
HPNYMEXFutures.Energies.NaturalGasHenryHubPenultimateFinancial
WTI Houston (Argus) vs. WTI Trade Month Futures
HTTNYMEXFutures.Energies.WTIHoustonArgusVsWTITradeMonth
Micro Gasoil 0.1% Barges FOB ARA (Platts) Futures
M1BNYMEXFutures.Energies.MicroGasoilZeroPointOnePercentBargesFOBARAPlatts
Micro European 3.5% Fuel Oil Cargoes FOB Med (Platts) Futures
M35NYMEXFutures.Energies.MicroEuropeanThreePointFivePercentFuelOilCargoesFOBMedPlatts
Micro Coal (API 5) fob Newcastle (Argus/McCloskey) Futures
M5FNYMEXFutures.Energies.MicroCoalAPIFivefobNewcastleArgusMcCloskey
Micro Singapore Fuel Oil 380CST (Platts) Futures
MAFNYMEXFutures.Energies.MicroSingaporeFuelOil380CSTPlatts
Micro WTI Crude Oil Futures
MCLNYMEXFutures.Energies.MicroCrudeOilWTI
Micro European 3.5% Fuel Oil Barges FOB Rdam (Platts) Futures
MEFNYMEXFutures.Energies.MicroEuropeanThreePointFivePercentOilBargesFOBRdamPlatts
Henry Hub Natural Gas Futures
NGNYMEXFutures.Energies.NaturalGas
Micro European FOB Rdam Marine Fuel 0.5% Barges (Platts) Futures
R5ONYMEXFutures.Energies.MicroEuropeanFOBRdamMarineFuelZeroPointFivePercentBargesPlatts
RBOB Gasoline Futures
RBNYMEXFutures.Energies.Gasoline
Micro Singapore FOB Marine Fuel 0.5% (Platts) Futures
S5ONYMEXFutures.Energies.MicroSingaporeFOBMarineFuelZeroPointFivePercetPlatts
Micro 10-Year Yield Futures
10YCBOTFutures.Financials.MicroY10TreasuryNote
Micro 2-Year Yield Futures
2YYCBOTFutures.Financials.MicroY2TreasuryBond
Micro 30-Year Yield Futures
30YCBOTFutures.Financials.MicroY30TreasuryBond
Micro 5-Year Yield Futures
5YYCBOTFutures.Financials.MicroY5TreasuryBond
5-Year USD MAC Swap Futures
F1UCBOTFutures.Financials.FiveYearUSDMACSwap
Eurodollar Futures
GECMEFutures.Financials.EuroDollar
Ultra 10-Year U.S. Treasury Note Futures
TNCBOTFutures.Financials.UltraTenYearUSTreasuryNote
Ultra U.S. Treasury Bond Futures
UBCBOTFutures.Financials.UltraUSTreasuryBond
U.S. Treasury Bond Futures
ZBCBOTFutures.Financials.Y30TreasuryBond
5-Year T-Note Futures
ZFCBOTFutures.Financials.Y5TreasuryNote
10-Year T-Note Futures
ZNCBOTFutures.Financials.Y10TreasuryNote
2-Year T-Note Futures
ZTCBOTFutures.Financials.Y2TreasuryNote
Lumber Futures
LBRCMEFutures.Forestry.Lumber
Random Length Lumber Futures
LBSCMEFutures.Forestry.RandomLengthLumber
Black Sea Corn Financially Settled (Platts) Futures
BCFCBOTFutures.Grains.BlackSeaCornFinanciallySettledPlatts
Black Sea Wheat Financially Settled (Platts) Futures
BWFCBOTFutures.Grains.BlackSeaWheatFinanciallySettledPlatts
KC HRW Wheat Futures
KECBOTFutures.Grains.HRWWheat
Corn Futures
ZCCBOTFutures.Grains.Corn
Soybean Oil Futures
ZLCBOTFutures.Grains.SoybeanOil
Soybean Meal Futures
ZMCBOTFutures.Grains.SoybeanMeal
Oats Futures
ZOCBOTFutures.Grains.Oats
Soybean Futures
ZSCBOTFutures.Grains.Soybeans
Chicago SRW Wheat Futures
ZWCBOTFutures.Grains.SRWWheat
Bloomberg Commodity Index Futures
AWCBOTFutures.Indices.BloombergCommodityIndex
BankNifty Index
BANKNIFTYINDIAFutures.Indices.BankNifty
E-mini Nasdaq-100 Biotechnology Index Futures
BIOCMEFutures.Indices.NASDAQ100BiotechnologyEMini
E-mini FTSE 100 GBP Futures
E3GCMEFutures.Indices.SPEurop350ESGEMini
E-mini FTSE Emerging Index Futures
EICMEFutures.Indices.FTSEEmergingEmini
E-mini S&P MidCap 400 Futures
EMDCMEFutures.Indices.SP400MidCapEmini
E-mini Nikkei YEN Futures
ENYCMEFutures.Indices.Nikkei225YenEMini
E-mini S&P 500 Futures
ESCMEFutures.Indices.SP500EMini
E-mini S&P500 ESG Futures
ESGCMEFutures.Indices.SP500EMiniESG
E-mini FTSE 100 GBP Futures
FT1CMEFutures.Indices.FTSE100EMini
E-mini FTSE China Futures
FT5CMEFutures.Indices.FTSEChina50EMini
E-mini FTSE 100 USD Futures
FTUCMEFutures.Indices.FTSE100USDEMini
S&P-GSCI Commodity Index Futures
GDCMEFutures.Indices.SPGSCICommodity
USD-Denominated Ibovespa Index Futures
IBVCMEFutures.Indices.USDDenominatedIbovespa
MSCI Europe NTR
M1EUNYSELIFFEFutures.Indices.MSCIEuropeNTR
The MSCI Japan NTR
M1JPNYSELIFFEFutures.Indices.MSCIJapanNTR
MSCI Emerging Markets Asia Net Total Return
M1MSANYSELIFFEFutures.Indices.MSCIEmergingMarketsAsiaNTR
Micro E-mini Russell 2000 Index Futures
M2KCMEFutures.Indices.MicroRussell2000EMini
Micro E-mini Standard and Poor's 500 Stock Price Index Futures
MESCMEFutures.Indices.MicroSP500EMini
Micro E-mini Nasdaq-100 Index Futures
MNQCMEFutures.Indices.MicroNASDAQ100EMini
MSCI EAFE Index
MXEANYSELIFFEFutures.Indices.MSCIEafeIndex
MSCI EMERGING MARKETS INDEX
MXEFNYSELIFFEFutures.Indices.MSCIEmergingMarketsIndex
MSCI USA Index
MXUSNYSELIFFEFutures.Indices.MSCIUsaIndex
Micro E-mini Dow Jones Industrial Average Index Futures
MYMCBOTFutures.Indices.MicroDow30EMini
Nifty50 Index
NIFTYINDIAFutures.Indices.Nifty50
Nikkei/YEN Futures
NIYCMEFutures.Indices.Nikkei225YenCME
SGX Nikkei 225 Index Futures
NKSGXFutures.Indices.Nikkei225Yen
Nikkei/USD Futures
NKDCMEFutures.Indices.Nikkei225Dollar
E-mini Nasdaq-100 Futures
NQCMEFutures.Indices.NASDAQ100EMini
E-mini Russell 1000 future
RS1CMEFutures.Indices.Russell1000EMini
E-mini Russell 2000 Index Futures
RTYCMEFutures.Indices.Russell2000EMini
DJRE Futures
RXCMEFutures.Indices.DowJonesRealEstate
SP500 S&P 500 Annual Dividend Index future
SDACMEFutures.Indices.SP500AnnualDividendIndex
BSE S&P Sensex Index
SENSEXINDIAFutures.Indices.BseSensex
TOPIX USD Futures
TPDCMEFutures.Indices.TOPIXUSD
TOPIX JPY Futures
TPYCMEFutures.Indices.TOPIXYEN
MSCI Taiwan Index Futures
TWSGXFutures.Indices.MSCITaiwanIndex
VIX futures
VXCFEFutures.Indices.VIX
E-mini Dow ($5) Futures
YMCBOTFutures.Indices.Dow30EMini
Feeder Cattle Futures
GFCMEFutures.Meats.FeederCattle
Lean Hog Futures
HECMEFutures.Meats.LeanHogs
Live Cattle Futures
LECMEFutures.Meats.LiveCattle
Aluminum MW U.S. Transaction Premium Platts (25MT) Futures
AUPCOMEXFutures.Metals.AluminumMWUSTransactionPremiumPlatts25MT
Aluminium European Premium Duty-Paid (Metal Bulletin) Futures
EDPCOMEXFutures.Metals.AluminiumEuropeanPremiumDutyPaidMetalBulletin
Gold Futures
GCCOMEXFutures.Metals.Gold
Copper Futures
HGCOMEXFutures.Metals.Copper
U.S. Midwest Domestic Hot-Rolled Coil Steel (CRU) Index Futures
HRCNYMEXFutures.Metals.USMidwestDomesticHotRolledCoilSteelCRUIndex
Micro Gold Futures
MGCCOMEXFutures.Metals.MicroGold
Micro Gold TAS Futures
MGTCOMEXFutures.Metals.MicroGoldTAS
Palladium Futures
PANYMEXFutures.Metals.Palladium
Micro Palladium Futures
PAMNYMEXFutures.Metals.MicroPalladium
Platinum Futures
PLNYMEXFutures.Metals.Platinum
Silver Futures
SICOMEXFutures.Metals.Silver
Micro Silver Futures
SILCOMEXFutures.Metals.MicroSilver
Mini Sized NY Gold Futures
YGNYSELIFFEFutures.Metals.MiniNYGold
Mini Sized NY Silver Future
YINYSELIFFEFutures.Metals.MiniNYSilver
Gold 100 Troy Oz
ZGNYSELIFFEFutures.Metals.Gold100Oz
CBOT 5000 Oz Silver Futures
ZINYSELIFFEFutures.Metals.Silver5000Oz
Cocoa Futures
CCICEFutures.Softs.Cocoa
Cotton No. 2 Futures
CTICEFutures.Softs.Cotton2
Coffee C Arabica Futures
KCICEFutures.Softs.Coffee
Frozen Concentrated Orange Juice
OJICEFutures.Softs.OrangeJuice
Sugar No. 11 Futures
SBICEFutures.Softs.Sugar11
No. 11 Sugar Futures
YONYMEXFutures.Softs.Sugar11CME

Requesting Data

To add US Futures data to your algorithm, call the AddFutureadd_future method. Save a reference to the Future so you can access the data later in your algorithm.

class USFuturesDataAlgorithm(QCAlgorithm):

    def initialize(self) -> None:
        self.set_start_date(2013, 12, 20) 
        self.set_end_date(2014, 2, 20) 
        self.set_cash(1000000) 
        self.universe_settings.asynchronous = True
        future = self.add_future(Futures.metals.gold) 
        future.set_filter(0, 90)
        self.future_symbol = future.symbol
namespace QuantConnect
{
    public class USFuturesDataAlgorithm : QCAlgorithm
    {
        private Symbol _futureSymbol;
        
        public override void Initialize()
        {
            SetStartDate(2013, 12, 20);
            SetEndDate(2014, 2, 20);
            SetCash(1000000);
            UniverseSettings.Asynchronous = True;
            var future = AddFuture(Futures.Metals.Gold);
            future.SetFilter(0, 90);
            _futureSymbol = future.Symbol;
        }
    }
}

For more information about creating Future subscriptions, see Requesting Data or Futures Universes.

Accessing Data

To get the current US Futures data, index the FuturesChainsfutures_chains property of the current Slice with the canonical Futures Symbol. Slice objects deliver unique events to your algorithm as they happen, but the Slice may not contain data for your Future at every time step.

def on_data(self, slice: Slice) -> None:
    chain = slice.futures_chains.get(self.future_symbol)
    if chain:
        for contract in chain:
            self.log(f"{contract.symbol} price at {slice.time}: {contract.last_price}")
public override void OnData(Slice slice)
{
    if (slice.FuturesChains.TryGetValue(_futureSymbol, out var chain))
    {
        foreach (var contract in chain)
        {
            Log($"{contract.Symbol} price at {slice.Time}: {contract.LastPrice}");
        }
    }
}

You can also iterate through all of the FuturesChain objects in the current Slice.

def on_data(self, slice: Slice) -> None:
    for canonical_symbol, chain in slice.futures_chains.items():
        for contract in chain:
            self.log(f"{contract.symbol} price at {slice.time}: {contract.last_price}")
public override void OnData(Slice slice)
{
    foreach (var kvp in slice.FuturesChains)
    {
        var canonicalSymbol = kvp.Key;
        var chain = kvp.Value;
        foreach (var contract in chain)
        {
            Log($"{contract.Symbol} price at {slice.Time}: {contract.LastPrice}");
        }
    }
}

For more information about accessing Futures data, see Handling Data.

Historical Data

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

Historical Data In Algorithms

To get historical US Futures data in an algorithm, call the Historyhistory method with the canonical Futures Symbol or a Futures contract Symbol. If there is no data in the period you request, the history result is empty.

# DataFrame objects
contract_history_df = self.history(contract.symbol, 100, Resolution.MINUTE)
continuous_history_df = self.history(self.future_symbol,
    start=self.time - timedelta(days=15), 
    end=self.time, 
    resolution=Resolution.MINUTE, 
    fill_forward=False, 
    extended_market_hours=False,
    dataMappingMode=DataMappingMode.OPEN_INTEREST, 
    dataNormalizationMode=DataNormalizationMode.RAW, 
    contractDepthOffset=0)

# TradeBar objects
contract_history_trade_bars = self.history[TradeBar](contract.symbol, 100, Resolution.MINUTE)
continous_history_trade_bars = self.history[TradeBar](self.future_symbol, 100, Resolution.MINUTE)

# QuoteBar objects
contract_history_quote_bars = self.history[QuoteBar](contract.symbol, 100, Resolution.MINUTE)
continous_history_quote_bars = self.history[QuoteBar](self.future_symbol, 100, Resolution.MINUTE)

# Tick objects
contract_history_ticks = self.history[Tick](self.symbol, timedelta(seconds=10), Resolution.TICK)
continous_history_ticks = self.history[Tick](self.future_symbol, timedelta(seconds=10), Resolution.TICK)
// TradeBar objects
var contractHistoryTradeBars = History(contract.Symbol, 100, Resolution.Minute);
var continuousHistoryTradeBars = History(
    symbols: new[] {_futureSymbol}, 
    start: Time - TimeSpan.FromDays(15),
    end: Time,
    resolution: Resolution.Minute,
    fillForward: False,
    extendedMarketHours: False,
    dataMappingMode: DataMappingMode.OpenInterest,
    dataNormalizationMode: DataNormalizationMode.Raw,
    contractDepthOffset: 0);

// QuoteBar objects
var contractHistoryQuoteBars = History<QuoteBar>(contract.Symbol, 100, Resolution.Minute);
var continuousHistoryQuoteBars = History<QuoteBar>(_futureSymbol, 100, Resolution.Minute);

// Tick objects
var contractHistoryTicks = History<Tick>(contract.Symbol, TimeSpan.FromSeconds(10), Resolution.Tick);
var continuousHistoryTicks = History<Tick>(_futureSymbol, TimeSpan.FromSeconds(10), Resolution.Tick);

For more information about historical data in algorithms, see History Requests. For more information about the price adjustments for continuous contracts, see Continous Contracts.

Historical Data In Research

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

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))

all_history = history.get_all_data()
expiries = history.get_expiry_dates()
var qb = new QuantBook();
var future = qb.AddFuture(Futures.Metals.Gold);
future.SetFilter(0, 90);
var history = qb.FutureHistory(future.Symbol, new DateTime(2020, 6, 1), new DateTime(2020, 6, 5));
    
var contracts = history.SelectMany(x => x.OptionChains.SelectMany(y => y.Value.Contracts.Keys)).Distinct().ToList();
var expiries = contracts.Select(x => x.ID.Date).Distinct().ToList();

To get historical data for a single US Futures contract or the continuous Futures contract, call the Historyhistory method like you would in an algorithm but on the QuantBook object. For more information about historical data in the Research Environment, see Futures.

Example Applications

The US Futures 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

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: