Agent skill

Wallet Profiling

by agiprolabs in agiprolabs/claude-trading-skills

Behavioral classification, performance analysis, and trading style detection for Solana wallets

MITAuto-check passedBusiness, Finance & HR

Install Wallet Profiling

skills CLI
$ npx skills add agiprolabs/claude-trading-skills --skill wallet-profiling -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install agiprolabs/claude-trading-skills wallet-profiling --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/agiprolabs/claude-trading-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/wallet-profiling .claude/skills/wallet-profiling && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
wallet-profiling
GitHub stars
410
Token cost
~2.3k tokens
SKILL.md length
922 words
Files
5 (incl. scripts, references)
Skills in repo
68
Repo updated
First seen
Licence
MIT

At a glance

Behavioral classification, performance analysis, and trading style detection for Solana wallets

  • Tasks that involve Trading and backtesting
  • SKILL.md covers Why Wallet Profiling Matters, Wallet Classification, Performance Metrics and Data Sources, plus 5 more sections
  • Runs Python scripts from its folder; calls uv; reaches data.solanatracker.io; needs ST_API_KEY

What it does

Wallet Profiling is an agent skill from agiprolabs/claude-trading-skills. Behavioral classification, performance analysis, and trading style detection for Solana wallets

Its SKILL.md is about 2.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including scripts and reference files (for example `references/classification_methods.md`, `references/performance_metrics.md` and `scripts/compare_wallets.py`).

It sits in Business, Finance & HR, covering Trading and backtesting. It works with Solana. The repository describes itself as: 68 trading, DeFi, and quantitative finance Agent Skills. Works with Claude Code, Cursor, Codex, Gemini CLI, and 30+ other tools. The licence is MIT.

When your agent uses it

  • Tasks that involve Trading and backtesting

Example prompts

  • “/wallet-profiling”

Requirements

  • Python 3
  • A credential in ST_API_KEY

What it can do on your machine

Read from SKILL.md and the folder at commit 981e1d7. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 2 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • uv

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • data.solanatracker.io

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • ST_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Wallet Profiling loads about 2.3k tokens when it runs, and up to ~6.7k if it reads all its reference files. Until then it costs about 28 tokens; SKILL.md has 922 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~28
When it runs · the whole SKILL.md, loaded when a task matches
~2.3k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~6.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from agiprolabs/claude-trading-skills at commit 981e1d7, republished under its MIT licence (© agiprolabs). 922 words, ~2,345 tokens.

Download SKILL.mdSave it as .claude/skills/wallet-profiling/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
wallet-profiling
description
Behavioral classification, performance analysis, and trading style detection for Solana wallets

Wallet Profiling

Behavioral classification, performance analysis, and trading style detection for Solana wallets. Profile any wallet to understand how it trades, how well it performs, and whether it is worth following.

Why Wallet Profiling Matters

Copy-Trade Evaluation

Before mirroring another wallet's trades, you need evidence that its historical performance is genuine, consistent, and not the result of a single lucky hit. Profiling quantifies win rate, profit factor, hold time, and consistency so you can make informed decisions about which wallets merit attention.

Smart Money Identification

Wallets that consistently buy tokens early and exit profitably are signal sources. Profiling separates genuinely skilled traders from lucky gamblers and wash-trading bots. Key differentiators: sustained profit factor above 2.0, win rates above 45% across 100+ trades, and diversified token selection.

Counterparty Analysis

When a large wallet enters a position you hold, understanding its historical behavior (sniper vs. holder, bot vs. human) helps you anticipate what will happen next. A sniper wallet buying suggests a quick dump is coming; a swing trader buying suggests multi-day conviction.

Risk Assessment

Token holder analysis benefits from knowing whether top holders are bots, snipers, or genuine investors. A token where 60% of holders are classified as snipers has very different risk characteristics than one held primarily by swing traders.

Wallet Classification

By Trading Style

Classification is based on the median hold time across all closed trades:

StyleMedian Hold TimeCharacteristics
Sniper< 5 minutesFirst-block buyers, MEV-adjacent, extremely fast exits
Scalper5 min – 1 hourQuick momentum trades, high frequency
Day Trader1 – 24 hoursIntraday positions, moderate frequency
Swing Trader1 – 7 daysMulti-day conviction holds
Position Holder> 7 daysLong-term accumulation, low frequency

See references/classification_methods.md for the full classification algorithm.

By Trade Size

Based on median trade size in SOL:

