liberfi-market

Original：🇺🇸 English

Translated

Discover trending tokens and newly listed tokens across supported blockchains: view trending token rankings by chain and time window, find newly launched tokens, filter by launchpad platform, sort by volume/price change/market cap, and search within rankings by keywords. Trigger words: trending, trending tokens, hot tokens, top tokens, top gainers, top losers, market overview, market trends, what's hot, what's trending, popular tokens, most traded, highest volume, biggest gainers, biggest movers, new tokens, new listings, newly listed, just launched, new coins, recent launches, launchpad, pump.fun, pump fun, new launch, discovery, discover tokens, explore, market scan, market watch, ranking, rankings, leaderboard, top chart, heat map, token rankings, performance ranking, best performing. Chinese: 趋势, 热门代币, 排行, 排行榜, 涨幅榜, 跌幅榜, 市场趋势, 什么在涨, 热门, 最热, 新币, 新上线, 刚上线, 新发行, 最近上线, 市场概览, 市场扫描, 发现代币, 探索. CRITICAL: Always use `--json` flag for structured output. CRITICAL: When showing rankings, display at least token name, symbol, price, and 24h change. Do NOT use this skill for: - Specific token details, security audit, holders, or K-line → use liberfi-token - Wallet holdings or portfolio analysis → use liberfi-portfolio - Swap quotes, trading, or transaction execution → use liberfi-swap Do NOT activate on vague inputs like "market" alone without context indicating the user wants rankings or new token discovery.

2installs

Sourceliberfi-io/liberfi-skills

Added on2026-03-29

NPX Install

npx skill4agent add liberfi-io/liberfi-skills liberfi-market

SKILL.md Content

View Translation Comparison →

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:
```
asc
```
or
```
desc
```
```
--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:
```
next
```
or
```
prev
```

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:
```
sol
```
chain,
```
24h
```
duration

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
```
--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

liberfi-market

NPX Install

Tags

SKILL.md Content

LiberFi Market Discovery

Pre-flight Checks

Skill Routing

CLI Command Index

Query Commands

Parameter Reference

Operation Flow

View Trending Tokens

View Trending with Filters

Discover New Tokens

Search Within Rankings

Cross-Skill Workflows

"Show me what's trending, and research the top token"

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

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

Suggest Next Steps

Edge Cases

Security Notes