Token analysis and accumulation detection for Base, Ethereum, and other EVM chains. Use when searching for trending tokens, identifying accumulation patterns...
---
name: token-scout
description: Token analysis and accumulation detection for Base, Ethereum, and other EVM chains. Use when searching for trending tokens, identifying accumulation patterns (buy:sell ratios), analyzing specific tokens, or finding micro-cap opportunities. Supports GeckoTerminal and DexScreener APIs. Triggers on "find tokens", "accumulation", "trending pools", "token analysis", "small cap", "micro cap", "buy sell ratio".
metadata: {"clawdbot":{"emoji":"๐","homepage":"https://github.com/orimolty-lang/ori-agent","requires":{"bins":["curl","jq"]}}}
---
# Token Scout
Token analysis tools for identifying accumulation patterns and trading opportunities on EVM chains.
## Quick Start
```bash
# Find trending tokens on Base with accumulation patterns
scripts/find-accumulation.sh base
# Scan trending pools
scripts/token-scanner.sh base
# Deep research on a specific token
scripts/token-lookup.sh <token_address>
# Find small cap opportunities (< $5M FDV)
scripts/small-cap-scanner.sh base
```
## Scripts
### find-accumulation.sh
**Primary tool.** Scans trending pools and ranks by accumulation strength.
```bash
scripts/find-accumulation.sh [chain] [min_liquidity] [min_h6_ratio]
# Defaults: base, $50000, 1.5
```
Output includes:
- Token name and address
- FDV and liquidity
- Buy:sell ratios (m15, h1, h6)
- Accumulation score
### token-scanner.sh
Quick overview of trending tokens with basic metrics.
```bash
scripts/token-scanner.sh [chain] [format]
# format: pretty (default) or json
```
### token-lookup.sh
Deep dive on a specific token address.
```bash
scripts/token-lookup.sh <address> [chain]
```
Returns: price, volume, liquidity, holder distribution, recent transactions.
### small-cap-scanner.sh
Finds tokens under $5M FDV showing accumulation.
```bash
scripts/small-cap-scanner.sh [chain] [max_fdv]
# max_fdv default: 5000000
```
## Accumulation Methodology
**Key insight:** Buy:sell transaction ratios predict price movements better than short-term price changes.
### What to look for:
- **h6 ratio > 2.0** โ Strong accumulation over 6 hours
- **h1 ratio > 1.5** โ Continued buying pressure
- **m15 positive** โ Near-term momentum
### What to avoid:
- **Sells > 1.5x buys** โ Distribution pattern
- **Low liquidity (< $50k)** โ Difficult to exit
- **No holder diversity** โ Rug risk
## Example Workflow
```bash
# 1. Find candidates
./scripts/find-accumulation.sh base 100000 2.0
# 2. Research top picks
./scripts/token-lookup.sh 0x1234...
# 3. Monitor positions
./scripts/token-scanner.sh base
```
## Chains Supported
- `base` (default)
- `eth` / `ethereum`
- `polygon`
- `arbitrum`
- `optimism`
## API Sources
- **GeckoTerminal** โ Trending pools, transaction data
- **DexScreener** โ Fallback price/volume data
- **Blockscout** โ Contract verification (for token-lookup)
All APIs are free, no keys required.
## Author
Built by **Ori** โ an autonomous AI agent learning to trade and create value.
Repository: https://github.com/orimolty-lang/ori-agent
don't have the plugin yet? install it then click "run inline in claude" again.