TierMedian Trade SizeTypical Behavior
Whale> 100 SOLMarket-moving entries, often front-run
Large10 – 100 SOLSignificant but not dominant
Medium1 – 10 SOLActive retail traders
Small< 1 SOLMicro-cap gamblers, new wallets
By Behavior Type
TypeDetection Method
BotLow inter-trade timing variance (CV < 0.3), uniform sizing
HumanVariable timing, variable sizing, session-based activity
MEVSandwich patterns, consistent small profits, high frequency
By Focus Area
FocusDetection Criteria
PumpFun Specialist> 70% of trades on PumpFun-launched tokens
DEX TraderPrimarily swaps on Raydium/Orca/Meteora
DeFi FarmerFrequent LP add/remove, staking operations
NFT TraderSignificant NFT marketplace interactions
Multi-StrategyNo single category exceeds 50%

Performance Metrics

Core Metrics

Win Rate — Percentage of trades that are profitable.

win_rate = count(pnl > 0) / count(all_closed_trades)

Minimum 30 trades for statistical significance. A 60% win rate across 200 trades is far more meaningful than 80% across 10 trades.

Average ROI Per Trade — Mean return across all closed positions.

avg_roi = mean((exit_value - entry_value) / entry_value)

Include all fees: platform fees, priority fees, and estimated slippage.

Profit Factor — Ratio of gross profits to gross losses.

profit_factor = sum(winning_pnl) / abs(sum(losing_pnl))

Interpretation: > 2.0 excellent, 1.5–2.0 good, 1.0–1.5 marginal, < 1.0 losing.

Total PnL — Cumulative profit/loss in SOL.

total_pnl = sum(all_trade_pnl)

Maximum Drawdown — Largest peak-to-trough decline in cumulative PnL curve.

drawdown = (peak_equity - trough_equity) / peak_equity

Sharpe-Like Ratio — Risk-adjusted return metric.

sharpe = mean(trade_returns) / std(trade_returns) * sqrt(trades_per_year)

See references/performance_metrics.md for detailed formulas, edge cases, and interpretation guidelines.

Activity Metrics
MetricCalculationWhat It Reveals
Trades per daytotal_trades / active_daysActivity level and capacity
Average hold timemean(exit_time - entry_time)Trading style confirmation
Token diversityunique_tokens / total_tradesSpecialization vs. diversification
Peak hoursmode(hour_of_trade)Session patterns, timezone hints
Activity streaksconsecutive active daysDedication and consistency

Data Sources

Show full SKILL.md (375 more words)Show less
SolanaTracker PnL API (Primary)

The SolanaTracker API provides pre-computed PnL data per wallet per token.

python
import httpx

url = f"https://data.solanatracker.io/pnl/{wallet_address}"
headers = {"x-api-key": os.getenv("ST_API_KEY")}
resp = httpx.get(url, headers=headers)
pnl_data = resp.json()

Response includes per-token: realized, unrealized, total_invested, total_sold, num_buys, num_sells, last_trade_time.

Helius Parsed Transactions (Detailed)

For granular transaction-level analysis, use the helius-api skill to fetch parsed transaction history. This provides exact timestamps, amounts, and program interactions.

Birdeye Trader Data

Birdeye's trader endpoints provide wallet-level analytics. See the birdeye-api skill for endpoint details.

DexScreener (Free Fallback)

DexScreener does not provide wallet-level PnL but can be used to validate token prices at trade timestamps.

Copy-Trade Evaluation Framework

Before following a wallet's trades, verify these criteria:

Minimum Requirements
  • Trade history: At least 50 closed trades (100+ preferred)
  • Time span: Active for at least 30 days
  • Consistent performance: Rolling 7-day win rate standard deviation < 15%
  • Reasonable sizing: No single trade > 20% of observed portfolio
  • Diverse tokens: At least 10 unique tokens traded
Green Flags
  • Profit factor > 1.8 sustained over 60+ days
  • Win rate 45–65% (unrealistically high rates suggest wash trading)
  • Moderate trade frequency (2–20 trades/day)
  • Mixed hold times indicating adaptive strategy
  • Gradual equity curve growth (not step-function jumps)
Red Flags
  • New wallet (< 14 days old): Possible sybil or one-hit-wonder
  • Single big win: One trade accounts for > 50% of total PnL
  • Declining performance: Last-30-day metrics significantly below all-time
  • Bot-like patterns: Uniform timing/sizing without proportional edge
  • Extreme win rate: > 80% often indicates small wins with catastrophic losses
  • Concentration: > 50% of PnL from a single token
  • Wash trading signals: Repeated buy/sell of same token with minimal price movement
