Skill: Zonein: Whale hunting for trading agents on Hyperliquid & Polymarket

Owner: phutt-bwai

Summary: Track and analyze top traders with >75% win-rate on Hyperliquid and Polymarket via Zonein API. Create Hyperliquid & Polymarket trading agents with ease. Auto...

Tags: latest:1.0.14

Version history:

v1.0.14 | 2026-02-23T21:52:22.652Z | auto

• Updated skill description to highlight tracking and analysis of top traders (>75% win-rate) and simplified automated agent creation.
• Clarified that both Hyperliquid and Polymarket are supported for agents and analysis.
• Emphasized a human-in-the-loop automated trading process.
• No changes were made to commands, usage, or quick reference.
• Documentation in SKILL.md is now more concise and focused on key benefits.

v1.0.13 | 2026-02-19T03:54:42.458Z | user

Refactor: clean up SKILL.md structure, fix command categorization, extract constants and helpers in zonein.py, sync version

v1.0.12 | 2026-02-18T13:33:25.553Z | user

Add backtest support: agent-backtest (streaming) and agent-backtests (list) commands

v1.0.11 | 2026-02-18T11:35:28.646Z | user

• Removed the file: scripts/manage_agent.py

v1.0.10 | 2026-02-18T11:28:01.894Z | user

Add backtest module with streaming engine, dashboard routes, and public GET endpoints for backtest results

v1.0.9 | 2026-02-17T09:55:55.247Z | user

require ETH gas for agent-fund bridge, remove gasless claim, update funding flow steps

v1.0.8 | 2026-02-17T09:22:12.791Z | user

Zonein 1.0.8 Changelog

• The --confirm flag is now required for all financial commands (agent-fund, agent-open, agent-close, agent-withdraw, agent-enable, agent-deploy). The script will refuse to execute these without confirmation.
• You must ask the user for explicit approval before running financial commands; only add --confirm after the user says yes.
• Updated documentation and usage examples to reflect this new safety requirement.
• No code changes detected; SKILL.md documentation now clarifies command safety and confirmation steps.

v1.0.7 | 2026-02-17T09:11:49.845Z | user

Fix manifest (declare openclaw.json read), remove undeclared .env path, document confirmation is instruction-level not programmatic

v1.0.6 | 2026-02-17T09:08:54.478Z | user

Remove ZONEIN_API_URL env var override from all scripts - hardcode API endpoint to prevent key exfiltration

v1.0.5 | 2026-02-17T09:05:16.029Z | user

Fix false read-only claim, accurately disclose GET and POST/PATCH/DELETE operations with user confirmation requirement

v1.0.4 | 2026-02-16T16:18:52.171Z | auto

• Major update to user safety and financial action handling.
• Now requires explicit user confirmation before executing financial commands (funding, opening/closing/withdrawing positions, agent actions).
• Read-only commands are clarified as safe to run without confirmation.
• Presentation rules updated—results must be reported in natural language; only show raw data on user request.
• "Critical rules" replaced with context-aware action/confirmation workflow for agent management (e.g., bridging funds only after user approval).
• No changes to actual commands or API usage; documentation and process improvements only.

v1.0.3 | 2026-02-16T16:13:57.771Z | user

Zonein 1.0.3 Changelog

• Updated documentation to clarify critical usage rules.
• Added strict instructions to never show raw commands or JSON to users.
• Mandated immediate handling of agent USDC bridging via agent-fund when needed.
• Improved user guidance for agent balance checks and deposits.
• No code or script files were changed—documentation only.

v1.0.2 | 2026-02-16T16:07:33.030Z | user

• Added guidance: All Python commands must be executed internally and results presented conversationally; never display raw commands or JSON to users.
• Updated funding instructions: After agent-deposit <id> and sending USDC, run agent-fund <id> to bridge to Hyperliquid.
• Clarified agent result reporting: Summaries (like trade count, win rate, PnL) should be given in natural language, not as raw output.
• No file or feature changes in code; documentation improvement only.

v1.0.1 | 2026-02-16T15:14:54.994Z | user

Zonein 2.0.0: Major upgrade — Adds agent creation and management commands.

• Introduced AI trading agent lifecycle: create, configure, deploy, pause, disable, fund, monitor, and withdraw using bundled commands.
• Expanded quick-reference with agent-focused actions (create/list/monitor/stop agent, check balance, open/close positions, deposit/withdraw funds).
• Added detailed command specs for all new agent management tasks including agent-create, agent-update, agent-get, agent-deploy, agent-stats, and more.
• Existing trading signal and leaderboard commands are fully retained.
• All usage now emphasizes proactive responses to both market analysis and agent requests.
• Updated documentation to reflect comprehensive agent flows and relevant command parameters.

v1.0.0 | 2026-02-14T15:26:05.588Z | user

Zonein 1.0.0 is a major update adding proactive smart money market intelligence via a bundled script.

• New: Proactive prompts for prediction/crypto signals, top traders, wallet tracking, and market flow.
• Bundled CLI: All data must be fetched via the provided Python script; inline API calls are disallowed.
• Expanded commands covering Polymarket prediction and HyperLiquid perpetuals, including categories, leaderboards, consensus signals, and trader profiles.
• Detailed quick reference and operational flows for market overviews, trading signals, and wallet tracking.
• Unified output formatting and explicit guidance on result presentation.
• Security, privacy, and setup instructions clarified, with a required API key and no direct calls.

