zoneinTrack and analyze top traders with >75% win-rate on Hyperliquid and Polymarket via Zonein API. Create Hyperliquid & Polymarket trading agents with ease. Auto...
Install via ClawdBot CLI:
clawdbot install phutt-bwai/zoneinRequires:
Fetch live trading intelligence from Polymarket and HyperLiquid smart money wallets using the bundled script.
zn_)Option A โ Gateway Dashboard (recommended):
/skills in the sidebarZONEIN_API_KEY and saveOption B โ Environment variable:
export ZONEIN_API_KEY="zn_your_key_here"
Option C โ The script also reads from ~/.openclaw/openclaw.json automatically (skills.entries.zonein.apiKey).
| User asks... | Command |
|-------------|---------|
| "What's happening in the market?" | signals --limit 5 + perp-signals --limit 5 |
| "Show me PM signals for politics" | signals --categories POLITICS --limit 10 |
| "What are whales doing on crypto?" | perp-signals --limit 10 |
| "Top Polymarket traders this week" | leaderboard --period WEEK --limit 10 |
| "Which coins are smart money long?" | perp-coins |
| "Best perp traders this month" | perp-top --period month --limit 10 |
| "Track wallet 0x..." | trader 0x... or perp-trader 0x... |
| "Where is smart money flowing?" | signals --limit 10 + perp-signals --limit 10 + perp-coins |
| "Create a trading agent" | Follow Agent Creation Flow (Step 1โ6) |
| "List my agents" | agents |
| "How is my agent doing?" | agent-stats + agent-trades |
| "Stop my agent" | agent-disable |
| "What agent types are available?" | agent-templates |
| "Check my agent's balance" | agent-balance |
| "What positions does my agent have?" | agent-positions |
| "How do I fund my agent?" | agent-deposit then send USDC, then agent-fund to bridge to Hyperliquid |
| "Open a BTC long for $100" | agent-open |
| "Close my ETH position" | agent-close |
| "Withdraw my funds" | agent-disable then agent-withdraw |
| "Backtest my agent on BTC" | agent-backtest |
| "Show past backtests" | agent-backtests |
Presentation Rules:
Read-only commands (safe to run without asking):
signals, leaderboard, consensus, trader, perp-signals, perp-traders, perp-top, perp-categories, perp-coins, perp-trader, agents, agent-get, agent-stats, agent-trades, agent-vault, agent-templates, agent-assets, agent-categories, agent-balance, agent-positions, agent-deposit, agent-orders, agent-backtests, status
State-changing commands (ask user before running โ no --confirm needed):
agent-create, agent-update, agent-disable, agent-pause, agent-delete
Financial commands (require --confirm flag โ script refuses without it):
agent-fund, agent-open, agent-close, agent-withdraw, agent-enable, agent-deploy, agent-backtest
You MUST ask the user for approval before running any state-changing or financial command.
For financial commands, only add --confirm after the user explicitly says yes.
Example โ user deposits USDC and asks to check balance:
agent-balance (read-only, safe โ no --confirm needed)arbitrum_usdc: 200, needs_funding: trueagent-fund --confirm --confirm, the script will refuse to execute and return an errorAll commands use the bundled Python script. Always use these commands โ never write inline API calls.
Prefix: python3 skills/zonein/scripts/zonein.py
Polymarket (PM)
signals โ PM smart money trading signals| Param | Type | Default | Values | Description |
|-------|------|---------|--------|-------------|
| --limit | int | 20 | 1โ100 | Max signals to return |
| --categories | str | all | POLITICS,CRYPTO,SPORTS,CULTURE,ECONOMICS,TECH,FINANCE | Comma-separated filter |
| --period | str | WEEK | DAY, WEEK, MONTH, ALL | Lookback period |
| --min-wallets | int | 3 | โฅ1 | Minimum smart wallets for consensus |
leaderboard โ PM top traders by PnL| Param | Type | Default | Values | Description |
|-------|------|---------|--------|-------------|
| --period | str | WEEK | DAY, WEEK, MONTH, ALL | Ranking period |
| --category | str | OVERALL | OVERALL, POLITICS, SPORTS, CRYPTO, CULTURE, ECONOMICS, TECH, FINANCE | Category filter |
| --limit | int | 20 | 1โ500 | Max traders to return |
consensus โ PM positions where smart bettors agree| Param | Type | Default | Description |
|-------|------|---------|-------------|
| --min-bettors | int | 3 | Minimum bettors agreeing on a position |
trader โ PM trader profile by wallet| Param | Type | Required | Description |
|-------|------|----------|-------------|
| wallet | str | yes | Polymarket wallet address (0x...) |
Perpetuals (HyperLiquid)
perp-signals โ Perp trading signals (HyperLiquid)| Param | Type | Default | Description |
|-------|------|---------|-------------|
| --limit | int | 20 | Max signals to return |
| --min-wallets | int | 3 | Minimum wallets for consensus |
| --min-score | float | 0 | Minimum trader credibility score (0โ100) |
perp-traders โ Perp smart money traders| Param | Type | Default | Description |
|-------|------|---------|-------------|
| --limit | int | 20 | Max traders to return |
| --min-score | float | 0 | Minimum trader score (0โ100) |
| --categories | str | all | Comma-separated: swing_trading, large_cap_trader, high_win_rate, scalper, etc. |
perp-top โ Perp top performers by PnL| Param | Type | Default | Values | Description |
|-------|------|---------|--------|-------------|
| --limit | int | 10 | 1โ100 | Max traders |
| --period | str | month | day, week, month | PnL ranking period |
perp-coins โ Coin distribution (long vs short sentiment)No parameters. Returns all coins with smart money positions.
perp-categories โ Perp trader category listNo parameters.
perp-trader โ Perp trader details by address| Param | Type | Required | Description |
|-------|------|----------|-------------|
| address | str | yes | HyperLiquid wallet address (0x...) |
Agent Management
agents โ List your trading agentsNo parameters.
agent-get โ Get full agent config and state| Param | Type | Required | Description |
|-------|------|----------|-------------|
| agent_id | str | yes | Agent ID (e.g. agent_abc12345) |
agent-create โ Create a new trading agent| Param | Type | Default | Description |
|-------|------|---------|-------------|
| --name | str | required | Agent display name |
| --type | str | composite | composite, momentum_hunter, stable_grower, precision_master, whale_follower, scalping_pro, swing_trader |
| --assets | str | BTC,ETH | Comma-separated: BTC,ETH,SOL,HYPE |
| --categories | str | auto from type | Comma-separated smart money categories |
| --leverage | int | 5 | Max leverage (1โ20) |
| --description | str | auto | Agent description |
| --risk-per-trade | float | 1 | Risk per trade % |
| --max-daily-loss | float | 3 | Max daily loss % |
| --risk-reward | str | 1:2 | Risk:reward ratio |
| --max-trades-per-day | int | 3 | Max trades per day |
| --min-confidence | float | 0.8 | Min LLM confidence (0โ1) |
| --min-consensus | float | 0.7 | Min smart money consensus (0โ1) |
agent-update โ Update agent configuration| Param | Type | Description |
|-------|------|-------------|
| agent_id | str | Agent ID (positional) |
| --name | str | New name |
| --assets | str | Comma-separated assets |
| --categories | str | Comma-separated categories |
| --leverage | int | Max leverage |
| --methodology | str | Trading methodology text |
| --entry-strategy | str | Entry strategy text |
| --exit-framework | str | Exit framework text |
| --strength-thresholds | json | Entry/exit thresholds per asset (see Strength Thresholds Guide) |
| --timeframe-weights | json | Timeframe weight distribution |
agent-deploy โ Validate config and enable trading| Param | Type | Required | Description |
|-------|------|----------|-------------|
| agent_id | str | yes | Agent to deploy |
agent-enable / agent-disable / agent-pause โ Lifecycle control| Param | Type | Required | Description |
|-------|------|----------|-------------|
| agent_id | str | yes | Agent ID |
agent-delete โ Delete agent (soft delete)| Param | Type | Required | Description |
|-------|------|----------|-------------|
| agent_id | str | yes | Agent ID |
agent-stats โ Performance statistics (PnL, win rate)| Param | Type | Required | Description |
|-------|------|----------|-------------|
| agent_id | str | yes | Agent ID |
agent-trades โ Trade history| Param | Type | Default | Description |
|-------|------|---------|-------------|
| agent_id | str | required | Agent ID |
| --limit | int | 50 | Max trades to return |
agent-vault โ Vault (trading wallet) info| Param | Type | Required | Description |
|-------|------|----------|-------------|
| agent_id | str | yes | Agent ID |
agent-balance โ Live vault balance from Hyperliquid| Param | Type | Required | Description |
|-------|------|----------|-------------|
| agent_id | str | yes | Agent ID |
Returns: account_value, withdrawable, has_positions, vault_address.
agent-positions โ Open positions (live from Hyperliquid)| Param | Type | Required | Description |
|-------|------|----------|-------------|
| agent_id | str | yes | Agent ID |
Returns each position: coin, side (LONG/SHORT), size, entry_price, unrealized_pnl, leverage, notional.
agent-deposit โ Get deposit address for funding agent| Param | Type | Required | Description |
|-------|------|----------|-------------|
| agent_id | str | yes | Agent ID |
Returns: deposit_address (send USDC on Arbitrum One to this address).
agent-fund โ Bridge USDC from Arbitrum to Hyperliquid| Param | Type | Required | Description |
|-------|------|----------|-------------|
| agent_id | str | yes | Agent ID |
After sending USDC to the vault address on Arbitrum, call this to auto-bridge funds into Hyperliquid.
Important: The bridge transaction requires a small amount of ETH on Arbitrum for gas fees (typically ~0.0001โ0.0005 ETH). Ask the user to send a small amount of ETH (e.g. 0.001 ETH) to the same vault address on Arbitrum One before running this command.
Returns tx_hash and amount bridged.
agent-open โ Open a position (manual order via chat)| Param | Type | Required | Description |
|-------|------|----------|-------------|
| agent_id | str | yes | Agent ID |
| --coin | str | yes | BTC, ETH, SOL, HYPE |
| --direction | str | no (default LONG) | LONG or SHORT |
| --size | float | yes | Position size in USD |
| --leverage | int | no | Leverage (1โ20) |
agent-close โ Close a position| Param | Type | Required | Description |
|-------|------|----------|-------------|
| agent_id | str | yes | Agent ID |
| --coin | str | yes | Coin to close (BTC, ETH, SOL, HYPE) |
agent-orders โ Manual order history| Param | Type | Default | Description |
|-------|------|---------|-------------|
| agent_id | str | required | Agent ID |
| --limit | int | 20 | Max orders to return |
agent-withdraw โ Withdraw funds to your wallet| Param | Type | Required | Description |
|-------|------|----------|-------------|
| agent_id | str | yes | Agent ID |
| --to | str | yes | Destination 0x... wallet address on Arbitrum |
Agent must be disabled before withdrawing. Flow: Hyperliquid โ Arbitrum โ your wallet.
agent-backtest โ Run backtest simulation| Param | Type | Default | Description |
|-------|------|---------|-------------|
| agent_id | str | required | Agent ID |
| --symbol | str | BTC | Coin to backtest: BTC, ETH, SOL, HYPE |
| --days | int | 30 | Backtest period (7โ90 days) |
| --initial-balance | float | 10000 | Starting balance in USD |
Runs a historical backtest using the agent's config (thresholds, leverage, risk profile) against cached smart money signals and real OHLC prices. Returns performance summary + a dashboard link with interactive charts (equity curve, candlestick with trade markers, daily PnL, trade table).
Requires --confirm (this is a compute-intensive action).
Example output:
{
"backtest_id": "bt_agent123_BTC_20260218_...",
"dashboard": "https://mcp.zonein.xyz/api/v1/backtest/bt_.../dashboard",
"pnl": 523.40,
"total_trades": 12,
"stats": {"win_rate": 66.67, "sharpe_ratio": 1.42, "max_drawdown": 3.2}
}
agent-backtests โ List past backtests| Param | Type | Default | Description |
|-------|------|---------|-------------|
| agent_id | str | required | Agent ID |
| --limit | int | 10 | Max results |
Returns list of previous backtests with summary metrics and dashboard links.
agent-templates โ Agent types & default configNo parameters. Returns available agent types with their category presets and default risk/trading config.
agent-assets โ Available trading assetsNo parameters. Returns: BTC, ETH, SOL, HYPE.
agent-categories โ Smart money categories with live statsNo parameters. Returns all categories with description and live trader counts.
Utility
status โ Check API key statusNo parameters.
When user wants to create a trading agent, follow this conversational flow:
Step 1: Collect Preferences
Ask the user about their trading goals:
Step 2: Show Available Options
Run these commands to give user context:
agent-templates โ show available agent typesagent-categories โ show smart money categories with statsagent-assets โ show available coinsStep 3: Create Agent
Based on collected preferences, create the agent:
agent-create --name "BTC Swing Trader" --type swing_trader --assets BTC,ETH --leverage 5 --risk-per-trade 1 --max-daily-loss 3 --risk-reward 1:2 --max-trades-per-day 3 --min-confidence 0.8 --min-consensus 0.7
Step 4: Configure Strategy
Update the agent with trading strategy prompts:
agent-update <agent_id> --methodology "Follow smart money signals..." --entry-strategy "Enter on SM consensus >70%..." --exit-framework "Take profit at +10%, stop loss at -5%..."
Step 5: Review & Deploy
agent-get โ review full configagent-deploy โ validate and enableStep 6: Fund the Agent
The vault (deposit address) is auto-created with the agent. The create response includes it.
agent-deposit )agent-balance โ check arbitrum_usdc field to confirm deposit arrivedagent-fund --confirm โ bridge USDC from Arbitrum into Hyperliquid (requires ETH for gas)agent-balance โ confirm Hyperliquid account_value shows the fundsStep 7: Monitor
agent-balance โ check vault balanceagent-positions โ view open positionsagent-stats โ check performance (PnL, win rate)agent-trades โ view trade historyagent-disable โ stop trading if neededDeposit:
agent-deposit โ get vault addressagent-balance โ check arbitrum_usdc to verify deposit arrivedagent-fund --confirm โ bridge USDC from Arbitrum โ Hyperliquid (requires ETH for gas)agent-balance โ confirm account_value on HyperliquidWithdraw:
agent-disable โ must disable agent firstagent-withdraw --to 0xYourWallet... โ queue withdrawalWhen user wants to check positions or trade manually:
Check positions:
agent-positions โ Present each position: "BTC LONG โ $500 at $95,432 entry โ PnL: +$23.45 โ 5x leverage"
Open a position:
agent-open
Close a position:
agent-close
Check order status:
agent-orders
When user asks about market conditions, run these in sequence:
signals --limit 5 โ top PM signalsperp-signals --limit 5 โ top perp signalsperp-coins โ coin long/short sentimenttrader โ Polymarket profileperp-trader โ HyperLiquid profilestrength_thresholds and timeframe_weights are auto-generated from agent_type when creating an agent. Override with agent-update if user wants custom values.
| Agent Type | Style | BTC buy/sell | ETH buy/sell | SOL buy/sell | OTHERS buy/sell | Timeframes 24h/4h/1h |
|------------|-------|-------------|-------------|-------------|----------------|---------------------|
| scalping_pro, momentum_hunter | Scalp | 65/65 | 70/65 | 78/65 | 78/65 | 0.2/0.4/0.4 |
| All others (swing_trader, stable_grower, composite, etc.) | Swing | 75/70 | 78/70 | 82/70 | 82/70 | 0.5/0.35/0.15 |
Adjust +/-5 from defaults:
| User says | What to adjust | Example |
|-----------|---------------|---------|
| "I want more trades" / aggressive | Lower min_strength_buy (-5 to -10) | BTC buy: 78 -> 70 |
| "Only high-quality setups" / conservative | Raise min_strength_buy (+5) | BTC buy: 78 -> 83 |
| "Cut losses quickly" / protect capital | Lower min_strength_sell (-5) | sell: 72 -> 65 |
| "Let winners ride" / trend following | Raise min_strength_sell (+5) | sell: 72 -> 77 |
OTHERS = max(BTC, ETH, SOL) + 0-5 bufferCorrect example:
Wrong example:
Must sum to 1.0. Three timeframes: 24h, 4h, 1h.
| User preference | 24h | 4h | 1h | Why |
|----------------|-----|----|----|-----|
| Quick trades / scalping | 0.2 | 0.4 | 0.4 | Focus on short-term signals |
| Swing / multi-day | 0.5 | 0.35 | 0.15 | Focus on long-term trend |
| Trend following | 0.4 | 0.4 | 0.2 | Balance trend + momentum |
| "I follow the daily trend" | 0.6 | 0.3 | 0.1 | Heavy 24h weight |
agent-update <agent_id> --strength-thresholds '{"BTC": {"min_strength_buy": 70, "min_strength_sell": 65}, "ETH": {"min_strength_buy": 75, "min_strength_sell": 65}, "SOL": {"min_strength_buy": 80, "min_strength_sell": 65}, "OTHERS": {"min_strength_buy": 80, "min_strength_sell": 65}}' --timeframe-weights '{"24h": 0.5, "4h": 0.35, "1h": 0.15}'
direction โ YES or NOconsensus โ 0 to 1 (1 = everyone agrees)total_wallets โ how many smart traders hold thisbest_rank โ best leaderboard positioncur_yes_price / cur_no_price โ current pricescoin โ token (BTC, ETH, SOL, HYPE...)direction โ LONG or SHORTconsensus โ agreement ratio (0-1)long_wallets / short_wallets โ traders per sidelong_value / short_value โ USD per sidebest_trader_score โ credibility score๐ฎ [market_title]
Smart money says: [YES/NO] | Agreement: [X]%
[N] top traders holding | Best ranked: #[rank]
Current price: YES [price] / NO [price]
๐ $[COIN]
Smart money says: [LONG/SHORT] | Agreement: [X]%
[N] whale traders | Top score: [score]
Long: $[X] | Short: $[X]
Disclaimer:
External endpoint: https://mcp.zonein.xyz/api/v1/* โ API key (X-API-Key header) + query parameters.
Data & access:
X-API-Key header)~/.openclaw/openclaw.json (API key fallback only). No other local files are accessed.https://mcp.zonein.xyz/api/v1 โ no other endpoints, no package installs, no filesystem writesConfirmation policy: Financial commands (agent-fund, agent-open, agent-close, agent-withdraw, agent-deploy, agent-enable, agent-backtest) are programmatically gated โ the script refuses to execute unless --confirm is explicitly passed. The agent must first ask the user for approval, then include --confirm only after the user agrees. This prevents prompt injection from bypassing confirmation.
By using this skill, your API key and query parameters are sent to https://mcp.zonein.xyz. Only install if you trust Zonein.
Generated Mar 1, 2026
A hedge fund uses Zonein to track top traders with >75% win-rate on Hyperliquid, identifying high-conviction positions in crypto perpetuals. By creating automated trading agents that mimic these smart money wallets, the fund can diversify its strategies and reduce risk through human-in-the-loop oversight, enhancing returns while maintaining control over large capital allocations.
A news organization leverages Zonein to monitor smart money activity on Polymarket for political events, using signals and consensus data to predict election outcomes or policy shifts. This provides real-time insights for reporting, allowing journalists to offer data-driven coverage and engage audiences with up-to-date market sentiment on trending political topics.
A professional sports betting syndicate employs Zonein to analyze top traders on Polymarket for sports categories, identifying profitable betting opportunities based on whale movements. By setting up automated agents to execute trades on consensus positions, the syndicate can scale its operations and improve decision-making with minimal manual intervention.
A decentralized finance protocol uses Zonein to track smart money flows on Hyperliquid for crypto assets, assessing market sentiment to inform liquidity provisioning and collateral strategies. Automated agents help simulate trades and backtest scenarios, enabling the protocol to mitigate volatility risks and optimize yield farming based on real-time trader intelligence.
A corporation with a treasury management team utilizes Zonein to follow high-win-rate traders on Hyperliquid for institutional-grade crypto investments. By creating agents to automate long/short positions with human approval, the team can efficiently manage digital asset portfolios, ensuring compliance and maximizing returns while leveraging data from top-performing market participants.
Zonein offers tiered subscription plans for access to its API, providing real-time data on smart money wallets from Hyperliquid and Polymarket. Revenue is generated through monthly or annual fees, with premium tiers including advanced analytics, higher rate limits, and priority support, catering to both individual traders and institutional clients seeking actionable insights.
The skill enables businesses to license Zonein's technology as a white-label solution for creating custom trading agents. Revenue comes from licensing fees and a percentage of profits generated by these agents, allowing clients to deploy branded automated trading systems without developing the underlying infrastructure, ideal for fintech startups or investment firms.
Zonein provides consulting services based on its data analysis, helping clients interpret smart money signals and optimize trading strategies. Revenue is generated through one-time project fees or ongoing retainer agreements, offering tailored reports, training, and strategic advice to hedge funds, media companies, and other entities leveraging market intelligence.
๐ฌ Integration Tip
Ensure the ZONEIN_API_KEY is securely stored in environment variables or the OpenClaw dashboard to avoid exposure, and test read-only commands first to verify connectivity before proceeding with financial operations.
Analyze stocks and cryptocurrencies using Yahoo Finance data. Supports portfolio management, watchlists with alerts, dividend analysis, 8-dimension stock scoring, viral trend detection (Hot Scanner), and rumor/early signal detection. Use for stock analysis, portfolio tracking, earnings reactions, crypto monitoring, trending stocks, or finding rumors before they hit mainstream.
Get stock prices, quotes, fundamentals, earnings, options, dividends, and analyst ratings using Yahoo Finance. Uses yfinance library - no API key required.
Yahoo Finance (yfinance) powered stock analysis skill: quotes, fundamentals, ASCII trends, high-resolution charts (RSI/MACD/BB/VWAP/ATR), plus optional web a...
Become an autonomous prediction market trader on Polymarket with AI-powered analysis and a performance-backed token on Base. Trade real markets, build a track record, and let the buyback flywheel run.
Get cryptocurrency token price and generate candlestick charts via CoinGecko API or Hyperliquid API. Use when user asks for token price, crypto price, price chart, or cryptocurrency market data.
Trade and monitor Hyperliquid perpetual futures. Check balances, view positions with P&L, place/cancel orders, execute market trades. Use when the user asks about Hyperliquid trading, portfolio status, crypto positions, or wants to execute trades on Hyperliquid.