Yahoo Finance FOREX

Fetches real-time FOREX news and market data from Yahoo Finance for major currency pairs (EUR/USD, GBP/USD, USD/JPY, etc.). Analyzes sentiment and provides trading context.

Security Scan

The skill's code, install, and runtime instructions are coherent with its stated purpose (fetching Yahoo Finance FOREX data and doing keyword-based sentiment analysis).

Purpose & Capability

Name/description match the implementation: the script uses yfinance to fetch ticker data and news for the documented 7 currency pairs and performs keyword-based sentiment analysis; required binaries and packages (python3, yfinance) are appropriate.

Instruction Scope

SKILL.md instructs the agent to run the included Python script and parse its JSON output. The script only performs network calls to Yahoo Finance via the yfinance library and does not read unrelated files, environment variables, or system configuration.

Install Mechanism

Install uses pip to install yfinance>=0.2.40, which is a standard packaging mechanism for a Python dependency. No downloads from untrusted URLs or archive extraction are present.

Credentials

The skill declares no required environment variables, credentials, or config paths. The code does not attempt to access secrets or external credentials.

Persistence & Privilege

The skill does not request permanent/always-on presence, does not modify other skills or system-wide settings, and uses only its own script at runtime.

Assessment

This skill appears internally consistent and uses yfinance to fetch Yahoo data. Before installing, consider: (1) it requires network access to Yahoo Finance (yfinance) so ensure your environment permits outbound HTTP(s); (2) sentiment is simple keyword-counting (not deep NLP) — do not rely on it as sole trading advice; (3) pip installs run code from PyPI, so install in a controlled/virtual environment; and (4) review the linked GitHub repo if you want more assurance or to audit code changes before use.

Analyze major FOREX pairs using Yahoo Finance data: news, market data, sentiment analysis.

When to Use This Skill

• User asks about FOREX pairs (EUR/USD, GBP/USD, USD/JPY, etc.)
• User wants latest FOREX news or market sentiment
• User needs fundamental analysis for currency trading
• User asks "What's happening with EUR/USD?" or similar

Supported Currency Pairs

7 Major Pairs:

• EUR/USD 🇪🇺🇺🇸 (Euro Dollar)
• GBP/USD 🇬🇧🇺🇸 (Cable)
• USD/JPY 🇺🇸🇯🇵 (Dollar Yen)
• USD/CHF 🇺🇸🇨🇭 (Swissy)
• AUD/USD 🇦🇺🇺🇸 (Aussie)
• USD/CAD 🇺🇸🇨🇦 (Loonie)
• NZD/USD 🇳🇿🇺🇸 (Kiwi)

Quick Start

Fetch FOREX News

python3 scripts/fetch_forex_news.py EURUSD --limit 10

Output:

{
  "pair": "EURUSD",
  "current_rate": 1.10250,
  "change_pct": 0.136,
  "news": [
    {
      "title": "ECB maintains hawkish stance on rates",
      "published": "2026-02-02 14:30:00",
      "publisher": "Reuters"
    }
  ],
  "sentiment": {
    "pair_sentiment": 3,
    "recommendation": "BUY"
  }
}

Workflow

1. User Asks About FOREX

User: "What's happening with EUR/USD?"

Your Action:

1. Run: python3 scripts/fetch_forex_news.py EURUSD --limit 8
2. Parse the JSON output
3. Analyze the sentiment and news
4. Provide a summary with:
   • Current rate and change
   • Key news headlines
   • Sentiment analysis (bullish/bearish)
   • Trading context (support/resistance if available)

2. Analyze Sentiment

The script automatically calculates sentiment based on keywords:

Bullish Keywords: strengthens, rallies, hawkish, rate hike, growth Bearish Keywords: weakens, falls, dovish, rate cut, recession

Sentiment Score:

• Positive (> 2): Bullish for the pair
• Negative (< -2): Bearish for the pair
• Near zero: Neutral

3. Provide Context

Always include:

• Fundamentals: What central banks are doing (ECB, Fed, BoJ, etc.)
• News Impact: How recent news affects the pair
• Technical Context: Current price vs support/resistance (if available)

Script Reference

fetch_forex_news.py

Usage:

python3 scripts/fetch_forex_news.py <PAIR> [--limit N]

Arguments:

• <PAIR>: Currency pair (EURUSD, GBPUSD, USDJPY, USDCHF, AUDUSD, USDCAD, NZDUSD)
• --limit N: Number of news articles to fetch (default: 10, max: 50)

Output Fields:

• pair: Currency pair code
• current_rate: Current exchange rate
• change_pct: 24h percentage change
• news[]: Array of news articles
  • title: Article headline
  • published: Publication timestamp
  • publisher: News source
  • link: Article URL (optional)
• sentiment: Sentiment analysis
  • pair_sentiment: Sentiment score (-10 to +10)
  • recommendation: BUY/SELL/HOLD

Examples

Get EUR/USD Analysis

python3 scripts/fetch_forex_news.py EURUSD --limit 5

Get GBP/USD News

python3 scripts/fetch_forex_news.py GBPUSD --limit 8

Central Bank Focus

When analyzing FOREX pairs, consider these central banks:

• EUR/USD: ECB (European Central Bank) vs Fed (Federal Reserve)
• GBP/USD: BoE (Bank of England) vs Fed
• USD/JPY: Fed vs BoJ (Bank of Japan)
• USD/CHF: Fed vs SNB (Swiss National Bank)
• AUD/USD: RBA (Reserve Bank of Australia) vs Fed
• USD/CAD: Fed vs BoC (Bank of Canada)
• NZD/USD: RBNZ (Reserve Bank of New Zealand) vs Fed

Best Practices

1. Always fetch news first before making analysis
2. Check sentiment score to understand market bias
3. Read headlines to identify key drivers
4. Consider fundamentals (interest rates, economic data, geopolitics)
5. Provide balanced analysis - acknowledge both bullish and bearish factors
6. Mention risk factors - volatility, upcoming events, technical levels

Reference Files

See /references directory for:

• api-examples.md: Detailed usage examples
• forex-pairs.md: Complete pairs reference with Yahoo Finance symbols
• sentiment-guide.md: Sentiment calculation methodology

Limitations

• News data may have slight delays (1-5 minutes)
• Sentiment is keyword-based, not deep NLP analysis
• Historical data limited to recent news (last 7-14 days typically)
• No real-time tick data (only periodic updates)

Troubleshooting

Script fails to run:

• Ensure Python 3.7+ is installed
• Install yfinance: pip install yfinance>=0.2.40

No news returned:

• Check internet connection
• Verify pair symbol is correct
• Try different pair or reduce limit

Rate data missing:

• Yahoo Finance API may be temporarily unavailable
• Try again in a few minutes

Support

For issues or questions:

• GitHub: https://github.com/nazimboudeffa/openclaw-yahoo-finance-forex
• Report bugs via GitHub Issues