Archive index:

Archive v1.0.14: 8 files, 23421 bytes

Files: references/schema.md (4532b), references/strategy.md (2656b), scripts/check_signals.py (3977b), scripts/market_overview.py (3623b), scripts/track_trader.py (5497b), scripts/zonein.py (30576b), SKILL.md (24527b), _meta.json (126b)

File v1.0.14:SKILL.md

---

name: zonein version: 2.0.0 description: | Track and analyze top traders with >75% win-rate on Hyperliquid and Polymarket via Zonein API. Create Hyperliquid & Polymarket trading agents with ease. Automated trading process with human-in-the-loop. homepage: https://zonein.xyz metadata: {"clawdbot":{"emoji":"🧠","requires":{"bins":["python3"],"env":["ZONEIN_API_KEY"]},"primaryEnv":"ZONEIN_API_KEY","files":["scripts/*"],"installer":{"instructions":"1. Go to https://app.zonein.xyz/pm\n2. Log in with your refcode\n3. Click 'Get API Key' button\n4. Copy the key and paste it below"}}}

Zonein — Smart Money Intelligence

Fetch live trading intelligence from Polymarket and HyperLiquid smart money wallets using the bundled script.

Setup (credentials)

Get Your API Key

1. Go to https://app.zonein.xyz/pm
2. Log in with your account (you need a referral code to register)
3. Click the "Get API Key" button
4. Copy your API key (starts with zn_)

Set API Key in OpenClaw

Option A — Gateway Dashboard (recommended):

1. Open your OpenClaw Gateway Dashboard
2. Go to /skills in the sidebar
3. Find "zonein" in Workspace Skills → click Enable
4. Enter your ZONEIN_API_KEY and save

Option 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).

Quick Reference

| 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 <id> + agent-trades <id> | | "Stop my agent" | agent-disable <id> | | "What agent types are available?" | agent-templates | | "Check my agent's balance" | agent-balance <id> | | "What positions does my agent have?" | agent-positions <id> | | "How do I fund my agent?" | agent-deposit <id> then send USDC, then agent-fund <id> to bridge to Hyperliquid | | "Open a BTC long for $100" | agent-open <id> --coin BTC --direction LONG --size 100 | | "Close my ETH position" | agent-close <id> --coin ETH | | "Withdraw my funds" | agent-disable <id> then agent-withdraw <id> --to 0x... | | "Backtest my agent on BTC" | agent-backtest <id> --symbol BTC --days 30 | | "Show past backtests" | agent-backtests <id> |

Commands

Presentation Rules:

• Present results in natural, readable language. Format numbers, tables, and summaries nicely.
• If the user asks to see raw JSON or the actual command, you may show it.

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:

• You run: agent-balance <id> (read-only, safe — no --confirm needed)
• You see: arbitrum_usdc: 200, needs_funding: true
• You tell the user: "Your vault has 200 USDC on Arbitrum but it hasn't been bridged to Hyperliquid yet. Would you like me to bridge it now so your agent can start trading?"
• User says yes → you run: agent-fund <id> --confirm
• Without --confirm, the script will refuse to execute and return an error

All 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 list

No 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 agents

No 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 config

No parameters. Returns available agent types with their category presets and default risk/trading config.

agent-assets — Available trading assets

No parameters. Returns: BTC, ETH, SOL, HYPE.

agent-categories — Smart money categories with live stats

No parameters. Returns all categories with description and live trader counts.

Utility

status — Check API key status

No parameters.

Operational Flows

🤖 Agent Creation Flow

When user wants to create a trading agent, follow this conversational flow:

Step 1: Collect Preferences Ask the user about their trading goals:

• What coins do you want to trade? (BTC, ETH, SOL, HYPE)
• What's your risk tolerance? (conservative, moderate, aggressive)
• What trading style? (scalping, swing trading, momentum, balanced)
• How much leverage? (1x–20x)
• Max daily loss tolerance? (1%–10%)

Step 2: Show Available Options Run these commands to give user context:

1. agent-templates — show available agent types
2. agent-categories — show smart money categories with stats
3. agent-assets — show available coins

Step 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

1. agent-get <agent_id> — review full config
2. agent-deploy <agent_id> — validate and enable

Step 6: Fund the Agent The vault (deposit address) is auto-created with the agent. The create response includes it.

1. Show user the deposit address from the create response (or use agent-deposit <agent_id>)
2. Tell user: "Send USDC to this address on Arbitrum One."
3. agent-balance <agent_id> — check arbitrum_usdc field to confirm deposit arrived
4. Tell user: "Also send a small amount of ETH (~0.001 ETH) to the same vault address on Arbitrum One for gas fees."
5. agent-fund <agent_id> --confirm — bridge USDC from Arbitrum into Hyperliquid (requires ETH for gas)
6. agent-balance <agent_id> — confirm Hyperliquid account_value shows the funds

Step 7: Monitor

• agent-balance <agent_id> — check vault balance
• agent-positions <agent_id> — view open positions
• agent-stats <agent_id> — check performance (PnL, win rate)
• agent-trades <agent_id> — view trade history
• agent-disable <agent_id> — stop trading if needed

💰 Deposit & Withdraw Flow

