fear-and-greed

What it is and what it does

fear-and-greed is a lightweight Python wrapper that scrapes CNN's Fear & Greed Index from their website and returns the current market sentiment metric as a structured named tuple. It wraps the web-scraping logic around requests and requests-cache, caching results locally for 1 minute to avoid repeated fetches.

The package is designed for developers who want programmatic access to CNN's Fear & Greed Index without building their own scraper. It returns three pieces of data: the numeric index value, a human-readable category label (ranging from "Extreme Fear" to "Extreme Greed"), and the UTC timestamp of the last update on CNN's site. However, the package has not been maintained since May 2022, so its scraper may fail if CNN's website structure has changed.

Use it for:

• Fetch the current Fear & Greed Index value in a financial dashboard or monitoring application.
• Log historical sentiment readings at intervals for trend analysis or backtesting trading strategies.
• Alert traders or analysts when the index crosses into extreme fear or greed territory.
• Combine with other market data sources to build a multi-factor sentiment analysis tool.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Fetches CNN's Fear & Greed Index from their website, parses the current value, and returns it as a named tuple with the index value, category description, and last update timestamp.

Yes, if you need quick programmatic access to CNN's Fear & Greed Index and are willing to accept the risk that the scraper may break due to site changes. The low install friction and permissive license make it a low-cost experiment. No, if you require active maintenance or a guaranteed working solution—the package is abandoned and has not been updated since May 2022. Test it first to confirm the scraper still works with the current CNN website.

Install

fear-and-greed on PyPI

pip install fear-and-greed

uv add fear-and-greed

poetry add fear-and-greed

Installing fear-and-greed

Before you install

Low install friction with only two runtime dependencies (requests and requests-cache). However, the package is abandoned—last updated May 2022—so no maintenance or bug fixes should be expected going forward.

License in practice

Licensed under MIT (permissive), so you can use, modify, and distribute the package freely with minimal restrictions.

Quickstart

pip install fear-and-greed

import fear_and_greed
result = fear_and_greed.get()
print(result.value, result.description, result.last_update)

CNN's website structure may have changed since the last release in May 2022; the scraper may no longer work if the page layout has been updated.

Verify before relying

• Whether the web scraper still successfully parses CNN's Fear & Greed Index page given potential site structure changes since May 2022.
• Whether the 1-minute cache duration for requests is still appropriate for current use cases.
• The range of the index value (description mentions it falls into categories from 'Extreme Fear' to 'Extreme Greed').

Package facts

Evidence: fear_and_greed-0.4-py3-none-any.whl

Tags

More WWW/HTTP packages