quantwise 1.2.0 → 1.2.2

package/.claude/skills/theme-detector/references/cross_sector_themes.md

@@ -0,0 +1,252 @@
+# Cross-Sector Theme Definitions
+
+This reference defines market themes by their constituent FINVIZ industries, sectors, proxy ETFs, and representative stocks. The theme_classifier.py script reads these definitions to map industry-level data into theme-level aggregations.
+
+**Usage Notes:**
+- Industry names must exactly match FINVIZ industry names (see `finviz_industry_codes.md`)
+- `min_matching_industries`: Minimum number of constituent industries that must show activity for the theme to be detected
+- `static_stocks`: Fallback representative stocks used when industry-level data is insufficient
+- `proxy_etfs`: Used for quick volume/momentum checks and as user-facing exposure recommendations
+
+---
+
+## AI & Semiconductors
+
+- **Direction bias**: Bullish (typically)
+- **Industries**: Semiconductors, Software - Application, Software - Infrastructure, Information Technology Services, Electronic Components, Computer Hardware, Scientific & Technical Instruments
+- **Sectors**: Technology (primary), Communication Services, Industrials
+- **Proxy ETFs**: SMH, SOXX, AIQ, BOTZ, CHAT
+- **Static stocks**: NVDA, AVGO, AMD, INTC, QCOM, MRVL, AMAT, LRCX, KLAC, TSM, MU, ARM, SNPS, CDNS, MCHP
+- **Min matching industries**: 2
+
+---
+
+## Clean Energy & EV
+
+- **Direction bias**: Bullish (typically)
+- **Industries**: Solar, Utilities - Renewable, Auto Manufacturers, Auto Parts, Electrical Equipment & Parts, Specialty Chemicals
+- **Sectors**: Utilities, Consumer Cyclical, Industrials, Basic Materials
+- **Proxy ETFs**: ICLN, QCLN, TAN, DRIV, LIT
+- **Static stocks**: ENPH, SEDG, FSLR, RUN, TSLA, RIVN, LCID, NIO, PLUG, BE, CHPT, ALB, SQM, LAC, LTHM
+- **Min matching industries**: 2
+
+---
+
+## Cybersecurity
+
+- **Direction bias**: Bullish (typically)
+- **Industries**: Software - Infrastructure, Information Technology Services, Software - Application, Communication Equipment
+- **Sectors**: Technology (primary)
+- **Proxy ETFs**: CIBR, HACK, BUG
+- **Static stocks**: CRWD, PANW, FTNT, ZS, NET, S, OKTA, CYBR, QLYS, RPD, TENB, VRNS, SAIL, MNDT, DDOG
+- **Min matching industries**: 2
+
+**Note:** Cybersecurity overlaps with broader software industries. Theme classification uses proxy ETF volume and static stock performance to differentiate from general software themes.
+
+---
+
+## Cloud Computing & SaaS
+
+- **Direction bias**: Bullish (typically)
+- **Industries**: Software - Application, Software - Infrastructure, Information Technology Services
+- **Sectors**: Technology (primary), Communication Services
+- **Proxy ETFs**: SKYY, WCLD, CLOU
+- **Static stocks**: CRM, NOW, SNOW, DDOG, TEAM, MDB, ESTC, NET, ZS, HUBS, BILL, TTD, PLTR, DOCN, DT
+- **Min matching industries**: 2
+
+**Note:** Cloud/SaaS overlaps significantly with Cybersecurity and AI themes. When multiple themes share the same industries, proxy ETF performance differentiates them.
+
+---
+
+## Biotech & Genomics
+
+- **Direction bias**: Bullish (typically, but highly volatile)
+- **Industries**: Biotechnology, Drug Manufacturers - Specialty & Generic, Medical Devices, Diagnostics & Research, Drug Manufacturers - General
+- **Sectors**: Healthcare (primary)
+- **Proxy ETFs**: XBI, IBB, ARKG, GNOM
+- **Static stocks**: AMGN, GILD, VRTX, REGN, MRNA, BIIB, ILMN, CRSP, NTLA, BEAM, EDIT, EXAS, TWST, SGEN, BMRN
+- **Min matching industries**: 2
+
+---
+
+## Infrastructure & Construction
+
+- **Direction bias**: Bullish (typically, policy-driven)
+- **Industries**: Engineering & Construction, Building Materials, Industrial Distribution, Farm & Heavy Construction Machinery, Steel, Specialty Industrial Machinery, Railroads, Waste Management
+- **Sectors**: Industrials (primary), Basic Materials
+- **Proxy ETFs**: PAVE, IFRA, SIMS
+- **Static stocks**: CAT, DE, VMC, MLM, URI, PWR, EME, MTZ, GVA, AECOM, STRL, GBX, NUE, CLF, RS
+- **Min matching industries**: 3
+
+---
+
+## Gold & Precious Metals
+
+- **Direction bias**: Bullish (typically in risk-off or inflation)
+- **Industries**: Gold, Silver, Other Precious Metals & Mining
+- **Sectors**: Basic Materials (primary)
+- **Proxy ETFs**: GDX, GDXJ, RING, SIL
+- **Static stocks**: NEM, GOLD, AEM, FNV, WPM, RGLD, KGC, AGI, AU, HMY, PAAS, CDE, HL, MAG, EQX
+- **Min matching industries**: 2
+
+---
+
+## Oil & Gas (Energy Sector)
+
+- **Direction bias**: Varies (cyclical)
+- **Industries**: Oil & Gas E&P, Oil & Gas Equipment & Services, Oil & Gas Midstream, Oil & Gas Refining & Marketing, Oil & Gas Integrated, Oil & Gas Drilling
+- **Sectors**: Energy (primary)
+- **Proxy ETFs**: XLE, XOP, OIH
+- **Static stocks**: XOM, CVX, COP, EOG, SLB, HAL, PXD, DVN, MPC, VLO, PSX, OXY, FANG, HES, WMB
+- **Min matching industries**: 2
+
+---
+
+## Financial Services & Banks
+
+- **Direction bias**: Varies (rate-sensitive)
+- **Industries**: Banks - Diversified, Banks - Regional, Capital Markets, Insurance - Diversified, Insurance - Property & Casualty, Financial Data & Stock Exchanges, Credit Services, Asset Management, Insurance Brokers, Mortgage Finance
+- **Sectors**: Financial Services (primary)
+- **Proxy ETFs**: XLF, KBE, KRE, IAI
+- **Static stocks**: JPM, BAC, WFC, GS, MS, C, SCHW, BLK, AXP, ICE, CME, MCO, SPGI, BX, KKR
+- **Min matching industries**: 3
+
+---
+
+## Healthcare & Pharma
+
+- **Direction bias**: Varies (defensive in downturns)
+- **Industries**: Drug Manufacturers - General, Health Care Plans, Medical Care Facilities, Health Information Services, Medical Distribution, Medical Instruments & Supplies, Pharmaceutical Retailers
+- **Sectors**: Healthcare (primary)
+- **Proxy ETFs**: XLV, IHE, IHI
+- **Static stocks**: UNH, JNJ, LLY, PFE, ABT, TMO, DHR, MDT, ISRG, SYK, BSX, EW, HCA, CVS, CI
+- **Min matching industries**: 3
+
+**Note:** Healthcare & Pharma is distinct from Biotech & Genomics. Healthcare focuses on established pharma, insurance, and medical devices; Biotech focuses on emerging drug development and genomics.
+
+---
+
+## Defense & Aerospace
+
+- **Direction bias**: Bullish (typically in geopolitical tension)
+- **Industries**: Aerospace & Defense, Airlines, Security & Protection Services
+- **Sectors**: Industrials (primary)
+- **Proxy ETFs**: ITA, PPA, ROKT, ARKX
+- **Static stocks**: LMT, RTX, NOC, BA, GD, LHX, HII, TDG, HWM, AXON, LDOS, BWXT, KTOS, RKLB, SPR
+- **Min matching industries**: 2
+
+---
+
+## Real Estate & REITs
+
+- **Direction bias**: Varies (rate-sensitive)
+- **Industries**: REIT - Residential, REIT - Industrial, REIT - Retail, REIT - Office, REIT - Healthcare Facilities, REIT - Diversified, REIT - Hotel & Motel, REIT - Specialty, Real Estate Services, Real Estate - Diversified, Real Estate - Development
+- **Sectors**: Real Estate (primary)
+- **Proxy ETFs**: VNQ, XLRE, IYR
+- **Static stocks**: PLD, AMT, CCI, EQIX, SPG, O, WELL, DLR, PSA, VICI, EXR, AVB, ARE, MAA, IRM
+- **Min matching industries**: 3
+
+---
+
+## Retail & Consumer
+
+- **Direction bias**: Varies (consumer sentiment driven)
+- **Industries**: Internet Retail, Specialty Retail, Apparel Retail, Home Improvement Retail, Department Stores, Discount Stores, Luxury Goods, Restaurants, Leisure, Resorts & Casinos, Gambling, Apparel Manufacturing, Footwear & Accessories
+- **Sectors**: Consumer Cyclical (primary), Consumer Defensive
+- **Proxy ETFs**: XLY, XRT, XLP, IBUY
+- **Static stocks**: AMZN, HD, LOW, TJX, COST, WMT, TGT, NKE, SBUX, MCD, DPZ, LULU, ROST, BURL, DECK
+- **Min matching industries**: 3
+
+---
+
+## Crypto & Blockchain
+
+- **Direction bias**: Bullish (typically in risk-on)
+- **Industries**: Capital Markets, Software - Application, Financial Data & Stock Exchanges, Information Technology Services
+- **Sectors**: Financial Services, Technology
+- **Proxy ETFs**: BITO, BLOK, BITQ, IBIT, DAPP
+- **Static stocks**: COIN, MSTR, MARA, RIOT, CLSK, HUT, BITF, SQ, PYPL, HOOD, CIFR, IREN, HIVE, CORZ, BTBT
+- **Min matching industries**: 2
+
+**Note:** Crypto theme uses proxy ETFs and static stocks as primary signals rather than industry classification, since blockchain companies span multiple traditional industries.
+
+---
+
+## Nuclear Energy
+
+- **Direction bias**: Bullish (policy-driven, AI data center demand)
+- **Industries**: Uranium, Utilities - Independent Power Producers, Specialty Industrial Machinery, Electrical Equipment & Parts
+- **Sectors**: Energy, Utilities, Industrials
+- **Proxy ETFs**: URA, URNM, NLR, NUKZ
+- **Static stocks**: CCJ, UEC, NXE, DNN, UUUU, LEU, SMR, OKLO, BWX, GEV, CEG, VST, TLN, NRG, BWXT
+- **Min matching industries**: 2
+
+---
+
+## Uranium
+
+- **Direction bias**: Bullish (supply deficit narrative)
+- **Industries**: Uranium, Other Industrial Metals & Mining
+- **Sectors**: Energy (primary), Basic Materials
+- **Proxy ETFs**: URA, URNM, URNJ
+- **Static stocks**: CCJ, UEC, NXE, DNN, UUUU, LEU, URG, GLATF, EU, PALAF, SRUUF, LTBR, FCUUF, AEC, WSTRF
+- **Min matching industries**: 1
+
+**Note:** Uranium is a sub-theme of Nuclear Energy but tracked separately due to its distinct commodity-driven dynamics. Requires only 1 matching industry due to narrow sector focus.
+
+---
+
+## Obesity & GLP-1
+
+- **Direction bias**: Bullish (medical innovation)
+- **Industries**: Drug Manufacturers - General, Drug Manufacturers - Specialty & Generic, Medical Devices, Biotechnology
+- **Sectors**: Healthcare (primary)
+- **Proxy ETFs**: SLIM, HRTS
+- **Static stocks**: LLY, NVO, AMGN, VKTX, ALT, GPCR, SMLR, RVMD, PTGX, IVA
+- **Min matching industries**: 2
+
+**Note:** Obesity/GLP-1 is a narrow theme that overlaps with Healthcare & Pharma. It is differentiated primarily through proxy ETF volume and static stock performance rather than industry classification.
+
+---
+
+## Summary Table
+
+| Theme | Industries | Sectors | Proxy ETFs | Static Stocks | Min Industries |
+|-------|-----------|---------|-----------|--------------|----------------|
+| AI & Semiconductors | 7 | 3 | 5 | 15 | 2 |
+| Clean Energy & EV | 6 | 4 | 5 | 15 | 2 |
+| Cybersecurity | 4 | 1 | 3 | 15 | 2 |
+| Cloud Computing & SaaS | 3 | 2 | 3 | 15 | 2 |
+| Biotech & Genomics | 5 | 1 | 4 | 15 | 2 |
+| Infrastructure & Construction | 8 | 2 | 3 | 15 | 3 |
+| Gold & Precious Metals | 3 | 1 | 4 | 15 | 2 |
+| Oil & Gas (Energy) | 6 | 1 | 3 | 15 | 2 |
+| Financial Services & Banks | 10 | 1 | 4 | 15 | 3 |
+| Healthcare & Pharma | 7 | 1 | 3 | 15 | 3 |
+| Defense & Aerospace | 3 | 1 | 4 | 15 | 2 |
+| Real Estate & REITs | 11 | 1 | 3 | 15 | 3 |
+| Retail & Consumer | 13 | 2 | 4 | 15 | 3 |
+| Crypto & Blockchain | 4 | 2 | 5 | 15 | 2 |
+| Nuclear Energy | 4 | 3 | 4 | 15 | 2 |
+| Uranium | 2 | 2 | 3 | 15 | 1 |
+| Obesity & GLP-1 | 4 | 1 | 2 | 10 | 2 |
+
+**Total: 17 themes** covering all major market narratives.
+
+---
+
+## Theme Overlap Matrix
+
+Some industries contribute to multiple themes. When scoring, each industry's data is used in all applicable themes:
+
+| Industry | Themes |
+|----------|--------|
+| Software - Application | AI, Cybersecurity, Cloud, Crypto |
+| Software - Infrastructure | AI, Cybersecurity, Cloud |
+| Drug Manufacturers - General | Healthcare, Biotech, Obesity |
+| Biotechnology | Biotech, Obesity |
+| Capital Markets | Financial Services, Crypto |
+| Electrical Equipment & Parts | Clean Energy, Nuclear |
+| Uranium | Nuclear, Uranium |
+
+This overlap is intentional - a strong software industry may boost multiple themes simultaneously, reflecting the interconnected nature of market narratives.

