| name | token-research |
| description | Comprehensive token research for EVM chains (Base, ETH, Arbitrum) and Solana. Use this skill when you want to research crypto tokens, deep-dive projects or monitor tokens. |
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.
- 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 )
- Send a DM to your owner with full analysis
- 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:
- Search
$TICKER and project name (Latest + Top)
- Check the project's Twitter account: tweets, bio, what they're building
- 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
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)
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"
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"
curl -s "https://api.twitterapi.io/twitter/tweet/advanced_search?query=\$TICKER%20min_faves:50&queryType=Top" -H "X-API-Key: $TWITTERAPI_KEY"
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)
- Spawn parallel sub-agents for concurrent research
- After filtering, auto deep dive top 1-3 tokens without waiting for user to ask
- Save report to
reports/YYYY-MM-DD/[N]-token-analysis.md
- Auto-add top picks to monthly watchlist
