liberfi-token

Original：🇺🇸 English

Translated

Research and analyze tokens on supported blockchains: search tokens by keyword, get token details (price, market cap, volume, supply), run security audits (honeypot, mint risk, proxy, tax), list DEX liquidity pools, view top holders, find smart money traders, and retrieve K-line candlestick chart data. Trigger words: token, coin, search token, find token, look up token, token info, token details, token data, token price, price of, how much is, what is the price, market cap, market capitalization, volume, trading volume, supply, total supply, circulating supply, FDV, fully diluted valuation, token security, security audit, is it safe, honeypot, rug pull, mint risk, proxy contract, buy tax, sell tax, token pools, liquidity pools, DEX pools, trading pools, LP, liquidity, token holders, top holders, who holds, whale holders, holder distribution, token traders, smart money, smart traders, KOL traders, top traders, candles, candlestick, K-line, kline, price chart, price history, OHLCV, token analysis, token research, due diligence, DYOR, check token. Chinese: 代币, 搜索代币, 查代币, 代币信息, 代币详情, 代币价格, 价格多少, 市值, 交易量, 总供应量, 代币安全, 安全审计, 是否安全, 蜜罐, 貔貅, 池子, 流动性, 持有者, 大户, 鲸鱼, 交易者, 聪明钱, K线, 蜡烛图, 价格走势. CRITICAL: Always use `--json` flag for structured output. CRITICAL: When user asks about token safety, ALWAYS run `token security` — do not guess. Do NOT use this skill for: - Trending token rankings or new token discovery → use liberfi-market - Wallet holdings, activity, or PnL stats → use liberfi-portfolio - Swap quotes, trade execution, or transaction broadcast → use liberfi-swap - General market trends without a specific token → use liberfi-market Do NOT activate on vague single-word inputs like "token" or "coin" without additional context specifying a search query, chain, or address.

2installs

Sourceliberfi-io/liberfi-skills

Added on2026-03-29

NPX Install

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

SKILL.md Content

View Translation Comparison →

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

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

liberfi-token

NPX Install

Tags

SKILL.md Content

LiberFi Token Research

Pre-flight Checks

Skill Routing

CLI Command Index

Query Commands

Parameter Reference

Operation Flow

Search for a Token

Get Token Details

Run Security Audit

Analyze Token Holders

View Smart Money Traders

Get K-line / Price Chart Data

Cross-Skill Workflows

"Help me research this token before buying"

"What tokens are trending, and tell me about the top one"

"Check if this token in my wallet is safe"

Suggest Next Steps

Edge Cases

Security Notes