token-research
Comprehensive token analysis combining price, market cap, unlock schedule, DeFi deposits, and yield opportunities. Use when the user asks to analyze a token, research a token, check token fundamentals, or wants full token intelligence including vesting and DeFi usage.
Best use case
token-research is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Comprehensive token analysis combining price, market cap, unlock schedule, DeFi deposits, and yield opportunities. Use when the user asks to analyze a token, research a token, check token fundamentals, or wants full token intelligence including vesting and DeFi usage.
Teams using token-research should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/defillama-official-token-research/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How token-research Compares
| Feature / Agent | token-research | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Comprehensive token analysis combining price, market cap, unlock schedule, DeFi deposits, and yield opportunities. Use when the user asks to analyze a token, research a token, check token fundamentals, or wants full token intelligence including vesting and DeFi usage.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
Related Guides
AI Agent for Product Research
Browse AI agent skills for product research, competitive analysis, customer discovery, and structured product decision support.
AI Agent for SaaS Idea Validation
Use AI agent skills for SaaS idea validation, market research, customer discovery, competitor analysis, and documenting startup hypotheses.
SKILL.md Source
# Token Research Perform end-to-end token analysis by combining price data, unlock schedules, DeFi deposit tracking, yield opportunities, and protocol fundamentals. ## Workflow ### Step 1 - Resolve the token entity Get the canonical token identifier (coingecko:xxx format). ``` defillama:resolve_entity entity_type: "token" name: "<user-provided name>" ``` ### Step 2 - Price and market data Fetch current price, market cap, volume, and ATH. ``` defillama:get_token_prices token: "<coingecko:token_id>" ``` Key fields: `price`, `mcap`, `volume`, `price_ath`. Distance from ATH can be computed as `(price_ath - price) / price_ath`. ### Step 3 - Unlock schedule Check vesting and upcoming token unlocks that may create sell pressure. ``` defillama:get_token_unlocks token: "<token_name>" ``` Flag any large unlocks in the next 30 days as potential sell pressure. ### Step 4 - DeFi deposits See where the token is deposited across DeFi protocols. ``` defillama:get_token_tvl token: "<coingecko:token_id>" ``` Uses `dim.token_set()` for family resolution (e.g., `coingecko:ethereum` matches ETH, wETH, stETH, etc.). The `component` param filters by TVL type (base, borrowed, staking, pool2, treasury, vesting). Quality filters (`is_distressed`, `has_misrepresented_tokens`) are applied. This shows which protocols hold the most of this token, indicating DeFi demand and utility. ### Step 5 - Yield opportunities Find pools where users can earn yield on this token. ``` defillama:get_yield_pools token: "<coingecko:token_id>" ``` The `token` param expects canonical keys (e.g., `coingecko:ethereum`). Uses `dim.pool_set()` for family matching. ### Step 6 - Protocol fundamentals (if applicable) If the token belongs to a DeFi protocol, fetch protocol metrics. ``` defillama:get_protocol_metrics protocol: "<protocol_slug>" ``` ## Output Format Present the report with these sections in order: 1. **Price & Market** - Current price, market cap, 24h volume, distance from ATH, and recent trend. 2. **Unlock Schedule** - Upcoming unlocks with dates, amounts, and percentage of circulating supply. Highlight any cliff unlocks. 3. **DeFi Deposits** - Top protocols holding this token, total value deposited, and what this implies about utility. 4. **Yield Opportunities** - Top 3-5 pools by APY and TVL where users can deploy this token. 5. **Protocol Fundamentals** - If the token is a protocol governance or utility token, include TVL, fees, revenue, and valuation ratios. ## Tips - Large unlocks (>2% of circulating supply) within 30 days are a material risk factor. - High DeFi deposits relative to circulating supply indicate strong holder conviction and reduced liquid supply. - Compare yield APY sources: base APY from fees is sustainable, reward APY from token emissions is not. - If the token has no unlock data, it may be fully unlocked or the data may not be tracked - note this to the user. - Use `start_date` / `end_date` for custom date ranges on price and TVL queries.
Related Skills
okx-dex-token
Use this skill for token-level data: cluster overview, search tokens, trending/hot tokens (热门, 代币榜单), liquidity pools, holder distribution (whale/巨鲸, sniper, bundler percent), token safety and honeypot risk (貔貅盘, 'is this token a honeypot', 'is this safe to buy', 'rugged?', 'can I sell this'), who created a token, recent buy/sell activity, top profit addresses, trade history by wallet type, or holder cluster analysis (持仓集中度, rug pull probability/跑路风险, new wallet percentage/新钱包持仓比例, suspicious holding percentage/可疑持仓%, bundle hold percent, holder clusters, 'are top holders in same cluster'). Invoke on user intent; address can be provided after. Do NOT use for market-wide whale/signal tracking — use okx-dex-signal. Do NOT use for meme/pump.fun launch scanning, dev reputation, or bundle detection — use okx-dex-trenches. Do NOT use for personal DEX trade history or price charts — use okx-dex-market.
query-token-info
Query token details by keyword, contract address, or chain. Search tokens, get metadata and social links, retrieve real-time market data (price, price trend, volume, holders, liquidity), and fetch K-Line candlestick charts. Use this skill when users search tokens, check token prices, view market data, or request kline/candlestick charts.
query-token-audit
Query token security audit to detect scams, honeypots, and malicious contracts before trading. Returns comprehensive security analysis including contract risks, trading risks, and scam detection. Use when users ask "is this token safe?", "check token security", "audit token", or before any swap.
tokr-tokenization-agent
Tokenization agent for the ERC-8004 ecosystem that automates token creation through on-chain feedback and matched token launches.
pay-with-any-token
Pay HTTP 402 payment challenges using tokens via the Tempo CLI and Uniswap Trading API. Use when the user encounters a 402 Payment Required response, needs to fulfill a machine payment, mentions "MPP", "Tempo payment", "pay for API access", "HTTP 402", "x402", "machine payment protocol", "pay-with-any-token", "use tempo", "tempo request", or "tempo wallet".
tokr-tokenization
Tokenization agent for ERC-8004 ecosystem automating token creation through on-chain feedback matching.
token-revoke-mcp
Check and revoke ERC-20 token allowances to secure wallets. Scan for risky unlimited approvals and generate revocation transactions.
rocketpool-tokens
Interact with Rocket Pool token contracts — RPL (governance/staking token) ERC-20 operations, inflation mechanics, old RPL swap, rocketVault balance queries, and L2 token addresses for rETH and RPL on Arbitrum, Optimism, Base, Polygon, zkSync Era, Scroll, Starknet, and Unichain. Supports cast (Foundry CLI) and Ethereum MCP tools on mainnet and Hoodi testnet.
hedera-token-mint
Create and manage tokens on Hedera (HTS). Use for: (1) Minting fungible tokens, (2) Creating NFTs (HTS), (3) Setting up token supplies, (4) Configuring token permissions.
x402-token-sentiment
X/Twitter sentiment analysis API with x402 USDC micropayments on Base at 0.10 USDC per query.
token-unlock-tracker
Query token vesting schedules and upcoming unlock events across the market.
token-unlock-scheduler
Monitor vesting schedules, upcoming unlocks, and token distribution timelines.