Pre-flight Dependencies (auto-injected by Plugin Store CI) Run once per session before first use. These checks ensure required tools are installed. Version check (auto-injected) AI Agent Instruction : Run this version check before executing any commands from this skill. The check is a read-only fetch from — it does not install anything. If it reports , you MUST stop, surface the message to the user verbatim, and obtain explicit confirmation before running the suggested command. Do not run the update silently. After a confirmed update completes, re-read this SKILL.md before proceeding. Install…

+n.toExponential(2);return n\u003c1?'

Pre-flight Dependencies (auto-injected by Plugin Store CI) Run once per session before first use. These checks ensure required tools are installed. Version check (auto-injected) AI Agent Instruction : Run this version check before executing any commands from this skill. The check is a read-only fetch from — it does not install anything. If it reports , you MUST stop, surface the message to the user verbatim, and obtain explicit confirmation before running the suggested command. Do not run the update silently. After a confirmed update completes, re-read this SKILL.md before proceeding. Install…

+n.toFixed(6):'

Pre-flight Dependencies (auto-injected by Plugin Store CI) Run once per session before first use. These checks ensure required tools are installed. Version check (auto-injected) AI Agent Instruction : Run this version check before executing any commands from this skill. The check is a read-only fetch from — it does not install anything. If it reports , you MUST stop, surface the message to the user verbatim, and obtain explicit confirmation before running the suggested command. Do not run the update silently. After a confirmed update completes, re-read this SKILL.md before proceeding. Install…