Risk Score Calculation
python
risk_score = 0  # 0 = low risk, 100 = high risk

if wallet_age_days < 14:
    risk_score += 25
if top_trade_pnl_pct > 0.5:
    risk_score += 20
if recent_pf < historical_pf * 0.7:
    risk_score += 15
if bot_probability > 0.7:
    risk_score += 15
if win_rate > 0.8:
    risk_score += 10
if unique_tokens < 5:
    risk_score += 15

Integration with Other Skills

  • whale-tracking: Identify large wallets, then profile them here for behavioral context
  • token-holder-analysis: Profile top holders of a token to assess holder quality
  • solana-onchain: Fetch raw transaction data for deep-dive analysis
  • helius-api: Parsed transaction history for granular trade reconstruction
  • birdeye-api: Token price data for PnL validation

Quick Start

Profile a Single Wallet
python
# Set environment variables
# export WALLET_ADDRESS=YourTargetWallet...
# export ST_API_KEY=your_solanatracker_key  (optional)

python scripts/profile_wallet.py
# Or use demo mode:
python scripts/profile_wallet.py --demo
Compare Multiple Wallets
python
# export WALLET_ADDRESSES=Wallet1...,Wallet2...,Wallet3...
# export ST_API_KEY=your_solanatracker_key  (optional)

python scripts/compare_wallets.py
# Or use demo mode:
python scripts/compare_wallets.py --demo

Files

FileDescription
references/classification_methods.mdHold time, size, bot detection, and focus classification algorithms
references/performance_metrics.mdDetailed metric formulas, interpretation, edge cases, and decay detection
scripts/profile_wallet.pyProfile a single wallet: fetch data, compute metrics, classify, report
scripts/compare_wallets.pyCompare multiple wallets side-by-side with ranking

Dependencies

bash
uv pip install httpx

Environment Variables

VariableRequiredDescription
WALLET_ADDRESSFor profile_wallet.pySolana wallet address to profile
WALLET_ADDRESSESFor compare_wallets.pyComma-separated wallet addresses
ST_API_KEYNoSolanaTracker API key for PnL data

© agiprolabs, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files (scripts, references) in skills/wallet-profiling of agiprolabs/claude-trading-skills.

  • SKILL.md
  • references/classification_methods.md
  • references/performance_metrics.md
  • scripts/compare_wallets.py
  • scripts/profile_wallet.py

Open the folder on GitHubat commit 981e1d7

Compare with similar skills

Wallet Profiling next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Wallet Profiling compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Wallet Profiling this skillagiprolabs/claude-trading-skills410—~2.3kAutomated safety check: PassMIT
Drift SDKalsk1992/CloddsBot2.9k1 repos~625Automated safety check: PassMIT
Prismirfndi/prism-liquidity-agent122—~1.5kAutomated safety check: PassMIT
Solana Sniper Botnpc-live/clawfirm156—~913Automated safety check: NotesNone
Solana Payments Wallets Tradingnpc-live/clawfirm1561 repos~4.7kAutomated safety check: PassMIT
Gmgn PortfolioGMGNAI/gmgn-skills604—~5.8kAutomated safety check: NotesMIT

Similar skills

  • Drift SDK

    alsk1992/CloddsBot

    Drift Protocol perpetual futures trading on Solana (direct SDK)

    2.9k GitHub starsUsed in 1 repo~625 tokens
    Business, Finance & HRAuto-check passed
  • Prism

    irfndi/prism-liquidity-agent

    Operate Prism, an autonomous Solana DLMM liquidity agent for Meteora pools.

    122 GitHub stars~1.5k tokensUpdated 10 days ago
    Business, Finance & HRAuto-check passed
  • Solana Sniper Bot

    npc-live/clawfirm

    Autonomous Solana token sniper and trading bot. An agent skill from npc-live/clawfirm.

    156 GitHub stars~913 tokensUpdated 3 mo ago
    Business, Finance & HRAuto-check: notes
  • Pay people in SOL or USDC, buy and sell tokens, check prices, discover trending and new tokens, create and manage Solana wallets, stake SOL, earn yield through lending and managed vaults, borrow…

    156 GitHub starsUsed in 1 repo~4.7k tokens
    Business, Finance & HRAuto-check passed
  • Gmgn Portfolio

    GMGNAI/gmgn-skills

    Analyze one or many crypto wallets by address — holdings, batch realized/unrealized P&L, win rate, trading history, performance stats, specific token balance, and tokens created by a developer…

    604 GitHub stars~5.8k tokensUpdated 10 days ago
    Business, Finance & HRAuto-check: notes
  • Trading Signal

    binance/binance-skills-hub

    Per-trade smart-money signals — each result is a discrete buy or sell event from a tracked smart-money wallet, with trigger price, current price, max gain since trigger, and exit rate.

    1.1k GitHub stars~682 tokensUpdated 27 days ago
    Business, Finance & HRAuto-check passed

