modbender 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
- Go to https://app.zonein.xyz/pm
- Log in with your account (you need a referral code to register)
- Click the "Get API Key" button
- Copy your API key (starts with
zn_)
Set API Key in OpenClaw
Option A — Gateway Dashboard (recommended):
- Open your OpenClaw Gateway Dashboard
- Go to
/skillsin the sidebar - Find "zonein" in Workspace Skills → click Enable
- Enter your
ZONEIN_API_KEYand 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--confirmneeded) - 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:
agent-templates— show available agent typesagent-categories— show smart money categories with statsagent-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
agent-get <agent_id>— review full configagent-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.
- Show user the deposit address from the create response (or use
agent-deposit <agent_id>) - Tell user: "Send USDC to this address on Arbitrum One."
agent-balance <agent_id>— checkarbitrum_usdcfield to confirm deposit arrived- Tell user: "Also send a small amount of ETH (~0.001 ETH) to the same vault address on Arbitrum One for gas fees."
agent-fund <agent_id> --confirm— bridge USDC from Arbitrum into Hyperliquid (requires ETH for gas)agent-balance <agent_id>— confirm Hyperliquidaccount_valueshows the funds
Step 7: Monitor
agent-balance <agent_id>— check vault balanceagent-positions <agent_id>— view open positionsagent-stats <agent_id>— check performance (PnL, win rate)agent-trades <agent_id>— view trade historyagent-disable <agent_id>— stop trading if needed
💰 Deposit & Withdraw Flow
Deposit:
agent-deposit <agent_id>— get vault address- User sends USDC to vault address on Arbitrum One
agent-balance <agent_id>— checkarbitrum_usdcto verify deposit arrived- User also sends a small amount of ETH (~0.001 ETH) to the same vault address for gas fees
agent-fund <agent_id> --confirm— bridge USDC from Arbitrum → Hyperliquid (requires ETH for gas)agent-balance <agent_id>— confirmaccount_valueon Hyperliquid
Withdraw:
agent-disable <agent_id>— must disable agent firstagent-withdraw <agent_id> --to 0xYourWallet...— queue withdrawal- 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:
signals --limit 5— top PM signalsperp-signals --limit 5— top perp signalsperp-coins— coin long/short sentiment- Summarize: which markets have strong agreement, which coins whales are bullish/bearish on
Trading Signals
- Ask: prediction markets, perp, or both?
- Run the relevant command(s)
- Present top signals sorted by consensus strength
- Explain each signal, e.g.: "5 top-100 traders all say YES on 'Will BTC hit $100k?' — current price 42c"
Track a Wallet
trader <wallet>— Polymarket profileperp-trader <address>— HyperLiquid profile- 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
- All values >= 55 (hard minimum)
- OTHERS >= max(BTC, ETH, SOL) altcoins are more volatile, need stronger signals
- Typical ordering: BTC <= ETH <= SOL <= OTHERS for buy thresholds
- 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 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 prices
Perp Signal
coin— 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
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-Keyheader) - 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