| name | token-research |
| description | 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.
|
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.
