Skills liberfi-portfolio

install
source · Clone the upstream repo
git clone https://github.com/openclaw/skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/bombmod/liberfi-portfolio" ~/.claude/skills/openclaw-skills-liberfi-portfolio && rm -rf "$T"
OpenClaw · Install into ~/.openclaw/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/skills/bombmod/liberfi-portfolio" ~/.openclaw/skills/openclaw-skills-liberfi-portfolio && rm -rf "$T"
manifest: skills/bombmod/liberfi-portfolio/SKILL.md
source content

LiberFi Portfolio Analysis

Analyze wallet holdings, transaction activity, PnL statistics, and net worth using the LiberFi CLI.

Supports two modes:

  • Public wallet (
    lfi wallet *
    ): Query any wallet address. No authentication required.
  • My TEE wallet (
    lfi me *
    ): Query the authenticated user's own LiberFi TEE wallet without specifying an address. Requires authentication.

Pre-flight Checks

See bootstrap.md for CLI installation and connectivity verification.

This skill's auth requirements:

Command groupRequires Auth
lfi wallet *
No (public API, uses on-chain data)
lfi me *
Yes (JWT, uses TEE wallet)

Authentication pre-flight for

me
commands:

  1. Run
    lfi status --json
  2. If not authenticated:
    • Agent:
      lfi login key --role AGENT --json
    • Human:
      lfi login <email> --json
      lfi verify <otpId> <code> --json
  3. Run
    lfi whoami --json
    to confirm wallet addresses

Skill Routing

If user asks about...Route to
Token search, price, details, securityliberfi-token
Token holders, smart money tradersliberfi-token
Token K-line, candlestick chartliberfi-token
Trending tokens, market rankingsliberfi-market
Newly listed tokensliberfi-market
Swap, trade, buy, sell tokensliberfi-swap
Transaction fees, gas estimationliberfi-swap

CLI Command Index

Public Wallet Commands (no auth, wallet address required)

CommandDescriptionAuth
lfi wallet holdings <chain> <address>
Get all token holdings with valuesNo
lfi wallet activity <chain> <address>
Get transaction activity historyNo
lfi wallet stats <chain> <address> [--resolution <window>]
Get PnL statisticsNo
lfi wallet net-worth <chain> <address>
Get total wallet net worthNo

My TEE Wallet Commands (auth required, no address needed)

CommandDescriptionAuth
lfi me holdings <chain>
Get holdings for the authenticated user's TEE walletYes
lfi me activity <chain>
Get transfer activity for the authenticated user's TEE walletYes
lfi me stats <chain> [--resolution <window>]
Get PnL statistics for the authenticated user's TEE walletYes
lfi me net-worth <chain>
Get total net worth for the authenticated user's TEE walletYes

Parameter Reference

Activity options (apply to both

wallet activity
and
me activity
):

  • --type <type>
    — Comma-separated transfer types to filter (e.g.
    buy,sell,transfer,add,remove
    )
  • --token-address <address>
    — Filter activity by specific token address
  • --cursor <cursor>
    — Pagination cursor
  • --limit <limit>
    — Max results per page
  • --direction <direction>
    — Cursor direction:
    next
    or
    prev

Stats options:

  • --resolution <resolution>
    — Time window:
    7d
    ,
    30d
    , or
    all
    • Default for
      wallet stats
      :
      all
    • Default for
      me stats
      :
      7d

Operation Flow

View Wallet Holdings (public)

  1. Collect inputs: Ask user for chain (e.g.
    sol
    ,
    eth
    ,
    bsc
    ) and wallet address if not provided
  2. Fetch holdings:
    lfi wallet holdings <chain> <address> --json
  3. Present: Show a table with Token, Amount, Value (USD), sorted by value descending
  4. Suggest next step: "Want to see your PnL stats or transaction history?"

View Transaction Activity (public)

  1. Collect inputs: Chain and wallet address
  2. Fetch activity:
    lfi wallet activity <chain> <address> --limit 20 --json
  3. Present: Show a table with Time, Type, Token, Amount, Tx Hash
  4. Suggest next step: "Want to filter by a specific token or check your overall PnL?"

Filter Activity by Token (public)

  1. Fetch filtered:
    lfi wallet activity <chain> <address> --token-address <tokenAddress> --limit 20 --json
  2. Present: Show filtered transaction list
  3. Suggest next step: "Want to check the details or security of this token?"

Check PnL Statistics (public)

  1. Determine time window: Ask user or default to
    all
    . Options:
    7d
    ,
    30d
    ,
    all
  2. Fetch stats:
    lfi wallet stats <chain> <address> --resolution <window> --json
  3. Present: Show PnL summary — total PnL, win rate, realized/unrealized P&L
  4. Suggest next step: "Want to see your current holdings or total net worth?"

Check Net Worth (public)

  1. Fetch net worth:
    lfi wallet net-worth <chain> <address> --json
  2. Present: Show total portfolio value in USD
  3. Suggest next step: "Want to see the breakdown by token?"

Full Portfolio Overview (public)

  1. Net worth:
    lfi wallet net-worth <chain> <address> --json
    → total value
  2. Holdings:
    lfi wallet holdings <chain> <address> --json
    → token breakdown
  3. Stats:
    lfi wallet stats <chain> <address> --json
    → PnL summary
  4. Present: Consolidated portfolio report with total value, top holdings, and PnL

View My Own TEE Wallet Portfolio (authenticated)

