Night shift: tweet analyzer, data connectors, feed monitor, market watch portal

tools/data_sources/README.md

@@ -0,0 +1,51 @@
+# Data Source Connectors
+
+Standalone Python scripts for fetching crypto/market data. Each has CLI with `--pretty` (JSON formatting) and `--summary` (human-readable output).
+
+## defillama.py ✅ (no auth needed)
+
+DefiLlama API — DeFi protocol data, token prices, yield farming opportunities.
+
+```bash
+./defillama.py protocols --limit 10 --summary    # Top protocols by TVL
+./defillama.py tvl aave --pretty                  # TVL for specific protocol
+./defillama.py prices coingecko:bitcoin coingecko:ethereum --summary
+./defillama.py yields --limit 20 --stablecoins --summary  # Top stablecoin yields
+```
+
+**Endpoints used:** api.llama.fi/protocols, api.llama.fi/tvl/{name}, coins.llama.fi/prices, yields.llama.fi/pools
+
+## coinglass.py 🔑 (API key recommended)
+
+Coinglass — funding rates, open interest, long/short ratios.
+
+```bash
+export COINGLASS_API_KEY=your_key  # Get at coinglass.com/pricing
+./coinglass.py funding --summary
+./coinglass.py oi --summary
+./coinglass.py long-short --summary
+```
+
+**Note:** Free internal API endpoints often return empty data. API key required for reliable access.
+
+## arkham.py 🔑 (API key required)
+
+Arkham Intelligence — whale wallet tracking, token transfers, entity search.
+
+```bash
+export ARKHAM_API_KEY=your_key  # Sign up at platform.arkhamintelligence.com
+./arkham.py notable --summary           # List known whale addresses
+./arkham.py address vitalik --summary   # Address intelligence (supports name shortcuts)
+./arkham.py transfers 0x1234... --limit 10 --pretty
+./arkham.py search "binance" --pretty
+```
+
+**Built-in shortcuts:** vitalik, justin-sun, binance-hot, coinbase-prime, aave-treasury, uniswap-deployer
+
+## Programmatic Usage
+
+```python
+from tools.data_sources.defillama import get_protocols, get_prices, get_yield_pools
+from tools.data_sources.coinglass import get_funding_rates
+from tools.data_sources.arkham import get_address_info, NOTABLE_ADDRESSES
+```