52 lines
1.9 KiB
Markdown
52 lines
1.9 KiB
Markdown
# 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
|
|
```
|