LiberFi Market Discovery
Discover trending tokens and newly launched tokens 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 |
|---|---|
| Specific token info, price, security, holders | liberfi-token |
| Token K-line, candlestick, price chart | liberfi-token |
| Wallet holdings, balance, PnL | liberfi-portfolio |
| Wallet activity, transaction history | liberfi-portfolio |
| Swap, trade, buy, sell tokens | liberfi-swap |
| Transaction broadcast or fee estimation | liberfi-swap |
CLI Command Index
Query Commands
| Command | Description | Auth |
|---|---|---|
lfi ranking trending <chain> <duration> | Get trending tokens by chain and time window | No |
lfi ranking new <chain> | Get newly listed tokens on a chain | No |
Parameter Reference
Trending command:
<chain>— Required. Chain identifier (e.g.sol,eth,bsc)<duration>— Required. Time window (e.g.1h,6h,24h)--sort-by <field>— Sort field (e.g.volume,price_change,market_cap)--sort-dir <dir>— Sort direction:ascordesc--filters <filters>— Comma-separated filters--launchpad-platform <platform>— Filter by launchpad (e.g.pump.fun)--search-keywords <keywords>— Comma-separated search keywords--exclude-keywords <keywords>— Comma-separated keywords to exclude--cursor <cursor>— Pagination cursor--limit <limit>— Max results per page--direction <direction>— Cursor direction:nextorprev
New tokens command — same options as trending except no <duration> argument.
Operation Flow
View Trending Tokens
- Determine parameters: Ask user for chain and time window if not specified. Default:
solchain,24hduration - Fetch trending:
lfi ranking trending <chain> <duration> --limit 20 --json - Present results: Show a table with Name, Symbol, Price, Change (%), Volume, Market Cap
- Suggest next step: "Want to see details or security audit for any of these tokens?"
View Trending with Filters
- Collect filters: Launchpad platform, sort field, keywords
- Fetch:
lfi ranking trending sol 1h --launchpad-platform "pump.fun" --sort-by volume --sort-dir desc --limit 20 --json - Present: Filtered results in table format
- Suggest next step: "Want to drill into any specific token?"
Discover New Tokens
- Determine chain: Ask user if not specified. Default:
sol - Fetch new tokens:
lfi ranking new <chain> --limit 20 --json - Present: Show recently listed tokens with name, symbol, price, launch time
- Suggest next step: "Want to check the security audit before investigating further?"
Search Within Rankings
- Collect keywords: What the user is looking for
- Fetch:
lfi ranking trending <chain> <duration> --search-keywords "meme,dog" --limit 20 --json - Present: Filtered results matching the keywords
- Suggest next step: "Want to see details for any of these?"
Cross-Skill Workflows
"Show me what's trending, and research the top token"
Full flow: market → token → token → token
- market →
lfi ranking trending sol 24h --sort-by volume --sort-dir desc --limit 10 --json - token →
lfi token info sol <topTokenAddress> --json— Details on #1 token - token →
lfi token security sol <topTokenAddress> --json— Security audit - token →
lfi token holders sol <topTokenAddress> --json— Holder analysis - Present consolidated findings
"Find new pump.fun tokens and check if the hottest one is safe"
Full flow: market → token → token
- market →
lfi ranking new sol --launchpad-platform "pump.fun" --limit 10 --json - Pick the top token by volume
- token →
lfi token security sol <address> --json— Security check - token →
lfi token info sol <address> --json— Full details - Present safety report
"What are the top gainers on ETH? I want to buy one"
Full flow: market → token → swap
- market →
lfi ranking trending eth 24h --sort-by price_change --sort-dir desc --limit 10 --json - User selects a token
- token →
lfi token security eth <address> --json— Mandatory security check - swap →
lfi swap quote --in <inputToken> --out <address> --amount <amt> --chain-family evm --chain-id 1 --json - Present quote and wait for user confirmation
Suggest Next Steps
| Just completed | Suggest to user |
|---|---|
| Trending ranking | "Want to see details for any token?" / "需要查看某个代币的详情？" |
| New tokens list | "Want to check the security audit for any of these?" / "需要对其中某个做安全审计？" |
| Filtered ranking | "Want to drill into a specific token?" / "需要深入了解某个代币？" |
Edge Cases
- Invalid chain identifier: If the API returns an error, list supported chains (e.g.
sol,eth,bsc) and ask the user to choose - Invalid duration: Suggest valid durations:
1h,6h,24h - No trending results: Inform user: "No trending tokens found for this chain and time window. Try a different chain or longer duration."
- No new tokens: Inform user: "No newly listed tokens found. The chain may have low launch activity right now."
- Network timeout: Retry once after 3 seconds; if still fails, suggest checking connectivity via
lfi ping --json - Too many results: Default to
--limit 20; if user asks for more, paginate with--cursorand--direction next
Security Notes
See security-policy.md for global security rules.
Skill-specific rules:
- Trending and new token rankings are informational only — a token appearing in rankings does not indicate endorsement or safety
- Always recommend users run a security audit (
lfi token security) before interacting with newly discovered tokens - New tokens from launchpad platforms carry higher risk — proactively mention this when presenting results