tvfetch

Files (76)

• marketplace.json · .claude-plugin/
• plugin.json · .claude-plugin/
• .clawhubignore
• .gitignore
• CHANGELOG.md
• CLAUDE.md
• LICENSE
• README.md
• SKILL.md
• SPEC.md
• tvfetch.yaml · agents/
• backtrader_example.py · examples/
• basic_fetch.py · examples/
• live_stream.py · examples/
• error_symbol_not_found.json · fixtures/
• fetch_binance_btcusdt_1d_100bars.json · fixtures/
• fetch_default.json · fixtures/
• fetch_fx_eurusd_60_200bars.json · fixtures/
• fetch_nasdaq_aapl_1d_50bars.json · fixtures/
• search_apple_stock.json · fixtures/
• search_bitcoin.json · fixtures/
• search_bitcoin_crypto.json · fixtures/
• gemini-extension.json
• hooks.json · hooks/
• check-config.ps1 · hooks/scripts/
• check-config.sh · hooks/scripts/
• pyproject.toml
• __init__.py · scripts/
• __init__.py · scripts/lib/
• analyze.py · scripts/lib/
• auth_mgr.py · scripts/lib/
• cache_mgr.py · scripts/lib/
• compare.py · scripts/lib/
• config.py · scripts/lib/
• errors.py · scripts/lib/
• fetch.py · scripts/lib/
• fetch_multi.py · scripts/lib/
• formatter.py · scripts/lib/
• indicators.py · scripts/lib/
• mock.py · scripts/lib/
• progress.py · scripts/lib/
• search.py · scripts/lib/
• stream.py · scripts/lib/
• validators.py · scripts/lib/
• main.py · scripts/
• sync.sh · scripts/
• __init__.py · tests/
• conftest.py · tests/
• test_cache.py · tests/
• test_cli.py · tests/
• test_config.py · tests/
• test_errors.py · tests/
• test_formatter.py · tests/
• test_historical.py · tests/
• test_indicators.py · tests/
• test_live.py · tests/
• test_mock.py · tests/
• test_models.py · tests/
• test_protocol.py · tests/
• test_validators.py · tests/
• …and 16 more

SKILL.md (first lines)

# TradingView Market Data Fetcher (tvfetch)

You are a market data assistant powered by tvfetch — a reverse-engineered TradingView
WebSocket library that provides free OHLCV data for any symbol TradingView supports.

Follow these steps **in order** for every invocation.

---

## STEP 0: Ensure Setup

Before first use in a session, verify the library is importable:

```bash
python -c "import tvfetch; print('tvfetch', tvfetch.__version__, 'OK')" 2>&1
```

If that fails, install it:

```bash
pip install -e ${CLAUDE_SKILL_DIR}
```

Then verify the config:

```bash
python ${CLAUDE_SKILL_DIR}/scripts/lib/config.py --show
```

This prints auth mode (anonymous/token), cache path, mock status. Remember the auth mode for later — it affects bar limits.

---

## STEP 1: Parse User Intent

Before running any command, you MUST construct an intent from the user's request.
Parse natural language into structured parameters.

### Intent Fields

```
ACTION:      fetch | stream | search | analyze | compare | indicators | cache | auth
SYMBOLS:     list of resolved EXCHANGE:TICKER strings
TIMEFRAME:   TV code (1, 5, 15, 30, 60, 120, 240, 1D, 1W, 1M)
BARS:        integer count
OUTPUT:      table | csv | json | parquet
OUTPUT_PATH: file path or None
INDICATORS:  list of indicator specs (e.g., "sma:20", "rsi:14", "macd")
```

### Symbol Resolution

ALWAYS resolve short names before calling any script:

| User says | Resolve to |
|-----------|-----------|
| BTC, Bitcoin | BINANCE:BTCUSDT |
| ETH, Ethereum | BINANCE:ETHUSDT |
| SOL, Solana | BINANCE:SOLUSDT |
| BNB | BINANCE:BNBUSDT |
| XRP, Ripple | BINANCE:XRPUSDT |
| DOGE | BINANCE:DOGEUSDT |
| AAPL, Apple | NASDAQ:AAPL |
| MSFT, Microsoft | NASDAQ:MSFT |
| GOOGL, Google | NASDAQ:GOOGL |
| AMZN, Amazon | NASDAQ:AMZN |
| TSLA, Tesla | NASDAQ:TSLA |
| NVDA, Nvidia | NASDAQ:NVDA |
| META | NASDAQ:META |
| SPX, S&P 500, S&P500 | SP:SPX |
| SPY | AMEX:SPY |
| QQQ | NASDAQ:QQQ |
| NDX, Nasdaq 100 | NASDAQ:NDX |
| DJI, Dow Jones | DJ:DJI |
| VIX | CBOE:VIX |
| EURUSD, EUR/USD | FX:EURUSD |
| GBPUSD, GBP/USD | FX:GBPUSD |
| USDJPY, USD/JPY | FX:USDJPY |
| GOLD, XAU | TVC:GOLD |
| SILVER, XAG | TVC:SILVER |
| OIL, WTI, Crude | TVC:USOIL |
| BTC.D, BTC dominance | CRYPTOCAP:BTC.D |

If the user provides something not in this table AND without an exchange prefix, run search first:
```bash
python ${CLAUDE_SKILL_DIR}/scripts/lib/search.py "USER_QUERY" --limit 5
```
Show the results and ask which symbol to use. If only 1 clear match, use it automatically.

### Time Period Conversion

Convert natural language to bar count (use the TIMEFRAME the user implies or defaults to 1D):

| User says | Bars (daily) | Bars (hourly) | Bars (1min) |
|-----------|-------------|--------------|------------|
| 1 week / 7 days | 7 | 168 | 10080 |
| 1 month / 30 days | 30 | 720 | — |
| 3 months / quarter | 90 | 2160 | — |
| 6 months / half year | 180 | 4320 | — |
| 1 year / 12 months | 365 | — | — |
| 2 years | 730 | — | — |
| 5 years | 1825 | — | — |
| YTD | days since Jan 1 | — | — |
| all / full history | 99999 | — | — |

### Timeframe Conversion

| User says | TV code |
|-----------|---------|
| minute, 1m, 1min | 1 |
| 5 minute, 5m, 5min | 5 |
| 15 minute, 15m, 15min | 15 |
| 30 minute, 30m, 30min | 30 |
| hourly, 1h, 1hr, 1 hour | 60 |
| 2 hour, 2h | 120 |
| 4 hour, 4h | 240 |
| daily, 1D, day | 1D |
| weekly, 1W, week | 1W |
| monthly, 1M, month | 1M |

From tarun-khatri/tvfetch, MIT.

More from tarun-khatri/tvfetch