package/.claude/skills/theme-detector/references/finviz_industry_codes.md

@@ -0,0 +1,403 @@
+# FINVIZ Industry Filter Codes
+
+This reference maps all FINVIZ industry names to their corresponding filter codes used in the FINVIZ Screener API and Elite CSV export URLs.
+
+**URL Pattern (Elite CSV Export):**
+```
+https://elite.finviz.com/export.ashx?v=151&f=ind_{code},cap_smallover&auth={API_KEY}
+```
+
+**URL Pattern (Public Screener):**
+```
+https://finviz.com/screener.ashx?v=151&f=ind_{code},cap_smallover
+```
+
+**Filter Code Convention:** `ind_` + lowercase industry name with spaces, hyphens, ampersands, and special characters removed.
+
+---
+
+## Aerospace & Defense
+
+| Industry Name | Filter Code |
+|---|---|
+| Aerospace & Defense | ind_aerospacedefense |
+
+## Auto & Transport
+
+| Industry Name | Filter Code |
+|---|---|
+| Airlines | ind_airlines |
+| Auto Manufacturers | ind_automanufacturers |
+| Auto Parts | ind_autoparts |
+| Railroads | ind_railroads |
+| Recreational Vehicles | ind_recreationalvehicles |
+| Trucking | ind_trucking |
+| Marine Shipping | ind_marineshipping |
+
+## Basic Materials
+
+| Industry Name | Filter Code |
+|---|---|
+| Aluminum | ind_aluminum |
+| Building Materials | ind_buildingmaterials |
+| Chemicals | ind_chemicals |
+| Coking Coal | ind_cokingcoal |
+| Copper | ind_copper |
+| Gold | ind_gold |
+| Lumber & Wood Production | ind_lumberwoodproduction |
+| Other Industrial Metals & Mining | ind_otherindustrialmetalsmining |
+| Other Precious Metals & Mining | ind_otherpreciousmetalsmining |
+| Paper & Paper Products | ind_paperpaperproducts |
+| Silver | ind_silver |
+| Specialty Chemicals | ind_specialtychemicals |
+| Steel | ind_steel |
+| Uranium | ind_uranium |
+
+## Communication Services
+
+| Industry Name | Filter Code |
+|---|---|
+| Advertising Agencies | ind_advertisingagencies |
+| Broadcasting | ind_broadcasting |
+| Electronic Gaming & Multimedia | ind_electronicgamingmultimedia |
+| Entertainment | ind_entertainment |
+| Internet Content & Information | ind_internetcontentinformation |
+| Publishing | ind_publishing |
+| Telecom Services | ind_telecomservices |
+
+## Consumer Cyclical
+
+| Industry Name | Filter Code |
+|---|---|
+| Apparel Manufacturing | ind_apparelmanufacturing |
+| Apparel Retail | ind_apparelretail |
+| Auto & Truck Dealerships | ind_autotruckdealerships |
+| Department Stores | ind_departmentstores |
+| Discount Stores | ind_discountstores |
+| Footwear & Accessories | ind_footwearaccessories |
+| Furnishings, Fixtures & Appliances | ind_furnishingsfixturesappliances |
+| Gambling | ind_gambling |
+| Home Improvement Retail | ind_homeimprovementretail |
+| Internet Retail | ind_internetretail |
+| Leisure | ind_leisure |
+| Lodging | ind_lodging |
+| Luxury Goods | ind_luxurygoods |
+| Packaging & Containers | ind_packagingcontainers |
+| Personal Services | ind_personalservices |
+| Residential Construction | ind_residentialconstruction |
+| Resorts & Casinos | ind_resortscasinos |
+| Restaurants | ind_restaurants |
+| Specialty Retail | ind_specialtyretail |
+| Textile Manufacturing | ind_textilemanufacturing |
+| Travel Services | ind_travelservices |
+
+## Consumer Defensive
+
+| Industry Name | Filter Code |
+|---|---|
+| Beverages - Brewers | ind_beveragesbrewers |
+| Beverages - Non-Alcoholic | ind_beveragesnonalcoholic |
+| Beverages - Wineries & Distilleries | ind_beverageswineriesanddistilleries |
+| Confectioners | ind_confectioners |
+| Discount Stores | ind_discountstores |
+| Education & Training Services | ind_educationtrainingservices |
+| Farm Products | ind_farmproducts |
+| Food Distribution | ind_fooddistribution |
+| Grocery Stores | ind_grocerystores |
+| Household & Personal Products | ind_householdpersonalproducts |
+| Packaged Foods | ind_packagedfoods |
+| Tobacco | ind_tobacco |
+
+## Energy
+
+| Industry Name | Filter Code |
+|---|---|
+| Oil & Gas Drilling | ind_oilgasdrilling |
+| Oil & Gas E&P | ind_oilgasep |
+| Oil & Gas Equipment & Services | ind_oilgasequipmentservices |
+| Oil & Gas Integrated | ind_oilgasintegrated |
+| Oil & Gas Midstream | ind_oilgasmidstream |
+| Oil & Gas Refining & Marketing | ind_oilgasrefiningmarketing |
+| Thermal Coal | ind_thermalcoal |
+| Uranium | ind_uranium |
+
+## Financial Services
+
+| Industry Name | Filter Code |
+|---|---|
+| Asset Management | ind_assetmanagement |
+| Banks - Diversified | ind_banksdiversified |
+| Banks - Regional | ind_banksregional |
+| Capital Markets | ind_capitalmarkets |
+| Credit Services | ind_creditservices |
+| Financial Conglomerates | ind_financialconglomerates |
+| Financial Data & Stock Exchanges | ind_financialdatastockexchanges |
+| Insurance - Diversified | ind_insurancediversified |
+| Insurance - Life | ind_insurancelife |
+| Insurance - Property & Casualty | ind_insurancepropertycasualty |
+| Insurance - Reinsurance | ind_insurancereinsurance |
+| Insurance - Specialty | ind_insurancespecialty |
+| Insurance Brokers | ind_insurancebrokers |
+| Mortgage Finance | ind_mortgagefinance |
+| Shell Companies | ind_shellcompanies |
+
+## Healthcare
+
+| Industry Name | Filter Code |
+|---|---|
+| Biotechnology | ind_biotechnology |
+| Diagnostics & Research | ind_diagnosticsresearch |
+| Drug Manufacturers - General | ind_drugmanufacturersgeneral |
+| Drug Manufacturers - Specialty & Generic | ind_drugmanufacturersspecialtygeneric |
+| Health Information Services | ind_healthinformationservices |
+| Health Care Plans | ind_healthcareplans |
+| Medical Care Facilities | ind_medicalcarefacilities |
+| Medical Devices | ind_medicaldevices |
+| Medical Distribution | ind_medicaldistribution |
+| Medical Instruments & Supplies | ind_medicalinstrumentssupplies |
+| Pharmaceutical Retailers | ind_pharmaceuticalretailers |
+
+## Industrials
+
+| Industry Name | Filter Code |
+|---|---|
+| Aerospace & Defense | ind_aerospacedefense |
+| Business Equipment & Supplies | ind_businessequipmentsupplies |
+| Conglomerates | ind_conglomerates |
+| Consulting Services | ind_consultingservices |
+| Electrical Equipment & Parts | ind_electricalequipmentparts |
+| Engineering & Construction | ind_engineeringconstruction |
+| Farm & Heavy Construction Machinery | ind_farmheavyconstructionmachinery |
+| Industrial Distribution | ind_industrialdistribution |
+| Infrastructure Operations | ind_infrastructureoperations |
+| Integrated Freight & Logistics | ind_integratedfreightlogistics |
+| Metal Fabrication | ind_metalfabrication |
+| Pollution & Treatment Controls | ind_pollutiontreatmentcontrols |
+| Rental & Leasing Services | ind_rentalleasingservices |
+| Security & Protection Services | ind_securityprotectionservices |
+| Specialty Business Services | ind_specialtybusinessservices |
+| Specialty Industrial Machinery | ind_specialtyindustrialmachinery |
+| Staffing & Employment Services | ind_staffingemploymentservices |
+| Tools & Accessories | ind_toolsaccessories |
+| Waste Management | ind_wastemanagement |
+
+## Real Estate
+
+| Industry Name | Filter Code |
+|---|---|
+| Real Estate - Development | ind_realestatedevelopment |
+| Real Estate - Diversified | ind_realestatediversified |
+| Real Estate Services | ind_realestateservices |
+| REIT - Diversified | ind_reitdiversified |
+| REIT - Healthcare Facilities | ind_reithealthcarefacilities |
+| REIT - Hotel & Motel | ind_reithotelandmotel |
+| REIT - Industrial | ind_reitindustrial |
+| REIT - Mortgage | ind_reitmortgage |
+| REIT - Office | ind_reitoffice |
+| REIT - Residential | ind_reitresidential |
+| REIT - Retail | ind_reitretail |
+| REIT - Specialty | ind_reitspecialty |
+
+## Technology
+
+| Industry Name | Filter Code |
+|---|---|
+| Communication Equipment | ind_communicationequipment |
+| Computer Hardware | ind_computerhardware |
+| Consumer Electronics | ind_consumerelectronics |
+| Electronic Components | ind_electroniccomponents |
+| Electronics & Computer Distribution | ind_electronicscomputerdistribution |
+| Information Technology Services | ind_informationtechnologyservices |
+| Scientific & Technical Instruments | ind_scientifictechnicalinstruments |
+| Semiconductor Equipment & Materials | ind_semiconductorequipmentmaterials |
+| Semiconductors | ind_semiconductors |
+| Software - Application | ind_softwareapplication |
+| Software - Infrastructure | ind_softwareinfrastructure |
+| Solar | ind_solar |
+
+## Utilities
+
+| Industry Name | Filter Code |
+|---|---|
+| Utilities - Diversified | ind_utilitiesdiversified |
+| Utilities - Independent Power Producers | ind_utilitiesindependentpowerproducers |
+| Utilities - Regulated Electric | ind_utilitiesregulatedelectric |
+| Utilities - Regulated Gas | ind_utilitiesregulatedgas |
+| Utilities - Regulated Water | ind_utilitiesregulatedwater |
+| Utilities - Renewable | ind_utilitiesrenewable |
+
+---
+
+## Complete Alphabetical Index
+
+This flat list provides all industry filter codes in alphabetical order for quick lookup:
+
+| # | Industry Name | Filter Code |
+|---|---|---|
+| 1 | Advertising Agencies | ind_advertisingagencies |
+| 2 | Aerospace & Defense | ind_aerospacedefense |
+| 3 | Airlines | ind_airlines |
+| 4 | Aluminum | ind_aluminum |
+| 5 | Apparel Manufacturing | ind_apparelmanufacturing |
+| 6 | Apparel Retail | ind_apparelretail |
+| 7 | Asset Management | ind_assetmanagement |
+| 8 | Auto & Truck Dealerships | ind_autotruckdealerships |
+| 9 | Auto Manufacturers | ind_automanufacturers |
+| 10 | Auto Parts | ind_autoparts |
+| 11 | Banks - Diversified | ind_banksdiversified |
+| 12 | Banks - Regional | ind_banksregional |
+| 13 | Beverages - Brewers | ind_beveragesbrewers |
+| 14 | Beverages - Non-Alcoholic | ind_beveragesnonalcoholic |
+| 15 | Beverages - Wineries & Distilleries | ind_beverageswineriesanddistilleries |
+| 16 | Biotechnology | ind_biotechnology |
+| 17 | Broadcasting | ind_broadcasting |
+| 18 | Building Materials | ind_buildingmaterials |
+| 19 | Business Equipment & Supplies | ind_businessequipmentsupplies |
+| 20 | Capital Markets | ind_capitalmarkets |
+| 21 | Chemicals | ind_chemicals |
+| 22 | Coking Coal | ind_cokingcoal |
+| 23 | Communication Equipment | ind_communicationequipment |
+| 24 | Computer Hardware | ind_computerhardware |
+| 25 | Confectioners | ind_confectioners |
+| 26 | Conglomerates | ind_conglomerates |
+| 27 | Consulting Services | ind_consultingservices |
+| 28 | Consumer Electronics | ind_consumerelectronics |
+| 29 | Copper | ind_copper |
+| 30 | Credit Services | ind_creditservices |
+| 31 | Department Stores | ind_departmentstores |
+| 32 | Diagnostics & Research | ind_diagnosticsresearch |
+| 33 | Discount Stores | ind_discountstores |
+| 34 | Drug Manufacturers - General | ind_drugmanufacturersgeneral |
+| 35 | Drug Manufacturers - Specialty & Generic | ind_drugmanufacturersspecialtygeneric |
+| 36 | Education & Training Services | ind_educationtrainingservices |
+| 37 | Electrical Equipment & Parts | ind_electricalequipmentparts |
+| 38 | Electronic Components | ind_electroniccomponents |
+| 39 | Electronic Gaming & Multimedia | ind_electronicgamingmultimedia |
+| 40 | Electronics & Computer Distribution | ind_electronicscomputerdistribution |
+| 41 | Engineering & Construction | ind_engineeringconstruction |
+| 42 | Entertainment | ind_entertainment |
+| 43 | Farm & Heavy Construction Machinery | ind_farmheavyconstructionmachinery |
+| 44 | Farm Products | ind_farmproducts |
+| 45 | Financial Conglomerates | ind_financialconglomerates |
+| 46 | Financial Data & Stock Exchanges | ind_financialdatastockexchanges |
+| 47 | Food Distribution | ind_fooddistribution |
+| 48 | Footwear & Accessories | ind_footwearaccessories |
+| 49 | Furnishings, Fixtures & Appliances | ind_furnishingsfixturesappliances |
+| 50 | Gambling | ind_gambling |
+| 51 | Gold | ind_gold |
+| 52 | Grocery Stores | ind_grocerystores |
+| 53 | Health Care Plans | ind_healthcareplans |
+| 54 | Health Information Services | ind_healthinformationservices |
+| 55 | Home Improvement Retail | ind_homeimprovementretail |
+| 56 | Household & Personal Products | ind_householdpersonalproducts |
+| 57 | Industrial Distribution | ind_industrialdistribution |
+| 58 | Infrastructure Operations | ind_infrastructureoperations |
+| 59 | Information Technology Services | ind_informationtechnologyservices |
+| 60 | Insurance - Diversified | ind_insurancediversified |
+| 61 | Insurance - Life | ind_insurancelife |
+| 62 | Insurance - Property & Casualty | ind_insurancepropertycasualty |
+| 63 | Insurance - Reinsurance | ind_insurancereinsurance |
+| 64 | Insurance - Specialty | ind_insurancespecialty |
+| 65 | Insurance Brokers | ind_insurancebrokers |
+| 66 | Integrated Freight & Logistics | ind_integratedfreightlogistics |
+| 67 | Internet Content & Information | ind_internetcontentinformation |
+| 68 | Internet Retail | ind_internetretail |
+| 69 | Leisure | ind_leisure |
+| 70 | Lodging | ind_lodging |
+| 71 | Lumber & Wood Production | ind_lumberwoodproduction |
+| 72 | Luxury Goods | ind_luxurygoods |
+| 73 | Marine Shipping | ind_marineshipping |
+| 74 | Medical Care Facilities | ind_medicalcarefacilities |
+| 75 | Medical Devices | ind_medicaldevices |
+| 76 | Medical Distribution | ind_medicaldistribution |
+| 77 | Medical Instruments & Supplies | ind_medicalinstrumentssupplies |
+| 78 | Metal Fabrication | ind_metalfabrication |
+| 79 | Mortgage Finance | ind_mortgagefinance |
+| 80 | Oil & Gas Drilling | ind_oilgasdrilling |
+| 81 | Oil & Gas E&P | ind_oilgasep |
+| 82 | Oil & Gas Equipment & Services | ind_oilgasequipmentservices |
+| 83 | Oil & Gas Integrated | ind_oilgasintegrated |
+| 84 | Oil & Gas Midstream | ind_oilgasmidstream |
+| 85 | Oil & Gas Refining & Marketing | ind_oilgasrefiningmarketing |
+| 86 | Other Industrial Metals & Mining | ind_otherindustrialmetalsmining |
+| 87 | Other Precious Metals & Mining | ind_otherpreciousmetalsmining |
+| 88 | Packaged Foods | ind_packagedfoods |
+| 89 | Packaging & Containers | ind_packagingcontainers |
+| 90 | Paper & Paper Products | ind_paperpaperproducts |
+| 91 | Personal Services | ind_personalservices |
+| 92 | Pharmaceutical Retailers | ind_pharmaceuticalretailers |
+| 93 | Pollution & Treatment Controls | ind_pollutiontreatmentcontrols |
+| 94 | Publishing | ind_publishing |
+| 95 | Railroads | ind_railroads |
+| 96 | Real Estate - Development | ind_realestatedevelopment |
+| 97 | Real Estate - Diversified | ind_realestatediversified |
+| 98 | Real Estate Services | ind_realestateservices |
+| 99 | Recreational Vehicles | ind_recreationalvehicles |
+| 100 | REIT - Diversified | ind_reitdiversified |
+| 101 | REIT - Healthcare Facilities | ind_reithealthcarefacilities |
+| 102 | REIT - Hotel & Motel | ind_reithotelandmotel |
+| 103 | REIT - Industrial | ind_reitindustrial |
+| 104 | REIT - Mortgage | ind_reitmortgage |
+| 105 | REIT - Office | ind_reitoffice |
+| 106 | REIT - Residential | ind_reitresidential |
+| 107 | REIT - Retail | ind_reitretail |
+| 108 | REIT - Specialty | ind_reitspecialty |
+| 109 | Rental & Leasing Services | ind_rentalleasingservices |
+| 110 | Residential Construction | ind_residentialconstruction |
+| 111 | Resorts & Casinos | ind_resortscasinos |
+| 112 | Restaurants | ind_restaurants |
+| 113 | Scientific & Technical Instruments | ind_scientifictechnicalinstruments |
+| 114 | Security & Protection Services | ind_securityprotectionservices |
+| 115 | Semiconductor Equipment & Materials | ind_semiconductorequipmentmaterials |
+| 116 | Semiconductors | ind_semiconductors |
+| 117 | Shell Companies | ind_shellcompanies |
+| 118 | Silver | ind_silver |
+| 119 | Software - Application | ind_softwareapplication |
+| 120 | Software - Infrastructure | ind_softwareinfrastructure |
+| 121 | Solar | ind_solar |
+| 122 | Specialty Business Services | ind_specialtybusinessservices |
+| 123 | Specialty Chemicals | ind_specialtychemicals |
+| 124 | Specialty Industrial Machinery | ind_specialtyindustrialmachinery |
+| 125 | Specialty Retail | ind_specialtyretail |
+| 126 | Staffing & Employment Services | ind_staffingemploymentservices |
+| 127 | Steel | ind_steel |
+| 128 | Telecom Services | ind_telecomservices |
+| 129 | Textile Manufacturing | ind_textilemanufacturing |
+| 130 | Thermal Coal | ind_thermalcoal |
+| 131 | Tobacco | ind_tobacco |
+| 132 | Tools & Accessories | ind_toolsaccessories |
+| 133 | Travel Services | ind_travelservices |
+| 134 | Trucking | ind_trucking |
+| 135 | Uranium | ind_uranium |
+| 136 | Utilities - Diversified | ind_utilitiesdiversified |
+| 137 | Utilities - Independent Power Producers | ind_utilitiesindependentpowerproducers |
+| 138 | Utilities - Regulated Electric | ind_utilitiesregulatedelectric |
+| 139 | Utilities - Regulated Gas | ind_utilitiesregulatedgas |
+| 140 | Utilities - Regulated Water | ind_utilitiesregulatedwater |
+| 141 | Utilities - Renewable | ind_utilitiesrenewable |
+| 142 | Waste Management | ind_wastemanagement |
+
+**Total: 142 industries**
+
+---
+
+## Notes
+
+1. **Filter code derivation**: Remove spaces, hyphens, ampersands (`&`), and other special characters from the industry name, then lowercase the result. Prefix with `ind_`.
+
+2. **Cross-sector industries**: Some industries (e.g., Uranium) appear under multiple FINVIZ sectors (Energy and Basic Materials). The filter code is the same regardless of which sector view you navigate from.
+
+3. **Industry changes**: FINVIZ occasionally adds, removes, or renames industries. This list was compiled as of February 2026. If a filter code returns no results, verify the industry name on FINVIZ directly.
+
+4. **Combining filters**: Multiple industry filters can be combined in FINVIZ URLs using comma separation:
+   ```
+   f=ind_semiconductors,ind_softwareapplication,cap_smallover
+   ```
+
+5. **Market cap filter**: For theme detection, always combine with `cap_smallover` (market cap > $300M) to filter out micro-caps that may distort aggregated metrics.
+
+6. **Special cases**:
+   - "E&P" becomes "ep" (ampersand removed)
+   - "REIT - " prefix becomes "reit" (hyphen and spaces removed)
+   - "Wineries & Distilleries" becomes "wineriesanddistilleries" (ampersand becomes "and" in this case)
+   - Verify edge cases against FINVIZ directly if results seem incorrect