liberfi-io LiberFi Token Research
Search, analyze, and audit tokens across supported blockchains using the LiberFi CLI.
Pre-flight Checks
See bootstrap.md for CLI installation and connectivity verification.
This skill's auth requirements:
- All commands: No authentication required (public API)
Skill Routing
| If user asks about... | Route to |
|---|---|
| Trending tokens, top gainers, hot tokens | liberfi-market |
| Newly listed tokens, new launches | liberfi-market |
| Wallet holdings, balance, portfolio | liberfi-portfolio |
| Wallet PnL, trading stats | liberfi-portfolio |
| Swap, trade, buy, sell tokens | liberfi-swap |
| Transaction fees, gas estimation | liberfi-swap |
| Send / broadcast a transaction | liberfi-swap |
CLI Command Index
Query Commands
| Command | Description | Auth |
|---|---|---|
lfi token search --q <query> [--chains <chains>] [--limit <n>] |
Search tokens by keyword | No |
lfi token info <chain> <address> |
Get token details (price, MC, volume, supply) | No |
lfi token security <chain> <address> |
Run security audit (honeypot, mint, tax, proxy) | No |
lfi token pools <chain> <address> [--limit <n>] |
List DEX liquidity pools | No |
lfi token holders <chain> <address> [--limit <n>] |
List top token holders | No |
lfi token traders <chain> <address> [--tag <tag>] |
List top traders (default: smart money) | No |
lfi token candles <chain> <address> --resolution <res> |
Get K-line candlestick data | No |
Parameter Reference
Common pagination options (apply to search, pools, holders, traders):
--cursor <cursor>— Pagination cursor from previous response--limit <limit>— Max results per page--direction <direction>— Cursor direction:nextorprev
Candle-specific options:
--resolution <resolution>— Required. Values:1m,5m,15m,1h,4h,1d--price-type <type>— Price type--from <timestamp>— Start timestamp--to <timestamp>— End timestamp--limit <limit>— Max candles to return
Traders tag options: smart (default), kol, whale, insider
Operation Flow
Search for a Token
- Search:
lfi token search --q "bitcoin" --json - Present results: Show token name, symbol, chain, address, and price in a table
- Suggest next step: "Would you like to see details for any of these tokens?"
Get Token Details
- Fetch info:
lfi token info <chain> <address> --json - Present: Display name, symbol, price, market cap, volume, supply, FDV
- Suggest next step: "Want to check the security audit or see the liquidity pools?"
Run Security Audit
- Fetch security:
lfi token security <chain> <address> --json - Analyze result: Check for honeypot, mint risk, proxy contract, buy/sell tax
- Present risk summary: If any flags are raised, clearly warn the user with risk level
- Suggest next step: If safe — "Want to check the liquidity pools or get a swap quote?" / If risky — "This token has risk flags. Proceed with caution."
Analyze Token Holders
- Fetch holders:
lfi token holders <chain> <address> --json - Present: Show top holders with address (truncated), holding amount, percentage
- Highlight: Flag if top 10 holders control >50% supply (concentration risk)
- Suggest next step: "Want to see smart money traders for this token?"
View Smart Money Traders
- Fetch traders:
lfi token traders <chain> <address> --tag smart --json - Present: Show trader addresses, trade direction, amounts
- Suggest next step: "Want to check the K-line chart for entry timing?"
Get K-line / Price Chart Data
- Determine resolution: Ask user or infer from context (e.g. "last hour" →
1m, "last week" →1h, "last month" →1d) - Fetch candles:
lfi token candles <chain> <address> --resolution <res> --json - Present: Summarize price trend — open, close, high, low, volume
- Suggest next step: "Want to get a swap quote for this token?"
Cross-Skill Workflows
"Help me research this token before buying"
Full flow: token → token → token → swap
- token →
lfi token info <chain> <address> --json— Get price, market cap - token →
lfi token security <chain> <address> --json— Security audit - token →
lfi token holders <chain> <address> --json— Check holder concentration - token →
lfi token traders <chain> <address> --tag smart --json— Smart money activity - Present consolidated research report to user
- If user wants to buy → swap →
lfi swap quote ...
"What tokens are trending, and tell me about the top one"
Full flow: market → token → token
- market →
lfi ranking trending <chain> <duration> --json— Get trending list - token →
lfi token info <chain> <address> --json— Details on #1 token - token →
lfi token security <chain> <address> --json— Security audit - Present findings to user
"Check if this token in my wallet is safe"
Full flow: portfolio → token
- portfolio →
lfi wallet holdings <chain> <walletAddress> --json— Get holdings - User selects a token from holdings
- token →
lfi token security <chain> <tokenAddress> --json— Security check - Present security results
Suggest Next Steps
| Just completed | Suggest to user |
|---|---|
| Token search | "Want to see details for any of these tokens?" / "需要查看哪个代币的详情？" |
| Token info | "Want to check the security audit or liquidity pools?" / "需要查看安全审计或流动性池？" |
| Token security | "Want to see holders or smart money traders?" / "需要查看持有者或聪明钱交易者？" |
| Token pools | "Want to check the holder distribution?" / "需要查看持有者分布？" |
| Token holders | "Want to see smart money traders?" / "需要查看聪明钱交易者？" |
| Token traders | "Want to check the K-line chart?" / "需要查看K线走势？" |
| Token candles | "Want to get a swap quote?" / "需要获取兑换报价？" |
Edge Cases
- Token not found: If
token searchreturns empty, inform the user: "No tokens found for this keyword. Try a different name, symbol, or contract address." - Invalid chain or address: If the API returns a 400/404 error, ask the user to verify the chain name (e.g.
sol,eth,bsc) and the contract address format - Network timeout: Retry once after 3 seconds; if still fails, inform the user to check connectivity via
lfi ping --json - Empty holders / traders / pools: Clearly state "No data available" — do not leave the response blank
- Security audit unavailable: Some tokens may not have security data; inform the user that the audit is not available and recommend manual due diligence
- Rate limiting: If the API returns 429, wait the duration indicated and retry; inform the user of the delay
Security Notes
See security-policy.md for global security rules.
Skill-specific rules:
- Token security audits are informational only — they do not guarantee safety; always advise users to do their own research (DYOR)
- Never claim a token is "safe" based solely on the security audit passing — state findings factually
- If a token shows honeypot or high tax flags, proactively warn the user before they attempt any swap