token-research

This skill is a comprehensive token research for EVM chains (Base, ETH, Arbitrum) and Solana. Two modes: **deep_research** and **shallow_dive**.

## MANDATORY: CALL Owner FOR WATCH OR APE TOKENS

**ANY token rated WATCH 🟡 or APE 🟢 → IMMEDIATELY call your owner + send Telegram/discord/whatsapp DM. NO EXCEPTIONS.**

1. Run `~/workspace/scripts/ape-call.sh "WATCH/APE alert: $TICKER at $MCAPk mcap, $VOLk volume. [1-line reason]"` ( or call normally if there's no script )
2. Send a DM to your owner with full analysis
3. Do BOTH — call AND message. Every time.

**DO NOT:** say "if owner were awake", filter out tokens because "pure meme" or "no narrative", or process alerts without calling.

## MANDATORY: ALWAYS RESEARCH ON X/TWITTER — SKIP PURE MEMES

**For EVERY token, before giving a verdict, check X/Twitter:**
1. Search `$TICKER` and project name (Latest + Top)
2. Check the project's Twitter account: tweets, bio, what they're building
3. Look for a PRODUCT (website, GitHub, app, protocol)

**IMPORTANT:** use the 'x-research' skill to search on X.

**If the product is real, CALL your owner regardless of chart action.** Bad charts on real products = buying opportunity, not a skip.

**Pure memes = AVOID by default.** Only exception: volume 10x+ the batch average.

## Reports & Watchlist

**Reports:** `reports/YYYY-MM-DD/[report-name].md`
**Watchlist:** `watchlists/YYYY-MM/watchlist.md`

### Watchlist Rules
- After any research, if token has real product/team or unique narrative → append to watchlist
- Tiers: **Tier 1** (strongest), **Tier 2** (good signal, higher risk), **Tier 3** (speculative)
- Each entry: token, chain, CA, entry MC, current MC, catalyst, status (🟢🟡🔴)
- APPEND only — never overwrite. Update status when new data comes in.

---

## DEEP RESEARCH

### Phase 1: Token Fundamentals
```bash
curl -s "https://api.dexscreener.com/latest/dex/tokens/CHAIN/TOKEN_ADDRESS"
curl -s "https://api.gopluslabs.io/api/v1/token_security/CHAIN_ID?contract_addresses=TOKEN_...

# 🔍 Token Research Skill

A comprehensive cryptocurrency token research framework supporting both quick assessments and deep analysis across multiple blockchains.

## Files Overview

- **`SKILL.md`** - Complete skill documentation with research templates
- **`fetch_token_data.sh`** - Automated data collection script  
- **`api_reference.md`** - Quick API commands and examples
- **`example_usage.md`** - Step-by-step usage examples
- **`README.md`** - This overview file

## Quick Start

### 1. Shallow Dive (5 minutes)
```bash
./fetch_token_data.sh shallow 0x6982508145454ce325ddbe47a25d4ec3d2311933 ethereum
```

### 2. Deep Research (15-20 minutes)
```bash
./fetch_token_data.sh deep 0x6982508145454ce325ddbe47a25d4ec3d2311933 ethereum
```

### 3. Manual Analysis
Follow the templates in `SKILL.md` for social sentiment and community research using web_search.

## Supported Chains

| Chain | ID | Example Address |
|-------|----| ---------------|
| Ethereum | 1 | 0x6982508145454ce325ddbe47a25d4ec3d2311933 |
| Base | 8453 | 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 |
| BSC | 56 | 0x... |
| Arbitrum | 42161 | 0x... |
| Solana | solana | So11111111111111111111111111111111111111112 |

## APIs Used

- **DexScreener** - Price, liquidity, volume data
- **GoPlus Security** - Token security analysis
- **Etherscan/Basescan** - On-chain data and holder analysis
- **Web Search** - Social sentiment and project research

## Research Modes

### Shallow Dive
Perfect for quick screening:
- ✅ Token basics & price
- ✅ Security check
- ✅ Top 3 holders
- ✅ Social narrative search

### Deep Research  
Comprehensive analysis:
- ✅ Complete fundamentals
- ✅ Holder distribution analysis
- ✅ Team/founder research
- ✅ Community sentiment analysis
- ✅ Risk assessment
- ✅ Market analysis

## Research Output

Both modes generate structured reports with:
- Token fundamentals
- Price and market data
- Security assessment
- Holder analysis
- Risk evaluation
- Investment thesis

## Important Note...