From f7b9b2a034ae39600506c34ae72f514631ef272a Mon Sep 17 00:00:00 2001 From: comzzy-comzzy Date: Mon, 11 May 2026 10:17:38 +0200 Subject: [PATCH 1/4] [new-plugin] smart-tradex v1.0.0 --- .../smart-tradex/.claude-plugin/plugin.json | 10 ++ skills/smart-tradex/LICENSE | 21 +++ skills/smart-tradex/SKILL.md | 155 ++++++++++++++++++ skills/smart-tradex/plugin.yaml | 22 +++ 4 files changed, 208 insertions(+) create mode 100644 skills/smart-tradex/.claude-plugin/plugin.json create mode 100644 skills/smart-tradex/LICENSE create mode 100644 skills/smart-tradex/SKILL.md create mode 100644 skills/smart-tradex/plugin.yaml diff --git a/skills/smart-tradex/.claude-plugin/plugin.json b/skills/smart-tradex/.claude-plugin/plugin.json new file mode 100644 index 000000000..0b2078bb1 --- /dev/null +++ b/skills/smart-tradex/.claude-plugin/plugin.json @@ -0,0 +1,10 @@ +{ + "name": "smart-tradex", + "description": "AI-powered smart money copy trader with safety checks, stop-loss, and dry-run mode for Solana and X Layer", + "version": "1.0.0", + "author": { + "name": "Kane" + }, + "license": "MIT", + "keywords": ["trading", "copy-trade", "smart-money", "solana", "safety"] +} diff --git a/skills/smart-tradex/LICENSE b/skills/smart-tradex/LICENSE new file mode 100644 index 000000000..d2476529e --- /dev/null +++ b/skills/smart-tradex/LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2026 Kane + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/skills/smart-tradex/SKILL.md b/skills/smart-tradex/SKILL.md new file mode 100644 index 000000000..9aa5d113e --- /dev/null +++ b/skills/smart-tradex/SKILL.md @@ -0,0 +1,155 @@ +--- +name: smart-tradex +description: "AI-powered smart money copy trader with safety checks, stop-loss, and dry-run mode for Solana and X Layer" +version: "1.0.0" +author: "Kane" +tags: + - trading + - copy-trade + - smart-money + - solana + - safety + - stop-loss +--- + +# Smart-TradeX + +## Overview + +Smart-TradeX is an AI-powered copy trading skill that monitors smart money and whale wallet signals, performs automatic security checks on tokens before any trade, and executes copy trades on Solana and X Layer with built-in stop-loss protection. It always asks the user to confirm before executing any real transaction and supports a dry-run mode for safe testing without risking funds. + +## Risk Disclaimer + +This skill involves automated trading and carries financial risk. Never trade more than you can afford to lose. Always start with dry-run mode to understand the strategy before using real funds. The author is not responsible for any financial losses. + +## Pre-flight Checks + +Before using this skill, ensure: + +1. The onchainos CLI is installed and configured by running: npx skills add okx/onchainos-skills +2. Add onchainos to your PATH if not found: export PATH="$HOME/.local/bin:$PATH" +3. Your Agentic Wallet is set up and funded with the amount you want to trade +4. You have read the Risk Disclaimer above + +## Modes + +### Dry-Run Mode (Default - Recommended for beginners) +Simulates all trades without executing real transactions. Use this to test the strategy safely. + +### Live Mode +Executes real trades after user confirmation at every step. Never trades automatically without approval. + +## Commands + +### Step 1: Scan Smart Money Signals + +Fetch the latest smart money and whale wallet activity on Solana or X Layer. + +Run: onchainos signal list --chain solana +Or: onchainos signal list --chain xlayer + +When to use: Always run this first to identify what tokens smart money is buying. +Output: List of tokens being accumulated by top traders with wallet addresses and trade sizes. + +### Step 2: Check Token Security + +Before considering any trade, scan the token for rug pull risk and security issues. + +Run: onchainos security token-scan --address TOKEN_ADDRESS --chain solana + +When to use: Run this on every token found in Step 1 before proceeding. +Output: Security score, honeypot detection, liquidity lock status, contract risks. +Rules: +- If security score is below 70, STOP and warn the user. Do not proceed. +- If honeypot is detected, STOP immediately and warn the user. +- Only proceed if the token passes all critical checks. + +### Step 3: Get Token Market Data + +Run: onchainos market price --address TOKEN_ADDRESS --chain solana +Run: onchainos market kline --address TOKEN_ADDRESS --chain solana --interval 1H + +When to use: After the token passes security checks, analyze market conditions. +Output: Current price, 24h change, volume, price chart data. +Rules: +- If 24h price change is above +50%, warn the user the token may already be pumped. +- Present the data clearly to the user before asking for confirmation. + +### Step 4: Check Wallet Balance + +Run: onchainos wallet balance --chain solana +Run: onchainos portfolio all-balances --address WALLET_ADDRESS --chain solana + +When to use: Before every trade to confirm available balance. +Output: Available token balances across the wallet. + +### Step 5: Get Swap Quote + +Run: onchainos swap quote --from USDC --to TOKEN_ADDRESS --amount AMOUNT --chain solana + +When to use: After the user confirms they want to proceed with the trade. +Output: Expected output amount, price impact, swap route, fees. +Rules: +- If price impact is above 5%, warn the user strongly before proceeding. +- Always show the full quote details to the user. + +### Step 6: User Confirmation (Mandatory) + +Before executing any real trade, present a full summary to the user and ask for explicit confirmation. Only proceed if the user explicitly says yes. + +### Step 7: Execute Swap (Live Mode Only) + +Run: onchainos swap swap --from USDC --to TOKEN_ADDRESS --amount AMOUNT --chain solana --slippage 1 + +When to use: Only after explicit user confirmation in Step 6. +Output: Transaction hash, actual amount received, final price. +Important: Always save the entry price after execution for stop-loss monitoring. + +### Step 8: Monitor Position and Stop-Loss + +Run: onchainos market price --address TOKEN_ADDRESS --chain solana + +When to use: Periodically after a trade is executed. +Stop-loss logic: +- Default stop-loss is 15% below entry price +- If current price drops below stop-loss level, alert the user immediately +- Ask user if they want to exit the position +- Never automatically sell without user confirmation + +## Safety Rules + +1. Never execute a trade without explicit user confirmation +2. Never trade a token with a security score below 70 +3. Never trade a honeypot token under any circumstances +4. Always show price impact before confirming +5. Always set a stop-loss at entry (default 15%, configurable) +6. Never invest more than the user specifies +7. Always run in dry-run mode by default unless user switches to live mode +8. If any step fails or returns an error, stop the workflow and inform the user + +## Error Handling + +| Error | Cause | Resolution | +|-------|-------|------------| +| onchainos not found | CLI not installed | Run npx skills add okx/onchainos-skills | +| Token not found | Invalid token address | Ask user to verify the contract address | +| Insufficient balance | Not enough funds | Show current balance and ask user to top up | +| Security scan failed | API error | Retry once, if still failing skip that token | +| Price impact too high | Low liquidity | Warn user and suggest reducing trade amount | +| Rate limited | Too many requests | Wait 10 seconds and retry | +| Swap failed | Network or slippage issue | Inform user, suggest retrying with higher slippage | + +## Configuration Options + +- Chain: solana (default) or xlayer +- Mode: dry-run (default) or live +- Stop-loss: percentage below entry price (default 15%) +- Max trade amount: maximum USDC per trade (default 50 USDC) +- Min security score: minimum score to allow a trade (default 70) + +## Skill Routing + +- For wallet balances only, use okx-wallet-portfolio skill +- For token security only, use okx-security skill +- For simple swaps without copy trading, use okx-dex-swap skill +- For market data only, use okx-dex-market skill diff --git a/skills/smart-tradex/plugin.yaml b/skills/smart-tradex/plugin.yaml new file mode 100644 index 000000000..b8ac7db29 --- /dev/null +++ b/skills/smart-tradex/plugin.yaml @@ -0,0 +1,22 @@ +schema_version: 1 +name: smart-tradex +version: "1.0.0" +description: "AI-powered smart money copy trader with safety checks, stop-loss, and dry-run mode for Solana and X Layer" +author: + name: "Kane" + github: "comzzy-comzzy" +license: MIT +category: trading-strategy +tags: + - trading + - copy-trade + - smart-money + - solana + - safety + - stop-loss + +components: + skill: + dir: "." + +api_calls: [] From a52f172886103e527a3f341e4cde173ad57eb7c8 Mon Sep 17 00:00:00 2001 From: comzzy-comzzy Date: Mon, 11 May 2026 11:26:32 +0200 Subject: [PATCH 2/4] improve: add trigger keywords and negative triggers to SKILL.md --- skills/smart-tradex/SKILL.md | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) diff --git a/skills/smart-tradex/SKILL.md b/skills/smart-tradex/SKILL.md index 9aa5d113e..3475c1ca3 100644 --- a/skills/smart-tradex/SKILL.md +++ b/skills/smart-tradex/SKILL.md @@ -153,3 +153,30 @@ Stop-loss logic: - For token security only, use okx-security skill - For simple swaps without copy trading, use okx-dex-swap skill - For market data only, use okx-dex-market skill + +## Trigger Keywords + +The following phrases should activate this skill: + +- "copy trade" +- "follow smart money" +- "whale copy" +- "copy whale trades" +- "smart money signals" +- "follow whale wallet" +- "auto copy trade" +- "mirror trade" +- "copy successful traders" +- "trade like whales" +- "follow top traders" +- "smart tradex" +- "start copy trading" +- "find whale signals" +- "what are whales buying" + +## Do NOT trigger for + +- Simple token price checks (use okx-dex-market instead) +- Basic swaps without copy trading intent (use okx-dex-swap instead) +- Portfolio checks only (use okx-wallet-portfolio instead) +- Security scans only (use okx-security instead) From 49a005340cfdd2d3ab455c4ac5b9357924bf894a Mon Sep 17 00:00:00 2001 From: comzzy-comzzy Date: Mon, 11 May 2026 11:31:56 +0200 Subject: [PATCH 3/4] improve: add concrete examples and strengthen onchainOS usage documentation --- skills/smart-tradex/SKILL.md | 68 ++++++++++++++++++++++++++++++++++++ 1 file changed, 68 insertions(+) diff --git a/skills/smart-tradex/SKILL.md b/skills/smart-tradex/SKILL.md index 3475c1ca3..550fdf3ff 100644 --- a/skills/smart-tradex/SKILL.md +++ b/skills/smart-tradex/SKILL.md @@ -180,3 +180,71 @@ The following phrases should activate this skill: - Basic swaps without copy trading intent (use okx-dex-swap instead) - Portfolio checks only (use okx-wallet-portfolio instead) - Security scans only (use okx-security instead) + +## Concrete Examples + +### Example 1: Find and copy a whale trade on Solana + +Step 1 - Get signals: +onchainos signal list --chain solana + +Step 2 - Pick the top token from results, then scan it: +onchainos security token-scan --address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v --chain solana + +Step 3 - Check market data: +onchainos market price --address EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v --chain solana + +Step 4 - Check your balance: +onchainos wallet balance --chain solana + +Step 5 - Get swap quote for 20 USDC: +onchainos swap quote --from USDC --to EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v --amount 20 --chain solana + +Step 6 - Show summary and ask user to confirm +Step 7 - Execute after confirmation: +onchainos swap swap --from USDC --to EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v --amount 20 --chain solana --slippage 1 + +### Example 2: Dry-run mode on X Layer + +Step 1 - Get signals: +onchainos signal list --chain xlayer + +Step 2 - Security scan on top result: +onchainos security token-scan --address 0x74b7f16337b8972027f6196a17a631ac6de26d22 --chain xlayer + +Step 3 - Market data: +onchainos market price --address 0x74b7f16337b8972027f6196a17a631ac6de26d22 --chain xlayer + +Step 4 - Show [DRY-RUN] summary — no real trade executed +Step 5 - Show what the trade would have returned + +### Example 3: Stop-loss monitoring after a trade + +After executing a swap, monitor the position every 5 minutes: +onchainos market price --address TOKEN_ADDRESS --chain solana + +If price drops 15% below entry: +- Alert the user immediately +- Ask: "Price has dropped 15% below your entry. Do you want to exit this position? (yes/no)" +- Only sell if user confirms: +onchainos swap swap --from TOKEN_ADDRESS --to USDC --amount FULL_POSITION --chain solana --slippage 2 + +### Example 4: Check leaderboard for top traders to follow + +onchainos leaderboard list --chain solana +onchainos signal list --chain solana + +Use leaderboard to identify top performing wallets, then use signal list to see what those wallets are currently buying. + +## Why OnchainOS is the Core + +Every data point in Smart-TradeX comes from OnchainOS: +- Signal detection: onchainos signal +- Security verification: onchainos security +- Price and chart data: onchainos market +- Balance checks: onchainos wallet and onchainos portfolio +- Trade execution: onchainos swap +- Position monitoring: onchainos market +- Leaderboard tracking: onchainos leaderboard + +No external APIs are used. OnchainOS is the single source of truth for all data and all transactions in this skill. From a578a911f95b66cabd78e632a26a7c8add71cc39 Mon Sep 17 00:00:00 2001 From: comzzy-comzzy Date: Mon, 11 May 2026 11:47:19 +0200 Subject: [PATCH 4/4] improve: add output examples for every command --- skills/smart-tradex/SKILL.md | 84 ++++++++++++++++++++++++++++++++++++ 1 file changed, 84 insertions(+) diff --git a/skills/smart-tradex/SKILL.md b/skills/smart-tradex/SKILL.md index 550fdf3ff..54ce4855b 100644 --- a/skills/smart-tradex/SKILL.md +++ b/skills/smart-tradex/SKILL.md @@ -248,3 +248,87 @@ Every data point in Smart-TradeX comes from OnchainOS: - Leaderboard tracking: onchainos leaderboard No external APIs are used. OnchainOS is the single source of truth for all data and all transactions in this skill. + +## Command Output Examples + +### onchainos signal list --chain solana +Example output: +[ +{ +"tokenAddress": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", +"tokenSymbol": "BONK", +"buyCount": 12, +"totalBuyAmountUsd": "45000", +"topWallets": ["0xabc...", "0xdef..."], +"signalStrength": "strong" +} +] +What to do: Pick tokens with buyCount above 5 and signalStrength of "strong". + +### onchainos security token-scan --address TOKEN --chain solana +Example output: +{ +"securityScore": 85, +"isHoneypot": false, +"liquidityLocked": true, +"contractVerified": true, +"rugRisk": "low" +} +What to do: Only proceed if securityScore is above 70 and isHoneypot is false. + +### onchainos market price --address TOKEN --chain solana +Example output: +{ +"price": "0.00245", +"priceChange24h": "+12.5%", +"volume24h": "2500000", +"marketCap": "45000000" +} +What to do: Warn user if priceChange24h is above +50%. Present all data before asking for confirmation. + +### onchainos wallet balance --chain solana +Example output: +{ +"totalValueUsd": "150.00", +"tokens": [ +{"symbol": "USDC", "balance": "100.00"}, +{"symbol": "SOL", "balance": "0.5"} +] +} +What to do: Confirm user has enough USDC for the trade amount before proceeding. + +### onchainos swap quote --from USDC --to TOKEN --amount 20 --chain solana +Example output: +{ +"fromAmount": "20", +"fromToken": "USDC", +"toAmount": "8163.26", +"toToken": "BONK", +"priceImpact": "0.12%", +"route": "USDC -> SOL -> BONK", +"estimatedFee": "0.02 SOL" +} +What to do: Warn user if priceImpact is above 5%. Always show full quote before confirmation. + +### onchainos swap swap --from USDC --to TOKEN --amount 20 --chain solana --slippage 1 +Example output: +{ +"txHash": "5KtRk...", +"fromAmount": "20", +"toAmount": "8100.00", +"executedPrice": "0.00247", +"status": "success" +} +What to do: Save executedPrice as entry price for stop-loss monitoring. Show txHash to user as confirmation. + +### onchainos leaderboard list --chain solana +Example output: +[ +{ +"walletAddress": "7xKX...", +"pnl30d": "+245%", +"winRate": "78%", +"totalTrades": 156 +} +] +What to do: Use top wallets from leaderboard to cross-reference with signal list for stronger copy trade confidence.