Download in Bulk

To unlock local access to the US Future Option Universe dataset, open the Pricing page of your organization and subscribe to the following data packages:

• US Future Option Universe History by QuantConnect
• US Futures Security Master by QuantConnect
• US Future Universe History by QuantConnect

You need billing permissions to change the organization's subscriptions.

After you subscribe to local access, to download the US Future Option Universe data, open a terminal in your organization workspace and then run:

$ lean data download --dataset "US Future Option Universe" --data-type "bulk" --start "20250403" --end "20250403"

To download the US Futures Security Master, run:

$ lean data download --dataset "US Futures Security Master"

To download the US Future Universe data, run:

$ lean data download --dataset "US Future Universe" --data-type "bulk" --start "20250403" --end "20250403"

After you bulk download the US Future Option Universe dataset, new daily updates are available at 7 AM Eastern Time (ET) after each trading day. To unlock local access to the data updates, open the Pricing page of your organization and subscribe to the US Future Option Universe Updates by QuantConnect and US Future Universe Updates by QuantConnect data packages. You need billing permissions to change the organization's subscriptions.

After you subscribe to dataset updates, to update your local copy of the US Future Option Universe dataset, open a terminal in your organization workspace and then run:

$ lean data download --dataset "US Future Option Universe" --data-type "bulk" --start "20250403" --end "20250403"

Alternatively, instead of directly calling the lean data download command, you can place the following Python script in the data directory of your organization workspace and run it to update your data files.

import os
from datetime import datetime, time, timedelta
from pytz import timezone
from os.path import abspath, dirname
os.chdir(dirname(abspath(__file__)))

OVERWRITE = False

def __get_start_date() -> str:
    dir_name = f"futureoption/cme/universes"
    files = [] if not os.path.exists(dir_name) else sorted(os.listdir(dir_name)) 
    return files[-1].split(".")[0] if files else '19980101'

def __get_end_date() -> str:
    now = datetime.now(timezone("US/Eastern"))
    if now.time() > time(7, 0):
        return (now - timedelta(1)).strftime("%Y%m%d")
    print('New data is available at 07:00 AM EST')
    return (now - timedelta(2)).strftime("%Y%m%d")

if __name__ == "__main__":
    start, end = __get_start_date(), __get_end_date()
    if start >= end:
        exit("Your data is already up to date.")
            
    command = f'lean data download --dataset "US Future Option Universe" --data-type "Bulk" --start {start} --end {end}'
    if OVERWRITE:
        command += " --overwrite"
    print(command)
    os.system(command)

The preceding script checks the date of the most recent US Future Option Universe data you have. If there is new data available, it downloads the new data files.

To update your local copy of the US Futures Security Master, run:

$ lean data download --dataset "US Futures Security Master"

To update your local copy of the US Future Universe data, run:

$ lean data download --dataset "US Future Universe" --data-type "bulk" --start "20250403" --end "20250403"

The US Future Option Universe dataset is about 6 GB in size. We structure the data files so there is one file per underlying Future contract per day. For an example, see the Data / futureoption / cme / universes / es / 20200619 / 20200108.csv file in the LEAN repository.

To view the prices of the datasets, see the Pricing tab of the following dataset listings:

• US Future Option Universe
• US Futures Security Master
• US Future Universe