Deposit:

1. agent-deposit <agent_id> — get vault address
2. User sends USDC to vault address on Arbitrum One
3. agent-balance <agent_id> — check arbitrum_usdc to verify deposit arrived
4. User also sends a small amount of ETH (~0.001 ETH) to the same vault address for gas fees
5. agent-fund <agent_id> --confirm — bridge USDC from Arbitrum → Hyperliquid (requires ETH for gas)
6. agent-balance <agent_id> — confirm account_value on Hyperliquid

Withdraw:

1. agent-disable <agent_id> — must disable agent first
2. agent-withdraw <agent_id> --to 0xYourWallet... — queue withdrawal
3. System processes: Hyperliquid → Arbitrum → your wallet

📊 Position Management via Chat

When user wants to check positions or trade manually:

Check positions: agent-positions <agent_id> — Present each position: "BTC LONG — $500 at $95,432 entry — PnL: +$23.45 — 5x leverage"

Open a position: agent-open <agent_id> --coin BTC --direction LONG --size 100 --leverage 5 --confirm

Close a position: agent-close <agent_id> --coin BTC --confirm

Check order status: agent-orders <agent_id>

Market Overview

When user asks about market conditions, run these in sequence:

1. signals --limit 5 — top PM signals
2. perp-signals --limit 5 — top perp signals
3. perp-coins — coin long/short sentiment
4. Summarize: which markets have strong agreement, which coins whales are bullish/bearish on

Trading Signals

1. Ask: prediction markets, perp, or both?
2. Run the relevant command(s)
3. Present top signals sorted by consensus strength
4. Explain each signal, e.g.: "5 top-100 traders all say YES on 'Will BTC hit $100k?' — current price 42c"

Track a Wallet

1. trader <wallet> — Polymarket profile
2. perp-trader <address> — HyperLiquid profile
3. Present: performance, open positions, win rate

Strength Thresholds Guide

strength_thresholds and timeframe_weights are auto-generated from agent_type when creating an agent. Override with agent-update if user wants custom values.

What they control

• min_strength_buy: How strong smart money signal must be to OPEN a position (higher = pickier, fewer trades)
• min_strength_sell: How strong opposite-direction signal must be to CLOSE a position (lower = exit fast, higher = ride trends)

Auto-generated defaults by agent type

| 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 |

How to customize based on user preferences

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 |

Validation rules

1. All values >= 55 (hard minimum)
2. OTHERS >= max(BTC, ETH, SOL) altcoins are more volatile, need stronger signals
3. Typical ordering: BTC <= ETH <= SOL <= OTHERS for buy thresholds
4. Set OTHERS = max(BTC, ETH, SOL) + 0-5 buffer

Correct example:

• BTC buy 70, ETH buy 75, SOL buy 78, OTHERS buy 78 (>= max)

Wrong example:

• BTC buy 70, OTHERS buy 68 INVALID! OTHERS lower than BTC!

Timeframe weights

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 |

Override command

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}'

Output Fields

PM Signal

• direction — YES or NO
• consensus — 0 to 1 (1 = everyone agrees)
• total_wallets — how many smart traders hold this
• best_rank — best leaderboard position
• cur_yes_price / cur_no_price — current prices

Perp Signal

• coin — token (BTC, ETH, SOL, HYPE...)
• direction — LONG or SHORT
• consensus — agreement ratio (0-1)
• long_wallets / short_wallets — traders per side
• long_value / short_value — USD per side
• best_trader_score — credibility score

Periods & Categories

• PM Periods: DAY, WEEK, MONTH, ALL
• PM Categories: OVERALL, POLITICS, SPORTS, CRYPTO, CULTURE, ECONOMICS, TECH, FINANCE
• Perp Periods: day, week, month

How to Present Results

PM Signal

🔮 [market_title]
Smart money says: [YES/NO] | Agreement: [X]%
[N] top traders holding | Best ranked: #[rank]
Current price: YES [price] / NO [price]

Perp Signal

📊 $[COIN]
Smart money says: [LONG/SHORT] | Agreement: [X]%
[N] whale traders | Top score: [score]
Long: $[X] | Short: $[X]

Security & Privacy

Disclaimer:

• Signals show what smart money is doing — not guaranteed outcomes
• Past performance does not predict future results
• Never invest more than you can afford to lose
• Always use the bundled script. Never construct raw API calls with curl or inline Python.

External endpoint: https://mcp.zonein.xyz/api/v1/* — API key (X-API-Key header) + query parameters.

Data & access:

• Only your API key leaves the machine (sent as X-API-Key header)
• No personal data is sent beyond the key and query parameters
• Local files read: ~/.openclaw/openclaw.json (API key fallback only). No other local files are accessed.
• Local files written: none
• The scripts connect only to https://mcp.zonein.xyz/api/v1 — no other endpoints, no package installs, no filesystem writes

Confirmation 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.

Links

• Dashboard: https://app.zonein.xyz/pm/
• Perp Dashboard: https://app.zonein.xyz/perp/
• API Docs: https://mcp.zonein.xyz/docs

File v1.0.14:_meta.json

{ "ownerId": "kn76ja3af7t2vzn6dwz9ndx4vx8141va", "slug": "zonein", "version": "1.0.14", "publishedAt": 1771883542652 }

