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_ADDRESS"
```

### Phase 2: X/Twitter Research (most important phase)

```bash
# Search by ticker, CA, and project name
curl -s "https://api.twitterapi.io/twitter/tweet/advanced_search?query=\$TICKER&queryType=Latest" -H "X-API-Key: $TWITTERAPI_KEY"
curl -s "https://api.twitterapi.io/twitter/tweet/advanced_search?query=TOKEN_ADDRESS&queryType=Latest" -H "X-API-Key: $TWITTERAPI_KEY"

# Project account info + tweets
curl -s "https://api.twitterapi.io/twitter/user/info?userName=PROJECT_HANDLE" -H "X-API-Key: $TWITTERAPI_KEY"
curl -s "https://api.twitterapi.io/twitter/user/last_tweets?userName=PROJECT_HANDLE" -H "X-API-Key: $TWITTERAPI_KEY"

# KOL mentions
curl -s "https://api.twitterapi.io/twitter/tweet/advanced_search?query=\$TICKER%20min_faves:50&queryType=Top" -H "X-API-Key: $TWITTERAPI_KEY"

# Founder research (if found)
curl -s "https://api.twitterapi.io/twitter/user/info?userName=FOUNDER_HANDLE" -H "X-API-Key: $TWITTERAPI_KEY"
```

⚠️ **VERIFY dev claims from THEIR OWN ACCOUNT.** Never trust holder/community claims about dev endorsement. Search `from:DEV_HANDLE` for mentions of the token. If dev hasn't posted about it → flag as unconfirmed.

### Phase 3: Web Research
Search for: project website, team/founder background, news/partnerships, Reddit sentiment.

### Phase 4: Narrative Assessment

**Narrative Score (add to every report):**
- 🔥 **Strong** — Novel concept, viral potential, clear catalyst
- 🟡 **Moderate** — Decent angle but not unique, or good concept with weak execution
- 🧊 **Weak/None** — Generic, repetitive, no story → likely dumps to zero

Key questions: Is it novel? Would someone share it unprompted? Is the market tired of this category? Why hold beyond a flip?

Smart money wallet count + narrative quality are better predictors than contract safety.

### Phase 5: Risk Synthesis
Combine: narrative quality, smart money interest, contract security, holder concentration, team transparency, social proof (organic vs bots), liquidity depth, buy/sell ratio.

---

## SHALLOW DIVE

Run only: DexScreener + GoPlus + one Twitter search + basic web search.

---

## Batch Research (5+ Tokens)

1. Spawn parallel sub-agents for concurrent research
2. After filtering, **auto deep dive top 1-3 tokens** without waiting for user to ask
3. Save report to `reports/YYYY-MM-DD/[N]-token-analysis.md`
4. Auto-add top picks to monthly watchlist