Agent skill

Traderspy Smart Money

by sickn33 in sickn33/agentic-awesome-skills

Track what top crypto futures traders hold on Binance, Hyperliquid, Bybit and OKX with TraderSpy: elite leaderboard, positions, trader profiles and history.

MITAuto-check passedBusiness, Finance & HR

Install Traderspy Smart Money

skills CLI
$ npx skills add sickn33/agentic-awesome-skills --skill traderspy-smart-money -a claude-code

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

GitHub CLI
$ gh skill install sickn33/agentic-awesome-skills traderspy-smart-money --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/sickn33/agentic-awesome-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/traderspy-smart-money .claude/skills/traderspy-smart-money && 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
traderspy-smart-money
GitHub stars
47k
Used in
1 other repo
Token cost
~2.4k tokens
SKILL.md length
1,247 words
Files
2 (incl. references)
Skills in repo
1,497
Repo updated
First seen
Licence
MIT

At a glance

Track what top crypto futures traders hold on Binance, Hyperliquid, Bybit and OKX with TraderSpy: elite leaderboard, positions, trader profiles and history.

  • What are whales doing
  • SKILL.md covers When to Use, Tools, Reading the data and Workflows, plus 5 more sections
  • Reaches mcp.traderspy.app

What it does

Traderspy Smart Money is an agent skill from sickn33/agentic-awesome-skills. Track what top crypto futures traders hold on Binance, Hyperliquid, Bybit and OKX with TraderSpy: elite leaderboard, positions, trader profiles and history. Use for "what are whales doing".