File v1.0.14:references/schema.md

Zonein Data Schema Reference

Prediction Market (Polymarket)

Leaderboard Entry

{
  "wallet": "0x...",
  "proxyWallet": "0x...",
  "userName": "trader_name",
  "profileImage": "https://...",
  "rank": 1,
  "pnl": 50000.0,
  "vol": 200000.0,
  "period": "WEEK",
  "category": "OVERALL"
}

Trader / User

{
  "wallet": "0x...",
  "username": "trader_name",
  "pfp": "https://...",
  "score": 85.5,
  "labels": ["smart_money", "whale", "consistent_winner"],
  "stats": {
    "total_trades": 150,
    "win_rate": 0.68,
    "roi": 0.45,
    "volume": 500000,
    "avg_hold_hours": 48
  }
}

Trader Performance (pre-calculated)

{
  "wallet": "0x...",
  "username": "trader_name",
  "overall": {
    "pnl": 50000,
    "volume": 200000,
    "roi": 0.25,
    "positions_count": 12
  },
  "best_category": "POLITICS",
  "category_stats": [
    {"category": "POLITICS", "pnl": 30000, "volume": 100000, "roi": 0.30},
    {"category": "CRYPTO", "pnl": 20000, "volume": 100000, "roi": 0.20}
  ]
}

Position (PM)

{
  "wallet": "0x...",
  "slug": "will-trump-win-2024",
  "eventSlug": "presidential-election-2024",
  "conditionId": "0x...",
  "title": "Will Trump win the 2024 election?",
  "outcome": "Yes",
  "outcomeIndex": 0,
  "size": 5000.0,
  "avgPrice": 0.45,
  "curPrice": 0.62,
  "totalBought": 5000.0,
  "category": "POLITICS",
  "endDate": "2024-11-05T00:00:00Z",
  "icon": "https://..."
}

PM Signal (consensus-based)

{
  "market_slug": "will-btc-hit-100k",
  "condition_id": "0x...",
  "title": "Will BTC hit $100k by end of 2024?",
  "direction": "YES",
  "consensus": 0.85,
  "total_wallets": 8,
  "yes_wallets": 7,
  "no_wallets": 1,
  "yes_size": 45000.0,
  "no_size": 3000.0,
  "cur_yes_price": 0.42,
  "cur_no_price": 0.58,
  "best_rank": 5,
  "category": "CRYPTO",
  "end_date": "2024-12-31T00:00:00Z"
}

Perp Trading (HyperLiquid)

Smart Trader

{
  "address": "0x...",
  "smart_trader_score": 85.5,
  "smart_trader_metrics": {
    "win_rate": 0.72,
    "profit_factor": 2.5,
    "avg_trade_duration": 48,
    "max_drawdown": 0.15
  },
  "categories": ["whale", "momentum_trader"],
  "account_value": 500000.0,
  "perp_month_pnl": 50000.0,
  "perp_week_pnl": 12000.0,
  "perp_day_pnl": 3000.0,
  "current_positions": {
    "asset_positions": [
      {
        "position": {
          "coin": "BTC",
          "szi": 0.5,
          "entryPx": 95000.0,
          "positionValue": 47500.0,
          "unrealizedPnl": 1200.0,
          "leverage": {"value": 3.0}
        }
      }
    ]
  }
}

Perp Signal (consensus-based)

{
  "coin": "BTC",
  "direction": "LONG",
  "consensus": 0.82,
  "total_wallets": 15,
  "long_wallets": 12,
  "short_wallets": 3,
  "long_value": 2500000.0,
  "short_value": 300000.0,
  "avg_entry_long": 95500.0,
  "avg_entry_short": 96200.0,
  "best_trader_score": 92.0
}

Coin Distribution

{
  "BTC": {
    "long_count": 45,
    "short_count": 12,
    "total_value": 5000000.0,
    "wallet_count": 57
  }
}

Agent Management

Agent Config

{
  "agent_id": "agent_abc123def456",
  "name": "PM Politics Agent",
  "agent_type": "prediction_market",
  "description": "Trades politics markets based on smart money signals",
  "enabled": true,
  "status": "enabled",
  "pm_config": {
    "categories": ["POLITICS", "ECONOMICS"],
    "leaderboard_period": "WEEK",
    "min_smart_wallets_agreeing": 3,
    "preferred_odds": 0.50,
    "min_edge": 0.03,
    "max_signals": 10,
    "signal_weights": {
      "consensus_ratio": 25,
      "user_count": 30,
      "leaderboard_rank": 20,
      "price_deviation_penalty": 10,
      "reward_ratio": 15
    }
  },
  "risk_config": {
    "max_position_size_pct": 0.05,
    "max_portfolio_exposure_pct": 0.50,
    "max_category_exposure_pct": 0.20,
    "min_edge": 0.05,
    "daily_loss_limit_pct": 0.10
  },
  "llm_config": {
    "provider": "openai",
    "model": "gpt-4-turbo",
    "temperature": 0.3
  },
  "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
  }
}

Agent Stats

{
  "total_trades": 45,
  "successful_trades": 28,
  "win_rate": 0.622,
  "total_pnl": 1250.50,
  "total_volume": 8500.0
}

File v1.0.14:references/strategy.md

Zonein Trading Strategy Reference

Signal Scoring Formula