+n.toLocaleString(undefined,{maximumFractionDigits:2})}\nfunction fk(v){const n=parseFloat(v);if(!n)return '$0';return n>=1e6?'

Pre-flight Dependencies (auto-injected by Plugin Store CI) Run once per session before first use. These checks ensure required tools are installed. Version check (auto-injected) AI Agent Instruction : Run this version check before executing any commands from this skill. The check is a read-only fetch from — it does not install anything. If it reports , you MUST stop, surface the message to the user verbatim, and obtain explicit confirmation before running the suggested command. Do not run the update silently. After a confirmed update completes, re-read this SKILL.md before proceeding. Install…

+(n/1e6).toFixed(1)+'M':'

Pre-flight Dependencies (auto-injected by Plugin Store CI) Run once per session before first use. These checks ensure required tools are installed. Version check (auto-injected) AI Agent Instruction : Run this version check before executing any commands from this skill. The check is a read-only fetch from — it does not install anything. If it reports , you MUST stop, surface the message to the user verbatim, and obtain explicit confirmation before running the suggested command. Do not run the update silently. After a confirmed update completes, re-read this SKILL.md before proceeding. Install…

+(n/1000).toFixed(1)+'k'}\nfunction ftime(ts){return new Date(ts).toLocaleTimeString('en-US',{hour12:false})}\n\nfunction copyAddr(){\n const a=document.getElementById('wallet-addr').title;\n if(a)navigator.clipboard.writeText(a);\n}\n\nasync function doStart(){try{await fetch(API+'/api/start',{method:'POST'})}catch(e){}}\nasync function doStop(){try{await fetch(API+'/api/stop',{method:'POST'})}catch(e){}}\nasync function setMode(m){\n try{\n const r=await fetch(API+'/api/mode',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({mode:m})});\n const d=await r.json();if(!d.ok)alert(d.msg);\n }catch(e){}\n}\nasync function doReset(){\n if(!confirm('Confirm clear all data? Positions, trade history, and logs will be reset.'))return;\n try{const r=await fetch(API+'/api/reset',{method:'POST'});const d=await r.json();alert(d.msg)}catch(e){}\n}\n\nfunction render(s){\n if(!s)return;\n state=s;\n const on=s.running;\n const mode=s.mode||'paper';\n\n // Status\n const dot=document.getElementById('status-dot');\n dot.className='dot '+(on?'on':'off');\n document.getElementById('status-text').textContent=on?'Running':'Stopped';\n\n // Mode buttons\n const bp=document.getElementById('btn-paper'),bl=document.getElementById('btn-live');\n bp.disabled=on;bl.disabled=on;\n bp.className=mode==='paper'?'active-paper':'';\n bl.className=mode==='live'?'active-live':'';\n\n // Start/Stop\n document.getElementById('btn-start').style.display=on?'none':'';\n document.getElementById('btn-stop').style.display=on?'':'none';\n document.getElementById('btn-reset').disabled=on;\n\n // Wallet\n const wb=document.getElementById('wallet-box');\n if(mode==='live'&&s.wallet){\n wb.style.display='';\n const wa=document.getElementById('wallet-addr');\n wa.textContent=s.wallet.slice(0,4)+'...'+s.wallet.slice(-4);\n wa.title=s.wallet;\n document.getElementById('wallet-bal').textContent=(s.solBalance!=null?s.solBalance.toFixed(4):'—')+' SOL';\n }else{wb.style.display='none'}\n\n // Stats\n const sells=(s.trades||[]).filter(t=>t.direction==='sell');\n const total=sells.reduce((a,t)=>a+parseFloat(t.pnlSol||0),0);\n const todayStr=new Date().toDateString();\n const todayS=sells.filter(t=>new Date(t.timestamp).toDateString()===todayStr);\n const todayP=todayS.reduce((a,t)=>a+parseFloat(t.pnlSol||0),0);\n const w=todayS.filter(t=>parseFloat(t.pnlSol||0)>=0).length;\n const wr=todayS.length?((w/todayS.length)*100).toFixed(1)+'%':'—';\n\n const st=document.getElementById('s-total');st.textContent=fp(total,' SOL');st.className='stat-value '+pc(total);\n const sy=document.getElementById('s-today');sy.textContent=fp(todayP,' SOL');sy.className='stat-value '+pc(todayP);\n document.getElementById('s-wr').textContent=wr;\n document.getElementById('s-pos').textContent=(s.positionsCount??0)+' / '+(s.maxPositions??5);\n\n // Positions\n const pb=document.getElementById('pos-body');\n const pos=s.positions||[];\n if(!pos.length){pb.innerHTML='\u003cdiv class=\"empty\">No positions\u003c/div>'}\n else{\n let h='\u003ctable>\u003cthead>\u003ctr>\u003cth>Token\u003c/th>\u003cth class=\"text-right\">Buy Price\u003c/th>\u003cth class=\"text-right\">Current Price\u003c/th>\u003cth class=\"text-right\">PnL%\u003c/th>\u003cth class=\"text-right\">Time\u003c/th>\u003cth>Trigger\u003c/th>\u003c/tr>\u003c/thead>\u003ctbody>';\n pos.forEach(p=>{\n const bp=parseFloat(p.buyPrice),cp=parseFloat(p.lastCheckPrice),pnl=bp>0?((cp-bp)/bp)*100:0,m=Math.floor((Date.now()-p.buyTimestamp)/60000);\n h+=`\u003ctr>\u003ctd class=\"bold\">${p.tokenSymbol}\u003c/td>\u003ctd class=\"text-right sub\">${f$(bp)}\u003c/td>\u003ctd class=\"text-right\">${f$(cp)}\u003c/td>\u003ctd class=\"text-right bold ${pc(pnl)}\">${fp(pnl)}\u003c/td>\u003ctd class=\"text-right sub\">${m}m\u003c/td>\u003ctd class=\"sub\" style=\"font-size:10px\">${p.triggerReason||''}\u003c/td>\u003c/tr>`;\n });\n h+='\u003c/tbody>\u003c/table>';pb.innerHTML=h;\n }\n\n // Trades\n const tb=document.getElementById('trades-body');\n const tr2=(s.trades||[]).slice(-20).reverse();\n if(!tr2.length){tb.innerHTML='\u003cdiv class=\"empty\">No trades\u003c/div>'}\n else{\n let h='\u003ctable>\u003cthead>\u003ctr>\u003cth>Time\u003c/th>\u003cth>Direction\u003c/th>\u003cth>Token\u003c/th>\u003cth class=\"text-right\">Amount\u003c/th>\u003cth class=\"text-right\">PnL\u003c/th>\u003cth>Reason\u003c/th>\u003c/tr>\u003c/thead>\u003ctbody>';\n tr2.forEach(t=>{\n const dc=t.direction==='buy'?'green':'red';\n h+=`\u003ctr>\u003ctd class=\"sub\">${ftime(t.timestamp)}\u003c/td>\u003ctd class=\"bold ${dc}\">${t.direction.toUpperCase()}\u003c/td>\u003ctd class=\"bold\">${t.tokenSymbol}\u003c/td>\u003ctd class=\"text-right\">${parseFloat(t.amountSol).toFixed(4)}\u003c/td>\u003ctd class=\"text-right ${pc(t.pnlPercent)}\">${t.direction==='sell'?fp(t.pnlPercent):'—'}\u003c/td>\u003ctd class=\"sub\" style=\"max-width:100px;overflow:hidden;text-overflow:ellipsis\">${t.reason}\u003c/td>\u003c/tr>`;\n });\n h+='\u003c/tbody>\u003c/table>';tb.innerHTML=h;\n }\n\n // Roster\n const rb=document.getElementById('roster-body');\n const ro=s.roster||[];\n if(!ro.length){rb.innerHTML='\u003cdiv class=\"empty\">No ranking data\u003c/div>'}\n else{\n let h='\u003ctable>\u003cthead>\u003ctr>\u003cth>#\u003c/th>\u003cth>Token\u003c/th>\u003cth class=\"text-right\">Change%\u003c/th>\u003cth class=\"text-right\">Liquidity\u003c/th>\u003cth class=\"text-right\">Market Cap\u003c/th>\u003c/tr>\u003c/thead>\u003ctbody>';\n ro.forEach((t,i)=>{\n const chg=parseFloat(t.change||0);\n h+=`\u003ctr>\u003ctd class=\"sub\">${i+1}\u003c/td>\u003ctd class=\"bold\">${t.tokenSymbol}\u003c/td>\u003ctd class=\"text-right ${chg>=0?'green':'red'}\">${chg.toFixed(1)}%\u003c/td>\u003ctd class=\"text-right sub\">${fk(t.liquidity)}\u003c/td>\u003ctd class=\"text-right sub\">${fk(t.marketCap)}\u003c/td>\u003c/tr>`;\n });\n h+='\u003c/tbody>\u003c/table>';rb.innerHTML=h;\n }\n\n // Logs\n const lb=document.getElementById('logs-body');\n const lg=s.logs||[];\n if(!lg.length){lb.innerHTML='\u003cdiv class=\"empty\">No logs\u003c/div>'}\n else{\n const tc={BUY:'green',SELL:'red',SKIP:'sub',SAFETY_REJECT:'warn',HOLDER_REJECT:'warn',RANK_EXIT:'red',LIVE_BUY:'green',ENGINE:'',PASS:'green',ERROR:'red',WARN:'warn',CONFIRMED:'green',BUY_UNCONFIRMED:'warn',UNCONFIRMED:'sub',UNCONFIRMED_EXPIRED:'red',AUDIT:'sub',RECONCILE:'sub'};\n let h='';\n [...lg].reverse().forEach(l=>{\n const cls=tc[l.type]||'sub';\n h+=`\u003cdiv class=\"log-entry\">\u003cspan class=\"log-time\">${ftime(l.ts)}\u003c/span>\u003cspan class=\"log-type ${cls}\">${l.type}\u003c/span>\u003cspan class=\"log-msg\">${l.msg}\u003c/span>\u003c/div>`;\n });\n lb.innerHTML=h;\n }\n}\n\n// Poll\nasync function poll(){\n try{\n const r=await fetch(API+'/api/state');\n const d=await r.json();\n render(d);\n }catch(e){}\n}\npoll();\nsetInterval(poll,3000);\n\u003c/script>\n\u003c/body>\n\u003c/html>\n","content_type":"text/html; charset=utf-8","language":"markup","size":13525,"content_sha256":"7a5374d2ca5d5de422fbe908fc292ebe084ab76690ebe335e258b8675bb0a652"},{"filename":"plugin.yaml","content":"schema_version: 1\nname: top-rank-tokens-sniper\nversion: \"1.0.0\"\ndescription: \"Top Rank Tokens Sniper v1.0 — OKX ranking leaderboard sniper with momentum scoring, 3-level safety, 6-layer exit system\"\nauthor:\n name: \"yz06276\"\n github: \"yz06276\"\nlicense: MIT\ncategory: strategy\ntags:\n - solana\n - onchainos\n - trading-bot\n\ncomponents:\n skill:\n repo: \"yz06276/top-rank-tokens-sniper\"\n commit: \"80489f89ed4a5ee5e9717e48fe8265e88db85fa1\"\n\napi_calls: []\ntype: community-developer\n","content_type":"application/yaml; charset=utf-8","language":"yaml","size":487,"content_sha256":"587abd1c0134ea6c3e74b7e0676cfa43dbced04d1a82d9e1916bdfaabb5b5653"},{"filename":"README.md","content":"# Top Rank Tokens Sniper - 榜单狙击手\n\nOKX ranking leaderboard sniper — scans Solana 1h gainers Top 20 every 10 seconds, filters new entries through 3-level safety + Momentum scoring, then automatically snipes entries. Ranking Exit ensures positions are closed when momentum fades. All on-chain operations powered by [onchainos](https://github.com/okx/onchainos-skills) Agentic Wallet (TEE signing, no API key needed).\n\nOKX 涨幅榜狙击手 — 每 10 秒扫描 Solana 1 小时涨幅榜 Top 20，新上榜代币经过三级安全过滤 + 动量评分后自动狙击入场。排名退出机制确保动量消退时及时平仓。所有链上操作由 [onchainos](https://github.com/okx/onchainos-skills) Agentic Wallet 驱动（TEE 签名，无需 API Key）。\n\n## Features / 功能\n\n- **Leaderboard Scanning / 榜单扫描** — Monitors Solana 1h gainers Top 20 every 10 seconds\n- **3-Level Safety / 三级安全过滤** — 13 Slot Guard + 9 Advanced Safety + 3 Holder Risk checks\n- **Momentum Scoring / 动量评分** — Composite score (0-125) from buy ratio, price change, traders, liquidity\n- **Ranking Exit / 排名退出** — Highest priority: auto-sell 100% when token drops off Top 20\n- **6-Layer Exit System / 6 层退出系统** — Ranking exit, hard stop, quick stop, trailing stop, time stop, tiered TP\n- **Session Risk Control / 会话风控** — Daily loss limit, consecutive loss pause, cumulative loss stop\n- **Wallet Audit / 钱包审计** — Periodic on-chain balance reconciliation\n- **Web Dashboard / 实时仪表盘** — http://localhost:3244\n\n## Install / 安装\n\n```bash\nnpx skills add okx/plugin-store --skill top-rank-tokens-sniper\n```\n\n## Risk Warning / 风险提示\n\n> Leaderboard data may be manipulated by wash trading. Rankings do not represent genuine market consensus. Always test in Paper Mode first.\n\n> 涨幅榜数据可能被刷量操纵，排名不代表真正的市场共识。请先在纸盘模式下测试。\n\n## License\n\nMIT\n","content_type":"text/markdown; charset=utf-8","language":"markdown","size":1984,"content_sha256":"4f260be4d1b08929ad7a3cdd8b446fc2912d8408e33b577ec57e35642cf801b2"},{"filename":"scripts/config.py","content":"\"\"\"\nTop Rank Tokens Sniper v1.0 — Strategy Configuration\nModify this file to adjust strategy parameters without changing ranking_sniper.py\n\n⚠️ Disclaimer:\nThis script and all parameter configurations are provided solely for educational\nresearch and technical reference purposes. They do not constitute any investment advice.\nCryptocurrency trading (especially Meme coins) carries extremely high risk, including but not limited to:\n - Drastic price volatility, potentially going to zero within seconds\n - Sudden liquidity drain, unable to sell\n - Smart contract vulnerabilities, Rug Pulls, and other malicious activities\n - On-chain transactions are irreversible, cannot be undone once executed\nUsers should adjust all parameters according to their own risk tolerance and assume\nfull responsibility for any losses incurred from using this strategy.\nIt is recommended to test thoroughly in Paper mode first.\n\"\"\"\n\n# ── Run Mode ──────────────────────────────────────────────────────────────\nMODE = \"paper\" # \"paper\" (recommended to test first) / \"live\" (Live Trading)\nPAUSED = True # True=Paused, no new positions (safe default), False=Normal operation\nTOTAL_BUDGET = 0.5 # SOL total budget\nDAILY_LOSS_LIMIT = 0.15 # Daily Loss Limit (ratio of TOTAL_BUDGET)\n\n# ── Session Risk Control ─────────────────────────────────────────────────\nMAX_CONSEC_LOSS = 3 # N consecutive losses → pause\nPAUSE_CONSEC_SEC = 900 # Consecutive loss pause duration (seconds, 15min)\nSESSION_STOP_SOL = 0.10 # Cumulative loss >= N SOL → stop trading\n\n# ── Position ──────────────────────────────────────────────────────────────\n# Ranking strategy characteristics: tokens already have market consensus (on the gainers leaderboard),\n# relatively sufficient liquidity — suitable for medium positions with quick TP/SL.\n# Per trade recommended \u003c= 10% of total budget.\nBUY_AMOUNT = 0.05 # Per trade buy amount (SOL)\nMAX_POSITIONS = 5 # Max simultaneous positions\nMAX_SINGLE_BUYS = 1 # Max buy count for the same token\nSLIPPAGE_BUY = 5 # Buy slippage (%) — leaderboard tokens have decent liquidity, 5% is enough\nSLIPPAGE_SELL = 8 # Normal sell slippage (%) — TP / Time Stop\nSLIPPAGE_SELL_URGENT = 15 # Urgent sell slippage (%) — Ranking Exit / Hard SL (liquidity may drain)\nGAS_RESERVE = 0.01 # Gas reserve (SOL)\nMIN_WALLET_BAL = 0.06 # Min wallet balance to open positions (SOL)\n\n# ── Leaderboard Scanning ─────────────────────────────────────────────────\nPOLL_INTERVAL = 10 # Polling interval (seconds)\nTOP_N = 20 # Leaderboard Top N\nMIN_CHANGE_PCT = 15 # Min price change (%) — raise threshold to avoid weak tokens\nMAX_CHANGE_PCT = 500 # Max price change (%) — tighten ceiling, overheated tokens risk pullback\nMIN_LIQUIDITY = 30_000 # Min liquidity ($) — leaderboard tokens should have sufficient liquidity\nMIN_MCAP = 50_000 # Min market cap ($) — too small market cap is easily manipulated\nMAX_MCAP = 10_000_000 # Max market cap ($) — very large market cap has limited upside\nMIN_HOLDERS = 100 # Min holders — ensure a real community exists\nMIN_BUY_RATIO = 0.55 # Min buy ratio — buy pressure should dominate\nMIN_TRADERS = 20 # Min unique traders — prevent wash trading\nCOOLDOWN_MIN = 30 # Cooldown after sell (minutes) — avoid repeated entry/exit on same token\nENABLE_RANKING_EXIT = True # Auto-exit when dropped off the leaderboard\n\n# ── Safety Checks ─────────────────────────────────────────────────────────\n# Ranking strategy faces tokens that already have some heat, but strict safety filtering is still needed.\n# The thresholds below are recommended values based on common Meme coin risk patterns.\n# Users can relax or tighten them as needed.\nMAX_RISK_LEVEL = 3 # Max risk level (1-5, 3=moderate risk acceptable)\nBLOCK_HONEYPOT = True # Block honeypots (strongly recommended to keep True)\nMAX_TOP10_HOLD = 40 # Top 10 holding cap (%) — high concentration risks a dump\nMAX_DEV_HOLD = 15 # Dev holding cap (%) — high dev holding risks rug pull\nMAX_BUNDLE_HOLD = 15 # Bundler holding cap (%) — bundler control risk\nMIN_LP_BURN = 50 # LP burn floor (%) — ensure liquidity cannot be drained\nMAX_DEV_RUG_COUNT = 2 # Dev rug count cap — stricter for devs with rug history\nMAX_SNIPER_HOLD = 15 # Sniper holding cap (%) — concentrated snipers create sell pressure\nBLOCK_INTERNAL = False # Block internal tokens\nMAX_SUSPICIOUS_HOLD = 30 # Suspicious address holding cap (%)\nMAX_SUSPICIOUS_COUNT = 10 # Suspicious address count cap\nBLOCK_PHISHING = True # Block tokens with phishing addresses\n\n# ── Take Profit ───────────────────────────────────────────────────────────\n# Ranking strategy: tokens already have momentum, TP targets can be moderately aggressive,\n# but first tier should recover cost quickly.\nTP_TIERS = [\n (8, 0.30), # +8% sell 30% — quick cost recovery, cover fees\n (20, 0.35), # +20% sell 35% — lock in profit\n (40, 0.35), # +40% sell 35% — trend continuation reward\n]\n\n# ── Stop Loss ─────────────────────────────────────────────────────────────\n# Ranking strategy: dropping off the leaderboard = momentum lost, exit quickly.\n# Hard stop tightened to -15%.\nSTOP_LOSS_PCT = -15 # Hard Stop Loss (%) — tighter than Signal Strategy, exit fast on momentum loss\nQUICK_STOP_MIN = 3 # Quick Stop: still losing after N minutes of holding\nQUICK_STOP_PCT = -8 # Quick Stop: loss exceeds N%\nTRAILING_ACTIVATE = 10 # Trailing Stop: activates when profit exceeds N%\nTRAILING_DROP = 8 # Trailing Stop: triggers when drawdown N% from peak\nMAX_HOLD_HOURS = 2 # Time Stop: max holding hours — leaderboard heat fades fast\n\n# ── Monitoring ────────────────────────────────────────────────────────────\nMONITOR_INTERVAL = 10 # Position check interval (seconds)\nHEALTH_CHECK_SEC = 300 # Wallet audit interval (seconds, 5min)\n\n# ── Network ───────────────────────────────────────────────────────────────\nDASHBOARD_PORT = 3244 # Dashboard port\n\n# ── Blacklist ─────────────────────────────────────────────────────────────\nSKIP_TOKENS = [\n \"11111111111111111111111111111111\", # native SOL\n \"So11111111111111111111111111111111111111112\", # WSOL\n \"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v\", # USDC\n]\nBLACKLIST = []\n","content_type":"text/x-python; charset=utf-8","language":"python","size":7960,"content_sha256":"8b8afe7a4371b1352406a29147b2e1341964b6788dc1c05056f0c0435d5348a1"},{"filename":"scripts/ranking_sniper.py","content":"\"\"\"\nTop Rank Tokens Sniper v1.0 — 榜单狙击手\nDashboard: http://localhost:3244\n\nRun: python3 ranking_sniper.py\nRequires: onchainos CLI >= 2.0.0-beta (onchainos wallet login required)\nNo pip install needed for any third-party packages\n\"\"\"\n\nimport os, sys, time, json, subprocess, shutil, threading, random, string\nfrom pathlib import Path\nfrom http.server import HTTPServer, BaseHTTPRequestHandler\nfrom datetime import datetime, timezone\n\n# ── Load Config ──────────────────────────────────────────────────────────\nPROJECT_DIR = Path(__file__).parent\nsys.path.insert(0, str(PROJECT_DIR))\nimport config as C\nfrom risk_check import pre_trade_checks, post_trade_flags\n\nSTATE_DIR = PROJECT_DIR / \"state\"\nWSOL = \"So11111111111111111111111111111111111111112\"\nSOL_NATIVE = \"11111111111111111111111111111111\"\n\n# ── onchainos CLI ───────────────────────────────────────────────────────\n\n_ONCHAINOS = shutil.which(\"onchainos\") or os.path.expanduser(\"~/.local/bin/onchainos\")\n\n\ndef _check_onchainos():\n if not os.path.isfile(_ONCHAINOS):\n print(\"=\" * 60)\n print(\" FATAL: onchainos CLI not found\")\n print(f\" Path: {_ONCHAINOS}\")\n print(\" Install: curl -fsSL https://onchainos.com/install.sh | bash\")\n print(\"=\" * 60)\n sys.exit(1)\n try:\n r = subprocess.run([_ONCHAINOS, \"--version\"], capture_output=True, text=True, timeout=10)\n print(f\" onchainos CLI: {r.stdout.strip()}\")\n except Exception as e:\n print(f\" WARNING: onchainos --version failed: {e}\")\n\n\ndef _onchainos(*args, timeout=30):\n cmd = [_ONCHAINOS] + list(args)\n try:\n result = subprocess.run(cmd, capture_output=True, text=True, timeout=timeout)\n except subprocess.TimeoutExpired:\n raise RuntimeError(f\"onchainos timeout ({timeout}s): {' '.join(args[:3])}\")\n out = result.stdout.strip()\n if not out:\n err = result.stderr.strip()\n raise RuntimeError(f\"onchainos empty output (rc={result.returncode}): {err[:200]}\")\n try:\n parsed = json.loads(out)\n except json.JSONDecodeError:\n raise RuntimeError(f\"onchainos invalid JSON: {out[:200]}\")\n if not parsed.get(\"ok\", True):\n raise RuntimeError(f\"onchainos error: {parsed.get('msg', out[:200])}\")\n return parsed.get(\"data\", parsed)\n\n\n# ── Data API Layer ───────────────────────────────────────────────────────\n\ndef sf(v, fb=0):\n try:\n n = float(v)\n return n if n == n else fb # NaN check\n except (TypeError, ValueError):\n return fb\n\n\ndef get_ranking(top_n=20):\n d = _onchainos(\"token\", \"trending\", \"--chain\", \"solana\", \"--sort-by\", \"2\", \"--time-frame\", \"2\")\n return (d if isinstance(d, list) else [])[:top_n]\n\n\ndef get_advanced(addr):\n return _onchainos(\"token\", \"advanced-info\", \"--chain\", \"solana\", \"--address\", addr)\n\n\ndef get_holders(addr, tag):\n d = _onchainos(\"token\", \"holders\", \"--chain\", \"solana\", \"--address\", addr, \"--tag-filter\", str(tag))\n return d if isinstance(d, list) else []\n\n\ndef get_batch_prices(addrs):\n tokens = \",\".join(f\"501:{a}\" for a in addrs)\n d = _onchainos(\"market\", \"prices\", \"--tokens\", tokens)\n m = {}\n for i in (d if isinstance(d, list) else []):\n m[i.get(\"tokenContractAddress\", \"\")] = sf(i.get(\"price\"))\n return m\n\n\ndef get_sol_price():\n m = get_batch_prices([SOL_NATIVE])\n return m.get(SOL_NATIVE, 0)\n\n\ndef get_quote(from_, to_, amt):\n d = _onchainos(\"swap\", \"quote\", \"--from\", from_, \"--to\", to_, \"--amount\", str(amt), \"--chain\", \"solana\")\n q = d[0] if isinstance(d, list) else d\n return {\n \"routerResult\": {\n \"toTokenAmount\": str(q.get(\"toTokenAmount\", 0) if q else 0),\n \"toTokenUsdPrice\": (q.get(\"toToken\", {}) or {}).get(\"tokenUnitPrice\", \"0\") if q else \"0\",\n \"toTokenDecimal\": int((q.get(\"toToken\", {}) or {}).get(\"decimal\", 9)) if q else 9,\n }\n }\n\n\ndef get_swap(from_, to_, amt, wallet, slippage=2):\n d = _onchainos(\"swap\", \"swap\", \"--from\", from_, \"--to\", to_, \"--amount\", str(amt),\n \"--chain\", \"solana\", \"--wallet\", wallet, \"--slippage\", str(slippage))\n return d[0] if isinstance(d, list) else d\n\n\ndef get_wallet_tokens():\n d = _onchainos(\"wallet\", \"balance\", \"--chain\", \"501\")\n assets = ((d or {}).get(\"details\", [{}]) or [{}])[0].get(\"tokenAssets\", [])\n return [a for a in assets if a.get(\"tokenAddress\") and a[\"tokenAddress\"] != \"\" and sf(a.get(\"balance\")) > 0]\n\n\ndef wallet_addr():\n d = _onchainos(\"wallet\", \"addresses\", \"--chain\", \"501\")\n addr = None\n if isinstance(d, dict):\n sol_list = d.get(\"solana\", [])\n if sol_list:\n addr = sol_list[0].get(\"address\")\n if not addr:\n addrs = d.get(\"addresses\", [])\n if addrs:\n addr = addrs[0].get(\"address\") if isinstance(addrs[0], dict) else addrs[0]\n elif isinstance(d, list) and d:\n addr = d[0].get(\"address\") if isinstance(d[0], dict) else d[0]\n if not addr:\n raise RuntimeError(\"No Solana address — run: onchainos wallet login\")\n return addr\n\n\ndef sol_balance():\n d = _onchainos(\"wallet\", \"balance\", \"--chain\", \"501\")\n assets = ((d or {}).get(\"details\", [{}]) or [{}])[0].get(\"tokenAssets\", [])\n sol = next((a for a in assets if a.get(\"symbol\") == \"SOL\" and a.get(\"tokenAddress\", \"\") == \"\"), None)\n return sf(sol.get(\"balance\")) if sol else 0\n\n\ndef sign_and_send(call_data, to):\n d = _onchainos(\"wallet\", \"contract-call\", \"--chain\", \"501\", \"--to\", to, \"--unsigned-tx\", call_data)\n return {\"success\": True, \"txHash\": (d or {}).get(\"txHash\", \"\"), \"orderId\": (d or {}).get(\"orderId\", \"\"), \"error\": None}\n\n\ndef order_status(order_id):\n if not order_id:\n return \"FAILED\"\n try:\n # [C1] wallet order-status doesn't exist — use wallet history\n d = _onchainos(\"wallet\", \"history\", \"--tx-hash\", order_id, \"--chain-index\", \"501\")\n item = d[0] if isinstance(d, list) and d else (d if isinstance(d, dict) else {})\n status = str(item.get(\"txStatus\", \"0\"))\n if status in (\"1\", \"2\", \"SUCCESS\"):\n return \"SUCCESS\"\n if status in (\"3\", \"FAILED\"):\n return \"FAILED\"\n if status in (\"TIMEOUT\", \"EXPIRED\"):\n return \"TIMEOUT\"\n return \"PENDING\"\n except Exception:\n return \"PENDING\"\n\n\ndef query_token_balance(token_addr):\n try:\n d = _onchainos(\"wallet\", \"balance\", \"--chain\", \"501\")\n assets = ((d or {}).get(\"details\", [{}]) or [{}])[0].get(\"tokenAssets\", [])\n tok = next((a for a in assets if a.get(\"tokenContractAddress\") == token_addr or a.get(\"tokenAddress\") == token_addr), None)\n return sf(tok.get(\"balance\")) if tok else 0\n except Exception:\n return -1 # RPC error — caller must NOT treat as zero\n\n\n# ── State Management ─────────────────────────────────────────────────────\n\n_state_lock = threading.Lock()\n\n\ndef _ensure_dir(p):\n p.mkdir(parents=True, exist_ok=True)\n\n\ndef state_read(filename, fallback=None):\n fp = STATE_DIR / filename\n try:\n return json.loads(fp.read_text(\"utf-8\"))\n except Exception:\n return fallback\n\n\ndef state_write(filename, data):\n fp = STATE_DIR / filename\n _ensure_dir(fp.parent)\n tmp = fp.with_suffix(fp.suffix + \".tmp\")\n tmp.write_text(json.dumps(data, indent=2, ensure_ascii=False), \"utf-8\")\n tmp.rename(fp)\n\n\ndef _mode_file(f):\n return f\"{C.MODE}/{f}\"\n\n\ndef load_positions():\n return state_read(_mode_file(\"positions.json\"), [])\n\n\ndef save_positions(p):\n state_write(_mode_file(\"positions.json\"), p)\n\n\ndef load_trades():\n return state_read(_mode_file(\"trades.json\"), [])\n\n\ndef add_trade(t):\n with _state_lock:\n a = load_trades()\n a.append(t)\n state_write(_mode_file(\"trades.json\"), a)\n\n\ndef today_key():\n return datetime.now(timezone.utc).strftime(\"%Y-%m-%d\")\n\n\ndef today_stats():\n all_stats = state_read(_mode_file(\"daily-stats.json\"), {})\n k = today_key()\n if k not in all_stats:\n all_stats[k] = {\"pnlSol\": 0, \"trades\": 0, \"wins\": 0, \"losses\": 0}\n state_write(_mode_file(\"daily-stats.json\"), all_stats)\n return all_stats[k]\n\n\ndef update_today(u):\n all_stats = state_read(_mode_file(\"daily-stats.json\"), {})\n k = today_key()\n all_stats[k] = {**(all_stats.get(k) or {\"pnlSol\": 0, \"trades\": 0, \"wins\": 0, \"losses\": 0}), **u}\n state_write(_mode_file(\"daily-stats.json\"), all_stats)\n\n\ndef add_signal(s):\n with _state_lock:\n a = state_read(_mode_file(\"signals-log.json\"), [])\n a.append(s)\n if len(a) > 100:\n a = a[-100:]\n state_write(_mode_file(\"signals-log.json\"), a)\n\n\n# ── Engine State ────────────────────────────────────────────────────────\n\n_engine_lock = threading.Lock()\n_running = False\n_prev_snap = set()\n_first_poll = True\n_cooldown = {} # addr → timestamp\n_buying = set() # addresses currently being bought\n_unconfirmed = {} # addr → {pos, zero_count, start_time, order_id}\n_roster = [] # current top N ranking\n_logs = [] # engine logs\n_MAX_LOG = 200\n_poll_busy = False\n_mon_busy = False\n_audit_busy = False\n_scanner_thread = None\n_monitor_thread = None\n_audit_thread = None\n_wallet_cache = None # cached Solana address — fetched once per engine start\n_stop_event = threading.Event()\n\n# Session risk control state\n_session_risk = {\n \"consecutive_losses\": 0,\n \"cumulative_loss_sol\": 0.0,\n \"paused_until\": 0,\n \"stopped\": False,\n}\n\n\ndef _record_session_loss(loss_sol):\n \"\"\"Record loss, trigger session pause/stop\"\"\"\n _session_risk[\"consecutive_losses\"] += 1\n _session_risk[\"cumulative_loss_sol\"] += abs(loss_sol)\n if _session_risk[\"cumulative_loss_sol\"] >= C.SESSION_STOP_SOL:\n _session_risk[\"stopped\"] = True\n log(\"SESSION\", f\"🛑 STOPPED — cumulative loss {_session_risk['cumulative_loss_sol']:.4f} SOL >= {C.SESSION_STOP_SOL}\")\n elif _session_risk[\"consecutive_losses\"] >= C.MAX_CONSEC_LOSS:\n _session_risk[\"paused_until\"] = time.time() + C.PAUSE_CONSEC_SEC\n log(\"SESSION\", f\"⏸ PAUSED {C.PAUSE_CONSEC_SEC//60}min — {_session_risk['consecutive_losses']} consecutive losses\")\n\n\ndef _record_session_win():\n \"\"\"Record win, reset consecutive loss counter\"\"\"\n _session_risk[\"consecutive_losses\"] = 0\n\n\ndef log(type_, msg):\n ts = int(time.time() * 1000)\n entry = {\"ts\": ts, \"type\": type_, \"msg\": msg}\n with _engine_lock:\n _logs.append(entry)\n if len(_logs) > _MAX_LOG:\n _logs.pop(0)\n t_str = datetime.fromtimestamp(ts / 1000).strftime(\"%H:%M:%S\")\n print(f\"[{t_str}][{type_}] {msg}\")\n\n\ndef engine_state():\n return {\n \"running\": _running,\n \"mode\": C.MODE,\n \"version\": \"1.0.0\",\n \"positionsCount\": len(load_positions()),\n \"maxPositions\": C.MAX_POSITIONS,\n \"totalBudget\": C.TOTAL_BUDGET,\n }\n\n\ndef get_logs(n=50):\n with _engine_lock:\n return list(_logs[-n:])\n\n\ndef get_roster():\n return list(_roster)\n\n\n# ── Engine Start / Stop ─────────────────────────────────────────────────\n\ndef engine_start():\n global _running, _first_poll, _prev_snap, _scanner_thread, _monitor_thread, _audit_thread, _wallet_cache\n if _running:\n return {\"ok\": False, \"msg\": \"Already running\"}\n\n if C.MODE == \"live\":\n log(\"ENGINE\", \"Live mode — agentic wallet (onchainos wallet)\")\n try:\n _wallet_cache = wallet_addr() # cache once; avoids CLI call on every buy/sell\n except Exception as e:\n log(\"FATAL\", f\"Wallet connection failed: {e}\")\n log(\"FATAL\", \"Please confirm: onchainos wallet login \u003cemail> has been executed\")\n return {\"ok\": False, \"msg\": f\"Wallet error: {e}\"}\n try:\n _wallet_audit()\n except Exception as e:\n log(\"WARN\", f\"Wallet audit skipped: {e}\")\n\n _running = True\n _first_poll = True\n _prev_snap = set()\n _cooldown.clear()\n _buying.clear()\n _unconfirmed.clear()\n _stop_event.clear()\n\n log(\"ENGINE\", f\"Started v1.0 | mode={C.MODE} | budget={C.TOTAL_BUDGET}SOL | per_trade={C.BUY_AMOUNT}SOL | max_pos={C.MAX_POSITIONS}\")\n\n _scanner_thread = threading.Thread(target=_scanner_loop, daemon=True)\n _monitor_thread = threading.Thread(target=_monitor_loop, daemon=True)\n _scanner_thread.start()\n _monitor_thread.start()\n\n if C.MODE == \"live\":\n _audit_thread = threading.Thread(target=_audit_loop, daemon=True)\n _audit_thread.start()\n\n return {\"ok\": True, \"msg\": \"Engine started\"}\n\n\ndef engine_stop():\n global _running, _wallet_cache\n if not _running:\n return {\"ok\": False, \"msg\": \"Not running\"}\n _wallet_cache = None\n\n _running = False\n _stop_event.set()\n\n # Close all positions\n pos = load_positions()\n if pos:\n log(\"ENGINE\", f\"Closing {len(pos)} position(s)...\")\n try:\n sp = get_sol_price()\n except Exception:\n sp = 0\n try:\n pm = get_batch_prices([p[\"tokenAddress\"] for p in pos])\n except Exception:\n pm = {}\n failed = []\n for p in pos:\n try:\n cp = pm.get(p[\"tokenAddress\"], sf(p.get(\"lastCheckPrice\")))\n bp = sf(p.get(\"buyPrice\"))\n pnl = ((cp - bp) / bp) * 100 if bp > 0 else 0\n _sell(p, 1, \"StopExit\", pnl, sp)\n log(\"SELL\", f\"{p['tokenSymbol']} | StopExit | PnL:{pnl:.1f}%\")\n except Exception as e:\n log(\"ERROR\", f\"StopExit {p['tokenSymbol']}: {e}\")\n failed.append(p)\n save_positions(failed)\n\n log(\"ENGINE\", \"Stopped\")\n return {\"ok\": True, \"msg\": \"Engine stopped\"}\n\n\n# ── Scanner Loop ────────────────────────────────────────────────────────\n\ndef _scanner_loop():\n while not _stop_event.is_set():\n if _running:\n _poll()\n _stop_event.wait(C.POLL_INTERVAL)\n\n\ndef _poll():\n global _poll_busy, _first_poll, _prev_snap, _roster\n if not _running or _poll_busy:\n return\n _poll_busy = True\n try:\n rank = get_ranking(C.TOP_N)\n if not rank:\n log(\"WARN\", \"Empty ranking\")\n return\n _roster = rank\n cur = set(t.get(\"tokenContractAddress\", \"\") for t in rank)\n\n if _first_poll:\n _prev_snap = cur\n _first_poll = False\n log(\"ENGINE\", f\"Initial snapshot: {len(rank)} tokens\")\n return\n\n news = [t for t in rank if t.get(\"tokenContractAddress\", \"\") not in _prev_snap]\n _prev_snap = cur\n if not news:\n return\n\n log(\"ENGINE\", f\"New entries: {', '.join(t.get('tokenSymbol', '?') for t in news)}\")\n\n cands = []\n for t in news:\n r = _filter(t)\n if r:\n cands.append(r)\n\n cands.sort(key=lambda x: x[\"score\"], reverse=True)\n\n delay = 2.0 if C.MODE == \"live\" else 0.3\n for i, cand in enumerate(cands):\n _buy(cand)\n if i \u003c len(cands) - 1:\n time.sleep(delay)\n\n except Exception as e:\n log(\"ERROR\", f\"poll: {e}\")\n finally:\n _poll_busy = False\n\n\n# ── 3-Level Filter ──────────────────────────────────────────────────────\n\ndef _filter(tok):\n addr = tok.get(\"tokenContractAddress\", \"\")\n sym = tok.get(\"tokenSymbol\", \"?\")\n ch = sf(tok.get(\"change\"))\n liq = sf(tok.get(\"liquidity\"))\n mc = sf(tok.get(\"marketCap\"))\n hold = sf(tok.get(\"holders\"))\n txs = sf(tok.get(\"txs\"), 1)\n txs_buy = sf(tok.get(\"txsBuy\"))\n tr = sf(tok.get(\"uniqueTraders\"))\n br = txs_buy / txs if txs > 0 else 0\n\n # Level 1: Slot Guard\n rej = []\n if ch \u003c C.MIN_CHANGE_PCT:\n rej.append(f\"change\u003c{C.MIN_CHANGE_PCT}%\")\n if ch > C.MAX_CHANGE_PCT:\n rej.append(f\"change>{C.MAX_CHANGE_PCT}%\")\n if liq \u003c C.MIN_LIQUIDITY:\n rej.append(f\"liq\u003c${C.MIN_LIQUIDITY}\")\n if mc \u003c C.MIN_MCAP:\n rej.append(f\"mcap\u003c${C.MIN_MCAP}\")\n if mc > C.MAX_MCAP:\n rej.append(f\"mcap>${C.MAX_MCAP}\")\n if hold \u003c C.MIN_HOLDERS:\n rej.append(f\"holders\u003c{C.MIN_HOLDERS}\")\n if br \u003c C.MIN_BUY_RATIO:\n rej.append(f\"buyRatio\u003c{C.MIN_BUY_RATIO * 100:.0f}%\")\n if tr \u003c C.MIN_TRADERS:\n rej.append(f\"traders\u003c{C.MIN_TRADERS}\")\n if addr in set(C.SKIP_TOKENS) | set(C.BLACKLIST):\n rej.append(\"blacklisted\")\n\n ls = _cooldown.get(addr)\n if ls and time.time() * 1000 - ls \u003c C.COOLDOWN_MIN * 60000:\n rej.append(\"cooldown\")\n\n pos = load_positions()\n if len(pos) >= C.MAX_POSITIONS:\n rej.append(\"max_positions\")\n if any(p[\"tokenAddress\"] == addr for p in pos):\n rej.append(\"already_held\")\n\n td = today_stats()\n if td[\"pnlSol\"] \u003c 0 and abs(td[\"pnlSol\"]) >= C.TOTAL_BUDGET * C.DAILY_LOSS_LIMIT:\n rej.append(\"daily_loss_limit\")\n\n # Session risk control check\n if _session_risk[\"stopped\"]:\n rej.append(\"session_stopped\")\n elif _session_risk[\"paused_until\"] > time.time():\n remain = int((_session_risk[\"paused_until\"] - time.time()) / 60)\n rej.append(f\"session_paused_{remain}min\")\n\n if rej:\n log(\"SKIP\", f\"{sym}: {', '.join(rej)}\")\n add_signal({\"ts\": int(time.time() * 1000), \"token\": sym, \"addr\": addr, \"type\": \"SKIP\", \"reasons\": rej})\n return None\n\n # Level 2: Advanced Safety Check\n try:\n adv = get_advanced(addr)\n except Exception as e:\n log(\"SAFETY_REJECT\", f\"{sym}: api_error: {e}\")\n add_signal({\"ts\": int(time.time() * 1000), \"token\": sym, \"addr\": addr, \"type\": \"SAFETY_REJECT\", \"reasons\": [\"api_error\"]})\n return None\n\n sr = []\n rl = sf((adv or {}).get(\"riskControlLevel\"), 3)\n t10 = sf((adv or {}).get(\"top10HoldPercent\"), 100)\n dh = sf((adv or {}).get(\"devHoldingPercent\"), 100)\n bh = sf((adv or {}).get(\"bundleHoldingPercent\"), 100)\n lpb = sf((adv or {}).get(\"lpBurnedPercent\"), 0)\n drc = sf((adv or {}).get(\"devRugPullTokenCount\"), 999)\n dev_created = sf((adv or {}).get(\"devCreateTokenCount\", (adv or {}).get(\"devLaunchedTokenCount\", 0)), 0)\n snh = sf((adv or {}).get(\"sniperHoldingPercent\"), 100)\n is_int = (adv or {}).get(\"isInternal\")\n\n raw_tags = (adv or {}).get(\"tokenTags\", [])\n if isinstance(raw_tags, str):\n tags = raw_tags.split(\",\")\n elif isinstance(raw_tags, list):\n tags = raw_tags\n else:\n tags = []\n\n if rl > C.MAX_RISK_LEVEL:\n sr.append(f\"RiskLevel:{rl}\")\n if C.BLOCK_HONEYPOT and any(\"honeypot\" in (t if isinstance(t, str) else \"\").lower() for t in tags):\n sr.append(\"Honeypot\")\n if t10 > C.MAX_TOP10_HOLD:\n sr.append(f\"Top10:{t10:.1f}%\")\n if dh > C.MAX_DEV_HOLD:\n sr.append(f\"DevHold:{dh:.1f}%\")\n if bh > C.MAX_BUNDLE_HOLD:\n sr.append(f\"Bundle:{bh:.1f}%\")\n if not is_int and lpb \u003c C.MIN_LP_BURN:\n sr.append(f\"LPBurn:{lpb:.1f}%\")\n # Rate-based rug check (aligned with risk_check.py)\n rug_rate = drc / max(dev_created, 1) if dev_created > 0 else (1.0 if drc > 0 else 0.0)\n if rug_rate >= 0.20 and drc >= 3:\n sr.append(f\"SerialRugger:rate={rug_rate*100:.0f}%×{drc:.0f}\")\n elif drc > C.MAX_DEV_RUG_COUNT:\n sr.append(f\"DevRug:{drc:.0f}\")\n if snh > C.MAX_SNIPER_HOLD:\n sr.append(f\"Sniper:{snh:.1f}%\")\n if C.BLOCK_INTERNAL and is_int is True:\n sr.append(\"Internal\")\n\n if sr:\n log(\"SAFETY_REJECT\", f\"{sym}: {', '.join(sr)}\")\n add_signal({\"ts\": int(time.time() * 1000), \"token\": sym, \"addr\": addr, \"type\": \"SAFETY_REJECT\", \"reasons\": sr})\n return None\n\n # Level 3: Holder Risk Scan\n try:\n sus_d = get_holders(addr, 6)\n phi_d = get_holders(addr, 8)\n except Exception as e:\n log(\"HOLDER_REJECT\", f\"{sym}: api_error: {e}\")\n add_signal({\"ts\": int(time.time() * 1000), \"token\": sym, \"addr\": addr, \"type\": \"HOLDER_REJECT\", \"reasons\": [\"api_error\"]})\n return None\n\n hr = []\n sus_act = [h for h in sus_d if sf(h.get(\"holdPercent\")) > 0]\n sus_p = sum(sf(h.get(\"holdPercent\")) * 100 for h in sus_act)\n phi_act = [h for h in phi_d if sf(h.get(\"holdPercent\")) > 0]\n\n if sus_p > C.MAX_SUSPICIOUS_HOLD:\n hr.append(f\"SuspiciousHold:{sus_p:.1f}%\")\n if C.BLOCK_PHISHING and len(phi_act) > 0:\n hr.append(f\"PhishingHolder:{len(phi_act)}\")\n if len(sus_act) > C.MAX_SUSPICIOUS_COUNT:\n hr.append(f\"SuspiciousCount:{len(sus_act)}\")\n\n if hr:\n log(\"HOLDER_REJECT\", f\"{sym}: {', '.join(hr)}\")\n add_signal({\"ts\": int(time.time() * 1000), \"token\": sym, \"addr\": addr, \"type\": \"HOLDER_REJECT\", \"reasons\": hr})\n return None\n\n # Momentum Score\n score = _calc_score(tok, adv, tags, len(sus_act))\n log(\"PASS\", f\"{sym} | +{ch:.1f}% | BR:{br * 100:.0f}% | Score:{score}\")\n add_signal({\"ts\": int(time.time() * 1000), \"token\": sym, \"addr\": addr, \"type\": \"PASS\", \"score\": score, \"change\": ch})\n return {\"tok\": tok, \"adv\": adv, \"tags\": tags, \"score\": score, \"ch\": ch, \"br\": br, \"sus_c\": len(sus_act)}\n\n\ndef _calc_score(tok, adv, tags, sus_c):\n ch = sf(tok.get(\"change\"))\n txs = sf(tok.get(\"txs\"), 1)\n br = sf(tok.get(\"txsBuy\")) / txs if txs > 0 else 0\n tr = sf(tok.get(\"uniqueTraders\"))\n liq = sf(tok.get(\"liquidity\"))\n\n base = (min(br, 1) * 40\n + (max(0, 20 - (ch - 100) / 10) if ch > 100 else min(ch / 5, 20))\n + min(tr / 50, 1) * 20\n + min(liq / 50000, 1) * 20)\n\n tl = [(t.lower() if isinstance(t, str) else \"\") for t in tags]\n b = 0\n if any(\"smartmoneybuy\" in t for t in tl):\n b += 8\n t10 = sf((adv or {}).get(\"top10HoldPercent\"), 100)\n if t10 \u003c 30:\n b += 5\n elif t10 \u003c 50:\n b += 2\n if any(\"dspaid\" in t for t in tl):\n b += 3\n if any(\"communitytakeover\" in t for t in tl):\n b += 2\n sn = sf((adv or {}).get(\"sniperHoldingPercent\"), 100)\n if sn \u003c 5:\n b += 4\n elif sn \u003c 10:\n b += 2\n if sf((adv or {}).get(\"devHoldingPercent\"), 100) == 0 and sf((adv or {}).get(\"devRugPullTokenCount\"), 999) \u003c 3:\n b += 3\n if sus_c == 0:\n b += 2\n\n return round(base + min(b, 25))\n\n\n# ── Buy ─────────────────────────────────────────────────────────────────\n\ndef _buy(cand):\n tok = cand[\"tok\"]\n adv = cand[\"adv\"]\n tags = cand[\"tags\"]\n score = cand[\"score\"]\n ch = cand[\"ch\"]\n br = cand[\"br\"]\n addr = tok.get(\"tokenContractAddress\", \"\")\n sym = tok.get(\"tokenSymbol\", \"?\")\n dec = int(sf(tok.get(\"decimal\"), 9))\n\n if addr in _buying:\n return\n _buying.add(addr)\n\n try:\n amt = C.BUY_AMOUNT\n if len(load_positions()) >= C.MAX_POSITIONS:\n log(\"SKIP\", f\"{sym}: max_positions\")\n return\n\n # Risk check — honeypot, wash trading, rug rate\n try:\n rc = pre_trade_checks(addr, sym, quick=True)\n if rc[\"grade\"] >= 3:\n log(\"RISK_BLOCK\", f\"{sym}: G{rc['grade']} — {', '.join(rc['reasons'][:2])}\")\n add_signal({\"ts\": int(time.time() * 1000), \"token\": sym, \"addr\": addr, \"type\": \"RISK_BLOCK\", \"reasons\": rc[\"reasons\"]})\n return\n if rc[\"grade\"] == 2:\n log(\"RISK_CAUTION\", f\"{sym}: {', '.join(rc['cautions'][:2])}\")\n except Exception as e:\n log(\"WARN\", f\"{sym}: risk_check error: {e}\")\n # Non-fatal — proceed if risk_check fails\n _rc_info = rc.get(\"raw\", {}).get(\"info\", {}) if 'rc' in locals() else {}\n _rc_liq = rc.get(\"raw\", {}).get(\"liquidity_usd\", 0) if 'rc' in locals() else 0\n\n price = 0\n hold = 0.0\n tx_hash = \"\"\n\n if C.MODE == \"paper\":\n # Paper mode\n try:\n q = get_quote(SOL_NATIVE, addr, str(round(amt * 1e9)))\n rr = q.get(\"routerResult\", {})\n dec = int(rr.get(\"toTokenDecimal\", dec))\n hold = sf(rr.get(\"toTokenAmount\")) / (10 ** dec)\n price = sf(rr.get(\"toTokenUsdPrice\"))\n if not price:\n price = sf(tok.get(\"price\"))\n if not price and hold > 0:\n sp = get_sol_price()\n price = (amt * sp) / hold\n except Exception:\n price = sf(tok.get(\"price\"))\n try:\n sp = get_sol_price()\n if price > 0 and sp > 0:\n hold = (amt * sp) / price\n except Exception:\n pass\n\n if not price or price \u003c= 0:\n log(\"SKIP\", f\"{sym}: price=0\")\n return\n\n with _state_lock:\n pos = load_positions()\n pos.append(_make_position(addr, sym, dec, price, amt, hold, ch, score, {}))\n # Attach risk_check snapshots\n if 'rc' in locals() and rc.get(\"raw\"):\n pos[-1][\"entry_liquidity_usd\"] = rc[\"raw\"].get(\"liquidity_usd\", 0)\n pos[-1][\"entry_top10\"] = float(rc[\"raw\"].get(\"info\", {}).get(\"top10HoldPercent\", 0) or 0)\n pos[-1][\"entry_sniper_pct\"] = float(rc[\"raw\"].get(\"info\", {}).get(\"sniperHoldingPercent\", 0) or 0)\n save_positions(pos)\n add_trade(_make_trade(\"buy\", addr, sym, amt, hold, price, tx_hash, f\"rank_score_{score}\", \"0\", \"0\"))\n log(\"BUY\", f\"{sym} | +{sf(ch):.0f}% | BR:{sf(br) * 100:.0f}% | S:{score} | {amt}SOL | ${price}\")\n\n else:\n # Live mode\n try:\n bal = sol_balance()\n min_required = amt + C.GAS_RESERVE\n if bal \u003c min_required:\n log(\"SKIP\", f\"{sym}: balance {bal:.4f} \u003c {min_required:.4f} (buy {amt} + gas {C.GAS_RESERVE})\")\n return\n\n w_addr = _wallet_cache or wallet_addr()\n log(\"ENGINE\", f\"{sym}: getSwap...\")\n sw = get_swap(SOL_NATIVE, addr, str(round(amt * 1e9)), w_addr, C.SLIPPAGE_BUY)\n\n tx_data = (sw or {}).get(\"tx\", {})\n if not tx_data.get(\"data\"):\n raise RuntimeError(f\"No callData: {json.dumps(sw)[:300]}\")\n\n log(\"ENGINE\", f\"{sym}: signAndSend...\")\n res = sign_and_send(tx_data[\"data\"], tx_data[\"to\"])\n if not res[\"success\"]:\n log(\"ERROR\", f\"{sym}: tx fail: {res['error']}\")\n return\n tx_hash = res[\"txHash\"]\n o_id = res[\"orderId\"]\n\n # Layer 1: order_status confirmation\n tx_status = \"PENDING\"\n if o_id:\n time.sleep(2)\n for _ in range(5):\n tx_status = order_status(o_id)\n if tx_status != \"PENDING\":\n break\n time.sleep(2)\n elif tx_hash:\n tx_status = \"SUCCESS\"\n\n if tx_status == \"FAILED\":\n log(\"ERROR\", f\"{sym}: tx FAILED on-chain (orderId: {o_id})\")\n return\n\n # Extract swap result\n rr = (sw or {}).get(\"routerResult\", {})\n dec = int(sf(rr.get(\"toToken\", {}).get(\"decimal\", rr.get(\"toTokenDecimal\", dec))))\n hold = sf(rr.get(\"toTokenAmount\")) / (10 ** dec)\n price = sf(rr.get(\"toTokenUsdPrice\")) or sf(tok.get(\"price\"))\n\n # Layer 2: on-chain balance verification\n confirmed = False\n if tx_status == \"SUCCESS\":\n time.sleep(1)\n on_chain_bal = query_token_balance(addr)\n if on_chain_bal > 0:\n confirmed = True\n hold = on_chain_bal\n log(\"LIVE_BUY\", f\"{sym} | tx: {tx_hash} | ${price} | balance verified: {hold}\")\n elif on_chain_bal == -1:\n confirmed = True\n log(\"LIVE_BUY\", f\"{sym} | tx: {tx_hash} | ${price} | RPC error on verify, assuming success\")\n else:\n log(\"WARN\", f\"{sym}: order SUCCESS but balance=0, marking unconfirmed\")\n\n safety_d = {\n \"riskControlLevel\": str((adv or {}).get(\"riskControlLevel\", \"\")),\n \"top10HoldPercent\": str((adv or {}).get(\"top10HoldPercent\", \"\")),\n \"devHoldingPercent\": str((adv or {}).get(\"devHoldingPercent\", \"\")),\n \"sniperHoldingPercent\": str((adv or {}).get(\"sniperHoldingPercent\", \"\")),\n \"bundleHoldingPercent\": str((adv or {}).get(\"bundleHoldingPercent\", \"\")),\n \"devRugPullTokenCount\": str((adv or {}).get(\"devRugPullTokenCount\", \"\")),\n \"hasSmartMoney\": any(\"smartmoneybuy\" in (t.lower() if isinstance(t, str) else \"\") for t in tags),\n }\n\n if confirmed:\n if not price or price \u003c= 0:\n log(\"SKIP\", f\"{sym}: price=0 after verification\")\n return\n with _state_lock:\n pos = load_positions()\n pos.append(_make_position(addr, sym, dec, price, amt, hold, ch, score, safety_d))\n # Attach risk_check snapshots\n if 'rc' in locals() and rc.get(\"raw\"):\n pos[-1][\"entry_liquidity_usd\"] = rc[\"raw\"].get(\"liquidity_usd\", 0)\n pos[-1][\"entry_top10\"] = float(rc[\"raw\"].get(\"info\", {}).get(\"top10HoldPercent\", 0) or 0)\n pos[-1][\"entry_sniper_pct\"] = float(rc[\"raw\"].get(\"info\", {}).get(\"sniperHoldingPercent\", 0) or 0)\n save_positions(pos)\n add_trade(_make_trade(\"buy\", addr, sym, amt, hold, price, tx_hash, f\"rank_score_{score}\", \"0\", \"0\"))\n log(\"BUY\", f\"{sym} | +{sf(ch):.0f}% | BR:{sf(br) * 100:.0f}% | S:{score} | {amt}SOL | ${price} | balance verified\")\n return\n\n # Layer 3: unconfirmed position\n unconf_pos = _make_position(addr, sym, dec, price or sf(tok.get(\"price\")), amt, hold, ch, score, safety_d)\n unconf_pos[\"unconfirmed\"] = True\n unconf_pos[\"triggerReason\"] += \" (unconfirmed)\"\n _unconfirmed[addr] = {\"pos\": unconf_pos, \"zero_count\": 0, \"start_time\": time.time() * 1000, \"order_id\": o_id}\n add_trade(_make_trade(\"buy\", addr, sym, amt, hold, price, tx_hash, f\"rank_score_{score}(unconfirmed)\", \"0\", \"0\"))\n log(\"BUY_UNCONFIRMED\", f\"{sym} | tx: {tx_hash} | orderId: {o_id} | monitoring balance...\")\n\n except Exception as e:\n log(\"ERROR\", f\"{sym}: live buy: {e}\")\n\n except Exception as e:\n log(\"ERROR\", f\"buy {sym}: {e}\")\n finally:\n _buying.discard(addr)\n\n\ndef _make_position(addr, sym, dec, price, amt, hold, ch, score, safety_d):\n now = int(time.time() * 1000)\n return {\n \"tokenAddress\": addr, \"tokenSymbol\": sym, \"decimal\": dec,\n \"buyPrice\": str(price), \"buyAmountSol\": str(amt), \"holdAmount\": str(hold),\n \"buyCount\": 1, \"buyTimestamp\": now,\n \"lastCheckPrice\": str(price), \"lastCheckTime\": now,\n \"peakPrice\": str(price), \"takeProfitTier\": 0,\n \"triggerReason\": f\"Rank +{sf(ch):.0f}% S:{score}\",\n \"safetyData\": safety_d,\n \"entry_liquidity_usd\": 0,\n \"entry_top10\": 0,\n \"entry_sniper_pct\": 0,\n \"risk_last_checked\": 0,\n }\n\n\ndef _make_trade(direction, addr, sym, amt_sol, amt_token, price, tx_hash, reason, pnl_pct, pnl_sol):\n return {\n \"tradeId\": f\"{direction}-{int(time.time() * 1000)}-{addr[:4]}-{''.join(random.choices(string.ascii_lowercase, k=4))}\",\n \"timestamp\": int(time.time() * 1000),\n \"direction\": direction,\n \"tokenAddress\": addr, \"tokenSymbol\": sym,\n \"amountSol\": str(amt_sol), \"amountToken\": str(amt_token),\n \"priceUsd\": str(price), \"txHash\": tx_hash,\n \"reason\": reason, \"pnlPercent\": str(pnl_pct), \"pnlSol\": str(pnl_sol),\n \"mode\": C.MODE,\n }\n\n\n# ── Monitor Loop (6-layer exit) ────────────────────────────────────────\n\ndef _monitor_loop():\n while not _stop_event.is_set():\n if _running:\n _monitor()\n _stop_event.wait(C.MONITOR_INTERVAL)\n\n\ndef _monitor():\n global _mon_busy\n if not _running or _mon_busy:\n return\n _mon_busy = True\n try:\n # Layer 3: check unconfirmed positions\n if C.MODE == \"live\":\n _check_unconfirmed()\n\n pos = load_positions()\n if not pos:\n return\n\n try:\n sp = get_sol_price()\n except Exception:\n sp = 130\n\n try:\n pm = get_batch_prices([p[\"tokenAddress\"] for p in pos])\n except Exception as e:\n log(\"WARN\", f\"price fetch: {e}\")\n return\n\n rm = []\n for p in pos:\n try:\n cp = pm.get(p[\"tokenAddress\"], 0)\n if cp \u003c= 0:\n continue\n p[\"lastCheckPrice\"] = str(cp)\n p[\"lastCheckTime\"] = int(time.time() * 1000)\n pk = sf(p.get(\"peakPrice\"))\n if cp > pk:\n p[\"peakPrice\"] = str(cp)\n bp = sf(p.get(\"buyPrice\"))\n if bp \u003c= 0:\n continue\n pnl = ((cp - bp) / bp) * 100\n mins = (time.time() * 1000 - p[\"buyTimestamp\"]) / 60000\n\n # EXIT 0: Ranking Exit\n if C.ENABLE_RANKING_EXIT and mins >= 1 and not any(t.get(\"tokenContractAddress\") == p[\"tokenAddress\"] for t in _roster):\n log(\"RANK_EXIT\", f\"{p['tokenSymbol']} dropped, PnL: {pnl:.1f}%\")\n _sell(p, 1, \"RankExit\", pnl, sp)\n rm.append(p[\"tokenAddress\"])\n continue\n\n # EXIT 1: Hard Stop\n if pnl \u003c= C.STOP_LOSS_PCT:\n log(\"SELL\", f\"{p['tokenSymbol']} | HardSL | PnL:{pnl:.1f}%\")\n _sell(p, 1, f\"SL({C.STOP_LOSS_PCT}%)\", pnl, sp)\n rm.append(p[\"tokenAddress\"])\n continue\n\n # EXIT 2: Quick Stop\n if mins >= C.QUICK_STOP_MIN and pnl \u003c= C.QUICK_STOP_PCT:\n log(\"SELL\", f\"{p['tokenSymbol']} | QuickSL | PnL:{pnl:.1f}%\")\n _sell(p, 1, \"QuickSL\", pnl, sp)\n rm.append(p[\"tokenAddress\"])\n continue\n\n # EXIT 3: Trailing Stop\n ppnl = ((sf(p.get(\"peakPrice\")) - bp) / bp) * 100\n if ppnl >= C.TRAILING_ACTIVATE and ppnl - pnl >= C.TRAILING_DROP:\n log(\"SELL\", f\"{p['tokenSymbol']} | TrailSL | PnL:{pnl:.1f}%\")\n _sell(p, 1, \"TrailSL\", pnl, sp)\n rm.append(p[\"tokenAddress\"])\n continue\n\n # EXIT 4: Time Stop\n if mins / 60 >= C.MAX_HOLD_HOURS:\n log(\"SELL\", f\"{p['tokenSymbol']} | TimeSL | PnL:{pnl:.1f}%\")\n _sell(p, 1, \"TimeSL\", pnl, sp)\n rm.append(p[\"tokenAddress\"])\n continue\n\n # EXIT 5: Tiered Take Profit\n ct = p.get(\"takeProfitTier\", 0)\n for i in range(ct, len(C.TP_TIERS)):\n tp_pct, tp_sell = C.TP_TIERS[i]\n if pnl >= tp_pct:\n log(\"SELL\", f\"{p['tokenSymbol']} | TP{i + 1}(+{tp_pct}%) | PnL:{pnl:.1f}%\")\n prev_hold = p[\"holdAmount\"]\n try:\n _sell(p, tp_sell, f\"TP{i + 1}\", pnl, sp)\n p[\"takeProfitTier\"] = i + 1\n if i == len(C.TP_TIERS) - 1:\n rm.append(p[\"tokenAddress\"])\n except Exception as e:\n p[\"holdAmount\"] = prev_hold\n log(\"ERROR\", f\"TP sell {p['tokenSymbol']}: {e}\")\n break\n\n except Exception as e:\n log(\"ERROR\", f\"mon {p['tokenSymbol']}: {e}\")\n\n if rm:\n save_positions([p for p in pos if p[\"tokenAddress\"] not in rm])\n else:\n save_positions(pos)\n\n # Risk check post-trade monitoring (background, throttled 60s per position)\n for p in (load_positions() if not rm else [px for px in pos if px[\"tokenAddress\"] not in rm]):\n _rlc = p.get(\"risk_last_checked\", 0)\n if time.time() - _rlc \u003c 60:\n continue\n # Update timestamp\n p[\"risk_last_checked\"] = time.time()\n _addr = p[\"tokenAddress\"]\n _sym = p[\"tokenSymbol\"]\n _eliq = p.get(\"entry_liquidity_usd\", 0)\n _et10 = p.get(\"entry_top10\", 0)\n _esp = p.get(\"entry_sniper_pct\", 0)\n def _run_rc(_a=_addr, _s=_sym, _el=_eliq, _t10=_et10, _sp=_esp):\n try:\n flags = post_trade_flags(_a, _s, entry_liquidity_usd=_el, entry_top10=_t10, entry_sniper_pct=_sp)\n for flag in flags:\n log(\"RISK_FLAG\", f\"{_s}: {flag}\")\n if flag.startswith(\"EXIT_NOW\"):\n log(\"RISK_EXIT\", f\"{_s}: {flag}\")\n # Actually close the position — get current price for PnL\n try:\n _pi = price_info(_a)\n _cp = sf(_pi.get(\"price\"))\n except Exception:\n _cp = 0\n _sell_pos = None\n with _state_lock:\n _all = load_positions()\n _sell_pos = next((px for px in _all if px[\"tokenAddress\"] == _a), None)\n if _sell_pos:\n _bp = sf(_sell_pos.get(\"buyPrice\"))\n _pnl = ((_cp - _bp) / _bp * 100) if _bp > 0 and _cp > 0 else 0\n try:\n _sp_sol = get_sol_price()\n except Exception:\n _sp_sol = 0\n _sell(_sell_pos, 1, f\"RISK:{flag[:30]}\", _pnl, _sp_sol)\n # Remove from positions\n with _state_lock:\n _all2 = load_positions()\n save_positions([px for px in _all2 if px[\"tokenAddress\"] != _a])\n break\n except Exception:\n pass\n threading.Thread(target=_run_rc, daemon=True).start()\n\n except Exception as e:\n log(\"ERROR\", f\"monitor: {e}\")\n finally:\n _mon_busy = False\n\n\n# ── Sell ────────────────────────────────────────────────────────────────\n\ndef _sell(pos, ratio, reason, pnl, sp):\n sym = pos[\"tokenSymbol\"]\n addr = pos[\"tokenAddress\"]\n hold = sf(pos.get(\"holdAmount\"))\n sell_amt = hold * ratio\n dec = int(sf(pos.get(\"decimal\"), 9))\n lam = round(sell_amt * (10 ** dec))\n b_sol = sf(pos.get(\"buyAmountSol\"))\n p_sol = b_sol * (pnl / 100) * ratio\n tx_hash = \"\"\n\n if C.MODE == \"paper\":\n try:\n get_quote(addr, SOL_NATIVE, str(lam))\n except Exception:\n pass\n else:\n # Urgent exit (Ranking Exit / Hard SL / Engine Stop) uses higher slippage to ensure fill\n is_urgent = reason in (\"RankExit\", \"StopExit\", \"QuickSL\") or reason.startswith(\"SL(\") or reason.startswith(\"RISK:\")\n slippage = C.SLIPPAGE_SELL_URGENT if is_urgent else C.SLIPPAGE_SELL\n tx_hash = _live_sell(addr, lam, slippage, sym)\n\n pos[\"holdAmount\"] = str(hold - sell_amt)\n add_trade(_make_trade(\"sell\", addr, sym, f\"{abs(p_sol + b_sol * ratio):.6f}\", str(sell_amt),\n pos.get(\"lastCheckPrice\", \"0\"), tx_hash, reason, f\"{pnl:.2f}\", f\"{p_sol:.6f}\"))\n\n td = today_stats()\n td[\"pnlSol\"] += p_sol\n td[\"trades\"] += 1\n if p_sol >= 0:\n td[\"wins\"] += 1\n _record_session_win()\n else:\n td[\"losses\"] += 1\n _record_session_loss(abs(p_sol))\n update_today(td)\n\n if ratio >= 1 or pnl \u003c 0:\n _cooldown[addr] = time.time() * 1000\n\n # Cleanup old cooldowns\n now = time.time() * 1000\n for k in list(_cooldown):\n if now - _cooldown[k] > 86400000:\n del _cooldown[k]\n\n\ndef _live_sell(addr, lamports, slippage, sym):\n w_addr = _wallet_cache or wallet_addr()\n try:\n return _exec_sell(addr, lamports, slippage, w_addr)\n except Exception as e1:\n log(\"WARN\", f\"{sym}: full sell failed ({e1}), trying batch 50%+50%...\")\n half = lamports // 2\n rest = lamports - half\n tx_hash = \"\"\n try:\n tx_hash = _exec_sell(addr, half, slippage, w_addr)\n log(\"SELL\", f\"{sym}: batch 1/2 OK (tx: {tx_hash})\")\n except Exception as e2:\n raise RuntimeError(f\"batch sell 1/2 failed: {e2}\")\n time.sleep(2)\n try:\n tx2 = _exec_sell(addr, rest, slippage, w_addr)\n log(\"SELL\", f\"{sym}: batch 2/2 OK (tx: {tx2})\")\n except Exception as e3:\n log(\"WARN\", f\"{sym}: batch 2/2 failed ({e3}), partial sell only\")\n return tx_hash\n\n\ndef _exec_sell(addr, lamports, slippage, w_addr):\n sw = get_swap(addr, SOL_NATIVE, str(lamports), w_addr, slippage)\n tx_data = (sw or {}).get(\"tx\", {})\n if not tx_data.get(\"data\"):\n raise RuntimeError(f\"No sell callData: {json.dumps(sw)[:200]}\")\n r = sign_and_send(tx_data[\"data\"], tx_data[\"to\"])\n if not r[\"success\"]:\n raise RuntimeError(f\"sell tx failed: {r['error']}\")\n return r.get(\"txHash\", \"\")\n\n\n# ── Layer 3: Unconfirmed positions ──────────────────────────────────────\n\ndef _check_unconfirmed():\n if not _unconfirmed:\n return\n TIMEOUT_MS = 180000\n MAX_ZERO = 10\n\n for addr in list(_unconfirmed):\n entry = _unconfirmed[addr]\n pos = entry[\"pos\"]\n elapsed = time.time() * 1000 - entry[\"start_time\"]\n\n bal = query_token_balance(addr)\n\n if bal > 0:\n pos[\"holdAmount\"] = str(bal)\n pos[\"unconfirmed\"] = False\n pos[\"triggerReason\"] = pos[\"triggerReason\"].replace(\" (unconfirmed)\", \" (confirmed)\")\n with _state_lock:\n all_pos = load_positions()\n all_pos.append(pos)\n save_positions(all_pos)\n del _unconfirmed[addr]\n log(\"CONFIRMED\", f\"{pos['tokenSymbol']} | balance: {bal} | confirmed after {elapsed / 1000:.0f}s\")\n continue\n\n if bal == -1:\n log(\"WARN\", f\"{pos['tokenSymbol']}: RPC error checking balance, skipping\")\n continue\n\n entry[\"zero_count\"] += 1\n if entry[\"zero_count\"] >= MAX_ZERO and elapsed > TIMEOUT_MS:\n del _unconfirmed[addr]\n log(\"UNCONFIRMED_EXPIRED\", f\"{pos['tokenSymbol']} | {entry['zero_count']} zero checks over {elapsed / 1000:.0f}s -> position discarded\")\n else:\n log(\"UNCONFIRMED\", f\"{pos['tokenSymbol']} | zero #{entry['zero_count']}/{MAX_ZERO} | {elapsed / 1000:.0f}s/{TIMEOUT_MS / 1000:.0f}s\")\n\n\n# ── Layer 4: Wallet Audit ───────────────────────────────────────────────\n\ndef _audit_loop():\n while not _stop_event.is_set():\n _stop_event.wait(C.HEALTH_CHECK_SEC)\n if _running and C.MODE == \"live\":\n _wallet_audit()\n\n\ndef _wallet_audit():\n global _audit_busy\n if _audit_busy:\n return\n _audit_busy = True\n try:\n if C.MODE != \"live\":\n return\n\n pos = load_positions()\n wallet_tokens = get_wallet_tokens()\n\n if len(wallet_tokens) == 0 and len(pos) > 0:\n log(\"AUDIT\", f\"Skipped - wallet API returned 0 tokens but we have {len(pos)} position(s)\")\n return\n\n wallet_map = {}\n for wt in wallet_tokens:\n # [C3] tokenContractAddress is None in wallet balance — use tokenAddress\n wt_addr = wt.get(\"tokenAddress\") or wt.get(\"tokenContractAddress\") or \"\"\n if wt_addr:\n wallet_map[wt_addr] = sf(wt.get(\"balance\"))\n\n drifts = 0\n AUDIT_COOLDOWN_MS = 300000\n\n for p in pos:\n addr = p[\"tokenAddress\"]\n wallet_bal = wallet_map.get(addr)\n\n if wallet_bal is None or wallet_bal \u003c= 0:\n age = time.time() * 1000 - (p.get(\"buyTimestamp\", 0) or 0)\n if age \u003c AUDIT_COOLDOWN_MS:\n log(\"AUDIT\", f\"{p['tokenSymbol']}: not in wallet but only {age / 1000:.0f}s old, keeping (cooldown)\")\n continue\n direct_bal = query_token_balance(addr)\n if direct_bal > 0:\n log(\"AUDIT\", f\"{p['tokenSymbol']}: not in wallet list but direct query shows {direct_bal}, keeping\")\n p[\"holdAmount\"] = str(direct_bal)\n drifts += 1\n continue\n if direct_bal == -1:\n log(\"AUDIT\", f\"{p['tokenSymbol']}: RPC error on direct check, keeping\")\n continue\n log(\"AUDIT\", f\"Ghost: {p['tokenSymbol']} in positions but NOT in wallet -> removing\")\n p[\"_remove\"] = True\n drifts += 1\n else:\n local_bal = sf(p.get(\"holdAmount\"))\n diff = abs(wallet_bal - local_bal)\n if local_bal > 0 and diff / local_bal > 0.01:\n log(\"AUDIT\", f\"Drift: {p['tokenSymbol']} local={local_bal} chain={wallet_bal} -> correcting\")\n p[\"holdAmount\"] = str(wallet_bal)\n drifts += 1\n\n # Check for orphaned tokens\n pos_addrs = set(p[\"tokenAddress\"] for p in pos)\n all_trades = load_trades()\n buy_map = {}\n for t in all_trades:\n if t.get(\"direction\") == \"buy\":\n buy_map[t.get(\"tokenAddress\", \"\")] = t\n\n for wt in wallet_tokens:\n # [C3] use tokenAddress (tokenContractAddress is None)\n wt_addr = wt.get(\"tokenAddress\") or wt.get(\"tokenContractAddress\") or \"\"\n if wt_addr in pos_addrs or wt_addr in _unconfirmed:\n continue\n buy_trade = buy_map.get(wt_addr)\n if not buy_trade:\n continue\n hold_amt = sf(wt.get(\"balance\"))\n if hold_amt \u003c= 0:\n continue\n pos.append({\n \"tokenAddress\": wt_addr,\n \"tokenSymbol\": wt.get(\"symbol\") or buy_trade.get(\"tokenSymbol\", \"?\"),\n \"decimal\": int(sf(wt.get(\"decimal\"), 9)),\n \"buyPrice\": buy_trade.get(\"priceUsd\", \"0\"),\n \"buyAmountSol\": buy_trade.get(\"amountSol\", \"0\"),\n \"holdAmount\": str(hold_amt),\n \"buyCount\": 1,\n \"buyTimestamp\": buy_trade.get(\"timestamp\", int(time.time() * 1000)),\n \"lastCheckPrice\": buy_trade.get(\"priceUsd\", \"0\"),\n \"lastCheckTime\": int(time.time() * 1000),\n \"peakPrice\": buy_trade.get(\"priceUsd\", \"0\"),\n \"takeProfitTier\": 0,\n \"triggerReason\": \"Recovered(audit)\",\n \"safetyData\": {},\n })\n drifts += 1\n log(\"AUDIT\", f\"Recovered orphan: {wt.get('symbol') or wt_addr[:8]} ({hold_amt})\")\n\n if drifts > 0:\n cleaned = [p for p in pos if not p.get(\"_remove\")]\n for p in cleaned:\n p.pop(\"_remove\", None)\n save_positions(cleaned)\n log(\"AUDIT\", f\"Fixed {drifts} drift(s), {len(cleaned)} active position(s)\")\n\n except Exception as e:\n log(\"WARN\", f\"Wallet audit failed: {e}\")\n finally:\n _audit_busy = False\n\n\n# ── HTTP Server ─────────────────────────────────────────────────────────\n\nclass DashHandler(BaseHTTPRequestHandler):\n\n def log_message(self, fmt, *args):\n pass # suppress access logs\n\n def _cors(self):\n self.send_header(\"Access-Control-Allow-Origin\", \"*\")\n self.send_header(\"Access-Control-Allow-Methods\", \"GET, POST, OPTIONS\")\n self.send_header(\"Access-Control-Allow-Headers\", \"Content-Type\")\n\n def _json(self, data, status=200):\n body = json.dumps(data, ensure_ascii=False).encode(\"utf-8\")\n self.send_response(status)\n self.send_header(\"Content-Type\", \"application/json\")\n self._cors()\n self.end_headers()\n self.wfile.write(body)\n\n def do_OPTIONS(self):\n self.send_response(204)\n self._cors()\n self.end_headers()\n\n def do_GET(self):\n path = self.path.split(\"?\")[0]\n\n if path == \"/\" or path == \"/index.html\":\n html_path = PROJECT_DIR / \"dashboard.html\"\n if html_path.exists():\n self.send_response(200)\n self.send_header(\"Content-Type\", \"text/html; charset=utf-8\")\n self.end_headers()\n self.wfile.write(html_path.read_bytes())\n else:\n self.send_response(404)\n self.end_headers()\n self.wfile.write(b\"dashboard.html not found\")\n return\n\n if path == \"/api/state\":\n s = engine_state()\n if s[\"mode\"] == \"live\":\n try:\n s[\"wallet\"] = wallet_addr()\n s[\"solBalance\"] = sol_balance()\n except Exception:\n pass\n s[\"positions\"] = load_positions()\n s[\"trades\"] = load_trades()\n s[\"logs\"] = get_logs(50)\n s[\"roster\"] = get_roster()\n self._json(s)\n return\n\n if path == \"/health\":\n self._json({\"ok\": True})\n return\n\n self.send_response(404)\n self.end_headers()\n\n def do_POST(self):\n path = self.path.split(\"?\")[0]\n body = {}\n cl = int(self.headers.get(\"Content-Length\", 0))\n if cl > 0:\n try:\n body = json.loads(self.rfile.read(cl))\n except Exception:\n pass\n\n if path == \"/api/start\":\n self._json(engine_start())\n return\n\n if path == \"/api/stop\":\n self._json(engine_stop())\n return\n\n if path == \"/api/mode\":\n mode = body.get(\"mode\")\n if mode not in (\"paper\", \"live\"):\n self._json({\"ok\": False, \"msg\": 'mode must be \"paper\" or \"live\"'})\n return\n if _running:\n self._json({\"ok\": False, \"msg\": \"Stop engine before switching mode\"})\n return\n if mode == \"live\":\n try:\n wallet_addr()\n except Exception as e:\n self._json({\"ok\": False, \"msg\": f\"Live mode requires onchainos wallet login: {e}\"})\n return\n C.MODE = mode\n self._json({\"ok\": True, \"msg\": f\"Mode switched to {mode}\"})\n return\n\n if path == \"/api/reset\":\n if _running:\n self._json({\"ok\": False, \"msg\": \"Stop engine before reset\"})\n return\n mode = C.MODE\n state_write(f\"{mode}/positions.json\", [])\n state_write(f\"{mode}/trades.json\", [])\n state_write(f\"{mode}/daily-stats.json\", {})\n state_write(f\"{mode}/signals-log.json\", [])\n label = \"Paper\" if mode == \"paper\" else \"Live\"\n self._json({\"ok\": True, \"msg\": f\"{label} data cleared\"})\n return\n\n self.send_response(404)\n self.end_headers()\n\n\n# ── Main ────────────────────────────────────────────────────────────────\n\ndef main():\n print(\"=\" * 60)\n print(\" Top Rank Tokens Sniper v1.0\")\n print(f\" Mode: {C.MODE}\")\n print(f\" Budget: {C.TOTAL_BUDGET} SOL | Per Trade: {C.BUY_AMOUNT} SOL\")\n print(f\" Max Positions: {C.MAX_POSITIONS}\")\n print(f\" Dashboard: http://localhost:{C.DASHBOARD_PORT}\")\n print(\"=\" * 60)\n\n _check_onchainos()\n _ensure_dir(STATE_DIR / \"paper\")\n _ensure_dir(STATE_DIR / \"live\")\n\n server = HTTPServer((\"127.0.0.1\", C.DASHBOARD_PORT), DashHandler)\n print(f\"\\n Dashboard ready: http://localhost:{C.DASHBOARD_PORT}\\n\")\n\n try:\n server.serve_forever()\n except KeyboardInterrupt:\n print(\"\\n Shutting down...\")\n if _running:\n engine_stop()\n server.server_close()\n print(\" Done.\")\n\n\nif __name__ == \"__main__\":\n main()\n","content_type":"text/x-python; charset=utf-8","language":"python","size":54317,"content_sha256":"c498f0e0d6011e24760f2bef851d8ce57b694cc531e4df8a71bd01731b14427a"},{"filename":"scripts/risk_check.py","content":"\"\"\"\nrisk_check.py — Standalone pre/post trade risk assessment for Solana meme tokens.\nDrop-in module for any skill: Top Rank Tokens Sniper, Smart Money Signal Copy Trade, Meme Trench Scanner, or future strategies.\n\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\nOVERVIEW\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\nTwo public functions:\n\n pre_trade_checks(addr, sym) — pre-trade gate. Call before entering any position.\n post_trade_flags(addr, sym) — post-trade monitor. Call periodically while in position.\n\nAll data comes from onchainos CLI (~/.local/bin/onchainos). No extra API keys needed.\nRequires onchainos v2.1.0+.\n\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\nSEVERITY GRADES\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\nGrade 4 — HARD BLOCK. Do not enter. Abort immediately.\n Triggers: honeypot, buy/sell tax >50%, dev actively removing liquidity,\n liquidity \u003c$5K, OKX riskControlLevel ≥4, active dev/insider dump ≥5 SOL/min.\n\nGrade 3 — STRONG WARNING. Do not enter. Too risky.\n Triggers: serial rugger (≥3 rugs), rug rate >50%, LP \u003c80% burned,\n volume plunge tag, snipers >15%,\n suspicious wallets >10%, soft rug velocity 1–5 SOL/min,\n single LP provider with unburned LP, wash trading (round-trip wallets),\n coordinated holder sells (dev/whale/insider/sniper ≥2 sells in 10 min).\n\nGrade 2 — CAUTION. Proceed with awareness. Log the flags.\n Triggers: top 10 wallets hold >30%, bundles still in >5%, dev sold all (non-CTO),\n paid DexScreener listing, no smart money detected.\n\nGrade 0 — PASS. All checks clear.\n\nresult[\"pass\"] is True when grade \u003c 3 (grades 0 and 2 are both tradeable).\n\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\nPRE-TRADE INTEGRATION (pre_trade_checks)\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\nCall this BEFORE the swap/buy, after basic filters (liquidity, MC) pass.\nStore the entry snapshots from result[\"raw\"] on the position record for\npost-trade monitoring — they are needed by post_trade_flags().\n\n import sys, os\n sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))\n from risk_check import pre_trade_checks, post_trade_flags\n\n # --- Pre-trade gate (quick=True: 4 calls, ~0.8s — includes wash trading check) ---\n result = pre_trade_checks(token_address, token_symbol, quick=True)\n\n if result[\"grade\"] >= 4:\n log(f\"BLOCKED {sym} — {result['reasons']}\")\n return # hard stop, do not trade\n\n if result[\"grade\"] == 3:\n log(f\"WARN {sym} — {result['reasons']}\")\n return # too risky, skip\n\n if result[\"grade\"] == 2:\n log(f\"CAUTION {sym} — {result['cautions']}\")\n # proceed but note the flags\n\n # --- Execute buy ---\n execute_swap(...)\n\n # --- Persist entry snapshots for post-trade use ---\n position[\"entry_liquidity_usd\"] = result[\"raw\"][\"liquidity_usd\"]\n position[\"entry_top10\"] = result[\"raw\"][\"info\"].get(\"top10HoldPercent\", 0)\n position[\"entry_sniper_pct\"] = result[\"raw\"][\"info\"].get(\"sniperHoldingPercent\", 0)\n position[\"risk_last_checked\"] = 0 # tracks throttle timestamp\n\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\nPOST-TRADE INTEGRATION (post_trade_flags)\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\nCall this inside your position monitor loop. THROTTLE to once per 60 seconds\nper position — each call makes 4–6 onchainos API requests.\n\nIMPORTANT: Run post_trade_flags() in a background thread so it does not block\nyour monitor loop. It makes multiple sequential API calls (~1–2s) and must not\nstall position updates, trailing stop logic, or TP/SL checks for other positions.\n\n import threading\n\n def _check_flags(pos):\n flags = post_trade_flags(\n pos[\"address\"],\n pos[\"symbol\"],\n entry_liquidity_usd = pos[\"entry_liquidity_usd\"],\n entry_top10 = pos[\"entry_top10\"],\n entry_sniper_pct = pos[\"entry_sniper_pct\"],\n )\n for flag in flags:\n log(flag)\n if flag.startswith(\"EXIT_NOW\"):\n close_position(pos, reason=flag)\n break\n elif flag.startswith(\"EXIT_NEXT_TP\"):\n # tighten trailing stop or take partial profit early\n pass\n elif flag.startswith(\"REDUCE_POSITION\"):\n # cut size if partial sells are supported\n pass\n\n # --- Inside monitor loop, per open position (throttled to once per 60s) ---\n now = time.time()\n if now - position.get(\"risk_last_checked\", 0) >= 60:\n position[\"risk_last_checked\"] = now\n threading.Thread(target=_check_flags, args=(position,), daemon=True).start()\n\nPost-trade flag meanings:\n EXIT_NOW: ... — close immediately (dev rug, liquidity drain >30%, active dump, holder selling)\n EXIT_NEXT_TP: ... — exit at next take profit or trailing stop (volume plunge, soft rug)\n REDUCE_POSITION: ... — cut position size (sniper spike)\n ALERT: ... — informational, no action required\n\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\nCLI USAGE (standalone token check)\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n python3 risk_check.py \u003ctoken_address> [symbol]\n\nExample:\n python3 risk_check.py 58piN8dJJBcjHj28LZzTGJTygAX6DoF22sfY1R7Apump horseballs\n\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\nWHAT IT CHECKS (data sources)\n━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n [quick + full mode]\n security token-scan → honeypot flag, buy/sell tax\n token advanced-info → dev rug history, LP burn %, sniper %, tokenTags,\n riskControlLevel, top10 hold %, bundle %, suspicious wallets\n token price-info → liquidity USD snapshot\n token trades → all recent trades (wash trading: round-trip + concentration)\n\n [full mode only — quick=False]\n token liquidity → LP pool creators (concentration check)\n token trades --tag-filter → dev (2), whale (4), insider (6), sniper (7) sell activity\n used for: selling velocity + holder sell coordination\n\"\"\"\n\nimport subprocess, json, os, time\nfrom collections import defaultdict\n\n_ONCHAINOS = os.path.expanduser(\"~/.local/bin/onchainos\")\n_CHAIN = \"solana\"\n_CHAIN_ID = \"501\"\n\n# Selling velocity — SOL sold per minute thresholds\n_SELL_VEL_WARN_SOL_PM = 1.0 # G3: > 1 SOL/min from dev/insiders\n_SELL_VEL_BLOCK_SOL_PM = 5.0 # G4: > 5 SOL/min (active dump)\n\n# Wash trading — round-trip detection thresholds\n_WASH_ROUNDTRIP_RATIO = 0.50 # G3: ≥50% of active wallets round-tripped alone\n_WASH_ROUNDTRIP_SOFT = 0.30 # G3: ≥30% round-tripped AND concentration above threshold\n_WASH_CONC_THRESHOLD = 0.40 # top-3 wallets driving >40% of all trades = suspicious\n\n# LP checks\n_LP_SINGLE_PROVIDER_WARN = True # G3: single LP provider + LP not burned\n_LP_DRAIN_EXIT_PCT = 0.30 # post-trade: exit if liquidity drops > 30%\n\n\n# ── Internal CLI wrapper ───────────────────────────────────────────────────────\n\ndef _onchainos(*args, timeout: int = 20) -> dict:\n try:\n r = subprocess.run([_ONCHAINOS, *args],\n capture_output=True, text=True, timeout=timeout)\n return json.loads(r.stdout)\n except Exception:\n return {\"ok\": False, \"data\": None}\n\ndef _data(r: dict):\n d = r.get(\"data\")\n if isinstance(d, list):\n return d[0] if d else {}\n return d or {}\n\ndef _data_list(r: dict) -> list:\n d = r.get(\"data\")\n return d if isinstance(d, list) else []\n\n\n# ── API calls ─────────────────────────────────────────────────────────────────\n\ndef _security_scan(addr: str) -> dict:\n r = _onchainos(\"security\", \"token-scan\",\n \"--tokens\", f\"{_CHAIN_ID}:{addr}\")\n d = _data(r)\n return d if isinstance(d, dict) else {}\n\ndef _advanced_info(addr: str) -> dict:\n r = _onchainos(\"token\", \"advanced-info\",\n \"--chain\", _CHAIN, \"--address\", addr)\n d = _data(r)\n return d if isinstance(d, dict) else {}\n\ndef _liquidity_usd(addr: str) -> float:\n \"\"\"Current total liquidity in USD from price-info.\"\"\"\n r = _onchainos(\"token\", \"price-info\",\n \"--chain\", _CHAIN, \"--address\", addr)\n items = _data_list(r)\n if not items:\n items = [_data(r)]\n for item in items:\n if isinstance(item, dict) and item.get(\"liquidity\"):\n try:\n return float(item[\"liquidity\"])\n except (ValueError, TypeError):\n pass\n return -1.0\n\ndef _lp_pools(addr: str) -> list:\n \"\"\"Top LP pools with creator info.\"\"\"\n r = _onchainos(\"token\", \"liquidity\",\n \"--chain\", _CHAIN, \"--address\", addr)\n return _data_list(r)\n\ndef _tagged_trades(addr: str, tag: int, limit: int = 50) -> list:\n \"\"\"Trades filtered by wallet tag (2=dev, 4=whale, 6=insider, 7=sniper).\"\"\"\n r = _onchainos(\"token\", \"trades\",\n \"--chain\", _CHAIN, \"--address\", addr,\n \"--tag-filter\", str(tag),\n \"--limit\", str(limit))\n return _data_list(r)\n\ndef _recent_trades(addr: str, limit: int = 100) -> list:\n \"\"\"All recent trades.\"\"\"\n r = _onchainos(\"token\", \"trades\",\n \"--chain\", _CHAIN, \"--address\", addr,\n \"--limit\", str(limit))\n return _data_list(r)\n\n\n# ── Helpers ───────────────────────────────────────────────────────────────────\n\ndef _tags(info: dict) -> list:\n return info.get(\"tokenTags\") or []\n\ndef _has_tag(info: dict, prefix: str) -> bool:\n return any(t.startswith(prefix) for t in _tags(info))\n\ndef _pct(info: dict, field: str) -> float:\n v = info.get(field, \"\") or \"\"\n try:\n return float(v)\n except (ValueError, TypeError):\n return -1.0\n\ndef _int(info: dict, field: str) -> int:\n v = info.get(field, 0) or 0\n try:\n return int(v)\n except (ValueError, TypeError):\n return 0\n\ndef _trade_sol(trade: dict) -> float:\n \"\"\"Extract SOL amount from a trade's changedTokenInfo.\"\"\"\n for t in trade.get(\"changedTokenInfo\", []):\n if t.get(\"tokenSymbol\") in (\"SOL\", \"wSOL\"):\n try:\n return float(t.get(\"amount\", 0))\n except (ValueError, TypeError):\n pass\n try:\n return float(trade.get(\"volume\", 0))\n except (ValueError, TypeError):\n return 0.0\n\n\n# ── Check 1: Selling velocity (dev + insider sells) ───────────────────────────\n\ndef _selling_velocity(addr: str) -> tuple:\n \"\"\"\n Returns (sol_per_min, reason_str).\n Checks dev (tag=2) + insider (tag=6) sells over last 50 trades.\n Detects soft rugs: steady sell pressure from privileged wallets.\n \"\"\"\n sells_by_wallet = defaultdict(list) # wallet -> [(timestamp_ms, sol)]\n\n for tag in (2, 6): # dev + insider\n for trade in _tagged_trades(addr, tag, limit=50):\n if trade.get(\"type\") != \"sell\":\n continue\n ts = int(trade.get(\"time\", 0))\n sol = _trade_sol(trade)\n if sol > 0 and ts > 0:\n sells_by_wallet[trade.get(\"userAddress\", \"?\")].append((ts, sol))\n\n if not sells_by_wallet:\n return 0.0, \"\"\n\n now_ms = int(time.time() * 1000)\n window = 5 * 60 * 1000 # 5-minute window\n total_sol = 0.0\n wallets = []\n\n for wallet, events in sells_by_wallet.items():\n recent = [(ts, sol) for ts, sol in events if now_ms - ts \u003c= window]\n if recent:\n sol_sum = sum(s for _, s in recent)\n total_sol += sol_sum\n wallets.append(f\"{wallet[:8]}…({sol_sum:.2f}SOL)\")\n\n if total_sol == 0:\n return 0.0, \"\"\n\n elapsed_min = window / 60000\n sol_pm = total_sol / elapsed_min\n detail = f\"{sol_pm:.2f} SOL/min — {', '.join(wallets)}\"\n return sol_pm, detail\n\n\n# ── Check 2: LP provider concentration ────────────────────────────────────────\n\ndef _lp_provider_check(addr: str, lp_burned: float) -> tuple:\n \"\"\"\n Returns (is_risky, reason_str).\n Single LP provider + LP not burned = high rug risk.\n \"\"\"\n pools = _lp_pools(addr)\n if not pools:\n return False, \"\"\n\n # Count unique creators across pools with meaningful liquidity\n creators = set()\n for pool in pools:\n liq = 0.0\n try:\n liq = float(pool.get(\"liquidityUsd\", 0))\n except (ValueError, TypeError):\n pass\n if liq > 100: # ignore dust pools\n creator = pool.get(\"poolCreator\", \"\")\n if creator:\n creators.add(creator)\n\n if len(creators) == 1 and lp_burned \u003c 80:\n creator = next(iter(creators))\n total_liq = sum(\n float(p.get(\"liquidityUsd\", 0) or 0) for p in pools\n )\n return (\n True,\n f\"SINGLE_LP_PROVIDER — {creator[:12]}… controls \"\n f\"${total_liq:,.0f} liquidity, LP only {lp_burned:.0f}% burned\"\n )\n\n return False, \"\"\n\n\n# ── Check 3: Wash trading ─────────────────────────────────────────────────────\n\ndef _wash_trading_check(addr: str) -> tuple:\n \"\"\"\n Returns (is_wash, reason_str).\n Detects wash trading via two signals:\n 1. Round-trip wallets — wallets that both buy AND sell within a 5-min window.\n Flags if ≥50% of active wallets are round-tripping (strong signal alone),\n or ≥30% round-tripping AND top-3 wallets drive >40% of trades (combined signal).\n 2. Wallet concentration — high trade share from a tiny set of wallets amplifies\n the round-trip signal, indicating coordinated volume inflation.\n Uses 200 recent trades for statistical reliability (~0.2s, one API call).\n \"\"\"\n trades = _recent_trades(addr, limit=200)\n if len(trades) \u003c 15:\n return False, \"\"\n\n wallet_buys = defaultdict(list) # wallet -> [timestamp_ms, ...]\n wallet_sells = defaultdict(list)\n wallet_count = defaultdict(int)\n\n for t in trades:\n w = t.get(\"userAddress\", \"\")\n ts = int(t.get(\"time\", 0))\n if not w or ts == 0:\n continue\n wallet_count[w] += 1\n if t.get(\"type\") == \"buy\":\n wallet_buys[w].append(ts)\n else:\n wallet_sells[w].append(ts)\n\n active_wallets = set(wallet_buys) | set(wallet_sells)\n if not active_wallets:\n return False, \"\"\n\n # Round-trip: any buy followed by a sell from the same wallet within 5 min\n window_ms = 5 * 60 * 1000\n rt_wallets = 0\n for w in active_wallets:\n buys = sorted(wallet_buys[w])\n sells = sorted(wallet_sells[w])\n if not buys or not sells:\n continue\n if any(any(s > b and s - b \u003c= window_ms for s in sells) for b in buys):\n rt_wallets += 1\n\n total_wallets = len(active_wallets)\n rt_ratio = rt_wallets / total_wallets\n\n # Wallet concentration: top-3 wallets share of all trades\n top3 = sum(c for _, c in sorted(wallet_count.items(), key=lambda x: -x[1])[:3])\n concentration = top3 / len(trades)\n\n if rt_ratio >= _WASH_ROUNDTRIP_RATIO:\n return (\n True,\n f\"WASH_TRADING — {rt_wallets}/{total_wallets} wallets round-tripped \"\n f\"({rt_ratio*100:.0f}%) within 5-min windows\"\n )\n if rt_ratio >= _WASH_ROUNDTRIP_SOFT and concentration >= _WASH_CONC_THRESHOLD:\n return (\n True,\n f\"WASH_TRADING — {rt_wallets}/{total_wallets} wallets round-tripped \"\n f\"({rt_ratio*100:.0f}%) + top-3 wallets drive {concentration*100:.0f}% of volume\"\n )\n\n return False, \"\"\n\n\n# ── Check 4: Holder sell transfers ────────────────────────────────────────────\n\ndef _holder_sell_check(addr: str) -> tuple:\n \"\"\"\n Returns (is_selling, reason_str).\n Detects coordinated sells from tagged wallets (dev, whale, insider, sniper).\n Pre-trade: catch early distribution before price drops.\n \"\"\"\n tag_names = {2: \"Dev\", 4: \"Whale\", 6: \"Insider\", 7: \"Sniper\"}\n now_ms = int(time.time() * 1000)\n window = 10 * 60 * 1000 # 10-minute window\n findings = []\n\n for tag, label in tag_names.items():\n trades = _tagged_trades(addr, tag, limit=30)\n recent_sells = [\n t for t in trades\n if t.get(\"type\") == \"sell\"\n and now_ms - int(t.get(\"time\", 0)) \u003c= window\n ]\n if len(recent_sells) >= 2:\n sol = sum(_trade_sol(t) for t in recent_sells)\n findings.append(f\"{label}×{len(recent_sells)}({sol:.2f}SOL)\")\n\n if findings:\n return True, \"HOLDER_SELLING — \" + \", \".join(findings) + \" in last 10min\"\n return False, \"\"\n\n\n# ── Core risk check ───────────────────────────────────────────────────────────\n\ndef pre_trade_checks(addr: str, sym: str, quick: bool = False) -> dict:\n \"\"\"\n Run pre-trade risk assessment.\n\n quick=True — fast mode (4 API calls, ~0.8s). Use for pre-trade gates.\n Runs: security scan + advanced-info + price-info + wash trading.\n Skips: selling velocity, LP provider, holder sells.\n Those slow checks are better handled by post_trade_flags() monitoring.\n\n quick=False — full mode (11 API calls, ~22–33s). Use for manual analysis only.\n\n Returns:\n {\n \"pass\": bool,\n \"grade\": int, # 4=block, 3=warn, 2=caution, 0=pass\n \"level\": int, # alias for grade (backward compatibility)\n \"reasons\": [str], # grade 4 + 3 failures\n \"cautions\": [str], # grade 2 flags\n \"raw\": {\n \"scan\": dict,\n \"info\": dict,\n \"liquidity_usd\": float # snapshot for post-trade monitoring\n }\n }\n \"\"\"\n scan = _security_scan(addr)\n info = _advanced_info(addr)\n liq_usd = _liquidity_usd(addr)\n lp_burned = _pct(info, \"lpBurnedPercent\")\n\n reasons = []\n cautions = []\n level = 0\n\n # ── Grade 4 — Hard Block ─────────────────────────────────────────────────\n\n if scan.get(\"isRiskToken\"):\n reasons.append(\"G4: HONEYPOT — isRiskToken flagged by OKX\")\n level = 4\n\n buy_tax = _pct(scan, \"buyTaxes\")\n if buy_tax > 50:\n reasons.append(f\"G4: BUY_TAX {buy_tax:.0f}% > 50%\")\n level = 4\n\n sell_tax = _pct(scan, \"sellTaxes\")\n if sell_tax > 50:\n reasons.append(f\"G4: SELL_TAX {sell_tax:.0f}% > 50%\")\n level = 4\n\n if _has_tag(info, \"devRemoveLiq\"):\n tag = next(t for t in _tags(info) if t.startswith(\"devRemoveLiq\"))\n reasons.append(f\"G4: DEV_REMOVING_LIQUIDITY — {tag}\")\n level = 4\n\n if _has_tag(info, \"lowLiquidity\"):\n reasons.append(\"G4: LOW_LIQUIDITY — total liquidity \u003c $5K\")\n level = 4\n\n risk_lvl = _int(info, \"riskControlLevel\")\n if risk_lvl >= 4:\n reasons.append(f\"G4: OKX_RISK_LEVEL {risk_lvl} >= 4\")\n level = 4\n\n # Selling velocity — active dump (slow check, full mode only)\n vel_sol_pm, vel_detail = (0.0, \"\") if quick else _selling_velocity(addr)\n if vel_sol_pm >= _SELL_VEL_BLOCK_SOL_PM:\n reasons.append(f\"G4: ACTIVE_DUMP — {vel_detail}\")\n level = 4\n\n # ── Grade 3 — Strong Warning ─────────────────────────────────────────────\n\n rug_count = _int(info, \"devRugPullTokenCount\")\n dev_created = _int(info, \"devCreateTokenCount\")\n\n if dev_created > 0:\n rug_rate = rug_count / dev_created\n if rug_rate >= 0.20 and rug_count >= 3:\n reasons.append(\n f\"G3: SERIAL_RUGGER — {rug_count}/{dev_created} tokens rugged \"\n f\"({rug_rate*100:.0f}%)\"\n )\n level = max(level, 3)\n elif rug_rate >= 0.05 and rug_count >= 2:\n cautions.append(\n f\"G2: RUG_HISTORY — {rug_count}/{dev_created} tokens rugged \"\n f\"({rug_rate*100:.0f}%)\"\n )\n elif rug_count >= 5:\n # devCreateTokenCount unavailable — fall back to flat count\n reasons.append(f\"G3: SERIAL_RUGGER — {rug_count} confirmed rug pulls (no total count)\")\n level = max(level, 3)\n\n if 0 \u003c= lp_burned \u003c 80:\n reasons.append(f\"G3: LP_NOT_BURNED — {lp_burned:.1f}% burned (\u003c 80%)\")\n level = max(level, 3)\n\n if _has_tag(info, \"volumeChangeRateVolumePlunge\"):\n reasons.append(\"G3: VOLUME_PLUNGE — trading activity collapsing\")\n level = max(level, 3)\n\n\n sniper_pct = _pct(info, \"sniperHoldingPercent\")\n if sniper_pct > 15:\n reasons.append(f\"G3: SNIPERS_HOLDING {sniper_pct:.1f}% > 15%\")\n level = max(level, 3)\n\n suspicious_pct = _pct(info, \"suspiciousHoldingPercent\")\n if suspicious_pct > 10:\n reasons.append(f\"G3: SUSPICIOUS_WALLETS {suspicious_pct:.1f}% > 10%\")\n level = max(level, 3)\n\n # Wash trading — round-trip + concentration (fast: 1 extra API call, ~0.2s)\n is_wash, wash_reason = _wash_trading_check(addr)\n if is_wash:\n reasons.append(f\"G3: {wash_reason}\")\n level = max(level, 3)\n\n # ── Slow checks — full mode only (post-trade covers these in real-time) ──\n\n if not quick:\n # Selling velocity — soft rug (steady bleed)\n if 0 \u003c vel_sol_pm \u003c _SELL_VEL_BLOCK_SOL_PM and vel_sol_pm >= _SELL_VEL_WARN_SOL_PM:\n reasons.append(f\"G3: SOFT_RUG_VELOCITY — {vel_detail}\")\n level = max(level, 3)\n\n # LP provider concentration\n lp_risky, lp_reason = _lp_provider_check(addr, lp_burned)\n if lp_risky:\n reasons.append(f\"G3: {lp_reason}\")\n level = max(level, 3)\n\n # Holder selling — coordinated exits from tagged wallets\n is_selling, sell_reason = _holder_sell_check(addr)\n if is_selling:\n reasons.append(f\"G3: {sell_reason}\")\n level = max(level, 3)\n\n # ── Grade 2 — Caution ────────────────────────────────────────────────────\n\n top10 = _pct(info, \"top10HoldPercent\")\n if top10 > 30:\n cautions.append(f\"G2: SUPPLY_CONCENTRATED — top 10 hold {top10:.1f}%\")\n level = max(level, 2)\n\n bundle_pct = _pct(info, \"bundleHoldingPercent\")\n if bundle_pct > 5:\n cautions.append(f\"G2: BUNDLES_STILL_IN {bundle_pct:.1f}% > 5%\")\n level = max(level, 2)\n\n is_cto = _has_tag(info, \"dexScreenerTokenCommunityTakeOver\")\n if _has_tag(info, \"devHoldingStatusSellAll\") and not is_cto:\n cautions.append(\"G2: DEV_SOLD_ALL — dev exited (not a CTO)\")\n level = max(level, 2)\n\n if _has_tag(info, \"dsPaid\"):\n cautions.append(\"G2: PAID_LISTING — dexscreener listing was paid\")\n level = max(level, 2)\n\n if not _has_tag(info, \"smartMoneyBuy\"):\n cautions.append(\"G2: NO_SMART_MONEY — no smart money wallet detected\")\n level = max(level, 2)\n\n # ── Result ────────────────────────────────────────────────────────────────\n\n passed = level \u003c 3\n\n return {\n \"pass\": passed,\n \"grade\": level,\n \"level\": level, # backward compat alias\n \"reasons\": reasons,\n \"cautions\": cautions,\n \"raw\": {\n \"scan\": scan,\n \"info\": info,\n \"liquidity_usd\": liq_usd,\n },\n }\n\n\n# ── Post-trade monitoring ─────────────────────────────────────────────────────\n\ndef post_trade_flags(addr: str, sym: str,\n entry_liquidity_usd: float = 0.0,\n entry_top10: float = 0.0,\n entry_sniper_pct: float = 0.0) -> list:\n \"\"\"\n Call periodically during position monitoring.\n\n Returns list of action strings:\n \"EXIT_NOW: ...\" — immediate exit required\n \"EXIT_NEXT_TP: ...\" — exit at next TP or trailing stop\n \"REDUCE_POSITION: ...\" — cut size\n \"ALERT: ...\" — informational\n \"\"\"\n info = _advanced_info(addr)\n liq_usd = _liquidity_usd(addr)\n flags = []\n\n # Dev removing liquidity — EXIT NOW\n if _has_tag(info, \"devRemoveLiq\"):\n tag = next((t for t in _tags(info) if t.startswith(\"devRemoveLiq\")), \"devRemoveLiq\")\n flags.append(f\"EXIT_NOW: DEV_REMOVING_LIQUIDITY — {tag}\")\n\n # Liquidity drain > 30% since entry — EXIT NOW\n if entry_liquidity_usd > 0 and liq_usd > 0:\n drain_pct = (entry_liquidity_usd - liq_usd) / entry_liquidity_usd\n if drain_pct >= _LP_DRAIN_EXIT_PCT:\n flags.append(\n f\"EXIT_NOW: LIQUIDITY_DRAIN {drain_pct*100:.0f}% — \"\n f\"${entry_liquidity_usd:,.0f} → ${liq_usd:,.0f}\"\n )\n\n # Active dump from dev/insiders — EXIT NOW\n vel_sol_pm, vel_detail = _selling_velocity(addr)\n if vel_sol_pm >= _SELL_VEL_BLOCK_SOL_PM:\n flags.append(f\"EXIT_NOW: ACTIVE_DUMP — {vel_detail}\")\n\n # Holder selling — coordinated exits\n is_selling, sell_reason = _holder_sell_check(addr)\n if is_selling:\n flags.append(f\"EXIT_NOW: {sell_reason}\")\n\n # Volume collapsing — exit at next TP\n if _has_tag(info, \"volumeChangeRateVolumePlunge\"):\n flags.append(\"EXIT_NEXT_TP: VOLUME_PLUNGE — activity collapsing\")\n\n # Soft rug velocity\n if 0 \u003c vel_sol_pm \u003c _SELL_VEL_BLOCK_SOL_PM and vel_sol_pm >= _SELL_VEL_WARN_SOL_PM:\n flags.append(f\"EXIT_NEXT_TP: SOFT_RUG_VELOCITY — {vel_detail}\")\n\n # Sniper spike\n sniper_pct = _pct(info, \"sniperHoldingPercent\")\n if sniper_pct > entry_sniper_pct + 5:\n flags.append(\n f\"REDUCE_POSITION: SNIPER_SPIKE {sniper_pct:.1f}% \"\n f\"(was {entry_sniper_pct:.1f}% at entry)\"\n )\n\n # Top 10 concentration increase\n top10 = _pct(info, \"top10HoldPercent\")\n if top10 > 40 and top10 > entry_top10 + 5:\n flags.append(\n f\"ALERT: TOP10_CONCENTRATION {top10:.1f}% \"\n f\"(was {entry_top10:.1f}% at entry)\"\n )\n\n return flags\n\n\n# ── CLI usage ─────────────────────────────────────────────────────────────────\n\nif __name__ == \"__main__\":\n import sys\n addr = sys.argv[1] if len(sys.argv) > 1 else \"\"\n sym = sys.argv[2] if len(sys.argv) > 2 else addr[:8]\n if not addr:\n print(\"Usage: python3 risk_check.py \u003ctoken_address> [symbol]\")\n sys.exit(1)\n\n print(f\"\\n{'='*55}\")\n print(f\" Risk Check — {sym}\")\n print(f\" {addr}\")\n print(f\"{'='*55}\")\n\n r = pre_trade_checks(addr, sym)\n\n level_label = {0: \"✅ PASS\", 2: \"⚠️ CAUTION\", 3: \"🚨 WARN\", 4: \"❌ BLOCK\"}\n print(f\"\\n Result: {level_label.get(r['level'], str(r['level']))}\")\n print(f\" Liquidity: ${r['raw']['liquidity_usd']:,.0f}\")\n\n if r[\"reasons\"]:\n print(\"\\n Blocks / Warnings:\")\n for reason in r[\"reasons\"]:\n print(f\" • {reason}\")\n\n if r[\"cautions\"]:\n print(\"\\n Cautions:\")\n for c in r[\"cautions\"]:\n print(f\" • {c}\")\n\n print()\n","content_type":"text/x-python; charset=utf-8","language":"python","size":30541,"content_sha256":"98345d23b0bf620786e0672c962efe8110b8c34eb663482ec38df4148ab3a31a"},{"filename":"SUMMARY.md","content":"## Overview\n\nTop Rank Tokens Sniper is a Solana ranking-leaderboard sniper that scans the OKX 1-hour gainers Top 20 every 10 seconds, snipes tokens on their first leaderboard appearance after 25 safety checks, and auto-exits when a token drops out of the Top 20.\n\nCore operations:\n\n- Scan OKX 1-hour gainers Top 20 leaderboard every 10 seconds for new entries\n- Score candidates with a 0–125 momentum score (buy ratio, price change, active traders, liquidity)\n- Run 25 pre-trade checks: 13 Slot Guard + 9 Advanced Safety + 3 Holder Risk checks\n- Manage exits via 6-layer system: rank-out (auto-sell when token leaves Top 20), stop loss, trailing stop, tiered TP, time stop, emergency exit\n- Monitor all positions and leaderboard activity on a live web dashboard\n\nTags: `sniper` `leaderboard` `solana` `meme-coin` `onchainos` `momentum`\n\n## Prerequisites\n\n- No IP/region restrictions\n- Supported chain: Solana\n- Supported tokens: OKX 1-hour gainers Top 20 leaderboard tokens on Solana\n- onchainos CLI ≥ 2.0.0 installed and authenticated (`onchainos --version` and `onchainos wallet status`)\n- Python 3.8+ (standard library only — no `pip install` required)\n- Funded Solana wallet for live trading\n\n## Quick Start\n\n1. **Install the skill**: `plugin-store install top-rank-tokens-sniper`\n2. **Configure risk**: Edit `config.py` to pick Conservative / Default / Aggressive and tune `BUY_AMOUNT`, `TOTAL_BUDGET`, `MAX_POSITIONS`, `TP_TIERS`, `STOP_LOSS_PCT`, `TRAILING_ACTIVATE`, `MAX_HOLD_HOURS`\n3. **Start in paper mode** (default, `MODE = \"paper\"`): Run `python3 ranking_sniper.py`\n4. **Open dashboard**: Visit `http://localhost:3244` to monitor the leaderboard, positions, and momentum scores\n5. **Go live**: Set `PAUSED = False` to allow new positions, then `MODE = \"live\"` to use real funds — re-confirm budget and per-trade size before switching\n6. **Stop anytime**: `pkill -f ranking_sniper.py`\n","content_type":"text/markdown; charset=utf-8","language":"markdown","size":1906,"content_sha256":"abb55fdb0467387a3183a8afd2aa0e893a69668dd08ff56cd314afc7e9702d37"}],"content_json":{"type":"doc","content":[{"type":"heading","attrs":{"level":2},"content":[{"text":"Pre-flight Dependencies (auto-injected by Plugin Store CI)","type":"text"}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"Run once per session before first use. These checks ensure required tools are installed.","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Version check (auto-injected)","type":"text"}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"AI Agent Instruction","type":"text","marks":[{"type":"strong"}]},{"text":": Run this version check before executing any commands from this skill. The check is a read-only fetch from ","type":"text"},{"text":"raw.githubusercontent.com","type":"text","marks":[{"type":"code_inline"}]},{"text":" — it does ","type":"text"},{"text":"not","type":"text","marks":[{"type":"strong"}]},{"text":" install anything. If it reports ","type":"text"},{"text":"Update available","type":"text","marks":[{"type":"code_inline"}]},{"text":", you MUST stop, surface the message to the user verbatim, and obtain explicit confirmation before running the suggested ","type":"text"},{"text":"npx skills add …","type":"text","marks":[{"type":"code_inline"}]},{"text":" command. Do not run the update silently. After a confirmed update completes, re-read this SKILL.md before proceeding.","type":"text"}]}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"# Check for skill updates (1-hour cache).\n# Network scope: this block calls raw.githubusercontent.com for the version probe only.\n# It does NOT install anything; install requires user-confirmed `npx skills add` below.\nUPDATE_CACHE=\"$HOME/.plugin-store/update-cache/top-rank-tokens-sniper\"\nCACHE_MAX=3600\nLOCAL_VER=\"1.0.0\"\nDO_CHECK=true\n\nif [ -f \"$UPDATE_CACHE\" ]; then\n CACHE_MOD=$(stat -f %m \"$UPDATE_CACHE\" 2>/dev/null || stat -c %Y \"$UPDATE_CACHE\" 2>/dev/null || echo 0)\n NOW=$(date +%s)\n AGE=$(( NOW - CACHE_MOD ))\n [ \"$AGE\" -lt \"$CACHE_MAX\" ] && DO_CHECK=false\nfi\n\nif [ \"$DO_CHECK\" = true ]; then\n REMOTE_VER=$(curl -sf --max-time 3 \"https://raw.githubusercontent.com/okx/plugin-store/main/skills/top-rank-tokens-sniper/plugin.yaml\" | grep '^version' | head -1 | tr -d '\"' | awk '{print $2}')\n if [ -n \"$REMOTE_VER\" ]; then\n mkdir -p \"$HOME/.plugin-store/update-cache\"\n echo \"$REMOTE_VER\" > \"$UPDATE_CACHE\"\n fi\nfi\n\nREMOTE_VER=$(cat \"$UPDATE_CACHE\" 2>/dev/null || echo \"$LOCAL_VER\")\nif [ \"$REMOTE_VER\" != \"$LOCAL_VER\" ]; then\n echo \"Update available: top-rank-tokens-sniper v$LOCAL_VER -> v$REMOTE_VER.\"\n echo \"ACTION REQUIRED: ask the user to confirm before running:\"\n echo \" npx skills add okx/plugin-store --skill top-rank-tokens-sniper --global\"\n echo \"(This contacts the npm registry and github.com/okx/plugin-store and overwrites this skill. Do NOT auto-run.)\"\nfi","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Install onchainos CLI + Skills (auto-injected)","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"# 1. Install onchainos CLI — pin to latest release tag, verify SHA256\n# of the installer before executing (no curl|sh from main).\nif ! command -v onchainos >/dev/null 2>&1; then\n set -e\n LATEST_TAG=$(curl -sSL --max-time 5 \\\n \"https://api.github.com/repos/okx/onchainos-skills/releases/latest\" \\\n | sed -n 's/.*\"tag_name\"[[:space:]]*:[[:space:]]*\"\\([^\"]*\\)\".*/\\1/p' | head -1)\n if [ -z \"$LATEST_TAG\" ]; then\n echo \"ERROR: failed to resolve latest onchainos release tag (network or rate limit).\" >&2\n echo \" Manual install: https://github.com/okx/onchainos-skills\" >&2\n exit 1\n fi\n\n ONCHAINOS_TMP=$(mktemp -d)\n curl -sSL --max-time 30 \\\n \"https://raw.githubusercontent.com/okx/onchainos-skills/${LATEST_TAG}/install.sh\" \\\n -o \"$ONCHAINOS_TMP/install.sh\"\n curl -sSL --max-time 30 \\\n \"https://github.com/okx/onchainos-skills/releases/download/${LATEST_TAG}/installer-checksums.txt\" \\\n -o \"$ONCHAINOS_TMP/installer-checksums.txt\"\n\n EXPECTED=$(awk '$2 ~ /install\\.sh$/ {print $1; exit}' \"$ONCHAINOS_TMP/installer-checksums.txt\")\n if command -v sha256sum >/dev/null 2>&1; then\n ACTUAL=$(sha256sum \"$ONCHAINOS_TMP/install.sh\" | awk '{print $1}')\n else\n ACTUAL=$(shasum -a 256 \"$ONCHAINOS_TMP/install.sh\" | awk '{print $1}')\n fi\n if [ -z \"$EXPECTED\" ] || [ \"$EXPECTED\" != \"$ACTUAL\" ]; then\n echo \"ERROR: onchainos installer SHA256 mismatch — refusing to execute.\" >&2\n echo \" expected=$EXPECTED actual=$ACTUAL tag=$LATEST_TAG\" >&2\n rm -rf \"$ONCHAINOS_TMP\"\n exit 1\n fi\n\n sh \"$ONCHAINOS_TMP/install.sh\"\n rm -rf \"$ONCHAINOS_TMP\"\n set +e\nfi\n\n# 2. Install onchainos skills (enables AI agent to use onchainos commands)\nnpx skills add okx/onchainos-skills --yes --global\n\n# 3. Install plugin-store skills (enables plugin discovery and management)\nnpx skills add okx/plugin-store --skill plugin-store --yes --global","type":"text"}]},{"type":"hr","attrs":{"markup":"---"}},{"type":"heading","attrs":{"level":1},"content":[{"text":"Top Rank Tokens Sniper v1.0","type":"text"}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"This is a real trading bot. Make sure you understand the risks before use. It is recommended to test in Paper mode first.","type":"text"}]}]},{"type":"hr","attrs":{"markup":"---"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Live Trading Confirmation Protocol","type":"text"}]},{"type":"paragraph","content":[{"text":"These gates are ","type":"text"},{"text":"mandatory","type":"text","marks":[{"type":"strong"}]},{"text":" for the AI agent driving this skill. Before any call that signs or broadcasts an on-chain transaction (any ","type":"text"},{"text":"onchainos swap swap","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"onchainos wallet contract-call","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"onchainos dex swap","type":"text","marks":[{"type":"code_inline"}]},{"text":", or any internal write code path that ends in a real on-chain submission), ALL of the following must be true:","type":"text"}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Paper / preview mode is the default.","type":"text","marks":[{"type":"strong"}]},{"text":" Real on-chain writes MUST NOT be broadcast unless the user has explicitly switched to live mode via the confirmation flow in rule 2. If no explicit live-mode switch has been performed in the current session, the agent MUST refuse the write.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Live-mode switch requires a typed user confirmation.","type":"text","marks":[{"type":"strong"}]},{"text":" Before flipping to live mode, the agent MUST display to the user: wallet address (","type":"text"},{"text":"onchainos wallet addresses","type":"text","marks":[{"type":"code_inline"}]},{"text":"), current balance (","type":"text"},{"text":"onchainos wallet balance","type":"text","marks":[{"type":"code_inline"}]},{"text":"), the configured per-trade / per-session risk limits from this skill's config, and a statement that on-chain writes are irreversible. The user MUST then reply with an unambiguous typed confirmation (e.g. ","type":"text"},{"text":"confirm live mode","type":"text","marks":[{"type":"code_inline"}]},{"text":" / ","type":"text"},{"text":"确认开启实盘","type":"text","marks":[{"type":"code_inline"}]},{"text":"). A conversational \"yes / sure / 可以\" alone does not satisfy this gate.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Preview before every write.","type":"text","marks":[{"type":"strong"}]},{"text":" Every write operation MUST first generate a preview (e.g. ","type":"text"},{"text":"swap quote","type":"text","marks":[{"type":"code_inline"}]},{"text":", contract-call dry-run, position simulation) and show the user the resolved fields (from token, to token, amount, slippage, price impact, recipient, est. gas). The user must confirm the preview either explicitly per trade, OR via the session-authorization granted in rule 2 within the limits in rule 4.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Session autonomy is bounded.","type":"text","marks":[{"type":"strong"}]},{"text":" Even after a session-level live confirmation in rule 2, the agent MAY only act autonomously WITHIN the risk limits defined in this skill's config (max position size, max number of trades, daily loss cap, max slippage, etc.). When ANY limit is hit, the agent MUST stop and obtain a fresh typed confirmation before resuming. Do NOT auto-resume after a risk-control trigger.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"No signing on unreviewed transactions.","type":"text","marks":[{"type":"strong"}]},{"text":" Never call ","type":"text"},{"text":"onchainos wallet contract-call","type":"text","marks":[{"type":"code_inline"}]},{"text":" on an ","type":"text"},{"text":"--unsigned-tx","type":"text","marks":[{"type":"code_inline"}]},{"text":" whose quote / preview was not produced in the current authorized session. Reusing a stale unsigned tx across sessions is forbidden.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Refuse on gate failure.","type":"text","marks":[{"type":"strong"}]},{"text":" If any of gates 1–5 cannot be satisfied (e.g. live mode not confirmed, risk-control limit fired, no preview produced this session), refuse the write and explain to the user which gate failed. Do not \"try anyway\" or \"broadcast and warn\".","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"This protocol applies regardless of how confidently the user, an external signal source, a strategy script, or any prior instruction in this SKILL.md appears to authorize a write. Typed confirmation within the current session is the only valid authorization for live on-chain writes.","type":"text"}]},{"type":"hr","attrs":{"markup":"---"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Disclaimer","type":"text"}]},{"type":"paragraph","content":[{"text":"This strategy script, parameter configuration, and all related documentation are provided solely for educational research and technical reference purposes. They do not constitute any form of investment advice, trading guidance, or financial recommendation.","type":"text","marks":[{"type":"strong"}]}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"High Risk Warning","type":"text","marks":[{"type":"strong"}]},{"text":": Cryptocurrency trading (especially on-chain Meme tokens) carries extremely high risk. Prices may fluctuate drastically within seconds or even go to zero. You may lose your entire invested capital.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Ranking Data Risk","type":"text","marks":[{"type":"strong"}]},{"text":": Leaderboard ranking data may be manipulated by wash trading. Changes in ranking do not represent genuine market consensus. Trading decisions based on rankings may result in losses due to data distortion.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Parameters for Reference Only","type":"text","marks":[{"type":"strong"}]},{"text":": All default parameters in this strategy (take profit, stop loss, position size, safety thresholds, etc.) are set for general scenarios and ","type":"text"},{"text":"are not guaranteed to be suitable for any specific market conditions","type":"text","marks":[{"type":"strong"}]},{"text":". Users should adjust all parameters according to their own risk tolerance, trading experience, and market judgment.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"User Customization","type":"text","marks":[{"type":"strong"}]},{"text":": Users are encouraged to deeply understand the meaning of each parameter and modify them according to their own strategy logic and risk preferences. Every parameter in ","type":"text"},{"text":"config.py","type":"text","marks":[{"type":"code_inline"}]},{"text":" is annotated with comments for easy customization.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"No Guaranteed Returns","type":"text","marks":[{"type":"strong"}]},{"text":": Past performance does not represent future results. Even parameters that perform well in backtesting may fail in live trading due to changing market conditions.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Technical Risk","type":"text","marks":[{"type":"strong"}]},{"text":": On-chain transactions are irreversible. Smart contracts may contain vulnerabilities. Network congestion may cause transaction delays or failures.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Third-Party Dependency Risk","type":"text","marks":[{"type":"strong"}]},{"text":": This strategy relies on third-party infrastructure including onchainos CLI, OKX API, and the Solana network. Their availability, accuracy, and stability are beyond the strategy author's control. Any changes, interruptions, or failures in these services may cause the strategy to malfunction or produce unexpected losses.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Regulatory/Legal Risk","type":"text","marks":[{"type":"strong"}]},{"text":": Cryptocurrency trading may be strictly restricted or prohibited in some countries and regions. Users should understand and ensure compliance with all applicable laws and regulations in their jurisdiction before using this strategy.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Tax Risk","type":"text","marks":[{"type":"strong"}]},{"text":": Frequent trading may generate numerous taxable events. Users should understand and comply with local tax laws regarding reporting and paying taxes on cryptocurrency trading gains.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Assume All Responsibility","type":"text","marks":[{"type":"strong"}]},{"text":": This strategy is provided \"AS-IS\" without any express or implied warranties. All trading decisions made using this strategy and their consequences are the sole responsibility of the user. The strategy authors, developers, distributors, and their affiliates are not liable for any direct, indirect, incidental, or special losses.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Recommendation","type":"text","marks":[{"type":"strong"}]},{"text":": For first-time use, please run in Paper mode (","type":"text"},{"text":"MODE = \"paper\"","type":"text","marks":[{"type":"code_inline"}]},{"text":"). After fully familiarizing yourself with the strategy logic and parameter behavior, then consider whether to switch to live trading.","type":"text"}]},{"type":"hr","attrs":{"markup":"---"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"File Structure","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":""},"content":[{"text":"Top Rank Tokens Sniper - 榜单狙击手/\n├── skill.md ← This file (strategy documentation)\n├── config.py ← All adjustable parameters (modify parameters here only)\n├── ranking_sniper.py ← Main strategy program\n├── dashboard.html ← Web Dashboard UI\n└── state/ ← [Auto-generated] Runtime data\n ├── paper/\n │ ├── positions.json\n │ ├── trades.json\n │ ├── daily-stats.json\n │ └── signals-log.json\n └── live/\n └── (same as above)","type":"text"}]},{"type":"hr","attrs":{"markup":"---"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Prerequisites","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"1. Install onchainos CLI (>= 2.0.0-beta)","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"# Check if already installed\nonchainos --version\n\n# If not installed, follow the onchainos official documentation\n# Make sure onchainos is in PATH or located at ~/.local/bin/onchainos","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"2. Login to Agentic Wallet (TEE Signing)","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"# One-time login (email verification)\nonchainos wallet login \u003cyour-email>\n\n# Verify login status\nonchainos wallet status\n# → loggedIn: true\n\n# Confirm Solana address\nonchainos wallet addresses --chain 501","type":"text"}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"Agentic Wallet uses TEE secure enclave signing. Private keys are never exposed to code/logs/network. No need to set the WALLET_PRIVATE_KEY environment variable.","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"3. No pip install Required","type":"text"}]},{"type":"paragraph","content":[{"text":"This strategy only depends on Python standard library + onchainos CLI. No third-party packages needed.","type":"text"}]},{"type":"hr","attrs":{"markup":"---"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"AI Agent Startup Interaction Protocol","type":"text"}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"When the user requests to start this strategy, the AI Agent must follow the procedure below and must not skip directly to launch.","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Phase 1: Show Strategy Overview","type":"text"}]},{"type":"paragraph","content":[{"text":"Present the following to the user:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":""},"content":[{"text":"🏆 Top Rank Tokens Sniper v1.0 — Solana Ranking Sniper\n\nThis strategy scans the Solana 1h gainers leaderboard Top 20 every 10 seconds.\nWhen a new token first appears on the leaderboard, it passes through\nthree-level safety filtering + Momentum scoring, then automatically snipes entry.\nPositions are managed through a 6-layer exit system.\n\n🧪 Current: Paper Mode — no real money spent, observing signals only\n\n⚠️ Risk Warning: Meme coins carry extremely high risk. You may lose your entire investment.\n\nDefault parameters (for reference only, recommended to adjust based on your situation):\n Per trade: 0.05 SOL\n Total budget: 0.5 SOL\n Max positions: 5\n Take profit: TP1 +8% / TP2 +20% / TP3 +40%\n Stop loss: -15% Hard Stop / -8% Quick Stop (3min)\n Trailing stop: Activates at +10% profit, exits on 8% drawdown\n Ranking exit: Auto sell 100% when dropped out of Top 20 (highest priority)\n Max hold time: 2 hours\n\nAll parameters can be freely modified in config.py to suit your trading style.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Q1: Risk Preference (Mandatory)","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"🛡️ Conservative: Quick in-and-out, small TP with tight SL","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"⚖️ Default: Balanced configuration (recommended)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"🔥 Aggressive: Large TP with wide SL","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"→ Parameter mapping (for AI Agent to write into config.py, no need to show to user):","type":"text"}]},{"type":"table","attrs":{"layout":null},"content":[{"type":"tr","content":[{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Preference","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"STOP_LOSS_PCT","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"QUICK_STOP_MIN","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"QUICK_STOP_PCT","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"TP_TIERS","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"MAX_HOLD_HOURS","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"TRAILING_ACTIVATE","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"TRAILING_DROP","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Conservative","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"-10","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"2","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"-5","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"(5,0.30),(12,0.35),(25,0.35)","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"1","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"8","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"5","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Default","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"-15","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"3","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"-8","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"(8,0.30),(20,0.35),(40,0.35)","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"2","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"10","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"8","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Aggressive","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"-25","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"5","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"-12","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"(12,0.30),(30,0.35),(60,0.35)","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"4","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"15","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"12","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Q2: Switch to Live Trading?","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"A. 🧪 Keep Paper mode, start directly (recommended by default)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"B. 💰 Switch to Live mode","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Option A","type":"text","marks":[{"type":"strong"}]},{"text":" → Proceed directly to the launch step.","type":"text"}]},{"type":"paragraph","content":[{"text":"Option B","type":"text","marks":[{"type":"strong"}]},{"text":" → Enter live trading sub-flow:","type":"text"}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"⚠️ Confirm with user: \"Live trading will use real SOL. Losses are irreversible. Confirm switch to live?\"","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"User confirms → Continue","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"User declines → Fall back to Paper mode","type":"text"}]}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Ask for total budget in SOL (default 0.5 SOL)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"AI auto-calculates (let B = user's input budget):","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"TOTAL_BUDGET = B","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"BUY_AMOUNT = max(B × 0.10, 0.01)","type":"text","marks":[{"type":"code_inline"}]}]}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Show calculated results and confirm with user: \"Your live configuration: Total budget X SOL, per trade Y SOL, daily loss limit Z SOL. Confirm?\"","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"User confirms → Write to config.py","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"User requests adjustment → Return to step 2","type":"text"}]}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Set mode parameters:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"MODE = \"live\"","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"PAUSED = False","type":"text","marks":[{"type":"code_inline"}]}]}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Launch","type":"text"}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Modify corresponding parameters in ","type":"text"},{"text":"config.py","type":"text","marks":[{"type":"code_inline"}]},{"text":" based on user answers","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Set ","type":"text"},{"text":"PAUSED = False","type":"text","marks":[{"type":"code_inline"}]},{"text":" (allow bot to run normally after interaction confirmation)","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Check prerequisites: ","type":"text"},{"text":"onchainos --version","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"onchainos wallet status","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Start bot: ","type":"text"},{"text":"python3 ranking_sniper.py","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Show Dashboard link: ","type":"text"},{"text":"http://localhost:3244","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Inform user: Currently in Paper mode. To switch to live, modify ","type":"text"},{"text":"MODE = \"live\"","type":"text","marks":[{"type":"code_inline"}]},{"text":" in ","type":"text"},{"text":"config.py","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"paragraph","content":[{"text":"If the user says \"use default config\" or \"just run it\", only set ","type":"text"},{"text":"PAUSED = False","type":"text","marks":[{"type":"code_inline"}]},{"text":", leave everything else unchanged, and start in Paper mode.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Special Cases","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"User explicitly says \"don't ask me, just run it\" → Start with default parameters (Paper mode), but must show Phase 1 overview + set ","type":"text"},{"text":"PAUSED = False","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"User is a returning user (configuration history exists in conversation) → Remind them of previous configuration and ask if they want to reuse it","type":"text"}]}]}]},{"type":"hr","attrs":{"markup":"---"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Quick Start","type":"text"}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"⚠️ Before starting, confirm the ","type":"text"},{"text":"MODE","type":"text","marks":[{"type":"code_inline"}]},{"text":" value in config.py — ","type":"text"},{"text":"\"paper\"","type":"text","marks":[{"type":"code_inline"}]},{"text":" for Paper trading, ","type":"text"},{"text":"\"live\"","type":"text","marks":[{"type":"code_inline"}]},{"text":" for Live trading.","type":"text"}]}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"cd ~/CC/Top\\ Rank\\ Tokens\\ Sniper\\ -\\ 榜单狙击手\n\n# 1. Confirm onchainos is logged in\nonchainos wallet status\n\n# 2. Start bot (foreground, Ctrl+C to stop)\npython3 ranking_sniper.py\n\n# 3. Open Dashboard\nopen http://localhost:3244\n\n# 4. Stop\npkill -f ranking_sniper.py","type":"text"}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"First startup defaults to PAUSED=True — no new positions will be opened. After confirming everything is normal, modify PAUSED=False in config.py.","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"hr","attrs":{"markup":"---"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Parameter Adjustment","type":"text"}]},{"type":"paragraph","content":[{"text":"All adjustable parameters are in ","type":"text","marks":[{"type":"strong"}]},{"text":"config.py","type":"text","marks":[{"type":"code_inline"},{"type":"strong"}]},{"text":" — no need to modify ","type":"text"},{"text":"ranking_sniper.py","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Common Adjustments","type":"text"}]},{"type":"table","attrs":{"layout":null},"content":[{"type":"tr","content":[{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Need","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Modify in ","type":"text"},{"text":"config.py","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Pause/resume trading","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"PAUSED = True/False","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Adjust per-trade amount","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"BUY_AMOUNT = 0.05","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Adjust total budget","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"TOTAL_BUDGET = 0.5","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Adjust max positions","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"MAX_POSITIONS = 5","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Adjust take profit","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"TP_TIERS = [(8,0.30),(20,0.35),(40,0.35)]","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Adjust hard stop loss","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"STOP_LOSS_PCT = -15","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Adjust quick stop","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"QUICK_STOP_MIN = 3","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"QUICK_STOP_PCT = -8","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Adjust trailing stop","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"TRAILING_ACTIVATE = 10","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"TRAILING_DROP = 8","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Adjust sell slippage","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"SLIPPAGE_SELL = 8","type":"text","marks":[{"type":"code_inline"}]},{"text":" (normal exit), ","type":"text"},{"text":"SLIPPAGE_SELL_URGENT = 15","type":"text","marks":[{"type":"code_inline"}]},{"text":" (urgent exit)","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Adjust scan speed","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"POLL_INTERVAL = 10","type":"text","marks":[{"type":"code_inline"}]},{"text":" (seconds)","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"MC range","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"MIN_MCAP = 50_000","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"MAX_MCAP = 10_000_000","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Paper trading","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"MODE = \"paper\"","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Dashboard port","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"DASHBOARD_PORT = 3244","type":"text","marks":[{"type":"code_inline"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"Restart the bot for changes to take effect.","type":"text"}]},{"type":"hr","attrs":{"markup":"---"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Strategy Architecture","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":""},"content":[{"text":"ranking_sniper.py (Single-file Bot)\n├── onchainos CLI (Data + Execution + Security — no API Key)\n├── _scanner_loop() ← Background thread, every 10s\n│ ├── get_ranking() Leaderboard Top 20\n│ ├── New entry detection prev_snap set diff\n│ └── _filter() Three-level filtering\n│ ├── Level 1: Slot Guard (13 basic metrics)\n│ ├── Level 2: Advanced Safety (9 safety checks)\n│ ├── Level 3: Holder Risk Scan (3 holder risk checks)\n│ ├── _calc_score() Momentum Score calculation\n│ └── → _buy() (synchronous execution)\n│ └── Live mode 4-layer verification\n├── _monitor_loop() ← Background thread, every 10s\n│ ├── get_batch_prices() Batch prices\n│ ├── _check_unconfirmed() Layer 3 monitoring\n│ └── check_position() Exit decisions\n│ ├── EXIT 0: Ranking Exit (dropped off leaderboard)\n│ ├── EXIT 1: Hard Stop (-15%)\n│ ├── EXIT 2: Quick Stop (3min, -8%)\n│ ├── EXIT 3: Trailing Stop (peak +10%, drop 8%)\n│ ├── EXIT 4: Time Stop (2h)\n│ └── EXIT 5: Tiered TP (+8%/+20%/+40%)\n├── _audit_loop() ← Background thread, every 5min (Live mode)\n│ └── _wallet_audit() Wallet reconciliation\n├── Dashboard (port 3244) Web UI\n└── Persistent files (JSON, atomic writes)","type":"text"}]},{"type":"hr","attrs":{"markup":"---"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Safety Checks","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Level 1: Slot Guard (13 checks, based on leaderboard data)","type":"text"}]},{"type":"table","attrs":{"layout":null},"content":[{"type":"tr","content":[{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"#","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Check","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Threshold","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"1","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Min price change","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":">= 15%","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"2","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Max price change","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"\u003c= 500%","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"3","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Liquidity","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":">= $30,000","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"4","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Market cap floor","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":">= $50,000","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"5","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Market cap ceiling","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"\u003c= $10M","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"6","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Holders","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":">= 100","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"7","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Buy ratio","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":">= 55%","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"8","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Unique traders","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":">= 20","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"9","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Blacklist","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Not in SKIP_TOKENS/BLACKLIST","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"10","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Cooldown","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":">= 30min since last sell","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"11","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Position cap","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"\u003c MAX_POSITIONS","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"12","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Dedup","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Not already holding same token","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"13","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Daily loss","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Daily loss limit not triggered","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Level 2: Advanced Safety (9 checks, onchainos token advanced-info)","type":"text"}]},{"type":"table","attrs":{"layout":null},"content":[{"type":"tr","content":[{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"#","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Check","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Threshold","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"S1","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Risk level","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"\u003c= 3","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"S2","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Honeypot","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"No honeypot tag","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"S3","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Top 10 concentration","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"\u003c= 40%","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"S4","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Dev holding","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"\u003c= 15%","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"S5","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Bundler holding","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"\u003c= 15%","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"S6","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"LP burned","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":">= 50%","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"S7","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Dev rug count","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"\u003c= 2","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"S8","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Sniper holding","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"\u003c= 15%","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"S9","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Internal token","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Default pass","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Level 3: Holder Risk (3 checks, onchainos token holders)","type":"text"}]},{"type":"table","attrs":{"layout":null},"content":[{"type":"tr","content":[{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"#","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Check","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Threshold","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"H1","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Suspicious address holding","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"\u003c= 30%","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"H2","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Phishing addresses","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Block (","type":"text"},{"text":"BLOCK_PHISHING = True","type":"text","marks":[{"type":"code_inline"}]},{"text":")","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"H3","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Suspicious address count","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"\u003c= 10","type":"text"}]}]}]}]},{"type":"hr","attrs":{"markup":"---"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Momentum Score","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":""},"content":[{"text":"Base Score (0-100):\n buyRatio × 40 + changePenalty × 20 + traderScore × 20 + liquidityScore × 20\n\nBonus (0-25):\n smartMoneyBuy +8 | top10\u003c30% +5 | dsPaid +3 | communityTakeover +2\n sniper\u003c5% +4 | devClean +3 | zeroSuspicious +2\n\nTotal = Base + min(Bonus, 25)","type":"text"}]},{"type":"hr","attrs":{"markup":"---"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"6-Layer Exit System","type":"text"}]},{"type":"table","attrs":{"layout":null},"content":[{"type":"tr","content":[{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Priority","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Exit Type","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Trigger Condition","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Sell Ratio","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"EXIT 0","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Ranking Exit","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Dropped out of Top 20 and held >= 1min","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"100%","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"EXIT 1","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Hard Stop Loss","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"PnL \u003c= -15%","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"100%","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"EXIT 2","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Quick Stop","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Held >= 3min and PnL \u003c= -8%","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"100%","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"EXIT 3","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Trailing Stop","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Peak PnL >= +10% then drawdown >= 8%","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"100%","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"EXIT 4","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Time Stop","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Held >= 2h","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"100%","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"EXIT 5","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Tiered Take Profit","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"+8% sell 30% / +20% sell 35% / +40% sell 35%","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Partial","type":"text"}]}]}]}]},{"type":"hr","attrs":{"markup":"---"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Session Risk Control","type":"text"}]},{"type":"table","attrs":{"layout":null},"content":[{"type":"tr","content":[{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Rule","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Value","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Daily Loss Limit","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"DAILY_LOSS_LIMIT = 0.15","type":"text","marks":[{"type":"code_inline"}]},{"text":" (ratio of TOTAL_BUDGET, i.e., stop for the day after 15% loss)","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Consecutive Loss Pause","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"3 times → pause 15min (","type":"text"},{"text":"MAX_CONSEC_LOSS = 3","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"PAUSE_CONSEC_SEC = 900","type":"text","marks":[{"type":"code_inline"}]},{"text":")","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Cumulative Loss Stop","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":">= 0.10 SOL → stop trading (","type":"text"},{"text":"SESSION_STOP_SOL = 0.10","type":"text","marks":[{"type":"code_inline"}]},{"text":")","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Max Positions","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"MAX_POSITIONS = 5","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Max Hold Time","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"MAX_HOLD_HOURS = 2","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Cooldown","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"COOLDOWN_MIN = 30","type":"text","marks":[{"type":"code_inline"}]},{"text":" (30 minutes after selling before buying the same token again)","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Daily loss limit scales automatically with ","type":"text"},{"text":"TOTAL_BUDGET","type":"text","marks":[{"type":"code_inline"}]},{"text":" (ratio fixed at 15%). Consecutive loss counter resets on a winning trade. Session risk control auto-resets on bot restart.","type":"text"}]},{"type":"hr","attrs":{"markup":"---"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Iron Rules (Must Not Be Violated)","type":"text"}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"RPC balance 0 ≠ token doesn't exist (Solana RPC has severe latency). Unconfirmed positions require zeroCount >= 10 AND elapsed > 180s before discarding.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Writing to positions.json ","type":"text"},{"text":"requires","type":"text","marks":[{"type":"strong"}]},{"text":" holding ","type":"text"},{"text":"_state_lock","type":"text","marks":[{"type":"code_inline"}]},{"text":".","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"When ","type":"text"},{"text":"order_status()","type":"text","marks":[{"type":"code_inline"}]},{"text":" returns TIMEOUT, ","type":"text"},{"text":"always","type":"text","marks":[{"type":"strong"}]},{"text":" create an unconfirmed position.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Safety check API failure → Fail-Closed, ","type":"text"},{"text":"do not buy","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Rank Exit (EXIT 0) has the ","type":"text"},{"text":"highest priority","type":"text","marks":[{"type":"strong"}]},{"text":".","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Daily loss limit triggered → stop all buying for the day.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"GAS_RESERVE","type":"text","marks":[{"type":"code_inline"}]},{"text":" 0.01 SOL is never spent on trades.","type":"text"}]}]}]},{"type":"hr","attrs":{"markup":"---"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"onchainos CLI Command Reference","type":"text"}]},{"type":"table","attrs":{"layout":null},"content":[{"type":"tr","content":[{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"#","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Command","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Purpose","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"1","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"onchainos token trending --chain solana --sort-by 2 --time-frame 2","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Leaderboard Top 20","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"2","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"onchainos token advanced-info --chain solana --address \u003caddr>","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Safety check data","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"3","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"onchainos token holders --chain solana --address \u003caddr> --tag-filter \u003ctag>","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Holder risk","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"4","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"onchainos market prices --tokens 501:\u003caddr1>,501:\u003caddr2>,...","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Batch prices","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"5","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"onchainos swap quote --from \u003cfrom> --to \u003cto> --amount \u003camt> --chain solana","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Quote","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"6","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"onchainos swap swap --from \u003cfrom> --to \u003cto> --amount \u003camt> --chain solana --wallet \u003caddr> --slippage \u003cpct>","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Trade","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"7","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"onchainos wallet addresses --chain 501","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Solana address","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"8","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"onchainos wallet balance --chain 501","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Balance","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"9","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"onchainos wallet contract-call --chain 501 --to \u003crouter> --unsigned-tx \u003ccallData>","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"TEE signing","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"10","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"onchainos wallet order-status --order-id \u003corderId>","type":"text","marks":[{"type":"code_inline"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Trade confirmation","type":"text"}]}]}]}]},{"type":"hr","attrs":{"markup":"---"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Troubleshooting","type":"text"}]},{"type":"table","attrs":{"layout":null},"content":[{"type":"tr","content":[{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Issue","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Solution","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"\"FATAL: onchainos CLI not found\"","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Install onchainos and ensure it is in PATH","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Dashboard won't open","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Check if port 3244 is in use: ","type":"text"},{"text":"lsof -i:3244","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Bot has no trade signals","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Leaderboard may have no new entries; wait for changes","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Login expired","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Re-run ","type":"text"},{"text":"onchainos wallet login \u003cemail>","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Live mode buy fails","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Check SOL balance >= MIN_WALLET_BAL (0.06)","type":"text"}]}]}]}]},{"type":"hr","attrs":{"markup":"---"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Glossary","type":"text"}]},{"type":"table","attrs":{"layout":null},"content":[{"type":"tr","content":[{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Term","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Definition","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Ranking Exit","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Ranking Exit — automatically sell entire position when token drops out of the Top 20 gainers leaderboard; exit when momentum is lost","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Slot Guard","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"13 basic metric pre-checks based on leaderboard data, zero additional API calls","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Advanced Safety","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"9 deep safety checks using ","type":"text"},{"text":"onchainos token advanced-info","type":"text","marks":[{"type":"code_inline"}]},{"text":" to obtain Dev/Bundler/LP data","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Holder Risk","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"3 holder risk checks using ","type":"text"},{"text":"onchainos token holders","type":"text","marks":[{"type":"code_inline"}]},{"text":" to detect suspicious/phishing addresses","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Momentum Score","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Momentum score (0-125), calculated from buy ratio, price change, trader count, liquidity, and safety bonuses","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Quick Stop","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Quick Stop — triggers when position is held for N minutes and loss exceeds N% (both conditions must be met)","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Trailing Stop","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Trailing Stop — triggers sell when profit reaches activation threshold then pulls back beyond threshold from peak","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Unconfirmed Position","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Pending position created when trade confirmation times out; requires multiple balance checks before discarding","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Fail-Closed","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"When safety check API fails, treat as unsafe and do not buy","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"TEE","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Trusted Execution Environment — onchainos signing is performed inside a secure enclave","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Agentic Wallet","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"onchainos managed wallet with private keys inside TEE, never leaving the secure environment","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"DAILY_LOSS_LIMIT","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Daily loss ratio (of TOTAL_BUDGET); when triggered, all buying stops for the day","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"MC / MCAP","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Market Cap — token total supply × current price, measuring token scale","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"LP","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Liquidity Pool — token pair pool on DEX for trading; larger LP means lower slippage","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"LP Burn","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Permanently burning LP tokens to ensure liquidity cannot be withdrawn by developers","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Rug Pull","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Malicious act where developers suddenly withdraw liquidity or dump all holdings, crashing the token price to zero","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Dev","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Token developer/deployer — in the Meme coin context, refers to the token contract creator; their holdings and history are important risk indicators","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Bundler","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Bundle trader — addresses that buy large amounts through bundled transactions at token launch; may be insiders or manipulators","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Sniper","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Sniper — bot addresses that auto-buy tokens instantly at launch; concentrated holdings may create sell pressure","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Honeypot","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Malicious token contract that can only be bought but not sold (or has extremely high sell tax)","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Slippage","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Difference between expected and actual execution price; worse liquidity means higher slippage","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"lamports","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Smallest unit of SOL, 1 SOL = 1,000,000,000 lamports","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Native SOL","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"SOL native token address ","type":"text"},{"text":"11111111111111111111111111111111","type":"text","marks":[{"type":"code_inline"}]},{"text":" (32 ones), must be used as --from in swap","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"WSOL","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Wrapped SOL (So11...112), SPL Token wrapped form of SOL, cannot be used as swap --from","type":"text"}]}]}]}]},{"type":"hr","attrs":{"markup":"---"}}]},"metadata":{"date":"2026-06-05","name":"top-rank-tokens-sniper","author":"@skillopedia","source":{"stars":11,"repo_name":"plugin-store","origin_url":"https://github.com/okx/plugin-store/blob/HEAD/skills/top-rank-tokens-sniper/SKILL.md","repo_owner":"okx","body_sha256":"4fbe299bc83310ac480f05827f3e8f6a000fed4ec0cedd7e4fd0d91add7cfb4c","cluster_key":"43940d76786542cde95b0af72abe7560edb313ed5352dbef42d7654955b52593","clean_bundle":{"format":"clean-skill-bundle-v1","source":"okx/plugin-store/skills/top-rank-tokens-sniper/SKILL.md","attachments":[{"id":"9a660617-62d7-55b8-b789-8115005702fd","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/9a660617-62d7-55b8-b789-8115005702fd/attachment.json","path":".claude-plugin/plugin.json","size":405,"sha256":"512607265a4ba2f034e029a2e4da21e8888235f6a3693181a186557d8f18123a","contentType":"application/json; charset=utf-8"},{"id":"e56802f9-8d50-5691-80ac-2716710f21cc","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/e56802f9-8d50-5691-80ac-2716710f21cc/attachment.md","path":"README.md","size":1984,"sha256":"4f260be4d1b08929ad7a3cdd8b446fc2912d8408e33b577ec57e35642cf801b2","contentType":"text/markdown; charset=utf-8"},{"id":"5a06d028-771a-55dd-815b-6de8abd15a3d","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/5a06d028-771a-55dd-815b-6de8abd15a3d/attachment.md","path":"SUMMARY.md","size":1906,"sha256":"abb55fdb0467387a3183a8afd2aa0e893a69668dd08ff56cd314afc7e9702d37","contentType":"text/markdown; charset=utf-8"},{"id":"595879ee-6486-5e1c-aa44-45928da66760","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/595879ee-6486-5e1c-aa44-45928da66760/attachment.html","path":"assets/dashboard.html","size":13525,"sha256":"7a5374d2ca5d5de422fbe908fc292ebe084ab76690ebe335e258b8675bb0a652","contentType":"text/html; charset=utf-8"},{"id":"c862731d-84dc-5734-997a-2d94c39c03ec","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/c862731d-84dc-5734-997a-2d94c39c03ec/attachment.yaml","path":"plugin.yaml","size":487,"sha256":"587abd1c0134ea6c3e74b7e0676cfa43dbced04d1a82d9e1916bdfaabb5b5653","contentType":"application/yaml; charset=utf-8"},{"id":"83953d2a-509e-5dd9-ab0c-cedbac55d5dc","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/83953d2a-509e-5dd9-ab0c-cedbac55d5dc/attachment.py","path":"scripts/config.py","size":7960,"sha256":"8b8afe7a4371b1352406a29147b2e1341964b6788dc1c05056f0c0435d5348a1","contentType":"text/x-python; charset=utf-8"},{"id":"de070a5b-b425-5088-b86d-00ea4454eddb","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/de070a5b-b425-5088-b86d-00ea4454eddb/attachment.py","path":"scripts/ranking_sniper.py","size":54317,"sha256":"c498f0e0d6011e24760f2bef851d8ce57b694cc531e4df8a71bd01731b14427a","contentType":"text/x-python; charset=utf-8"},{"id":"6d228367-a9eb-559e-8409-c34c0bc99c5a","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/6d228367-a9eb-559e-8409-c34c0bc99c5a/attachment.py","path":"scripts/risk_check.py","size":30541,"sha256":"98345d23b0bf620786e0672c962efe8110b8c34eb663482ec38df4148ab3a31a","contentType":"text/x-python; charset=utf-8"}],"bundle_sha256":"a301c57ae98ad7db4dbd64a260ccfc64d88b8df849bc5e05d8de88c9aa19f1d7","attachment_count":8,"text_attachments":8,"attachment_storage":"skillopedia-attachments-v1","binary_attachments":0,"excluded_attachments":[]},"cluster_size":1,"skill_md_path":"skills/top-rank-tokens-sniper/SKILL.md","import_metadata":{"date":"2026-06-05","author":"@skillopedia","version":"v1","category":"data-analytics","category_label":"Data"},"exact_dupes_collapsed_into_this":0},"updated":"2026-03-26T00:00:00.000Z","version":"v1","category":"data-analytics","import_tag":"clean-skills-v1","description":"Top Rank Tokens Sniper v1.0 — OKX Ranking Sniper (Real Trading). Monitors the OKX leaderboard for newly listed tokens, filters through 13 Slot Guard pre-checks + 9 Advanced Safety checks + 3 Holder Risk checks + Momentum scoring, then automatically snipes entries. 6-layer exit system manages take profit and stop loss. Triggered when the user mentions top rank tokens sniper, ranking strategy, leaderboard sniper, top N sniper, 榜单狙击手, or start ranking sniper. Run file: ranking_sniper.py (includes Web Dashboard http://localhost:3244)\n"}},"renderedAt":1782982108699}

Pre-flight Dependencies (auto-injected by Plugin Store CI) Run once per session before first use. These checks ensure required tools are installed. Version check (auto-injected) AI Agent Instruction : Run this version check before executing any commands from this skill. The check is a read-only fetch from — it does not install anything. If it reports , you MUST stop, surface the message to the user verbatim, and obtain explicit confirmation before running the suggested command. Do not run the update silently. After a confirmed update completes, re-read this SKILL.md before proceeding. Install…