Real-time crypto market data, wallet portfolio tracking, and token analytics across 88+ blockchains. Use when the user wants to check any token price (by name, symbol, or contract address), look up wallet balances and holdings across all chains, get historical price data, track portfolio PnL, monitor whale wallets, find new tokens, or get oracle-grade pricing. Requires free API key from mobula.io.
Real-time crypto market data, wallet portfolio tracking, and token analytics across 88+ blockchains. Use when the user wants to check any token price (by name, symbol, or contract address), look up wallet balances and holdings across all chains, get historical price data, track portfolio PnL, monitor whale wallets, find new tokens, or get oracle-grade pricing. Requires free API key from mobula.io.
Real-time crypto market data, wallet tracking, and on-chain analytics across 88+ blockchains. Oracle-grade pricing trusted by Chainlink, Supra, and API3.
When to Use This Skill
USE WHEN the user:
Asks about any token price, volume, market cap, or price change
Wants to check a wallet's holdings or portfolio value
Needs historical price data for charts or analysis
Mentions a contract address and wants token info
Asks about tokens on specific chains (Base, Arbitrum, Solana, etc.)
Wants cross-chain portfolio overview
Needs batch data on multiple tokens at once
Asks about token liquidity, ATH, ATL, or trading volume
Wants to track whale wallets or monitor significant transactions
Needs to find new tokens matching specific criteria
DON'T USE WHEN:
User wants to execute trades (use bankr skill instead)
User wants DEX swap quotes (use defi skill)
User wants exchange-specific data (use okx/binance skills)
TOKEN Analysis
Price: $0.042 (down 8% 24h, up 156% 7d)
- Near 7d high, down from $0.051
- Still up 400% from 30d low
Fundamentals:
- Mcap: $2.1M (small cap, high risk/reward)
- Liquidity: $280K (decent for size)
- Volume: $1.2M 24h (healthy)
On-chain:
- Recent trades show buying pressure (3:1 buy/sell ratio)
- 2 large buys ($50K+) in last 2h
Project:
- Contract verified
- Active Twitter (12K followers)
Risk: Small cap, high volatility. Don't ape more than you can lose.
Response Formatting Guidelines
Prices
Always show direction: "up 12.4%" or "down 3.2%"
Include timeframe: "up 12.4% (24h)"
Add context: "Price $0.042 (up 12% 24h, down 8% from ATH)"
Large Numbers
Format clearly: "$1.23M", "$456K", "$45.6B"
Not: "$1234567"
Percentages
Use for allocations: "ETH: 42% of portfolio"
Use for changes: "down 15.3% in 24h"
Context is Key
Don't just say "price is $0.003"
Say: "Price $0.003 (down 8% 24h, down 65% from ATH of $0.089 on Dec 1st, but up 12% from 7d low)"
Common User Requests & How to Handle
"Set up alerts for [token]"
Acknowledge the request
Ask for specific conditions (price threshold? percentage move? volume spike?)
Confirm you'll monitor via heartbeat
Store the alert config in memory
Confirm: "I'll check [token] every 30min and alert you on [channel] if [condition]"
"Track this wallet"
Add wallet to monitoring list
Ask what to watch for:
All activity?
Only large trades (>$X)?
Specific tokens?
Store in memory
Confirm monitoring is active
"Find tokens matching [criteria]"
Clarify criteria:
Chains?
Market cap range?
Volume requirements?
Liquidity minimum?
Set up periodic checks (suggest 4-6h interval)
Ask how many results they want
Start monitoring on next heartbeat
"What's happening in crypto right now?"
Check major tokens (BTC, ETH, SOL, BNB) via mobula_market_multi
Identify any major moves (>5% in 24h)
Check volume leaders
Provide concise overview
Error Handling
API Key Issues
No key set: "I need a Mobula API key to fetch crypto data. Get one free at https://mobula.io then add it to your environment with export MOBULA_API_KEY='your_key'"
Invalid key: "Your API key seems invalid. Please check it at https://mobula.io"
Rate limited: "You've hit the API rate limit. Upgrade your plan at https://mobula.io for higher limits, or I'll retry in a few minutes."
Token Not Found
"I couldn't find that token by name. Could you provide the contract address? Or check the spelling?"
Suggest similar tokens if possible
Offer to search by contract address
Wallet Issues
Invalid address: "That doesn't look like a valid wallet address. Should be 0x... (42 characters) or an ENS name like vitalik.eth"
No activity: "This wallet has no activity or balance. Is this the correct address and chain?"
Rate Limits & Best Practices
Respect Rate Limits
Free tier: 100 requests/minute
Use mobula_market_multi for batch queries instead of multiple mobula_market_data calls
Cache data in memory when appropriate (metadata doesn't change often)
Efficient Heartbeat Usage
Don't call every endpoint on every heartbeat
Only fetch what's needed based on active monitoring tasks
Batch requests when possible
Store previous values to detect changes
Supported Blockchains
88+ chains including: Ethereum, Base, Arbitrum, Optimism, Polygon, BNB Chain, Avalanche, Solana, Fantom, Cronos, and many more.
