# market-data

> Fetch real-time stock market data including prices, fundamentals (P/E, market cap, dividend yield), technical analysis (RSI, MACD, signals), and TADAWUL screeners. Use when user asks about stock prices, market data, top gainers/losers, or wants to compare/screen stocks. Covers all 400+ Saudi Tadawul stocks, US markets, and 100+ global exchanges.

- Author: Mohammed Alogayyil
- Repository: Cycls/tasibot
- Version: 20260203004256
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/Cycls/tasibot
- Web: https://mule.run/skillshub/@@Cycls/tasibot~market-data:20260203004256

---

---
name: market-data
description: Fetch real-time stock market data including prices, fundamentals (P/E, market cap, dividend yield), technical analysis (RSI, MACD, signals), and TADAWUL screeners. Use when user asks about stock prices, market data, top gainers/losers, or wants to compare/screen stocks. Covers all 400+ Saudi Tadawul stocks, US markets, and 100+ global exchanges.
---

# Stock & Market Data

Fetch real-time stock prices, fundamentals, technical analysis, and screen stocks. **No API key required.**

## Quick Start

```bash
# Ensure dependencies installed (first time only)
cd .claude/skills/market-data/scripts && npm install

# Get quote with fundamentals
node .claude/skills/market-data/scripts/tradingview-skill.js quote TADAWUL:1120

# Get technical analysis with buy/sell signals
node .claude/skills/market-data/scripts/tradingview-skill.js ta TADAWUL:1120

# Compare stocks
node .claude/skills/market-data/scripts/tradingview-skill.js compare TADAWUL:1120 TADAWUL:2222 TADAWUL:2010
```

## TADAWUL Screeners

Screen all 400+ Saudi stocks with one command:

```bash
# Market movers
node .claude/skills/market-data/scripts/tradingview-skill.js gainers 10      # Top gainers
node .claude/skills/market-data/scripts/tradingview-skill.js losers 10       # Top losers
node .claude/skills/market-data/scripts/tradingview-skill.js active 10       # Most active by volume

# Fundamentals-based
node .claude/skills/market-data/scripts/tradingview-skill.js dividend 10     # High dividend yield
node .claude/skills/market-data/scripts/tradingview-skill.js undervalued 10  # Low P/E ratio

# Technical signals
node .claude/skills/market-data/scripts/tradingview-skill.js signals 10      # Strong buy signals
node .claude/skills/market-data/scripts/tradingview-skill.js oversold 10     # RSI < 30 (potential buys)
node .claude/skills/market-data/scripts/tradingview-skill.js overbought 10   # RSI > 70 (potential sells)

# List all stocks
node .claude/skills/market-data/scripts/tradingview-skill.js list            # All 400+ TADAWUL stocks
```

## Commands Reference

| Command | Usage | Returns |
|---------|-------|---------|
| `quote` | `quote SYMBOL` | Price, change, market cap, P/E, dividend yield, sector |
| `ta` | `ta SYMBOL` | Technical analysis: RSI, MACD, signals (BUY/SELL/NEUTRAL) |
| `history` | `history SYMBOL TIMEFRAME BARS` | OHLCV candles (timeframe: D/W/1/60) |
| `search` | `search "QUERY"` | Matching symbols across exchanges |
| `compare` | `compare SYM1 SYM2 ...` | Side-by-side comparison with full data |
| `list` | `list` | All TADAWUL stocks (400+) |
| `gainers` | `gainers [limit]` | Top gaining stocks today |
| `losers` | `losers [limit]` | Top losing stocks today |
| `dividend` | `dividend [limit]` | Highest dividend yield stocks |
| `signals` | `signals [limit]` | Strongest buy signals |
| `oversold` | `oversold [limit]` | Stocks with RSI < 30 |
| `overbought` | `overbought [limit]` | Stocks with RSI > 70 |
| `active` | `active [limit]` | Most traded by volume |
| `undervalued` | `undervalued [limit]` | Lowest P/E ratios |

## Symbol Format

`EXCHANGE:TICKER` - Examples:
- Saudi: `TADAWUL:1120` (Al Rajhi), `TADAWUL:2222` (Aramco), `TADAWUL:2010` (SABIC)
- US: `NASDAQ:AAPL`, `NYSE:JPM`
- Crypto: `BINANCE:BTCUSDT`

## Data Fields

### Quote Data
```json
{
  "symbol": "TADAWUL:2222",
  "name": "Saudi Arabian Oil Co.",
  "name_ar": "أرامكو السعودية",
  "price": 25.80,
  "change_percent": 0.62,
  "market_cap": 6240962974822,
  "pe_ratio": 17.08,
  "dividend_yield": 5.13,
  "sector": "Energy Minerals",
  "currency": "SAR"
}
```

### Technical Analysis Data
```json
{
  "symbol": "TADAWUL:1120",
  "signals": {
    "overall": 0.45,
    "moving_averages": 0.80,
    "oscillators": 0.09,
    "interpretation": "BUY"
  },
  "indicators": {
    "rsi": 65.4,
    "macd": 2.53,
    "stochastic": 86.7,
    "adx": 38.0
  },
  "moving_averages": {
    "sma20": 102.6,
    "sma50": 99.2,
    "sma200": 98.0
  }
}
```

### Screener Data
```json
{
  "symbol": "TADAWUL:1120",
  "description": "Al Rajhi Bank",
  "close": 107.2,
  "change": -1.29,
  "volume": 4128719,
  "market_cap_basic": 428799987793,
  "dividend_yield_recent": 2.33,
  "recommend_all": 0.45,
  "rsi": 65.4
}
```

## Signal Interpretation

| Signal Value | Interpretation |
|--------------|----------------|
| >= 0.5 | STRONG BUY |
| >= 0.1 | BUY |
| > -0.1 | NEUTRAL |
| > -0.5 | SELL |
| <= -0.5 | STRONG SELL |

## Notes

- Real-time data from TradingView
- 400+ TADAWUL stocks available
- Technical analysis via Scanner API
- All screeners fetch live data (may take a few seconds)
- Results cached for 1 hour for stock list