Use when the user wants to check their own LiberFi account without knowing the wallet address.

Authentication pre-flight:

lfi status --json
# If not authenticated:
lfi login key --role AGENT --json   # agent
# or: lfi login <email> --json → lfi verify <otpId> <code> --json
lfi whoami --json   # confirm evmAddress / solAddress
  1. Ask for chain: Which chain to check (e.g.
    sol
    for Solana,
    eth
    for Ethereum)
  2. Run all four in sequence:
    lfi me net-worth <chain> --json
    lfi me holdings <chain> --json
    lfi me stats <chain> --resolution 7d --json
    
  3. Present: Consolidated report — total value, top holdings, and 7d PnL summary
  4. Suggest next step: "Want to check trends or research any specific token?"

View My Activity (authenticated)

  1. Auth pre-flight:
    lfi status --json
    ; authenticate if needed
  2. Fetch:
    lfi me activity <chain> --limit 20 --json
  3. Present: Show Time, Type, Token, Amount, Tx Hash
  4. Suggest next step: "Want to filter by a specific token?"

Cross-Skill Workflows

"Check my wallet and tell me about my biggest holding"

Full flow: portfolio → token → token

  1. portfolio
    lfi wallet holdings <chain> <address> --json
    — Get all holdings
  2. Identify the largest holding by USD value
  3. token
    lfi token info <chain> <tokenAddress> --json
    — Get token details
  4. token
    lfi token security <chain> <tokenAddress> --json
    — Security audit
  5. Present findings: "Your largest holding is X, currently worth $Y"

"Show my recent trades and check if any tokens I hold are risky"

Full flow: portfolio → portfolio → token

  1. portfolio
    lfi wallet activity <chain> <address> --limit 10 --json
    — Recent activity
  2. portfolio
    lfi wallet holdings <chain> <address> --json
    — Current holdings
  3. For each held token: token
    lfi token security <chain> <tokenAddress> --json
  4. Present: Activity summary + risk flags for any held tokens

"What's my PnL this month, and what's trending that I should look at?"

Full flow: portfolio → market

  1. portfolio
    lfi wallet stats <chain> <address> --resolution 30d --json
    — Monthly PnL
  2. market
    lfi ranking trending <chain> 24h --limit 10 --json
    — Current trends
  3. Present: "Your 30d PnL is $X. Here are today's trending tokens you might consider."

"Check my own LiberFi wallet — I don't know my address"

Full flow: auth → portfolio (me commands)

  1. auth
    lfi status --json
    — Check session; if not authed →
    lfi login key --json
  2. auth
    lfi whoami --json
    — Confirm chain addresses
  3. portfolio
    lfi me holdings sol --json
    — Get Solana TEE wallet holdings
  4. portfolio
    lfi me stats sol --resolution 7d --json
    — 7d PnL
  5. portfolio
    lfi me net-worth sol --json
    — Total net worth
  6. Present consolidated report

"I just swapped — check my updated TEE wallet balance"

Full flow: swap (already done) → portfolio (me commands)

  1. auth
    lfi status --json
    — Confirm session still valid
  2. portfolio
    lfi me holdings <chain> --json
    — Updated holdings post-swap
  3. portfolio
    lfi me net-worth <chain> --json
    — Updated total value
  4. Present: Before vs after comparison if prior holdings are available

Suggest Next Steps

Just completedSuggest to user
Holdings view"Want to check your PnL or transaction history?" / "需要查看盈亏或交易记录?"
Activity list"Want to filter by token or check PnL stats?" / "需要按代币筛选或查看盈亏统计?"
PnL stats"Want to see your current holdings?" / "需要查看当前持仓?"
Net worth"Want to see the token breakdown?" / "需要查看各代币明细?"
Full overview"Want to research any specific token or check trends?" / "需要研究某个代币或查看趋势?"
Me holdings"Want to check your activity or PnL stats?" / "需要查看交易记录或盈亏统计?"
Me stats"Want to see your full holdings breakdown?" / "需要查看完整持仓明细?"

Edge Cases

  • Invalid wallet address: If the API returns 400/404, ask the user to verify the address format. Solana addresses are base58 (32–44 chars), EVM addresses are
    0x
    + 40 hex chars
  • Wallet not found / Empty wallet: Inform user: "This wallet has no token holdings on this chain. Verify the address and chain are correct."
  • No activity: Inform user: "No recent activity found for this wallet on this chain."
  • Network timeout: Retry once after 3 seconds; if still fails, suggest checking connectivity
  • Wrong chain for address: EVM addresses used with
    sol
    chain (or vice versa) will fail; detect the address format and suggest the correct chain
  • Large number of holdings: Default to top 20 by value; inform user if more exist and offer pagination
  • me
    command returns 401
    : Session expired; run
    lfi status --json
    , then re-authenticate
  • me
    command used without auth
    : Do not call
    lfi me *
    without first verifying authentication via
    lfi status --json

Security Notes

See security-policy.md for global security rules.

Skill-specific rules:

  • Public wallet data is public on-chain information — no privacy concern in querying any address
  • Never ask for or accept private keys or seed phrases — only public wallet addresses are needed for
    wallet *
    commands;
    me *
    commands require no address at all
  • When displaying wallet addresses provided by the user, confirm the address before querying to avoid mistakes
  • PnL data is historical and may not reflect real-time values — note this when presenting stats
  • me
    commands expose the authenticated user's TEE wallet data — only use after confirming the user intends to query their own account