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

CLI Command Index

Query Commands

Parameter Reference

Trending command:

• — Required. Chain identifier (e.g. sol, eth, bsc)
• — Required. Time window (e.g. 1h, 6h, 24h)
• --sort-by — Sort field (e.g. volume, price_change, market_cap)
• --sort-dir — Sort direction: asc or desc
• --filters — Comma-separated filters
• --launchpad-platform — Filter by launchpad (e.g. pump.fun)
• --search-keywords — Comma-separated search keywords
• --exclude-keywords — Comma-separated keywords to exclude
• --cursor — Pagination cursor
• --limit — Max results per page
• --direction — Cursor direction: next or prev

New tokens command — same options as trending except no argument.

Operation Flow

View Trending Tokens

1. Determine parameters: Ask user for chain and time window if not specified. Default: sol chain, 24h duration
2. Fetch trending: lfi ranking trending --limit 20 --json
3. Present results: Show a table with Name, Symbol, Price, Change (%), Volume, Market Cap
4. Suggest next step: "Want to see details or security audit for any of these tokens?"

View Trending with Filters

1. Collect filters: Launchpad platform, sort field, keywords
2. Fetch: lfi ranking trending sol 1h --launchpad-platform "pump.fun" --sort-by volume --sort-dir desc --limit 20 --json
3. Present: Filtered results in table format
4. Suggest next step: "Want to drill into any specific token?"

Discover New Tokens

1. Determine chain: Ask user if not specified. Default: sol
2. Fetch new tokens: lfi ranking new --limit 20 --json
3. Present: Show recently listed tokens with name, symbol, price, launch time
4. Suggest next step: "Want to check the security audit before investigating further?"

Search Within Rankings

1. Collect keywords: What the user is looking for
2. Fetch: lfi ranking trending --search-keywords "meme,dog" --limit 20 --json
3. Present: Filtered results matching the keywords
4. 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

1. market → lfi ranking trending sol 24h --sort-by volume --sort-dir desc --limit 10 --json
2. token → lfi token info sol --json — Details on #1 token
3. token → lfi token security sol --json — Security audit
4. token → lfi token holders sol --json — Holder analysis
5. Present consolidated findings

"Find new pump.fun tokens and check if the hottest one is safe"

> Full flow: market → token → token

1. market → lfi ranking new sol --launchpad-platform "pump.fun" --limit 10 --json
2. Pick the top token by volume
3. token → lfi token security sol
   --json — Security check
4. token → lfi token info sol
   --json — Full details
5. Present safety report

"What are the top gainers on ETH? I want to buy one"

> Full flow: market → token → swap

1. market → lfi ranking trending eth 24h --sort-by price_change --sort-dir desc --limit 10 --json
2. User selects a token
3. token → lfi token security eth
   --json — Mandatory security check
4. swap → lfi swap quote --in --out
   --amount --chain-family evm --chain-id 1 --json
5. Present quote and wait for user confirmation

Suggest Next Steps

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 --cursor and --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