Skip to content

jeremylongshore/tons-of-skills-marketplace / plugins/crypto/on-chain-analytics/skills/analyzing-on-chain-data

analyzing-on-chain-data

Verified

Process perform on-chain analysis including whale tracking, token flows, and network activity. Use when performing crypto analysis. Trigger with phrases like "analyze crypto", "check blockchain", or "monitor market".

FileKindSize
ARD.mdmarkdown7.1 KB
PRD.mdmarkdown2.2 KB
SKILL.mdskill md5.7 KB
config/settings.yamlconfig1.1 KB
references/errors.mdmarkdown2.0 KB
references/examples.mdmarkdown3.3 KB
references/implementation.mdmarkdown1.5 KB
scripts/data_fetcher.pyscript7.6 KB
scripts/formatters.pyscript6.1 KB
scripts/metrics_calculator.pyscript7.6 KB
scripts/onchain_analytics.pyscript10.2 KB

references/errors.md

View on GitHub
# Error Handling Reference

## API Errors

### DeFiLlama API Timeout

```
Error: Request timeout
```

**Cause:** DeFiLlama API slow or unreachable
**Solution:**

1. Wait and retry (service usually recovers quickly)
2. Check  for outages
3. Use cached data if available

### Invalid Protocol Name

```
Error: Protocol not found: invalid-name
```

**Cause:** Protocol slug doesn't match DeFiLlama database
**Solution:**

1. Check protocol list: `python onchain_analytics.py protocols`
2. Use exact slug from DeFiLlama (case-sensitive)
3. Search by partial name in protocol list

### Empty Response

```
Error: No data returned for query
```

**Cause:** Filter too restrictive or data unavailable
**Solution:**

1. Remove filters and retry
2. Check if category/chain exists
3. Try broader time range

## Data Quality Issues

### Missing TVL Data

```
Warning: TVL data unavailable for some protocols
```

**Cause:** New protocols or data collection gaps
**Solution:**

1. Check DeFiLlama directly for protocol
2. Data usually available within 24h of listing

### Stale Data

```
Warning: Data may be stale (last updated: X hours ago)
```

**Cause:** Cache not refreshed
**Solution:**

1. Clear cache: `rm ~/.onchain_analytics_cache.json`
2. Use `--verbose` to see cache status

## Output Issues

### Large Output Truncated

```
[Showing top 50 of 1000+ protocols]
```

**Solution:** Use `--limit` flag or `--format json` for full data

### Encoding Errors

```
UnicodeEncodeError: ...
```

**Solution:**

1. Use `--format json`
2. Set `LANG=en_US.UTF-8`

## Recovery Strategies

### Clear Cache

```bash
rm ~/.onchain_analytics_cache.json
```

### Verbose Mode for Debugging

```bash
python onchain_analytics.py protocols --verbose
```

### Fallback to JSON

If table output fails:

```bash
python onchain_analytics.py protocols --format json > output.json
```

---
*[Tons of Skills](https://tonsofskills.com) by [Intent Solutions](https://intentsolutions.io) | [jeremylongshore.com](https://jeremylongshore.com)*
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 196kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 196kUpdated Claude CodeCodexVerifiedInstall