Its SKILL.md is about 2.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/exchange-notes.md`).

It sits in Business, Finance & HR. It works with Hyperliquid, Binance and OKX. The repository describes itself as: AAS Core is the local, agent-first control plane for complete catalog discovery, agent-owned selection, stack validation, and planning, backed by 2,400+ agentic skills. Includes… The licence is MIT.

When your agent uses it

  • What are whales doing

Example prompts

  • “what are whales doing”
  • “/traderspy-smart-money”

What it can do on your machine

Read from SKILL.md and the folder at commit b84d35a. 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

    No scripts in the folder and no shell commands in SKILL.md.

    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:

    • mcp.traderspy.app

    Also links to:

    • traderspy.app

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

  • Credentials

    Names no API keys, tokens, secrets or passwords.

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

Context cost

Traderspy Smart Money loads about 2.4k tokens when it runs, and up to ~3k if it reads all its reference files. Until then it costs about 53 tokens; SKILL.md has 1,247 words of instructions outside code blocks.

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

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from sickn33/agentic-awesome-skills at commit b84d35a, republished under its MIT licence (© sickn33). 1,247 words, ~2,390 tokens.

Download SKILL.mdSave it as .claude/skills/traderspy-smart-money/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
traderspy-smart-money
description
Track what top crypto futures traders hold on Binance, Hyperliquid, Bybit and OKX with TraderSpy: elite leaderboard, positions, trader profiles and history. Use for "what are whales doing".
category
finance
risk
safe
source
https://github.com/target1m/traderspy-mcp/tree/069aae5a84640d671f92705a2e3bc0b62efca1e0/skills/smart-money
source_repo
target1m/traderspy-mcp
source_type
official
date_added
2026-09-25
author
target1m
tags
traderspy, crypto, smart-money, whale-tracking, mcp
tools
claude, cursor, gemini
license
MIT

TraderSpy Smart Money

TraderSpy follows thousands of top-ranked accounts on four exchanges and records their positions as they open, change and close. This skill turns that feed into answers about positioning and about individual traders. Positions are observations of what other people did with their own money — present them as evidence, never as instructions.

When to Use

  • Use when the user asks what whales or top traders are buying, shorting or holding, or whether big accounts are long or short a coin.
  • Use when the user asks who ranks highest on an exchange or across exchanges, or wants to research one trader's record and open positions.
  • Use for "smart money", "whale watch" or "what are the pros doing".
  • Not for funding rate, open interest or long/short ratios of the whole market (@traderspy-technical-analysis), and not for AI signals (@traderspy-trading-signals).

Tools

ToolUse it forKey arguments
get_elite_leaderboardThe cross-exchange top 10 by smart score, with the scoring rationalenone
get_top_tradersRanked traders per exchange and windowsource all / binance / hyperliquid / bybit / okx, timeRange 24h / 3D / 7D / 30D, rankingType ROI / PNL, sortBy ROI / PNL / SCORE, limit ≤ 200
get_positionsThe position feedstatus open / closed / all, source, symbol, limit ≤ 50, offset
get_trader_profileOne trader: metrics + latest positionstraderId AND source (see below), timeRange, rankingType
get_trader_position_historyOne trader's closed trades, pagedtraderId, source, page, limit ≤ 50
get_market_statsAggregate counts and PnL across all tracked positionssource, period 4h / 8h / 24h / 7d
get_exchangesWhich exchanges are currently trackednone

Always pass source with a trader id. get_trader_profile and get_trader_position_history default to Binance; a Hyperliquid address (0x…) or an OKX id looked up on the wrong exchange returns nothing. Take source from the row you got the id from.

Reading the data

Symbols differ per exchange. Hyperliquid rows use bare coins (BTC, ZEC) and prefix tokenized stocks with xyz: (xyz:AVGO); Binance, Bybit and OKX rows use BTCUSDT. When the user asks about "BTC positions", pass symbol: "BTC" — the filter matches both BTC and BTCUSDT exactly — and read the symbol field before summing anything. Tokenized stocks (xyz:AVGO) are not reachable through the filter; fetch without symbol and pick them out.

Position rows: side LONG / SHORT, size in coins, entryPrice, markPrice, leverage, unrealizedPnl (open rows) or pnl + roi (closed rows), openTime / closeTime, isOpen, lastEvent (increase, partial_close, or null when the last change was the open itself). Notional ≈ size × markPrice; use notional, not row count, when you say "whales are net long".

Freshness. Binance and Bybit snapshots refresh every 5–15 minutes, Hyperliquid every 15 minutes plus live fills, OKX every 10–60 minutes. On a free-tier key the feed is delayed 15 minutes — if get_positions returns nothing newer than that, say the feed is delayed rather than "no activity".

Leaderboard rows (get_top_traders) carry the exchange's own ranking snapshot: roi, pnl, assets (account size), winRate (null on Hyperliquid — the exchange does not publish it), rankings[] with the same trader across every window, and smartScore when TraderSpy has scored them. traderName is a shortened address when the account has no public name. A trader who is #1 on 30-day ROI with assets of $5k is a different animal from #19 with $3.4M — quote both.

Smart score (get_elite_leaderboard, 0–100, recomputed daily): realized PnL 30% (all-time blended with the last 30 days), effective win rate 22%, ROI edge 18%, consistency 14%, longevity 10%, trade depth 6%, plus a recency bonus (up to +9) and a staleness penalty (down to −12 after about three weeks idle). scoreBreakdown shows each part, rationale[] is a ready-made plain-language justification, metrics has the raw counts (closedTrades, profitFactor, realizedPnl30d, openPositionCount, worstDayPnl). reliabilityMultiplier below 1 means a short history dragged the score down — say so when a 6-day-old account ranks top-5.

Market stats aggregate every tracked position, thousands of them, so realizedPnl can be a large negative number even when the leaders are winning; the tracked universe includes traders who fell off the leaderboard. Use it for counts and the exchange split, not as "smart money is losing".

Show full SKILL.md (590 more words)Show less

Workflows

"What are whales doing in SOL?" → get_positions with symbol, status: open, limit 50. Sum notional by side, name the largest two or three accounts with entry and leverage, and note how recent the newest entries are. If open rows are few, add status: closed for the last day to show whether they have been exiting.

"Who are the best traders right now?" → get_elite_leaderboard first (it is cross-exchange and score-based), then get_top_traders for a specific exchange or window if the user wants raw ROI/PnL. Explain that 7-day ROI rankings reward one lucky week; the smart score is built to penalise exactly that.

"Should I copy trader X?" / "Research this trader" → get_trader_profile + one or two pages of get_trader_position_history. From the history compute what the user actually needs: win rate from closed rows, typical hold time (closeTime − openTime), typical leverage, how concentrated in one coin, worst single trade, and whether the recent month looks like the all-time record. Present it as a profile. Copying is the user's decision — this connector cannot follow anyone.

"Are the pros long or short?" (whole market) → get_positions status: open on the majors plus get_market_stats; for exchange-wide long/short ratios of ALL accounts use get_derivatives from technical-analysis instead, which answers that directly.

Presenting

Positions: one row per position —

| Trader | Exchange | Side | Size (notional) | Entry | Mark | Lev | uPnL | Opened |

Traders: name, exchange, score or rank, window, ROI, PnL, account size, win rate (or "n/a" on Hyperliquid), then the two-line rationale. Lead with the number that answers the question, keep addresses shortened as returned, and always say which window a ROI belongs to.

Conduct

  • Positions are what other traders did, with their capital, their hedges and their exits, which you cannot see in full. Present them as evidence about positioning, never as a recommendation to mirror them; a leader's long can be one leg of a hedge.
  • Past ROI and win rates describe a past sample — do not present a leaderboard as a forecast of who will win next. Point out short histories and small samples.
  • Nothing in this connector trades or copies. There is no order, follow, transfer or withdrawal tool, by design. If asked to copy or execute a trade, say so plainly; the decision and the trade stay with the user.
  • Quote only what the tools returned; say when data is delayed or a field is null.
  • When the answer is about a specific trade idea, end with one plain sentence that crypto derivatives are high-risk and this is market information, not financial advice.

For exchange-specific quirks and refresh cadences read references/exchange-notes.md.

Examples

text
What are the top traders long and short right now?
What are whales doing in SOL?
Who is at the top of the Hyperliquid leaderboard right now, and what are they positioned in? Then show me the position history of the top one.

Limitations

  • Needs the hosted TraderSpy MCP server connected in the client (https://mcp.traderspy.app/mcp, Streamable HTTP), authorized with OAuth or a personal key from https://traderspy.app/mcp. A free TraderSpy account is enough. Without the server the skill has no data to work from.
  • Tool calls are metered per day: 300 on the free tier, 5,000 on premium.
  • Every tool is read-only. Nothing here places, closes or modifies an order, and there is no withdrawal or transfer tool.
  • The output is market data and analysis for the user's own research, not investment advice.
  • On a free key, position rows are delayed 15 minutes. Leaderboards, profiles and stats are not delayed.
  • It sees only the accounts TraderSpy tracks on Binance, Hyperliquid, Bybit and OKX, not what the same traders hold elsewhere, so a tracked long can be one leg of a hedge.
  • @traderspy-technical-analysis (called technical-analysis in the text above, its upstream ID) - get_derivatives for exchange-wide funding, open interest and long/short ratios
  • @traderspy-trading-signals - AI signals rather than trader positions

© sickn33, 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 1 other file (references) in skills/traderspy-smart-money of sickn33/agentic-awesome-skills.

  • SKILL.md
  • references/exchange-notes.md

Open the folder on GitHubat commit b84d35a

Used in 1 other repository

We found 5 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in sickn33/agentic-awesome-skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Traderspy Smart Money 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.

Traderspy Smart Money compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Traderspy Smart Money this skillsickn33/agentic-awesome-skills47k1 repos~2.4kAutomated safety check: PassMIT
Fintoolsecond-state/fintool316—~5.9kAutomated safety check: PassNone
Hyperliquid Readerhimself65/finance-skills3.4k—~2.3kAutomated safety check: PassMIT
Trading Futuresalsk1992/CloddsBot3k—~5.6kAutomated safety check: PassMIT
ArbiscanLeoYeAI/openclaw-master-skills2.2k—~4.7kAutomated safety check: PassMIT
Heytraders APILeoYeAI/openclaw-master-skills2.2k—~4.2kAutomated safety check: PassMIT

Similar skills

  • Fintool

    second-state/fintool

    Financial trading CLIs — spot and perp trading on Hyperliquid, Binance, Coinbase, OKX.

    316 GitHub stars~5.9k tokensUpdated 4 mo ago
    Business, Finance & HRAuto-check passed
  • Hyperliquid Reader

    himself65/finance-skills

    Read Hyperliquid (app.hyperliquid.xyz) perp and spot market data through opencli and Hyperliquid's public info API: mark, oracle, and mid prices, 24h change, funding rates (hourly and annualized…

    3.4k GitHub stars~2.3k tokensUpdated 5 days ago
    Business, Finance & HRAuto-check passed
  • Trading Futures

    alsk1992/CloddsBot

    Trade perpetual futures on Binance, Bybit, Hyperliquid, MEXC with up to 200x leverage

    3k GitHub stars~5.6k tokensUpdated 7 days ago
    Business, Finance & HRAuto-check passed
  • Arbiscan

    LeoYeAI/openclaw-master-skills

    Comprehensive crypto market scanner across Binance, OKX, Bybit, and Bitget.

    2.2k GitHub stars~4.7k tokensUpdated 2 mo ago
    Business, Finance & HRAuto-check passed
  • Heytraders API

    LeoYeAI/openclaw-master-skills

    Trade crypto (Binance, Upbit, Hyperliquid, Lighter) and prediction markets (Polymarket).

    2.2k GitHub stars~4.2k tokensUpdated 2 mo ago
    Business, Finance & HRAuto-check passed
  • Okx Defi Invest

    nirholas/three.ws

    OKX-aggregated DeFi discovery and execution — for users who want OKX to find and route to the best protocol WITHOUT naming a specific DApp.

    229 GitHub stars~4.4k tokensUpdated today
    Business, Finance & HRAuto-check passed

More from sickn33/agentic-awesome-skills

All 1,497 skills in this repo
  • Liuguang Banlan UI

    sickn33/agentic-awesome-skills

    Implements an interface in one of two named color modes, iridescent white or colorful black, from a parameterized starter that reports measured color intensity.

    47k GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • User Thoughts Memory

    sickn33/agentic-awesome-skills

    Saves a user's project decisions, rules and preferences into a project-local mdbase so later sessions and other agents can recover the intent.

    47k GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • Using LWC Memory and Graphs

    sickn33/agentic-awesome-skills

    Keeps project decisions, research and verified results available across coding-agent sessions through LWC memory, a document Wiki graph and a CodeGraph code index.

    47k GitHub starsUsed in 1 repo~2k tokens
    Auto-check passed
  • Find Complementary Founders

    sickn33/agentic-awesome-skills

    Guides an agent through assessing its own owner for cofounder fit, publishing an approved profile, and ranking complementary profiles other agents published for their owners.

    47k GitHub starsUsed in 1 repo~4.8k tokens
    Auto-check passed
  • Whatsapp Cloud API

    sickn33/agentic-awesome-skills

    Integracao com WhatsApp Business Cloud API (Meta). An agent skill from sickn33/agentic-awesome-skills.

    47k GitHub starsUsed in 2 repos~4.5k tokens
    Auto-check passed
  • Cline Pilot

    sickn33/agentic-awesome-skills

    Acts as a proxy for the Cline CLI, dispatching coding tasks one at a time, monitoring runs by hard evidence, relaying decisions to you and learning per-project preferences.

    47k GitHub starsUsed in 1 repo~4.6k tokens
    Auto-check passed

Questions about Traderspy Smart Money

What does Traderspy Smart Money do?

Track what top crypto futures traders hold on Binance, Hyperliquid, Bybit and OKX with TraderSpy: elite leaderboard, positions, trader profiles and history. Traderspy Smart Money is an agent skill from sickn33/agentic-awesome-skills. Track what top crypto futures traders hold on Binance, Hyperliquid, Bybit and OKX with TraderSpy: elite leaderboard, positions, trader profiles and history.

When should I use Traderspy Smart Money?

Traderspy Smart Money fits situations like: what are whales doing.

How do I install Traderspy Smart Money in Claude Code?

Run `npx skills add sickn33/agentic-awesome-skills --skill traderspy-smart-money -a claude-code`. Or copy the skill folder (skills/traderspy-smart-money in sickn33/agentic-awesome-skills) into .claude/skills/traderspy-smart-money in your project. Claude Code loads it when a task matches its description.

How do I install Traderspy Smart Money in Codex?

Run `npx skills add sickn33/agentic-awesome-skills --skill traderspy-smart-money -a codex`. Or copy the skill folder (skills/traderspy-smart-money in sickn33/agentic-awesome-skills) into .agents/skills/traderspy-smart-money in your project. Codex loads it when a task matches its description.

Can I use Traderspy Smart Money 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 sickn33/agentic-awesome-skills --skill traderspy-smart-money -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/traderspy-smart-money, .gemini/skills/traderspy-smart-money, .github/skills/traderspy-smart-money and .opencode/skills/traderspy-smart-money in your project.

What does Traderspy Smart Money need to run?

SKILL.md names no scripts, command-line tools or credentials: Traderspy Smart Money is instructions for the agent only.

Does Traderspy Smart Money access the network?

SKILL.md names 2 domains. In commands or code: mcp.traderspy.app; the agent is likely to contact it when it follows the instructions. As links in the text: traderspy.app. This is read from the text; nothing was executed.

Is Traderspy Smart Money 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. Review the folder before installing.

What licence does Traderspy Smart Money use?

Traderspy Smart Money is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Traderspy Smart Money use?

About 2.4k tokens (SKILL.md is roughly 9.6k 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 631 tokens, read only when the agent opens those files.

What are the alternatives to Traderspy Smart Money?

Skills that share tags, products or a category with Traderspy Smart Money: Fintool (second-state/fintool, 316 stars), Hyperliquid Reader (himself65/finance-skills, 3.4k stars), Trading Futures (alsk1992/CloddsBot, 3k stars) and Arbiscan (LeoYeAI/openclaw-master-skills, 2.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Traderspy Smart Money?

sickn33 (a GitHub user) maintains it in sickn33/agentic-awesome-skills, which has 47,405 GitHub stars. The repository holds 1,497 skills in this directory. The repository was last updated on October 9, 2026.

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