Prediction Market Signals

Signals are scored 0-100 based on weighted components:

| Component | Weight | Description | |-----------|--------|-------------| | Consensus Ratio | 25% | % of wallets agreeing on direction (YES/NO) | | User Count | 30% | Number of smart wallets holding the market | | Leaderboard Rank | 20% | Best rank among holders (lower = better) | | Price Deviation | 10% | Penalty if entry price deviates from current | | Reward Ratio | 15% | Potential payout relative to cost |

Threshold: Signals with score >= 60 are considered actionable.

Perp Signals

Perp signals are consensus-based:

• Consensus = dominant_side_count / total_count
• Higher consensus + more wallets = stronger signal
• Best trader score adds credibility
• Long/Short value ratio shows conviction

Risk Management Rules

Position Sizing

• Max per trade: 5% of portfolio
• Max total exposure: 50% of portfolio
• Max per category: 20% of portfolio

Safety Rails

• Min edge: 3-5% (signal price vs market price)
• Daily loss limit: 10% of portfolio
• Cooldown: 24h per market after analysis without trade
• Kill switch: Disable agent immediately if daily loss exceeded

Agent Types

Prediction Market Agent

• Follows smart bettor consensus on Polymarket
• Trades YES/NO shares based on signal strength
• Domain filter: categories like POLITICS, CRYPTO, SPORTS
• Uses LLM to validate signal direction before execution

Perp Trading Agent

• Follows HyperLiquid whale positions
• Opens LONG/SHORT based on smart money consensus
• Coin filter: specific tokens (BTC, ETH, SOL, etc.)
• Leverage and stop-loss management

Trading Flow

1. Signal Detection
   └─ Smart wallet consensus detected
   └─ Score >= threshold (60)

2. Validation
   └─ Domain/category filter
   └─ Risk check (position limits, exposure)
   └─ LLM confirmation (optional)

3. Execution
   └─ Size calculation (Kelly or fixed %)
   └─ Order placement
   └─ Position tracking

4. Monitoring
   └─ Price updates
   └─ Stop-loss / Take-profit
   └─ Portfolio rebalancing

Recommended Cron Schedules

| Schedule | Job | Description | |----------|-----|-------------| | */5 * * * * | Signal scan | Check for new signals every 5 min | | 0 * * * * | Risk check | Hourly portfolio risk assessment | | 0 */6 * * * | Performance | 6-hourly PnL and win rate report | | 0 23 * * * | Daily summary | End-of-day report with full breakdown | | 0 8 * * 1 | Weekly review | Monday morning weekly performance review |

Archive v1.0.13: 8 files, 23541 bytes

Files: references/schema.md (4532b), references/strategy.md (2656b), scripts/check_signals.py (3977b), scripts/market_overview.py (3623b), scripts/track_trader.py (5497b), scripts/zonein.py (30576b), SKILL.md (24919b), _meta.json (126b)

File v1.0.13:SKILL.md

---

name: zonein version: 2.0.0 description: | Fetch live smart money signals from Polymarket and HyperLiquid via Zonein API. Create, configure, and manage AI trading agents that follow smart money. Use PROACTIVELY when user asks about: (1) Prediction market signals, whales, smart bettors (2) Crypto perp trading signals, long/short sentiment (3) Leaderboard, top traders, wallet tracking (4) Create/manage trading agents (agent creation flow) (5) Market overview, crypto sentiment, smart money flow (6) Agent performance, stats, trades, vault balance Always use the bundled script — never call the API with inline code. homepage: https://zonein.xyz metadata: {"clawdbot":{"emoji":"🧠","requires":{"bins":["python3"],"env":["ZONEIN_API_KEY"]},"primaryEnv":"ZONEIN_API_KEY","files":["scripts/*"],"installer":{"instructions":"1. Go to https://app.zonein.xyz/pm\n2. Log in with your refcode\n3. Click 'Get API Key' button\n4. Copy the key and paste it below"}}}

Zonein — Smart Money Intelligence

Fetch live trading intelligence from Polymarket and HyperLiquid smart money wallets using the bundled script.

Setup (credentials)

Get Your API Key

1. Go to https://app.zonein.xyz/pm
2. Log in with your account (you need a referral code to register)
3. Click the "Get API Key" button
4. Copy your API key (starts with zn_)

Set API Key in OpenClaw

Option A — Gateway Dashboard (recommended):

1. Open your OpenClaw Gateway Dashboard
2. Go to /skills in the sidebar
3. Find "zonein" in Workspace Skills → click Enable
4. Enter your ZONEIN_API_KEY and save

Option 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).

Quick Reference

| 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 <id> + agent-trades <id> | | "Stop my agent" | agent-disable <id> | | "What agent types are available?" | agent-templates | | "Check my agent's balance" | agent-balance <id> | | "What positions does my agent have?" | agent-positions <id> | | "How do I fund my agent?" | agent-deposit <id> then send USDC, then agent-fund <id> to bridge to Hyperliquid | | "Open a BTC long for $100" | agent-open <id> --coin BTC --direction LONG --size 100 | | "Close my ETH position" | agent-close <id> --coin ETH | | "Withdraw my funds" | agent-disable <id> then agent-withdraw <id> --to 0x... | | "Backtest my agent on BTC" | agent-backtest <id> --symbol BTC --days 30 | | "Show past backtests" | agent-backtests <id> |

