Download in Bulk

US Equity Coarse Universe

Introduction

Download the US Equity Coarse Universe dataset in bulk to get the full dataset without any selection bias. The bulk dataset packages contain data for every trading day.

The US Equity Coarse Universe dataset depends on the US Equity Security Master dataset because the US Equity Security Master contains information on splits, dividends, and symbol changes.

Download History

To unlock local access to the US Equity Coarse Universe dataset, open the Pricing page of your organization and subscribe to the US Equity Coarse Universe History by QuantConnect data package. If you don't already subscribe to the US Equity Security Master by QuantConnect data package, subscribe to it too. You need billing permissions to change the organization's subscriptions.

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

$ lean data download --dataset "US Equity Coarse Universe" --data-type "Bulk"

To download the US Equity Security Master, run:

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

Download Daily Updates

After you bulk download the US Equity Coarse 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 Equity Coarse Universe Updates by QuantConnect data package. You need billing permissions to change the organization's subscriptions.

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

$ lean data download --dataset "US Equity Coarse Universe" --data-type "Bulk"

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

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

Alternatively, instead of directly calling the lean data download command, you can place a Python script in the data directory of your organization workspace and run it to update your data files. The following example script downloads the latest data when it's available:

import os
from datetime import datetime
from pytz import timezone

END_DATE = datetime.now(timezone("US/Eastern")).strftime("%Y%m%d")
latest_date = sorted([f for f in os.listdir(f"equity/usa/fundamental/coarse")])[-1]
if latest_date >= END_DATE:
    print(f"Your local data is already up to date.")
else:
    print("Updating data...")
    os.system(f'lean data download --dataset "US Equity Coarse Universe" --data-type "Bulk"')

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

Size and Format

The US Equity Coarse Universe dataset is 4 GB in size. We structure the data files so there is one file per day.

Price

The following table shows the price of an annual subscription to the US Equity Security Master for each organization tier:

TierPrice ($/Year)
Quant Researcher
600
Team
900
Trading Firm
1,200
Institution
1,800

All of the historical US Equity Coarse Universe data costs $1,800. An annual subscription to daily updates costs $960/year.

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: