# 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
```