Commands

Presentation Rules:

• Present results in natural, readable language. Format numbers, tables, and summaries nicely.
• If the user asks to see raw JSON or the actual command, you may show it.

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:

• You run: agent-balance <id> (read-only, safe — no --confirm needed)
• You see: arbitrum_usdc: 200, needs_funding: true
• You tell the user: "Your vault has 200 USDC on Arbitrum but it hasn't been bridged to Hyperliquid yet. Would you like me to bridge it now so your agent can start trading?"
• User says yes → you run: agent-fund <id> --confirm
• Without --confirm, the script will refuse to execute and return an error

All 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 list

No 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 agents

No 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 config

No parameters. Returns available agent types with their category presets and default risk/trading config.

agent-assets — Available trading assets

No parameters. Returns: BTC, ETH, SOL, HYPE.

agent-categories — Smart money categories with live stats

No parameters. Returns all categories with description and live trader counts.

Utility

status — Check API key status

No parameters.

Operational Flows

🤖 Agent Creation Flow

When user wants to create a trading agent, follow this conversational flow:

Step 1: Collect Preferences Ask the user about their trading goals:

• What coins do you want to trade? (BTC, ETH, SOL, HYPE)
• What's your risk tolerance? (conservative, moderate, aggressive)
• What trading style? (scalping, swing trading, momentum, balanced)
• How much leverage? (1x–20x)
• Max daily loss tolerance? (1%–10%)

Step 2: Show Available Options Run these commands to give user context:

1. agent-templates — show available agent types
2. agent-categories — show smart money categories with stats
3. agent-assets — show available coins

Step 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

1. agent-get <agent_id> — review full config
2. agent-deploy <agent_id> — validate and enable

Step 6: Fund the Agent The vault (deposit address) is auto-created with the agent. The create response includes it.

1. Show user the deposit address from the create response (or use agent-deposit <agent_id>)
2. Tell user: "Send USDC to this address on Arbitrum One."
3. agent-balance <agent_id> — check arbitrum_usdc field to confirm deposit arrived
4. Tell user: "Also send a small amount of ETH (~0.001 ETH) to the same vault address on Arbitrum One for gas fees."
5. agent-fund <agent_id> --confirm — bridge USDC from Arbitrum into Hyperliquid (requires ETH for gas)
6. agent-balance <agent_id> — confirm Hyperliquid account_value shows the funds

Step 7: Monitor

• agent-balance <agent_id> — check vault balance
• agent-positions <agent_id> — view open positions
• agent-stats <agent_id> — check performance (PnL, win rate)
• agent-trades <agent_id> — view trade history
• agent-disable <agent_id> — stop trading if needed

💰 Deposit & Withdraw Flow

Deposit:

1. agent-deposit <agent_id> — get vault address
2. User sends USDC to vault address on Arbitrum One
3. agent-balance <agent_id> — check arbitrum_usdc to verify deposit arrived
4. User also sends a small amount of ETH (~0.001 ETH) to the same vault address for gas fees
5. agent-fund <agent_id> --confirm — bridge USDC from Arbitrum → Hyperliquid (requires ETH for gas)
6. agent-balance <agent_id> — confirm account_value on Hyperliquid

Withdraw:

1. agent-disable <agent_id> — must disable agent first
2. agent-withdraw <agent_id> --to 0xYourWallet... — queue withdrawal
3. System processes: Hyperliquid → Arbitrum → your wallet

📊 Position Management via Chat

When user wants to check positions or trade manually:

Check positions: agent-positions <agent_id> — Present each position: "BTC LONG — $500 at $95,432 entry — PnL: +$23.45 — 5x leverage"

Open a position: agent-open <agent_id> --coin BTC --direction LONG --size 100 --leverage 5 --confirm

Close a position: agent-close <agent_id> --coin BTC --confirm

Check order status: agent-orders <agent_id>

Market Overview

When user asks about market conditions, run these in sequence:

1. signals --limit 5 — top PM signals
2. perp-signals --limit 5 — top perp signals
3. perp-coins — coin long/short sentiment
4. Summarize: which markets have strong agreement, which coins whales are bullish/bearish on

Trading Signals

1. Ask: prediction markets, perp, or both?
2. Run the relevant command(s)
3. Present top signals sorted by consensus strength
4. Explain each signal, e.g.: "5 top-100 traders all say YES on 'Will BTC hit $100k?' — current price 42c"

Track a Wallet

1. trader <wallet> — Polymarket profile
2. perp-trader <address> — HyperLiquid profile
3. Present: performance, open positions, win rate

Strength Thresholds Guide

strength_thresholds and timeframe_weights are auto-generated from agent_type when creating an agent. Override with agent-update if user wants custom values.

What they control

• min_strength_buy: How strong smart money signal must be to OPEN a position (higher = pickier, fewer trades)
• min_strength_sell: How strong opposite-direction signal must be to CLOSE a position (lower = exit fast, higher = ride trends)

Auto-generated defaults by agent type

| 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 |

How to customize based on user preferences

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 |

Validation rules

1. All values >= 55 (hard minimum)
2. OTHERS >= max(BTC, ETH, SOL) altcoins are more volatile, need stronger signals
3. Typical ordering: BTC <= ETH <= SOL <= OTHERS for buy thresholds
4. Set OTHERS = max(BTC, ETH, SOL) + 0-5 buffer

