workspace/tools/data_sources/README.md

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.

./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.

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.

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

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