monitor-etf-holdings-drawdown-risk

Detect commodity price and ETF holdings divergences to flag delivery risk.

3|1|Updated Jan 12, 2026
One-click install
npx skills add https://github.com/fatfingererr/macro-skills --skill monitor-etf-holdings-drawdown-risk
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: monitor-etf-holdings-drawdown-risk
Source: https://github.com/fatfingererr/macro-skills/tree/main/skills/monitor-etf-holdings-drawdown-risk
Command: npx skills add https://github.com/fatfingererr/macro-skills --skill monitor-etf-holdings-drawdown-risk

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pandas, numpy, yfinance, selenium, webdriver-manager, beautifulsoup4, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill detects divergences between commodity prices and ETF/physical holdings to flag potential physical tightness and delivery risk, using multiple data signals to guide risk assessment.

Core Features & Use Cases

  • Detect price-to-holdings divergence across major physical ETFs (e.g., SLV, GLD)
  • Cross-validate signals using inventory trends, decade-low analysis, futures curve, and retail premia
  • Generate actionable outputs including divergence status, stress scores, and recommended next steps

Quick Start

Quick start commands:

  • python scripts/divergence_detector.py --etf SLV --commodity SI=F --quick
  • python scripts/divergence_detector.py --etf GLD --commodity GC=F --start 2020-01-01 --end 2026-01-16 --output result.json

Frequently Asked Questions about monitor-etf-holdings-drawdown-risk

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I detect divergence between commodity ETF holdings and spot prices?

You can detect ETF price-to-holdings divergence by running the divergence detector script with yfinance price data and holdings data, which computes divergence and stress scores to flag potential physical tightness and delivery risk.

What signals indicate physical tightness in commodity ETFs like SLV or GLD?

Physical tightness signals include price-to-holdings divergence, inventory trends hitting decade-lows, futures curve structure changes, and elevated retail premia, all cross-validated through multi-indicator checks within the data pipeline.

Can I cross-validate ETF delivery risk using futures structure and retail premia?

Yes, the Skill cross-validates potential delivery risk by checking inventory trends, decade-low analysis, futures curve structure, and retail premia alongside the primary ETF price-to-holdings divergence signal.

How do I run a quick divergence check on a physical commodity ETF?

Run the divergence detector script with the --quick flag, specifying the ETF ticker and commodity futures symbol, to fetch prices and holdings data and output a structured divergence status result.

Does this ETF holdings divergence tool require Selenium and web scraping dependencies?

Yes, the Skill uses Selenium, webdriver-manager, and beautifulsoup4 alongside pandas, numpy, and yfinance to fetch holdings data, commodity prices, and retail premia for cross-validation of divergence signals.

What are the limitations of using price-to-holdings divergence for delivery risk assessment?

Divergence detection relies on accurate holdings data and multiple cross-checks; signals may lag during rapid market dislocations, and retail premia scraping can break if source websites change their structure.