Correct example:

• BTC buy 70, ETH buy 75, SOL buy 78, OTHERS buy 78 (>= max)

Wrong example:

• BTC buy 70, OTHERS buy 68 INVALID! OTHERS lower than BTC!

Timeframe weights

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 |

Override command

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}'

Output Fields

PM Signal

• direction — YES or NO
• consensus — 0 to 1 (1 = everyone agrees)
• total_wallets — how many smart traders hold this
• best_rank — best leaderboard position
• cur_yes_price / cur_no_price — current prices

Perp Signal

• coin — token (BTC, ETH, SOL, HYPE...)
• direction — LONG or SHORT
• consensus — agreement ratio (0-1)
• long_wallets / short_wallets — traders per side
• long_value / short_value — USD per side
• best_trader_score — credibility score

Periods & Categories

• PM Periods: DAY, WEEK, MONTH, ALL
• PM Categories: OVERALL, POLITICS, SPORTS, CRYPTO, CULTURE, ECONOMICS, TECH, FINANCE
• Perp Periods: day, week, month

How to Present Results

PM Signal

🔮 [market_title]
Smart money says: [YES/NO] | Agreement: [X]%
[N] top traders holding | Best ranked: #[rank]
Current price: YES [price] / NO [price]

Perp Signal

📊 $[COIN]
Smart money says: [LONG/SHORT] | Agreement: [X]%
[N] whale traders | Top score: [score]
Long: $[X] | Short: $[X]

Security & Privacy

Disclaimer:

• Signals show what smart money is doing — not guaranteed outcomes
• Past performance does not predict future results
• Never invest more than you can afford to lose
• Always use the bundled script. Never construct raw API calls with curl or inline Python.

External endpoint: https://mcp.zonein.xyz/api/v1/* — API key (X-API-Key header) + query parameters.

Data & access:

• Only your API key leaves the machine (sent as X-API-Key header)
• No personal data is sent beyond the key and query parameters
• Local files read: ~/.openclaw/openclaw.json (API key fallback only). No other local files are accessed.
• Local files written: none
• The scripts connect only to https://mcp.zonein.xyz/api/v1 — no other endpoints, no package installs, no filesystem writes

Confirmation 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.

Links

• Dashboard: https://app.zonein.xyz/pm/
• Perp Dashboard: https://app.zonein.xyz/perp/
• API Docs: https://mcp.zonein.xyz/docs

File v1.0.13:_meta.json

{ "ownerId": "kn76ja3af7t2vzn6dwz9ndx4vx8141va", "slug": "zonein", "version": "1.0.13", "publishedAt": 1771473282458 }

File v1.0.13:references/schema.md

Zonein Data Schema Reference

Prediction Market (Polymarket)

Leaderboard Entry

{
  "wallet": "0x...",
  "proxyWallet": "0x...",
  "userName": "trader_name",
  "profileImage": "https://...",
  "rank": 1,
  "pnl": 50000.0,
  "vol": 200000.0,
  "period": "WEEK",
  "category": "OVERALL"
}

Trader / User

{
  "wallet": "0x...",
  "username": "trader_name",
  "pfp": "https://...",
  "score": 85.5,
  "labels": ["smart_money", "whale", "consistent_winner"],
  "stats": {
    "total_trades": 150,
    "win_rate": 0.68,
    "roi": 0.45,
    "volume": 500000,
    "avg_hold_hours": 48
  }
}

Trader Performance (pre-calculated)

{
  "wallet": "0x...",
  "username": "trader_name",
  "overall": {
    "pnl": 50000,
    "volume": 200000,
    "roi": 0.25,
    "positions_count": 12
  },
  "best_category": "POLITICS",
  "category_stats": [
    {"category": "POLITICS", "pnl": 30000, "volume": 100000, "roi": 0.30},
    {"category": "CRYPTO", "pnl": 20000, "volume": 100000, "roi": 0.20}
  ]
}

Position (PM)

{
  "wallet": "0x...",
  "slug": "will-trump-win-2024",
  "eventSlug": "presidential-election-2024",
  "conditionId": "0x...",
  "title": "Will Trump win the 2024 election?",
  "outcome": "Yes",
  "outcomeIndex": 0,
  "size": 5000.0,
  "avgPrice": 0.45,
  "curPrice": 0.62,
  "totalBought": 5000.0,
  "category": "POLITICS",
  "endDate": "2024-11-05T00:00:00Z",
  "icon": "https://..."
}

PM Signal (consensus-based)

{
  "market_slug": "will-btc-hit-100k",
  "condition_id": "0x...",
  "title": "Will BTC hit $100k by end of 2024?",
  "direction": "YES",
  "consensus": 0.85,
  "total_wallets": 8,
  "yes_wallets": 7,
  "no_wallets": 1,
  "yes_size": 45000.0,
  "no_size": 3000.0,
  "cur_yes_price": 0.42,
  "cur_no_price": 0.58,
  "best_rank": 5,
  "category": "CRYPTO",
  "end_date": "2024-12-31T00:00:00Z"
}

Perp Trading (HyperLiquid)

Smart Trader