More from agiprolabs/claude-trading-skills

All 68 skills in this repo
  • Backtrader

    agiprolabs/claude-trading-skills

    Event-driven backtesting with bar-by-bar execution, complex order types, multiple analyzers, and custom indicators

    410 GitHub stars~2.4k tokensUpdated 1 mo ago
    Auto-check passed
  • Birdeye API

    agiprolabs/claude-trading-skills

    Solana token market data via Birdeye — prices, OHLCV, trades, token metadata, security checks, and trader activity

    410 GitHub stars~1.8k tokensUpdated 1 mo ago
    Auto-check passed
  • Coingecko API

    agiprolabs/claude-trading-skills

    Broad crypto market data from CoinGecko covering 13,000+ tokens.

    410 GitHub stars~1.6k tokensUpdated 1 mo ago
    Auto-check passed
  • Cointegration Analysis

    agiprolabs/claude-trading-skills

    Cointegration testing for pairs trading using Engle-Granger, Johansen, and rolling stability analysis

    410 GitHub stars~2.1k tokensUpdated 1 mo ago
    Auto-check passed
  • Copy Trading

    agiprolabs/claude-trading-skills

    Wallet evaluation, monitoring, and copy-trade strategy design for Solana DEX trading

    410 GitHub stars~2.4k tokensUpdated 1 mo ago
    Auto-check passed
  • Correlation Analysis

    agiprolabs/claude-trading-skills

    Cross-asset correlation analysis including rolling correlation, hierarchical clustering, tail dependence, and regime-dependent correlation

    410 GitHub stars~2.4k tokensUpdated 1 mo ago
    Auto-check passed

Works with

Questions about Wallet Profiling

What does Wallet Profiling do?

Behavioral classification, performance analysis, and trading style detection for Solana wallets. Wallet Profiling is an agent skill from agiprolabs/claude-trading-skills.

When should I use Wallet Profiling?

Wallet Profiling fits situations like: tasks that involve Trading and backtesting.

How do I install Wallet Profiling in Claude Code?

Run `npx skills add agiprolabs/claude-trading-skills --skill wallet-profiling -a claude-code`. Or copy the skill folder (skills/wallet-profiling in agiprolabs/claude-trading-skills) into .claude/skills/wallet-profiling in your project. Claude Code loads it when a task matches its description.

How do I install Wallet Profiling in Codex?

Run `npx skills add agiprolabs/claude-trading-skills --skill wallet-profiling -a codex`. Or copy the skill folder (skills/wallet-profiling in agiprolabs/claude-trading-skills) into .agents/skills/wallet-profiling in your project. Codex loads it when a task matches its description.

Can I use Wallet Profiling in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add agiprolabs/claude-trading-skills --skill wallet-profiling -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/wallet-profiling, .gemini/skills/wallet-profiling, .github/skills/wallet-profiling and .opencode/skills/wallet-profiling in your project.

What does Wallet Profiling need to run?

Going by SKILL.md and its folder, Wallet Profiling needs Python for the scripts in its folder, the command-line tools its instructions call (uv) and credentials named ST_API_KEY. Our summary lists: Python 3; A credential in ST_API_KEY.

Does Wallet Profiling access the network?

SKILL.md names 1 domain. In commands or code: data.solanatracker.io; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Wallet Profiling safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Wallet Profiling use?

Wallet Profiling is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Wallet Profiling use?

About 2.3k tokens (SKILL.md is roughly 9.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 4.3k tokens, read only when the agent opens those files.

What are the alternatives to Wallet Profiling?

Skills that share tags, products or a category with Wallet Profiling: Drift SDK (alsk1992/CloddsBot, 2.9k stars), Prism (irfndi/prism-liquidity-agent, 122 stars), Solana Sniper Bot (npc-live/clawfirm, 156 stars) and Solana Payments Wallets Trading (npc-live/clawfirm, 156 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Wallet Profiling?

agiprolabs (a GitHub user) maintains it in agiprolabs/claude-trading-skills, which has 410 GitHub stars. The repository holds 68 skills in this directory. The repository was last updated on September 3, 2026.

Source: agiprolabs/claude-trading-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.