{
  "address": "0x...",
  "smart_trader_score": 85.5,
  "smart_trader_metrics": {
    "win_rate": 0.72,
    "profit_factor": 2.5,
    "avg_trade_duration": 48,
    "max_drawdown": 0.15
  },
  "categories": ["whale", "momentum_trader"],
  "account_value": 500000.0,
  "perp_month_pnl": 50000.0,
  "perp_week_pnl": 12000.0,
  "perp_day_pnl": 3000.0,
  "current_positions": {
    "asset_positions": [
      {
        "position": {
          "coin": "BTC",
          "szi": 0.5,
          "entryPx": 95000.0,
          "positionValue": 47500.0,
          "unrealizedPnl": 1200.0,
          "leverage": {"value": 3.0}
        }
      }
    ]
  }
}

Perp Signal (consensus-based)

{
  "coin": "BTC",
  "direction": "LONG",
  "consensus": 0.82,
  "total_wallets": 15,
  "long_wallets": 12,
  "short_wallets": 3,
  "long_value": 2500000.0,
  "short_value": 300000.0,
  "avg_entry_long": 95500.0,
  "avg_entry_short": 96200.0,
  "best_trader_score": 92.0
}

Coin Distribution

{
  "BTC": {
    "long_count": 45,
    "short_count": 12,
    "total_value": 5000000.0,
    "wallet_count": 57
  }
}

Agent Management

Agent Config

{
  "agent_id": "agent_abc123def456",
  "name": "PM Politics Agent",
  "agent_type": "prediction_market",
  "description": "Trades politics markets based on smart money signals",
  "enabled": true,
  "status": "enabled",
  "pm_config": {
    "categories": ["POLITICS", "ECONOMICS"],
    "leaderboard_period": "WEEK",
    "min_smart_wallets_agreeing": 3,
    "preferred_odds": 0.50,
    "min_edge": 0.03,
    "max_signals": 10,
    "signal_weights": {
      "consensus_ratio": 25,
      "user_count": 30,
      "leaderboard_rank": 20,
      "price_deviation_penalty": 10,
      "reward_ratio": 15
    }
  },
  "risk_config": {
    "max_position_size_pct": 0.05,
    "max_portfolio_exposure_pct": 0.50,
    "max_category_exposure_pct": 0.20,
    "min_edge": 0.05,
    "daily_loss_limit_pct": 0.10
  },
  "llm_config": {
    "provider": "openai",
    "model": "gpt-4-turbo",
    "temperature": 0.3
  },
  "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
  }
}

Agent Stats

{
  "total_trades": 45,
  "successful_trades": 28,
  "win_rate": 0.622,
  "total_pnl": 1250.50,
  "total_volume": 8500.0
}

File v1.0.13:references/strategy.md

Zonein Trading Strategy Reference

Signal Scoring Formula

Prediction Market Signals

Signals are scored 0-100 based on weighted components:

| Component | Weight | Description | |-----------|--------|-------------| | Consensus Ratio | 25% | % of wallets agreeing on direction (YES/NO) | | User Count | 30% | Number of smart wallets holding the market | | Leaderboard Rank | 20% | Best rank among holders (lower = better) | | Price Deviation | 10% | Penalty if entry price deviates from current | | Reward Ratio | 15% | Potential payout relative to cost |

Threshold: Signals with score >= 60 are considered actionable.

Perp Signals

Perp signals are consensus-based:

• Consensus = dominant_side_count / total_count
• Higher consensus + more wallets = stronger signal
• Best trader score adds credibility
• Long/Short value ratio shows conviction

Risk Management Rules

Position Sizing

• Max per trade: 5% of portfolio
• Max total exposure: 50% of portfolio
• Max per category: 20% of portfolio

Safety Rails

• Min edge: 3-5% (signal price vs market price)
• Daily loss limit: 10% of portfolio
• Cooldown: 24h per market after analysis without trade
• Kill switch: Disable agent immediately if daily loss exceeded

Agent Types

Prediction Market Agent

• Follows smart bettor consensus on Polymarket
• Trades YES/NO shares based on signal strength
• Domain filter: categories like POLITICS, CRYPTO, SPORTS
• Uses LLM to validate signal direction before execution

Perp Trading Agent

• Follows HyperLiquid whale positions
• Opens LONG/SHORT based on smart money consensus
• Coin filter: specific tokens (BTC, ETH, SOL, etc.)
• Leverage and stop-loss management

Trading Flow

1. Signal Detection
   └─ Smart wallet consensus detected
   └─ Score >= threshold (60)

2. Validation
   └─ Domain/category filter
   └─ Risk check (position limits, exposure)
   └─ LLM confirmation (optional)

3. Execution
   └─ Size calculation (Kelly or fixed %)
   └─ Order placement
   └─ Position tracking

4. Monitoring
   └─ Price updates
   └─ Stop-loss / Take-profit
   └─ Portfolio rebalancing

Recommended Cron Schedules

| Schedule | Job | Description | |----------|-----|-------------| | */5 * * * * | Signal scan | Check for new signals every 5 min | | 0 * * * * | Risk check | Hourly portfolio risk assessment | | 0 */6 * * * | Performance | 6-hourly PnL and win rate report | | 0 23 * * * | Daily summary | End-of-day report with full breakdown | | 0 8 * * 1 | Weekly review | Monday morning weekly performance review |