{"id":"ed3454b6-886f-478b-b810-96db8f25d402","entityType":"agent","slug":"clawhub-phutt-bwai-zonein","name":"Zonein: Whale hunting for trading agents on Hyperliquid & Polymarket","canonicalUrl":"https://www.xpersona.co/agent/clawhub-phutt-bwai-zonein","canonicalPath":"/agent/clawhub-phutt-bwai-zonein","generatedAt":"2026-10-09T13:03:35.874Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"editorial-content","verified":true,"confidence":"high","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":null},"description":"Track and analyze top traders with >75% win-rate on Hyperliquid and Polymarket via Zonein API. Create Hyperliquid & Polymarket trading agents with ease. Auto... 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","descriptionLabel":"Technical summary","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 463 downloads reported by the source. Last updated 4/15/2026.","installCommand":"clawhub skill install kn76ja3af7t2vzn6dwz9ndx4vx8141va:zonein","sourceUrl":"https://clawhub.ai/phutt-bwai/zonein","homepage":"https://clawhub.ai/phutt-bwai/zonein","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/phutt-bwai/zonein","kind":"source"}],"safetyScore":84,"overallRank":62,"popularityScore":53,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"Track and analyze top traders with >75% win-rate on Hyperliquid and Polymarket via Zonein API. Create Hyperliquid & Polymarket trading agents with ease. Auto..."},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":null},"stars":null,"forks":null,"downloads":463,"packageName":null,"latestVersion":"1.0.14","tractionLabel":"463 downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-03-01T05:37:01.957Z","emptyReason":null},"lastUpdatedAt":"2026-04-15T00:45:39.800Z","lastCrawledAt":"2026-03-01T05:37:01.957Z","lastIndexedAt":null,"nextCrawlAt":"2026-03-02T05:37:01.957Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.14","createdAt":"2026-02-23T21:52:22.652Z","changelog":"- 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.","fileCount":8,"zipByteSize":23421},{"version":"1.0.13","createdAt":"2026-02-19T03:54:42.458Z","changelog":"Refactor: clean up SKILL.md structure, fix command categorization, extract constants and helpers in zonein.py, sync version","fileCount":8,"zipByteSize":23541},{"version":"1.0.12","createdAt":"2026-02-18T13:33:25.553Z","changelog":"Add backtest support: agent-backtest (streaming) and agent-backtests (list) commands","fileCount":null,"zipByteSize":null},{"version":"1.0.11","createdAt":"2026-02-18T11:35:28.646Z","changelog":"- Removed the file: scripts/manage_agent.py","fileCount":null,"zipByteSize":null},{"version":"1.0.10","createdAt":"2026-02-18T11:28:01.894Z","changelog":"Add backtest module with streaming engine, dashboard routes, and public GET endpoints for backtest results","fileCount":null,"zipByteSize":null},{"version":"1.0.9","createdAt":"2026-02-17T09:55:55.247Z","changelog":"require ETH gas for agent-fund bridge, remove gasless claim, update funding flow steps","fileCount":null,"zipByteSize":null},{"version":"1.0.8","createdAt":"2026-02-17T09:22:12.791Z","changelog":"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.","fileCount":null,"zipByteSize":null},{"version":"1.0.7","createdAt":"2026-02-17T09:11:49.845Z","changelog":"Fix manifest (declare openclaw.json read), remove undeclared .env path, document confirmation is instruction-level not programmatic","fileCount":null,"zipByteSize":null}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install kn76ja3af7t2vzn6dwz9ndx4vx8141va:zonein","setupComplexity":"low","setupSteps":["Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.","Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-phutt-bwai-zonein/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-phutt-bwai-zonein/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-phutt-bwai-zonein/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-phutt-bwai-zonein/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-phutt-bwai-zonein/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-phutt-bwai-zonein/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-09T13:03:35.873Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-phutt-bwai-zonein/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-phutt-bwai-zonein/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-phutt-bwai-zonein/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-phutt-bwai-zonein/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"high","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":null},"readme":"Skill: Zonein: Whale hunting for trading agents on Hyperliquid & Polymarket\n\nOwner: phutt-bwai\n\nSummary: Track and analyze top traders with >75% win-rate on Hyperliquid and Polymarket via Zonein API. Create Hyperliquid & Polymarket trading agents with ease. Auto...\n\nTags: latest:1.0.14\n\nVersion history:\n\nv1.0.14 | 2026-02-23T21:52:22.652Z | auto\n\n- Updated skill description to highlight tracking and analysis of top traders (>75% win-rate) and simplified automated agent creation.\n- Clarified that both Hyperliquid and Polymarket are supported for agents and analysis.\n- Emphasized a human-in-the-loop automated trading process.\n- No changes were made to commands, usage, or quick reference.\n- Documentation in SKILL.md is now more concise and focused on key benefits.\n\nv1.0.13 | 2026-02-19T03:54:42.458Z | user\n\nRefactor: clean up SKILL.md structure, fix command categorization, extract constants and helpers in zonein.py, sync version\n\nv1.0.12 | 2026-02-18T13:33:25.553Z | user\n\nAdd backtest support: agent-backtest (streaming) and agent-backtests (list) commands\n\nv1.0.11 | 2026-02-18T11:35:28.646Z | user\n\n- Removed the file: scripts/manage_agent.py\n\nv1.0.10 | 2026-02-18T11:28:01.894Z | user\n\nAdd backtest module with streaming engine, dashboard routes, and public GET endpoints for backtest results\n\nv1.0.9 | 2026-02-17T09:55:55.247Z | user\n\nrequire ETH gas for agent-fund bridge, remove gasless claim, update funding flow steps\n\nv1.0.8 | 2026-02-17T09:22:12.791Z | user\n\nZonein 1.0.8 Changelog\n\n- 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.\n- You must ask the user for explicit approval before running financial commands; only add `--confirm` after the user says yes.\n- Updated documentation and usage examples to reflect this new safety requirement.\n- No code changes detected; SKILL.md documentation now clarifies command safety and confirmation steps.\n\nv1.0.7 | 2026-02-17T09:11:49.845Z | user\n\nFix manifest (declare openclaw.json read), remove undeclared .env path, document confirmation is instruction-level not programmatic\n\nv1.0.6 | 2026-02-17T09:08:54.478Z | user\n\nRemove ZONEIN_API_URL env var override from all scripts - hardcode API endpoint to prevent key exfiltration\n\nv1.0.5 | 2026-02-17T09:05:16.029Z | user\n\nFix false read-only claim, accurately disclose GET and POST/PATCH/DELETE operations with user confirmation requirement\n\nv1.0.4 | 2026-02-16T16:18:52.171Z | auto\n\n- Major update to user safety and financial action handling.\n- Now requires explicit user confirmation before executing financial commands (funding, opening/closing/withdrawing positions, agent actions).\n- Read-only commands are clarified as safe to run without confirmation.\n- Presentation rules updated—results must be reported in natural language; only show raw data on user request.\n- \"Critical rules\" replaced with context-aware action/confirmation workflow for agent management (e.g., bridging funds only after user approval).\n- No changes to actual commands or API usage; documentation and process improvements only.\n\nv1.0.3 | 2026-02-16T16:13:57.771Z | user\n\nZonein 1.0.3 Changelog\n\n- Updated documentation to clarify critical usage rules.\n- Added strict instructions to never show raw commands or JSON to users.\n- Mandated immediate handling of agent USDC bridging via `agent-fund` when needed.\n- Improved user guidance for agent balance checks and deposits.\n- No code or script files were changed—documentation only.\n\nv1.0.2 | 2026-02-16T16:07:33.030Z | user\n\n- Added guidance: All Python commands must be executed internally and results presented conversationally; never display raw commands or JSON to users.\n- Updated funding instructions: After `agent-deposit <id>` and sending USDC, run `agent-fund <id>` to bridge to Hyperliquid.\n- Clarified agent result reporting: Summaries (like trade count, win rate, PnL) should be given in natural language, not as raw output.\n- No file or feature changes in code; documentation improvement only.\n\nv1.0.1 | 2026-02-16T15:14:54.994Z | user\n\n**Zonein 2.0.0: Major upgrade — Adds agent creation and management commands.**\n\n- Introduced AI trading agent lifecycle: create, configure, deploy, pause, disable, fund, monitor, and withdraw using bundled commands.\n- Expanded quick-reference with agent-focused actions (create/list/monitor/stop agent, check balance, open/close positions, deposit/withdraw funds).\n- Added detailed command specs for all new agent management tasks including `agent-create`, `agent-update`, `agent-get`, `agent-deploy`, `agent-stats`, and more.\n- Existing trading signal and leaderboard commands are fully retained.\n- All usage now emphasizes proactive responses to both market analysis and agent requests.\n- Updated documentation to reflect comprehensive agent flows and relevant command parameters.\n\nv1.0.0 | 2026-02-14T15:26:05.588Z | user\n\nZonein 1.0.0 is a major update adding proactive smart money market intelligence via a bundled script.\n\n- New: Proactive prompts for prediction/crypto signals, top traders, wallet tracking, and market flow.\n- Bundled CLI: All data must be fetched via the provided Python script; inline API calls are disallowed.\n- Expanded commands covering Polymarket prediction and HyperLiquid perpetuals, including categories, leaderboards, consensus signals, and trader profiles.\n- Detailed quick reference and operational flows for market overviews, trading signals, and wallet tracking.\n- Unified output formatting and explicit guidance on result presentation.\n- Security, privacy, and setup instructions clarified, with a required API key and no direct calls.\n\nArchive index:\n\nArchive v1.0.14: 8 files, 23421 bytes\n\nFiles: 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)\n\nFile v1.0.14:SKILL.md\n\n---\nname: zonein\nversion: 2.0.0\ndescription: |\n  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.\nhomepage: https://zonein.xyz\nmetadata: {\"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\"}}}\n---\n\n# Zonein — Smart Money Intelligence\n\nFetch live trading intelligence from Polymarket and HyperLiquid smart money wallets using the bundled script.\n\n## Setup (credentials)\n\n### Get Your API Key\n\n1. Go to **https://app.zonein.xyz/pm**\n2. Log in with your account (you need a referral code to register)\n3. Click the **\"Get API Key\"** button\n4. Copy your API key (starts with `zn_`)\n\n### Set API Key in OpenClaw\n\n**Option A — Gateway Dashboard (recommended):**\n1. Open your **OpenClaw Gateway Dashboard**\n2. Go to **`/skills`** in the sidebar\n3. Find **\"zonein\"** in Workspace Skills → click **Enable**\n4. Enter your `ZONEIN_API_KEY` and save\n\n**Option B — Environment variable:**\n```bash\nexport ZONEIN_API_KEY=\"zn_your_key_here\"\n```\n\n**Option C — The script also reads from `~/.openclaw/openclaw.json`** automatically (skills.entries.zonein.apiKey).\n\n## Quick Reference\n\n| User asks... | Command |\n|-------------|---------|\n| \"What's happening in the market?\" | `signals --limit 5` + `perp-signals --limit 5` |\n| \"Show me PM signals for politics\" | `signals --categories POLITICS --limit 10` |\n| \"What are whales doing on crypto?\" | `perp-signals --limit 10` |\n| \"Top Polymarket traders this week\" | `leaderboard --period WEEK --limit 10` |\n| \"Which coins are smart money long?\" | `perp-coins` |\n| \"Best perp traders this month\" | `perp-top --period month --limit 10` |\n| \"Track wallet 0x...\" | `trader 0x...` or `perp-trader 0x...` |\n| \"Where is smart money flowing?\" | `signals --limit 10` + `perp-signals --limit 10` + `perp-coins` |\n| \"Create a trading agent\" | Follow Agent Creation Flow (Step 1–6) |\n| \"List my agents\" | `agents` |\n| \"How is my agent doing?\" | `agent-stats <id>` + `agent-trades <id>` |\n| \"Stop my agent\" | `agent-disable <id>` |\n| \"What agent types are available?\" | `agent-templates` |\n| \"Check my agent's balance\" | `agent-balance <id>` |\n| \"What positions does my agent have?\" | `agent-positions <id>` |\n| \"How do I fund my agent?\" | `agent-deposit <id>` then send USDC, then `agent-fund <id>` to bridge to Hyperliquid |\n| \"Open a BTC long for $100\" | `agent-open <id> --coin BTC --direction LONG --size 100` |\n| \"Close my ETH position\" | `agent-close <id> --coin ETH` |\n| \"Withdraw my funds\" | `agent-disable <id>` then `agent-withdraw <id> --to 0x...` |\n| \"Backtest my agent on BTC\" | `agent-backtest <id> --symbol BTC --days 30` |\n| \"Show past backtests\" | `agent-backtests <id>` |\n\n## Commands\n\n**Presentation Rules:**\n- Present results in natural, readable language. Format numbers, tables, and summaries nicely.\n- If the user asks to see raw JSON or the actual command, you may show it.\n\n**Read-only commands (safe to run without asking):**\n`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`\n\n**State-changing commands (ask user before running — no `--confirm` needed):**\n`agent-create`, `agent-update`, `agent-disable`, `agent-pause`, `agent-delete`\n\n**Financial commands (require `--confirm` flag — script refuses without it):**\n`agent-fund`, `agent-open`, `agent-close`, `agent-withdraw`, `agent-enable`, `agent-deploy`, `agent-backtest`\n\nYou MUST ask the user for approval before running any state-changing or financial command.\nFor financial commands, only add `--confirm` after the user explicitly says yes.\n\n**Example — user deposits USDC and asks to check balance:**\n- You run: `agent-balance <id>` (read-only, safe — no `--confirm` needed)\n- You see: `arbitrum_usdc: 200, needs_funding: true`\n- 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?\"\n- User says yes → you run: `agent-fund <id> --confirm`\n- Without `--confirm`, the script will refuse to execute and return an error\n\nAll commands use the bundled Python script. **Always use these commands — never write inline API calls.**\n\nPrefix: `python3 skills/zonein/scripts/zonein.py`\n\n**Polymarket (PM)**\n\n### `signals` — PM smart money trading signals\n\n| Param | Type | Default | Values | Description |\n|-------|------|---------|--------|-------------|\n| `--limit` | int | 20 | 1–100 | Max signals to return |\n| `--categories` | str | all | `POLITICS,CRYPTO,SPORTS,CULTURE,ECONOMICS,TECH,FINANCE` | Comma-separated filter |\n| `--period` | str | WEEK | `DAY`, `WEEK`, `MONTH`, `ALL` | Lookback period |\n| `--min-wallets` | int | 3 | ≥1 | Minimum smart wallets for consensus |\n\n### `leaderboard` — PM top traders by PnL\n\n| Param | Type | Default | Values | Description |\n|-------|------|---------|--------|-------------|\n| `--period` | str | WEEK | `DAY`, `WEEK`, `MONTH`, `ALL` | Ranking period |\n| `--category` | str | OVERALL | `OVERALL`, `POLITICS`, `SPORTS`, `CRYPTO`, `CULTURE`, `ECONOMICS`, `TECH`, `FINANCE` | Category filter |\n| `--limit` | int | 20 | 1–500 | Max traders to return |\n\n### `consensus` — PM positions where smart bettors agree\n\n| Param | Type | Default | Description |\n|-------|------|---------|-------------|\n| `--min-bettors` | int | 3 | Minimum bettors agreeing on a position |\n\n### `trader` — PM trader profile by wallet\n\n| Param | Type | Required | Description |\n|-------|------|----------|-------------|\n| `wallet` | str | yes | Polymarket wallet address (0x...) |\n\n**Perpetuals (HyperLiquid)**\n\n### `perp-signals` — Perp trading signals (HyperLiquid)\n\n| Param | Type | Default | Description |\n|-------|------|---------|-------------|\n| `--limit` | int | 20 | Max signals to return |\n| `--min-wallets` | int | 3 | Minimum wallets for consensus |\n| `--min-score` | float | 0 | Minimum trader credibility score (0–100) |\n\n### `perp-traders` — Perp smart money traders\n\n| Param | Type | Default | Description |\n|-------|------|---------|-------------|\n| `--limit` | int | 20 | Max traders to return |\n| `--min-score` | float | 0 | Minimum trader score (0–100) |\n| `--categories` | str | all | Comma-separated: `swing_trading`, `large_cap_trader`, `high_win_rate`, `scalper`, etc. |\n\n### `perp-top` — Perp top performers by PnL\n\n| Param | Type | Default | Values | Description |\n|-------|------|---------|--------|-------------|\n| `--limit` | int | 10 | 1–100 | Max traders |\n| `--period` | str | month | `day`, `week`, `month` | PnL ranking period |\n\n### `perp-coins` — Coin distribution (long vs short sentiment)\n\nNo parameters. Returns all coins with smart money positions.\n\n### `perp-categories` — Perp trader category list\n\nNo parameters.\n\n### `perp-trader` — Perp trader details by address\n\n| Param | Type | Required | Description |\n|-------|------|----------|-------------|\n| `address` | str | yes | HyperLiquid wallet address (0x...) |\n\n**Agent Management**\n\n### `agents` — List your trading agents\n\nNo parameters.\n\n### `agent-get` — Get full agent config and state\n\n| Param | Type | Required | Description |\n|-------|------|----------|-------------|\n| `agent_id` | str | yes | Agent ID (e.g. `agent_abc12345`) |\n\n### `agent-create` — Create a new trading agent\n\n| Param | Type | Default | Description |\n|-------|------|---------|-------------|\n| `--name` | str | required | Agent display name |\n| `--type` | str | composite | `composite`, `momentum_hunter`, `stable_grower`, `precision_master`, `whale_follower`, `scalping_pro`, `swing_trader` |\n| `--assets` | str | BTC,ETH | Comma-separated: `BTC,ETH,SOL,HYPE` |\n| `--categories` | str | auto from type | Comma-separated smart money categories |\n| `--leverage` | int | 5 | Max leverage (1–20) |\n| `--description` | str | auto | Agent description |\n| `--risk-per-trade` | float | 1 | Risk per trade % |\n| `--max-daily-loss` | float | 3 | Max daily loss % |\n| `--risk-reward` | str | 1:2 | Risk:reward ratio |\n| `--max-trades-per-day` | int | 3 | Max trades per day |\n| `--min-confidence` | float | 0.8 | Min LLM confidence (0–1) |\n| `--min-consensus` | float | 0.7 | Min smart money consensus (0–1) |\n\n### `agent-update` — Update agent configuration\n\n| Param | Type | Description |\n|-------|------|-------------|\n| `agent_id` | str | Agent ID (positional) |\n| `--name` | str | New name |\n| `--assets` | str | Comma-separated assets |\n| `--categories` | str | Comma-separated categories |\n| `--leverage` | int | Max leverage |\n| `--methodology` | str | Trading methodology text |\n| `--entry-strategy` | str | Entry strategy text |\n| `--exit-framework` | str | Exit framework text |\n| `--strength-thresholds` | json | Entry/exit thresholds per asset (see Strength Thresholds Guide) |\n| `--timeframe-weights` | json | Timeframe weight distribution |\n\n### `agent-deploy` — Validate config and enable trading\n\n| Param | Type | Required | Description |\n|-------|------|----------|-------------|\n| `agent_id` | str | yes | Agent to deploy |\n\n### `agent-enable` / `agent-disable` / `agent-pause` — Lifecycle control\n\n| Param | Type | Required | Description |\n|-------|------|----------|-------------|\n| `agent_id` | str | yes | Agent ID |\n\n### `agent-delete` — Delete agent (soft delete)\n\n| Param | Type | Required | Description |\n|-------|------|----------|-------------|\n| `agent_id` | str | yes | Agent ID |\n\n### `agent-stats` — Performance statistics (PnL, win rate)\n\n| Param | Type | Required | Description |\n|-------|------|----------|-------------|\n| `agent_id` | str | yes | Agent ID |\n\n### `agent-trades` — Trade history\n\n| Param | Type | Default | Description |\n|-------|------|---------|-------------|\n| `agent_id` | str | required | Agent ID |\n| `--limit` | int | 50 | Max trades to return |\n\n### `agent-vault` — Vault (trading wallet) info\n\n| Param | Type | Required | Description |\n|-------|------|----------|-------------|\n| `agent_id` | str | yes | Agent ID |\n\n### `agent-balance` — Live vault balance from Hyperliquid\n\n| Param | Type | Required | Description |\n|-------|------|----------|-------------|\n| `agent_id` | str | yes | Agent ID |\n\nReturns: `account_value`, `withdrawable`, `has_positions`, `vault_address`.\n\n### `agent-positions` — Open positions (live from Hyperliquid)\n\n| Param | Type | Required | Description |\n|-------|------|----------|-------------|\n| `agent_id` | str | yes | Agent ID |\n\nReturns each position: `coin`, `side` (LONG/SHORT), `size`, `entry_price`, `unrealized_pnl`, `leverage`, `notional`.\n\n### `agent-deposit` — Get deposit address for funding agent\n\n| Param | Type | Required | Description |\n|-------|------|----------|-------------|\n| `agent_id` | str | yes | Agent ID |\n\nReturns: `deposit_address` (send USDC on Arbitrum One to this address).\n\n### `agent-fund` — Bridge USDC from Arbitrum to Hyperliquid\n\n| Param | Type | Required | Description |\n|-------|------|----------|-------------|\n| `agent_id` | str | yes | Agent ID |\n\nAfter sending USDC to the vault address on Arbitrum, call this to auto-bridge funds into Hyperliquid.\n**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.\nReturns `tx_hash` and `amount` bridged.\n\n### `agent-open` — Open a position (manual order via chat)\n\n| Param | Type | Required | Description |\n|-------|------|----------|-------------|\n| `agent_id` | str | yes | Agent ID |\n| `--coin` | str | yes | BTC, ETH, SOL, HYPE |\n| `--direction` | str | no (default LONG) | LONG or SHORT |\n| `--size` | float | yes | Position size in USD |\n| `--leverage` | int | no | Leverage (1–20) |\n\n### `agent-close` — Close a position\n\n| Param | Type | Required | Description |\n|-------|------|----------|-------------|\n| `agent_id` | str | yes | Agent ID |\n| `--coin` | str | yes | Coin to close (BTC, ETH, SOL, HYPE) |\n\n### `agent-orders` — Manual order history\n\n| Param | Type | Default | Description |\n|-------|------|---------|-------------|\n| `agent_id` | str | required | Agent ID |\n| `--limit` | int | 20 | Max orders to return |\n\n### `agent-withdraw` — Withdraw funds to your wallet\n\n| Param | Type | Required | Description |\n|-------|------|----------|-------------|\n| `agent_id` | str | yes | Agent ID |\n| `--to` | str | yes | Destination 0x... wallet address on Arbitrum |\n\nAgent must be **disabled** before withdrawing. Flow: Hyperliquid → Arbitrum → your wallet.\n\n### `agent-backtest` — Run backtest simulation\n\n| Param | Type | Default | Description |\n|-------|------|---------|-------------|\n| `agent_id` | str | required | Agent ID |\n| `--symbol` | str | BTC | Coin to backtest: BTC, ETH, SOL, HYPE |\n| `--days` | int | 30 | Backtest period (7–90 days) |\n| `--initial-balance` | float | 10000 | Starting balance in USD |\n\nRuns 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).\n\n**Requires `--confirm`** (this is a compute-intensive action).\n\nExample output:\n```json\n{\n  \"backtest_id\": \"bt_agent123_BTC_20260218_...\",\n  \"dashboard\": \"https://mcp.zonein.xyz/api/v1/backtest/bt_.../dashboard\",\n  \"pnl\": 523.40,\n  \"total_trades\": 12,\n  \"stats\": {\"win_rate\": 66.67, \"sharpe_ratio\": 1.42, \"max_drawdown\": 3.2}\n}\n```\n\n### `agent-backtests` — List past backtests\n\n| Param | Type | Default | Description |\n|-------|------|---------|-------------|\n| `agent_id` | str | required | Agent ID |\n| `--limit` | int | 10 | Max results |\n\nReturns list of previous backtests with summary metrics and dashboard links.\n\n### `agent-templates` — Agent types & default config\n\nNo parameters. Returns available agent types with their category presets and default risk/trading config.\n\n### `agent-assets` — Available trading assets\n\nNo parameters. Returns: BTC, ETH, SOL, HYPE.\n\n### `agent-categories` — Smart money categories with live stats\n\nNo parameters. Returns all categories with description and live trader counts.\n\n**Utility**\n\n### `status` — Check API key status\n\nNo parameters.\n\n## Operational Flows\n\n### 🤖 Agent Creation Flow\n\nWhen user wants to create a trading agent, follow this conversational flow:\n\n**Step 1: Collect Preferences**\nAsk the user about their trading goals:\n- What coins do you want to trade? (BTC, ETH, SOL, HYPE)\n- What's your risk tolerance? (conservative, moderate, aggressive)\n- What trading style? (scalping, swing trading, momentum, balanced)\n- How much leverage? (1x–20x)\n- Max daily loss tolerance? (1%–10%)\n\n**Step 2: Show Available Options**\nRun these commands to give user context:\n1. `agent-templates` — show available agent types\n2. `agent-categories` — show smart money categories with stats\n3. `agent-assets` — show available coins\n\n**Step 3: Create Agent**\nBased on collected preferences, create the agent:\n```\nagent-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\n```\n\n**Step 4: Configure Strategy**\nUpdate the agent with trading strategy prompts:\n```\nagent-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%...\"\n```\n\n**Step 5: Review & Deploy**\n1. `agent-get <agent_id>` — review full config\n2. `agent-deploy <agent_id>` — validate and enable\n\n**Step 6: Fund the Agent**\nThe vault (deposit address) is auto-created with the agent. The create response includes it.\n1. Show user the deposit address from the create response (or use `agent-deposit <agent_id>`)\n2. Tell user: \"Send USDC to this address on Arbitrum One.\"\n3. `agent-balance <agent_id>` — check `arbitrum_usdc` field to confirm deposit arrived\n4. Tell user: \"Also send a small amount of ETH (~0.001 ETH) to the same vault address on Arbitrum One for gas fees.\"\n5. `agent-fund <agent_id> --confirm` — bridge USDC from Arbitrum into Hyperliquid (requires ETH for gas)\n6. `agent-balance <agent_id>` — confirm Hyperliquid `account_value` shows the funds\n\n**Step 7: Monitor**\n- `agent-balance <agent_id>` — check vault balance\n- `agent-positions <agent_id>` — view open positions\n- `agent-stats <agent_id>` — check performance (PnL, win rate)\n- `agent-trades <agent_id>` — view trade history\n- `agent-disable <agent_id>` — stop trading if needed\n\n### 💰 Deposit & Withdraw Flow\n\n**Deposit:**\n1. `agent-deposit <agent_id>` — get vault address\n2. User sends USDC to vault address on **Arbitrum One**\n3. `agent-balance <agent_id>` — check `arbitrum_usdc` to verify deposit arrived\n4. User also sends a small amount of ETH (~0.001 ETH) to the same vault address for gas fees\n5. `agent-fund <agent_id> --confirm` — bridge USDC from Arbitrum → Hyperliquid (requires ETH for gas)\n6. `agent-balance <agent_id>` — confirm `account_value` on Hyperliquid\n\n**Withdraw:**\n1. `agent-disable <agent_id>` — must disable agent first\n2. `agent-withdraw <agent_id> --to 0xYourWallet...` — queue withdrawal\n3. System processes: Hyperliquid → Arbitrum → your wallet\n\n### 📊 Position Management via Chat\n\nWhen user wants to check positions or trade manually:\n\n**Check positions:**\n`agent-positions <agent_id>` — Present each position: \"BTC LONG — $500 at $95,432 entry — PnL: +$23.45 — 5x leverage\"\n\n**Open a position:**\n`agent-open <agent_id> --coin BTC --direction LONG --size 100 --leverage 5 --confirm`\n\n**Close a position:**\n`agent-close <agent_id> --coin BTC --confirm`\n\n**Check order status:**\n`agent-orders <agent_id>`\n\n### Market Overview\n\nWhen user asks about market conditions, run these in sequence:\n1. `signals --limit 5` — top PM signals\n2. `perp-signals --limit 5` — top perp signals\n3. `perp-coins` — coin long/short sentiment\n4. Summarize: which markets have strong agreement, which coins whales are bullish/bearish on\n\n### Trading Signals\n\n1. Ask: prediction markets, perp, or both?\n2. Run the relevant command(s)\n3. Present top signals sorted by consensus strength\n4. Explain each signal, e.g.: \"5 top-100 traders all say YES on 'Will BTC hit $100k?' — current price 42c\"\n\n### Track a Wallet\n\n1. `trader <wallet>` — Polymarket profile\n2. `perp-trader <address>` — HyperLiquid profile\n3. Present: performance, open positions, win rate\n\n## Strength Thresholds Guide\n\n`strength_thresholds` and `timeframe_weights` are **auto-generated** from `agent_type` when creating an agent. Override with `agent-update` if user wants custom values.\n\n### What they control\n\n- **min_strength_buy**: How strong smart money signal must be to OPEN a position (higher = pickier, fewer trades)\n- **min_strength_sell**: How strong opposite-direction signal must be to CLOSE a position (lower = exit fast, higher = ride trends)\n\n### Auto-generated defaults by agent type\n\n| Agent Type | Style | BTC buy/sell | ETH buy/sell | SOL buy/sell | OTHERS buy/sell | Timeframes 24h/4h/1h |\n|------------|-------|-------------|-------------|-------------|----------------|---------------------|\n| scalping_pro, momentum_hunter | Scalp | 65/65 | 70/65 | 78/65 | 78/65 | 0.2/0.4/0.4 |\n| All others (swing_trader, stable_grower, composite, etc.) | Swing | 75/70 | 78/70 | 82/70 | 82/70 | 0.5/0.35/0.15 |\n\n### How to customize based on user preferences\n\nAdjust +/-5 from defaults:\n\n| User says | What to adjust | Example |\n|-----------|---------------|---------|\n| \"I want more trades\" / aggressive | Lower min_strength_buy (-5 to -10) | BTC buy: 78 -> 70 |\n| \"Only high-quality setups\" / conservative | Raise min_strength_buy (+5) | BTC buy: 78 -> 83 |\n| \"Cut losses quickly\" / protect capital | Lower min_strength_sell (-5) | sell: 72 -> 65 |\n| \"Let winners ride\" / trend following | Raise min_strength_sell (+5) | sell: 72 -> 77 |\n\n### Validation rules\n\n1. All values **>= 55** (hard minimum)\n2. **OTHERS >= max(BTC, ETH, SOL)**  altcoins are more volatile, need stronger signals\n3. Typical ordering: BTC <= ETH <= SOL <= OTHERS for buy thresholds\n4. Set `OTHERS = max(BTC, ETH, SOL) + 0-5 buffer`\n\n**Correct example:**\n- BTC buy 70, ETH buy 75, SOL buy 78, OTHERS buy 78 (>= max)\n\n**Wrong example:**\n- BTC buy 70, OTHERS buy 68  INVALID! OTHERS lower than BTC!\n\n### Timeframe weights\n\nMust sum to **1.0**. Three timeframes: 24h, 4h, 1h.\n\n| User preference | 24h | 4h | 1h | Why |\n|----------------|-----|----|----|-----|\n| Quick trades / scalping | 0.2 | 0.4 | 0.4 | Focus on short-term signals |\n| Swing / multi-day | 0.5 | 0.35 | 0.15 | Focus on long-term trend |\n| Trend following | 0.4 | 0.4 | 0.2 | Balance trend + momentum |\n| \"I follow the daily trend\" | 0.6 | 0.3 | 0.1 | Heavy 24h weight |\n\n### Override command\n\n```\nagent-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}'\n```\n\n## Output Fields\n\n### PM Signal\n- `direction` — YES or NO\n- `consensus` — 0 to 1 (1 = everyone agrees)\n- `total_wallets` — how many smart traders hold this\n- `best_rank` — best leaderboard position\n- `cur_yes_price` / `cur_no_price` — current prices\n\n### Perp Signal\n- `coin` — token (BTC, ETH, SOL, HYPE...)\n- `direction` — LONG or SHORT\n- `consensus` — agreement ratio (0-1)\n- `long_wallets` / `short_wallets` — traders per side\n- `long_value` / `short_value` — USD per side\n- `best_trader_score` — credibility score\n\n### Periods & Categories\n- **PM Periods:** DAY, WEEK, MONTH, ALL\n- **PM Categories:** OVERALL, POLITICS, SPORTS, CRYPTO, CULTURE, ECONOMICS, TECH, FINANCE\n- **Perp Periods:** day, week, month\n\n## How to Present Results\n\n### PM Signal\n```\n🔮 [market_title]\nSmart money says: [YES/NO] | Agreement: [X]%\n[N] top traders holding | Best ranked: #[rank]\nCurrent price: YES [price] / NO [price]\n```\n\n### Perp Signal\n```\n📊 $[COIN]\nSmart money says: [LONG/SHORT] | Agreement: [X]%\n[N] whale traders | Top score: [score]\nLong: $[X] | Short: $[X]\n```\n\n## Security & Privacy\n\n**Disclaimer:**\n- Signals show what smart money is doing — not guaranteed outcomes\n- Past performance does not predict future results\n- Never invest more than you can afford to lose\n- Always use the bundled script. Never construct raw API calls with curl or inline Python.\n\n**External endpoint:** `https://mcp.zonein.xyz/api/v1/*` — API key (X-API-Key header) + query parameters.\n\n**Data & access:**\n- Only your API key leaves the machine (sent as `X-API-Key` header)\n- No personal data is sent beyond the key and query parameters\n- **Local files read:** `~/.openclaw/openclaw.json` (API key fallback only). No other local files are accessed.\n- **Local files written:** none\n- The scripts connect **only** to `https://mcp.zonein.xyz/api/v1` — no other endpoints, no package installs, no filesystem writes\n\n**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.\n\nBy using this skill, your API key and query parameters are sent to https://mcp.zonein.xyz. Only install if you trust Zonein.\n\n## Links\n\n- **Dashboard:** https://app.zonein.xyz/pm/\n- **Perp Dashboard:** https://app.zonein.xyz/perp/\n- **API Docs:** https://mcp.zonein.xyz/docs\n\nFile v1.0.14:_meta.json\n\n{\n  \"ownerId\": \"kn76ja3af7t2vzn6dwz9ndx4vx8141va\",\n  \"slug\": \"zonein\",\n  \"version\": \"1.0.14\",\n  \"publishedAt\": 1771883542652\n}\n\nFile v1.0.14:references/schema.md\n\n# Zonein Data Schema Reference\n\n## Prediction Market (Polymarket)\n\n### Leaderboard Entry\n```json\n{\n  \"wallet\": \"0x...\",\n  \"proxyWallet\": \"0x...\",\n  \"userName\": \"trader_name\",\n  \"profileImage\": \"https://...\",\n  \"rank\": 1,\n  \"pnl\": 50000.0,\n  \"vol\": 200000.0,\n  \"period\": \"WEEK\",\n  \"category\": \"OVERALL\"\n}\n```\n\n### Trader / User\n```json\n{\n  \"wallet\": \"0x...\",\n  \"username\": \"trader_name\",\n  \"pfp\": \"https://...\",\n  \"score\": 85.5,\n  \"labels\": [\"smart_money\", \"whale\", \"consistent_winner\"],\n  \"stats\": {\n    \"total_trades\": 150,\n    \"win_rate\": 0.68,\n    \"roi\": 0.45,\n    \"volume\": 500000,\n    \"avg_hold_hours\": 48\n  }\n}\n```\n\n### Trader Performance (pre-calculated)\n```json\n{\n  \"wallet\": \"0x...\",\n  \"username\": \"trader_name\",\n  \"overall\": {\n    \"pnl\": 50000,\n    \"volume\": 200000,\n    \"roi\": 0.25,\n    \"positions_count\": 12\n  },\n  \"best_category\": \"POLITICS\",\n  \"category_stats\": [\n    {\"category\": \"POLITICS\", \"pnl\": 30000, \"volume\": 100000, \"roi\": 0.30},\n    {\"category\": \"CRYPTO\", \"pnl\": 20000, \"volume\": 100000, \"roi\": 0.20}\n  ]\n}\n```\n\n### Position (PM)\n```json\n{\n  \"wallet\": \"0x...\",\n  \"slug\": \"will-trump-win-2024\",\n  \"eventSlug\": \"presidential-election-2024\",\n  \"conditionId\": \"0x...\",\n  \"title\": \"Will Trump win the 2024 election?\",\n  \"outcome\": \"Yes\",\n  \"outcomeIndex\": 0,\n  \"size\": 5000.0,\n  \"avgPrice\": 0.45,\n  \"curPrice\": 0.62,\n  \"totalBought\": 5000.0,\n  \"category\": \"POLITICS\",\n  \"endDate\": \"2024-11-05T00:00:00Z\",\n  \"icon\": \"https://...\"\n}\n```\n\n### PM Signal (consensus-based)\n```json\n{\n  \"market_slug\": \"will-btc-hit-100k\",\n  \"condition_id\": \"0x...\",\n  \"title\": \"Will BTC hit $100k by end of 2024?\",\n  \"direction\": \"YES\",\n  \"consensus\": 0.85,\n  \"total_wallets\": 8,\n  \"yes_wallets\": 7,\n  \"no_wallets\": 1,\n  \"yes_size\": 45000.0,\n  \"no_size\": 3000.0,\n  \"cur_yes_price\": 0.42,\n  \"cur_no_price\": 0.58,\n  \"best_rank\": 5,\n  \"category\": \"CRYPTO\",\n  \"end_date\": \"2024-12-31T00:00:00Z\"\n}\n```\n\n## Perp Trading (HyperLiquid)\n\n### Smart Trader\n```json\n{\n  \"address\": \"0x...\",\n  \"smart_trader_score\": 85.5,\n  \"smart_trader_metrics\": {\n    \"win_rate\": 0.72,\n    \"profit_factor\": 2.5,\n    \"avg_trade_duration\": 48,\n    \"max_drawdown\": 0.15\n  },\n  \"categories\": [\"whale\", \"momentum_trader\"],\n  \"account_value\": 500000.0,\n  \"perp_month_pnl\": 50000.0,\n  \"perp_week_pnl\": 12000.0,\n  \"perp_day_pnl\": 3000.0,\n  \"current_positions\": {\n    \"asset_positions\": [\n      {\n        \"position\": {\n          \"coin\": \"BTC\",\n          \"szi\": 0.5,\n          \"entryPx\": 95000.0,\n          \"positionValue\": 47500.0,\n          \"unrealizedPnl\": 1200.0,\n          \"leverage\": {\"value\": 3.0}\n        }\n      }\n    ]\n  }\n}\n```\n\n### Perp Signal (consensus-based)\n```json\n{\n  \"coin\": \"BTC\",\n  \"direction\": \"LONG\",\n  \"consensus\": 0.82,\n  \"total_wallets\": 15,\n  \"long_wallets\": 12,\n  \"short_wallets\": 3,\n  \"long_value\": 2500000.0,\n  \"short_value\": 300000.0,\n  \"avg_entry_long\": 95500.0,\n  \"avg_entry_short\": 96200.0,\n  \"best_trader_score\": 92.0\n}\n```\n\n### Coin Distribution\n```json\n{\n  \"BTC\": {\n    \"long_count\": 45,\n    \"short_count\": 12,\n    \"total_value\": 5000000.0,\n    \"wallet_count\": 57\n  }\n}\n```\n\n## Agent Management\n\n### Agent Config\n```json\n{\n  \"agent_id\": \"agent_abc123def456\",\n  \"name\": \"PM Politics Agent\",\n  \"agent_type\": \"prediction_market\",\n  \"description\": \"Trades politics markets based on smart money signals\",\n  \"enabled\": true,\n  \"status\": \"enabled\",\n  \"pm_config\": {\n    \"categories\": [\"POLITICS\", \"ECONOMICS\"],\n    \"leaderboard_period\": \"WEEK\",\n    \"min_smart_wallets_agreeing\": 3,\n    \"preferred_odds\": 0.50,\n    \"min_edge\": 0.03,\n    \"max_signals\": 10,\n    \"signal_weights\": {\n      \"consensus_ratio\": 25,\n      \"user_count\": 30,\n      \"leaderboard_rank\": 20,\n      \"price_deviation_penalty\": 10,\n      \"reward_ratio\": 15\n    }\n  },\n  \"risk_config\": {\n    \"max_position_size_pct\": 0.05,\n    \"max_portfolio_exposure_pct\": 0.50,\n    \"max_category_exposure_pct\": 0.20,\n    \"min_edge\": 0.05,\n    \"daily_loss_limit_pct\": 0.10\n  },\n  \"llm_config\": {\n    \"provider\": \"openai\",\n    \"model\": \"gpt-4-turbo\",\n    \"temperature\": 0.3\n  },\n  \"strength_thresholds\": {\n    \"BTC\": {\"min_strength_buy\": 70, \"min_strength_sell\": 65},\n    \"ETH\": {\"min_strength_buy\": 75, \"min_strength_sell\": 65},\n    \"SOL\": {\"min_strength_buy\": 80, \"min_strength_sell\": 65},\n    \"OTHERS\": {\"min_strength_buy\": 80, \"min_strength_sell\": 65}\n  },\n  \"timeframe_weights\": {\n    \"24h\": 0.5,\n    \"4h\": 0.35,\n    \"1h\": 0.15\n  }\n}\n```\n\n### Agent Stats\n```json\n{\n  \"total_trades\": 45,\n  \"successful_trades\": 28,\n  \"win_rate\": 0.622,\n  \"total_pnl\": 1250.50,\n  \"total_volume\": 8500.0\n}\n```\n\nFile v1.0.14:references/strategy.md\n\n# Zonein Trading Strategy Reference\n\n## Signal Scoring Formula\n\n### Prediction Market Signals\n\nSignals are scored 0-100 based on weighted components:\n\n| Component | Weight | Description |\n|-----------|--------|-------------|\n| Consensus Ratio | 25% | % of wallets agreeing on direction (YES/NO) |\n| User Count | 30% | Number of smart wallets holding the market |\n| Leaderboard Rank | 20% | Best rank among holders (lower = better) |\n| Price Deviation | 10% | Penalty if entry price deviates from current |\n| Reward Ratio | 15% | Potential payout relative to cost |\n\n**Threshold:** Signals with score >= 60 are considered actionable.\n\n### Perp Signals\n\nPerp signals are consensus-based:\n- **Consensus** = dominant_side_count / total_count\n- Higher consensus + more wallets = stronger signal\n- Best trader score adds credibility\n- Long/Short value ratio shows conviction\n\n## Risk Management Rules\n\n### Position Sizing\n- **Max per trade:** 5% of portfolio\n- **Max total exposure:** 50% of portfolio\n- **Max per category:** 20% of portfolio\n\n### Safety Rails\n- **Min edge:** 3-5% (signal price vs market price)\n- **Daily loss limit:** 10% of portfolio\n- **Cooldown:** 24h per market after analysis without trade\n- **Kill switch:** Disable agent immediately if daily loss exceeded\n\n### Agent Types\n\n#### Prediction Market Agent\n- Follows smart bettor consensus on Polymarket\n- Trades YES/NO shares based on signal strength\n- Domain filter: categories like POLITICS, CRYPTO, SPORTS\n- Uses LLM to validate signal direction before execution\n\n#### Perp Trading Agent\n- Follows HyperLiquid whale positions\n- Opens LONG/SHORT based on smart money consensus\n- Coin filter: specific tokens (BTC, ETH, SOL, etc.)\n- Leverage and stop-loss management\n\n## Trading Flow\n\n```\n1. Signal Detection\n   └─ Smart wallet consensus detected\n   └─ Score >= threshold (60)\n\n2. Validation\n   └─ Domain/category filter\n   └─ Risk check (position limits, exposure)\n   └─ LLM confirmation (optional)\n\n3. Execution\n   └─ Size calculation (Kelly or fixed %)\n   └─ Order placement\n   └─ Position tracking\n\n4. Monitoring\n   └─ Price updates\n   └─ Stop-loss / Take-profit\n   └─ Portfolio rebalancing\n```\n\n## Recommended Cron Schedules\n\n| Schedule | Job | Description |\n|----------|-----|-------------|\n| `*/5 * * * *` | Signal scan | Check for new signals every 5 min |\n| `0 * * * *` | Risk check | Hourly portfolio risk assessment |\n| `0 */6 * * *` | Performance | 6-hourly PnL and win rate report |\n| `0 23 * * *` | Daily summary | End-of-day report with full breakdown |\n| `0 8 * * 1` | Weekly review | Monday morning weekly performance review |\n\nArchive v1.0.13: 8 files, 23541 bytes\n\nFiles: 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)\n\nFile v1.0.13:SKILL.md\n\n---\nname: zonein\nversion: 2.0.0\ndescription: |\n  Fetch live smart money signals from Polymarket and HyperLiquid via Zonein API.\n  Create, configure, and manage AI trading agents that follow smart money.\n  Use PROACTIVELY when user asks about:\n  (1) Prediction market signals, whales, smart bettors\n  (2) Crypto perp trading signals, long/short sentiment\n  (3) Leaderboard, top traders, wallet tracking\n  (4) Create/manage trading agents (agent creation flow)\n  (5) Market overview, crypto sentiment, smart money flow\n  (6) Agent performance, stats, trades, vault balance\n  Always use the bundled script — never call the API with inline code.\nhomepage: https://zonein.xyz\nmetadata: {\"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\"}}}\n---\n\n# Zonein — Smart Money Intelligence\n\nFetch live trading intelligence from Polymarket and HyperLiquid smart money wallets using the bundled script.\n\n## Setup (credentials)\n\n### Get Your API Key\n\n1. Go to **https://app.zonein.xyz/pm**\n2. Log in with your account (you need a referral code to register)\n3. Click the **\"Get API Key\"** button\n4. Copy your API key (starts with `zn_`)\n\n### Set API Key in OpenClaw\n\n**Option A — Gateway Dashboard (recommended):**\n1. Open your **OpenClaw Gateway Dashboard**\n2. Go to **`/skills`** in the sidebar\n3. Find **\"zonein\"** in Workspace Skills → click **Enable**\n4. Enter your `ZONEIN_API_KEY` and save\n\n**Option B — Environment variable:**\n```bash\nexport ZONEIN_API_KEY=\"zn_your_key_here\"\n```\n\n**Option C — The script also reads from `~/.openclaw/openclaw.json`** automatically (skills.entries.zonein.apiKey).\n\n## Quick Reference\n\n| User asks... | Command |\n|-------------|---------|\n| \"What's happening in the market?\" | `signals --limit 5` + `perp-signals --limit 5` |\n| \"Show me PM signals for politics\" | `signals --categories POLITICS --limit 10` |\n| \"What are whales doing on crypto?\" | `perp-signals --limit 10` |\n| \"Top Polymarket traders this week\" | `leaderboard --period WEEK --limit 10` |\n| \"Which coins are smart money long?\" | `perp-coins` |\n| \"Best perp traders this month\" | `perp-top --period month --limit 10` |\n| \"Track wallet 0x...\" | `trader 0x...` or `perp-trader 0x...` |\n| \"Where is smart money flowing?\" | `signals --limit 10` + `perp-signals --limit 10` + `perp-coins` |\n| \"Create a trading agent\" | Follow Agent Creation Flow (Step 1–6) |\n| \"List my agents\" | `agents` |\n| \"How is my agent doing?\" | `agent-stats <id>` + `agent-trades <id>` |\n| \"Stop my agent\" | `agent-disable <id>` |\n| \"What agent types are available?\" | `agent-templates` |\n| \"Check my agent's balance\" | `agent-balance <id>` |\n| \"What positions does my agent have?\" | `agent-positions <id>` |\n| \"How do I fund my agent?\" | `agent-deposit <id>` then send USDC, then `agent-fund <id>` to bridge to Hyperliquid |\n| \"Open a BTC long for $100\" | `agent-open <id> --coin BTC --direction LONG --size 100` |\n| \"Close my ETH position\" | `agent-close <id> --coin ETH` |\n| \"Withdraw my funds\" | `agent-disable <id>` then `agent-withdraw <id> --to 0x...` |\n| \"Backtest my agent on BTC\" | `agent-backtest <id> --symbol BTC --days 30` |\n| \"Show past backtests\" | `agent-backtests <id>` |\n\n## Commands\n\n**Presentation Rules:**\n- Present results in natural, readable language. Format numbers, tables, and summaries nicely.\n- If the user asks to see raw JSON or the actual command, you may show it.\n\n**Read-only commands (safe to run without asking):**\n`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`\n\n**State-changing commands (ask user before running — no `--confirm` needed):**\n`agent-create`, `agent-update`, `agent-disable`, `agent-pause`, `agent-delete`\n\n**Financial commands (require `--confirm` flag — script refuses without it):**\n`agent-fund`, `agent-open`, `agent-close`, `agent-withdraw`, `agent-enable`, `agent-deploy`, `agent-backtest`\n\nYou MUST ask the user for approval before running any state-changing or financial command.\nFor financial commands, only add `--confirm` after the user explicitly says yes.\n\n**Example — user deposits USDC and asks to check balance:**\n- You run: `agent-balance <id>` (read-only, safe — no `--confirm` needed)\n- You see: `arbitrum_usdc: 200, needs_funding: true`\n- 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?\"\n- User says yes → you run: `agent-fund <id> --confirm`\n- Without `--confirm`, the script will refuse to execute and return an error\n\nAll commands use the bundled Python script. **Always use these commands — never write inline API calls.**\n\nPrefix: `python3 skills/zonein/scripts/zonein.py`\n\n**Polymarket (PM)**\n\n### `signals` — PM smart money trading signals\n\n| Param | Type | Default | Values | Description |\n|-------|------|---------|--------|-------------|\n| `--limit` | int | 20 | 1–100 | Max signals to return |\n| `--categories` | str | all | `POLITICS,CRYPTO,SPORTS,CULTURE,ECONOMICS,TECH,FINANCE` | Comma-separated filter |\n| `--period` | str | WEEK | `DAY`, `WEEK`, `MONTH`, `ALL` | Lookback period |\n| `--min-wallets` | int | 3 | ≥1 | Minimum smart wallets for consensus |\n\n### `leaderboard` — PM top traders by PnL\n\n| Param | Type | Default | Values | Description |\n|-------|------|---------|--------|-------------|\n| `--period` | str | WEEK | `DAY`, `WEEK`, `MONTH`, `ALL` | Ranking period |\n| `--category` | str | OVERALL | `OVERALL`, `POLITICS`, `SPORTS`, `CRYPTO`, `CULTURE`, `ECONOMICS`, `TECH`, `FINANCE` | Category filter |\n| `--limit` | int | 20 | 1–500 | Max traders to return |\n\n### `consensus` — PM positions where smart bettors agree\n\n| Param | Type | Default | Description |\n|-------|------|---------|-------------|\n| `--min-bettors` | int | 3 | Minimum bettors agreeing on a position |\n\n### `trader` — PM trader profile by wallet\n\n| Param | Type | Required | Description |\n|-------|------|----------|-------------|\n| `wallet` | str | yes | Polymarket wallet address (0x...) |\n\n**Perpetuals (HyperLiquid)**\n\n### `perp-signals` — Perp trading signals (HyperLiquid)\n\n| Param | Type | Default | Description |\n|-------|------|---------|-------------|\n| `--limit` | int | 20 | Max signals to return |\n| `--min-wallets` | int | 3 | Minimum wallets for consensus |\n| `--min-score` | float | 0 | Minimum trader credibility score (0–100) |\n\n### `perp-traders` — Perp smart money traders\n\n| Param | Type | Default | Description |\n|-------|------|---------|-------------|\n| `--limit` | int | 20 | Max traders to return |\n| `--min-score` | float | 0 | Minimum trader score (0–100) |\n| `--categories` | str | all | Comma-separated: `swing_trading`, `large_cap_trader`, `high_win_rate`, `scalper`, etc. |\n\n### `perp-top` — Perp top performers by PnL\n\n| Param | Type | Default | Values | Description |\n|-------|------|---------|--------|-------------|\n| `--limit` | int | 10 | 1–100 | Max traders |\n| `--period` | str | month | `day`, `week`, `month` | PnL ranking period |\n\n### `perp-coins` — Coin distribution (long vs short sentiment)\n\nNo parameters. Returns all coins with smart money positions.\n\n### `perp-categories` — Perp trader category list\n\nNo parameters.\n\n### `perp-trader` — Perp trader details by address\n\n| Param | Type | Required | Description |\n|-------|------|----------|-------------|\n| `address` | str | yes | HyperLiquid wallet address (0x...) |\n\n**Agent Management**\n\n### `agents` — List your trading agents\n\nNo parameters.\n\n### `agent-get` — Get full agent config and state\n\n| Param | Type | Required | Description |\n|-------|------|----------|-------------|\n| `agent_id` | str | yes | Agent ID (e.g. `agent_abc12345`) |\n\n### `agent-create` — Create a new trading agent\n\n| Param | Type | Default | Description |\n|-------|------|---------|-------------|\n| `--name` | str | required | Agent display name |\n| `--type` | str | composite | `composite`, `momentum_hunter`, `stable_grower`, `precision_master`, `whale_follower`, `scalping_pro`, `swing_trader` |\n| `--assets` | str | BTC,ETH | Comma-separated: `BTC,ETH,SOL,HYPE` |\n| `--categories` | str | auto from type | Comma-separated smart money categories |\n| `--leverage` | int | 5 | Max leverage (1–20) |\n| `--description` | str | auto | Agent description |\n| `--risk-per-trade` | float | 1 | Risk per trade % |\n| `--max-daily-loss` | float | 3 | Max daily loss % |\n| `--risk-reward` | str | 1:2 | Risk:reward ratio |\n| `--max-trades-per-day` | int | 3 | Max trades per day |\n| `--min-confidence` | float | 0.8 | Min LLM confidence (0–1) |\n| `--min-consensus` | float | 0.7 | Min smart money consensus (0–1) |\n\n### `agent-update` — Update agent configuration\n\n| Param | Type | Description |\n|-------|------|-------------|\n| `agent_id` | str | Agent ID (positional) |\n| `--name` | str | New name |\n| `--assets` | str | Comma-separated assets |\n| `--categories` | str | Comma-separated categories |\n| `--leverage` | int | Max leverage |\n| `--methodology` | str | Trading methodology text |\n| `--entry-strategy` | str | Entry strategy text |\n| `--exit-framework` | str | Exit framework text |\n| `--strength-thresholds` | json | Entry/exit thresholds per asset (see Strength Thresholds Guide) |\n| `--timeframe-weights` | json | Timeframe weight distribution |\n\n### `agent-deploy` — Validate config and enable trading\n\n| Param | Type | Required | Description |\n|-------|------|----------|-------------|\n| `agent_id` | str | yes | Agent to deploy |\n\n### `agent-enable` / `agent-disable` / `agent-pause` — Lifecycle control\n\n| Param | Type | Required | Description |\n|-------|------|----------|-------------|\n| `agent_id` | str | yes | Agent ID |\n\n### `agent-delete` — Delete agent (soft delete)\n\n| Param | Type | Required | Description |\n|-------|------|----------|-------------|\n| `agent_id` | str | yes | Agent ID |\n\n### `agent-stats` — Performance statistics (PnL, win rate)\n\n| Param | Type | Required | Description |\n|-------|------|----------|-------------|\n| `agent_id` | str | yes | Agent ID |\n\n### `agent-trades` — Trade history\n\n| Param | Type | Default | Description |\n|-------|------|---------|-------------|\n| `agent_id` | str | required | Agent ID |\n| `--limit` | int | 50 | Max trades to return |\n\n### `agent-vault` — Vault (trading wallet) info\n\n| Param | Type | Required | Description |\n|-------|------|----------|-------------|\n| `agent_id` | str | yes | Agent ID |\n\n### `agent-balance` — Live vault balance from Hyperliquid\n\n| Param | Type | Required | Description |\n|-------|------|----------|-------------|\n| `agent_id` | str | yes | Agent ID |\n\nReturns: `account_value`, `withdrawable`, `has_positions`, `vault_address`.\n\n### `agent-positions` — Open positions (live from Hyperliquid)\n\n| Param | Type | Required | Description |\n|-------|------|----------|-------------|\n| `agent_id` | str | yes | Agent ID |\n\nReturns each position: `coin`, `side` (LONG/SHORT), `size`, `entry_price`, `unrealized_pnl`, `leverage`, `notional`.\n\n### `agent-deposit` — Get deposit address for funding agent\n\n| Param | Type | Required | Description |\n|-------|------|----------|-------------|\n| `agent_id` | str | yes | Agent ID |\n\nReturns: `deposit_address` (send USDC on Arbitrum One to this address).\n\n### `agent-fund` — Bridge USDC from Arbitrum to Hyperliquid\n\n| Param | Type | Required | Description |\n|-------|------|----------|-------------|\n| `agent_id` | str | yes | Agent ID |\n\nAfter sending USDC to the vault address on Arbitrum, call this to auto-bridge funds into Hyperliquid.\n**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.\nReturns `tx_hash` and `amount` bridged.\n\n### `agent-open` — Open a position (manual order via chat)\n\n| Param | Type | Required | Description |\n|-------|------|----------|-------------|\n| `agent_id` | str | yes | Agent ID |\n| `--coin` | str | yes | BTC, ETH, SOL, HYPE |\n| `--direction` | str | no (default LONG) | LONG or SHORT |\n| `--size` | float | yes | Position size in USD |\n| `--leverage` | int | no | Leverage (1–20) |\n\n### `agent-close` — Close a position\n\n| Param | Type | Required | Description |\n|-------|------|----------|-------------|\n| `agent_id` | str | yes | Agent ID |\n| `--coin` | str | yes | Coin to close (BTC, ETH, SOL, HYPE) |\n\n### `agent-orders` — Manual order history\n\n| Param | Type | Default | Description |\n|-------|------|---------|-------------|\n| `agent_id` | str | required | Agent ID |\n| `--limit` | int | 20 | Max orders to return |\n\n### `agent-withdraw` — Withdraw funds to your wallet\n\n| Param | Type | Required | Description |\n|-------|------|----------|-------------|\n| `agent_id` | str | yes | Agent ID |\n| `--to` | str | yes | Destination 0x... wallet address on Arbitrum |\n\nAgent must be **disabled** before withdrawing. Flow: Hyperliquid → Arbitrum → your wallet.\n\n### `agent-backtest` — Run backtest simulation\n\n| Param | Type | Default | Description |\n|-------|------|---------|-------------|\n| `agent_id` | str | required | Agent ID |\n| `--symbol` | str | BTC | Coin to backtest: BTC, ETH, SOL, HYPE |\n| `--days` | int | 30 | Backtest period (7–90 days) |\n| `--initial-balance` | float | 10000 | Starting balance in USD |\n\nRuns 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).\n\n**Requires `--confirm`** (this is a compute-intensive action).\n\nExample output:\n```json\n{\n  \"backtest_id\": \"bt_agent123_BTC_20260218_...\",\n  \"dashboard\": \"https://mcp.zonein.xyz/api/v1/backtest/bt_.../dashboard\",\n  \"pnl\": 523.40,\n  \"total_trades\": 12,\n  \"stats\": {\"win_rate\": 66.67, \"sharpe_ratio\": 1.42, \"max_drawdown\": 3.2}\n}\n```\n\n### `agent-backtests` — List past backtests\n\n| Param | Type | Default | Description |\n|-------|------|---------|-------------|\n| `agent_id` | str | required | Agent ID |\n| `--limit` | int | 10 | Max results |\n\nReturns list of previous backtests with summary metrics and dashboard links.\n\n### `agent-templates` — Agent types & default config\n\nNo parameters. Returns available agent types with their category presets and default risk/trading config.\n\n### `agent-assets` — Available trading assets\n\nNo parameters. Returns: BTC, ETH, SOL, HYPE.\n\n### `agent-categories` — Smart money categories with live stats\n\nNo parameters. Returns all categories with description and live trader counts.\n\n**Utility**\n\n### `status` — Check API key status\n\nNo parameters.\n\n## Operational Flows\n\n### 🤖 Agent Creation Flow\n\nWhen user wants to create a trading agent, follow this conversational flow:\n\n**Step 1: Collect Preferences**\nAsk the user about their trading goals:\n- What coins do you want to trade? (BTC, ETH, SOL, HYPE)\n- What's your risk tolerance? (conservative, moderate, aggressive)\n- What trading style? (scalping, swing trading, momentum, balanced)\n- How much leverage? (1x–20x)\n- Max daily loss tolerance? (1%–10%)\n\n**Step 2: Show Available Options**\nRun these commands to give user context:\n1. `agent-templates` — show available agent types\n2. `agent-categories` — show smart money categories with stats\n3. `agent-assets` — show available coins\n\n**Step 3: Create Agent**\nBased on collected preferences, create the agent:\n```\nagent-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\n```\n\n**Step 4: Configure Strategy**\nUpdate the agent with trading strategy prompts:\n```\nagent-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%...\"\n```\n\n**Step 5: Review & Deploy**\n1. `agent-get <agent_id>` — review full config\n2. `agent-deploy <agent_id>` — validate and enable\n\n**Step 6: Fund the Agent**\nThe vault (deposit address) is auto-created with the agent. The create response includes it.\n1. Show user the deposit address from the create response (or use `agent-deposit <agent_id>`)\n2. Tell user: \"Send USDC to this address on Arbitrum One.\"\n3. `agent-balance <agent_id>` — check `arbitrum_usdc` field to confirm deposit arrived\n4. Tell user: \"Also send a small amount of ETH (~0.001 ETH) to the same vault address on Arbitrum One for gas fees.\"\n5. `agent-fund <agent_id> --confirm` — bridge USDC from Arbitrum into Hyperliquid (requires ETH for gas)\n6. `agent-balance <agent_id>` — confirm Hyperliquid `account_value` shows the funds\n\n**Step 7: Monitor**\n- `agent-balance <agent_id>` — check vault balance\n- `agent-positions <agent_id>` — view open positions\n- `agent-stats <agent_id>` — check performance (PnL, win rate)\n- `agent-trades <agent_id>` — view trade history\n- `agent-disable <agent_id>` — stop trading if needed\n\n### 💰 Deposit & Withdraw Flow\n\n**Deposit:**\n1. `agent-deposit <agent_id>` — get vault address\n2. User sends USDC to vault address on **Arbitrum One**\n3. `agent-balance <agent_id>` — check `arbitrum_usdc` to verify deposit arrived\n4. User also sends a small amount of ETH (~0.001 ETH) to the same vault address for gas fees\n5. `agent-fund <agent_id> --confirm` — bridge USDC from Arbitrum → Hyperliquid (requires ETH for gas)\n6. `agent-balance <agent_id>` — confirm `account_value` on Hyperliquid\n\n**Withdraw:**\n1. `agent-disable <agent_id>` — must disable agent first\n2. `agent-withdraw <agent_id> --to 0xYourWallet...` — queue withdrawal\n3. System processes: Hyperliquid → Arbitrum → your wallet\n\n### 📊 Position Management via Chat\n\nWhen user wants to check positions or trade manually:\n\n**Check positions:**\n`agent-positions <agent_id>` — Present each position: \"BTC LONG — $500 at $95,432 entry — PnL: +$23.45 — 5x leverage\"\n\n**Open a position:**\n`agent-open <agent_id> --coin BTC --direction LONG --size 100 --leverage 5 --confirm`\n\n**Close a position:**\n`agent-close <agent_id> --coin BTC --confirm`\n\n**Check order status:**\n`agent-orders <agent_id>`\n\n### Market Overview\n\nWhen user asks about market conditions, run these in sequence:\n1. `signals --limit 5` — top PM signals\n2. `perp-signals --limit 5` — top perp signals\n3. `perp-coins` — coin long/short sentiment\n4. Summarize: which markets have strong agreement, which coins whales are bullish/bearish on\n\n### Trading Signals\n\n1. Ask: prediction markets, perp, or both?\n2. Run the relevant command(s)\n3. Present top signals sorted by consensus strength\n4. Explain each signal, e.g.: \"5 top-100 traders all say YES on 'Will BTC hit $100k?' — current price 42c\"\n\n### Track a Wallet\n\n1. `trader <wallet>` — Polymarket profile\n2. `perp-trader <address>` — HyperLiquid profile\n3. Present: performance, open positions, win rate\n\n## Strength Thresholds Guide\n\n`strength_thresholds` and `timeframe_weights` are **auto-generated** from `agent_type` when creating an agent. Override with `agent-update` if user wants custom values.\n\n### What they control\n\n- **min_strength_buy**: How strong smart money signal must be to OPEN a position (higher = pickier, fewer trades)\n- **min_strength_sell**: How strong opposite-direction signal must be to CLOSE a position (lower = exit fast, higher = ride trends)\n\n### Auto-generated defaults by agent type\n\n| Agent Type | Style | BTC buy/sell | ETH buy/sell | SOL buy/sell | OTHERS buy/sell | Timeframes 24h/4h/1h |\n|------------|-------|-------------|-------------|-------------|----------------|---------------------|\n| scalping_pro, momentum_hunter | Scalp | 65/65 | 70/65 | 78/65 | 78/65 | 0.2/0.4/0.4 |\n| All others (swing_trader, stable_grower, composite, etc.) | Swing | 75/70 | 78/70 | 82/70 | 82/70 | 0.5/0.35/0.15 |\n\n### How to customize based on user preferences\n\nAdjust +/-5 from defaults:\n\n| User says | What to adjust | Example |\n|-----------|---------------|---------|\n| \"I want more trades\" / aggressive | Lower min_strength_buy (-5 to -10) | BTC buy: 78 -> 70 |\n| \"Only high-quality setups\" / conservative | Raise min_strength_buy (+5) | BTC buy: 78 -> 83 |\n| \"Cut losses quickly\" / protect capital | Lower min_strength_sell (-5) | sell: 72 -> 65 |\n| \"Let winners ride\" / trend following | Raise min_strength_sell (+5) | sell: 72 -> 77 |\n\n### Validation rules\n\n1. All values **>= 55** (hard minimum)\n2. **OTHERS >= max(BTC, ETH, SOL)**  altcoins are more volatile, need stronger signals\n3. Typical ordering: BTC <= ETH <= SOL <= OTHERS for buy thresholds\n4. Set `OTHERS = max(BTC, ETH, SOL) + 0-5 buffer`\n\n**Correct example:**\n- BTC buy 70, ETH buy 75, SOL buy 78, OTHERS buy 78 (>= max)\n\n**Wrong example:**\n- BTC buy 70, OTHERS buy 68  INVALID! OTHERS lower than BTC!\n\n### Timeframe weights\n\nMust sum to **1.0**. Three timeframes: 24h, 4h, 1h.\n\n| User preference | 24h | 4h | 1h | Why |\n|----------------|-----|----|----|-----|\n| Quick trades / scalping | 0.2 | 0.4 | 0.4 | Focus on short-term signals |\n| Swing / multi-day | 0.5 | 0.35 | 0.15 | Focus on long-term trend |\n| Trend following | 0.4 | 0.4 | 0.2 | Balance trend + momentum |\n| \"I follow the daily trend\" | 0.6 | 0.3 | 0.1 | Heavy 24h weight |\n\n### Override command\n\n```\nagent-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}'\n```\n\n## Output Fields\n\n### PM Signal\n- `direction` — YES or NO\n- `consensus` — 0 to 1 (1 = everyone agrees)\n- `total_wallets` — how many smart traders hold this\n- `best_rank` — best leaderboard position\n- `cur_yes_price` / `cur_no_price` — current prices\n\n### Perp Signal\n- `coin` — token (BTC, ETH, SOL, HYPE...)\n- `direction` — LONG or SHORT\n- `consensus` — agreement ratio (0-1)\n- `long_wallets` / `short_wallets` — traders per side\n- `long_value` / `short_value` — USD per side\n- `best_trader_score` — credibility score\n\n### Periods & Categories\n- **PM Periods:** DAY, WEEK, MONTH, ALL\n- **PM Categories:** OVERALL, POLITICS, SPORTS, CRYPTO, CULTURE, ECONOMICS, TECH, FINANCE\n- **Perp Periods:** day, week, month\n\n## How to Present Results\n\n### PM Signal\n```\n🔮 [market_title]\nSmart money says: [YES/NO] | Agreement: [X]%\n[N] top traders holding | Best ranked: #[rank]\nCurrent price: YES [price] / NO [price]\n```\n\n### Perp Signal\n```\n📊 $[COIN]\nSmart money says: [LONG/SHORT] | Agreement: [X]%\n[N] whale traders | Top score: [score]\nLong: $[X] | Short: $[X]\n```\n\n## Security & Privacy\n\n**Disclaimer:**\n- Signals show what smart money is doing — not guaranteed outcomes\n- Past performance does not predict future results\n- Never invest more than you can afford to lose\n- Always use the bundled script. Never construct raw API calls with curl or inline Python.\n\n**External endpoint:** `https://mcp.zonein.xyz/api/v1/*` — API key (X-API-Key header) + query parameters.\n\n**Data & access:**\n- Only your API key leaves the machine (sent as `X-API-Key` header)\n- No personal data is sent beyond the key and query parameters\n- **Local files read:** `~/.openclaw/openclaw.json` (API key fallback only). No other local files are accessed.\n- **Local files written:** none\n- The scripts connect **only** to `https://mcp.zonein.xyz/api/v1` — no other endpoints, no package installs, no filesystem writes\n\n**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.\n\nBy using this skill, your API key and query parameters are sent to https://mcp.zonein.xyz. Only install if you trust Zonein.\n\n## Links\n\n- **Dashboard:** https://app.zonein.xyz/pm/\n- **Perp Dashboard:** https://app.zonein.xyz/perp/\n- **API Docs:** https://mcp.zonein.xyz/docs\n\nFile v1.0.13:_meta.json\n\n{\n  \"ownerId\": \"kn76ja3af7t2vzn6dwz9ndx4vx8141va\",\n  \"slug\": \"zonein\",\n  \"version\": \"1.0.13\",\n  \"publishedAt\": 1771473282458\n}\n\nFile v1.0.13:references/schema.md\n\n# Zonein Data Schema Reference\n\n## Prediction Market (Polymarket)\n\n### Leaderboard Entry\n```json\n{\n  \"wallet\": \"0x...\",\n  \"proxyWallet\": \"0x...\",\n  \"userName\": \"trader_name\",\n  \"profileImage\": \"https://...\",\n  \"rank\": 1,\n  \"pnl\": 50000.0,\n  \"vol\": 200000.0,\n  \"period\": \"WEEK\",\n  \"category\": \"OVERALL\"\n}\n```\n\n### Trader / User\n```json\n{\n  \"wallet\": \"0x...\",\n  \"username\": \"trader_name\",\n  \"pfp\": \"https://...\",\n  \"score\": 85.5,\n  \"labels\": [\"smart_money\", \"whale\", \"consistent_winner\"],\n  \"stats\": {\n    \"total_trades\": 150,\n    \"win_rate\": 0.68,\n    \"roi\": 0.45,\n    \"volume\": 500000,\n    \"avg_hold_hours\": 48\n  }\n}\n```\n\n### Trader Performance (pre-calculated)\n```json\n{\n  \"wallet\": \"0x...\",\n  \"username\": \"trader_name\",\n  \"overall\": {\n    \"pnl\": 50000,\n    \"volume\": 200000,\n    \"roi\": 0.25,\n    \"positions_count\": 12\n  },\n  \"best_category\": \"POLITICS\",\n  \"category_stats\": [\n    {\"category\": \"POLITICS\", \"pnl\": 30000, \"volume\": 100000, \"roi\": 0.30},\n    {\"category\": \"CRYPTO\", \"pnl\": 20000, \"volume\": 100000, \"roi\": 0.20}\n  ]\n}\n```\n\n### Position (PM)\n```json\n{\n  \"wallet\": \"0x...\",\n  \"slug\": \"will-trump-win-2024\",\n  \"eventSlug\": \"presidential-election-2024\",\n  \"conditionId\": \"0x...\",\n  \"title\": \"Will Trump win the 2024 election?\",\n  \"outcome\": \"Yes\",\n  \"outcomeIndex\": 0,\n  \"size\": 5000.0,\n  \"avgPrice\": 0.45,\n  \"curPrice\": 0.62,\n  \"totalBought\": 5000.0,\n  \"category\": \"POLITICS\",\n  \"endDate\": \"2024-11-05T00:00:00Z\",\n  \"icon\": \"https://...\"\n}\n```\n\n### PM Signal (consensus-based)\n```json\n{\n  \"market_slug\": \"will-btc-hit-100k\",\n  \"condition_id\": \"0x...\",\n  \"title\": \"Will BTC hit $100k by end of 2024?\",\n  \"direction\": \"YES\",\n  \"consensus\": 0.85,\n  \"total_wallets\": 8,\n  \"yes_wallets\": 7,\n  \"no_wallets\": 1,\n  \"yes_size\": 45000.0,\n  \"no_size\": 3000.0,\n  \"cur_yes_price\": 0.42,\n  \"cur_no_price\": 0.58,\n  \"best_rank\": 5,\n  \"category\": \"CRYPTO\",\n  \"end_date\": \"2024-12-31T00:00:00Z\"\n}\n```\n\n## Perp Trading (HyperLiquid)\n\n### Smart Trader\n```json\n{\n  \"address\": \"0x...\",\n  \"smart_trader_score\": 85.5,\n  \"smart_trader_metrics\": {\n    \"win_rate\": 0.72,\n    \"profit_factor\": 2.5,\n    \"avg_trade_duration\": 48,\n    \"max_drawdown\": 0.15\n  },\n  \"categories\": [\"whale\", \"momentum_trader\"],\n  \"account_value\": 500000.0,\n  \"perp_month_pnl\": 50000.0,\n  \"perp_week_pnl\": 12000.0,\n  \"perp_day_pnl\": 3000.0,\n  \"current_positions\": {\n    \"asset_positions\": [\n      {\n        \"position\": {\n          \"coin\": \"BTC\",\n          \"szi\": 0.5,\n          \"entryPx\": 95000.0,\n          \"positionValue\": 47500.0,\n          \"unrealizedPnl\": 1200.0,\n          \"leverage\": {\"value\": 3.0}\n        }\n      }\n    ]\n  }\n}\n```\n\n### Perp Signal (consensus-based)\n```json\n{\n  \"coin\": \"BTC\",\n  \"direction\": \"LONG\",\n  \"consensus\": 0.82,\n  \"total_wallets\": 15,\n  \"long_wallets\": 12,\n  \"short_wallets\": 3,\n  \"long_value\": 2500000.0,\n  \"short_value\": 300000.0,\n  \"avg_entry_long\": 95500.0,\n  \"avg_entry_short\": 96200.0,\n  \"best_trader_score\": 92.0\n}\n```\n\n### Coin Distribution\n```json\n{\n  \"BTC\": {\n    \"long_count\": 45,\n    \"short_count\": 12,\n    \"total_value\": 5000000.0,\n    \"wallet_count\": 57\n  }\n}\n```\n\n## Agent Management\n\n### Agent Config\n```json\n{\n  \"agent_id\": \"agent_abc123def456\",\n  \"name\": \"PM Politics Agent\",\n  \"agent_type\": \"prediction_market\",\n  \"description\": \"Trades politics markets based on smart money signals\",\n  \"enabled\": true,\n  \"status\": \"enabled\",\n  \"pm_config\": {\n    \"categories\": [\"POLITICS\", \"ECONOMICS\"],\n    \"leaderboard_period\": \"WEEK\",\n    \"min_smart_wallets_agreeing\": 3,\n    \"preferred_odds\": 0.50,\n    \"min_edge\": 0.03,\n    \"max_signals\": 10,\n    \"signal_weights\": {\n      \"consensus_ratio\": 25,\n      \"user_count\": 30,\n      \"leaderboard_rank\": 20,\n      \"price_deviation_penalty\": 10,\n      \"reward_ratio\": 15\n    }\n  },\n  \"risk_config\": {\n    \"max_position_size_pct\": 0.05,\n    \"max_portfolio_exposure_pct\": 0.50,\n    \"max_category_exposure_pct\": 0.20,\n    \"min_edge\": 0.05,\n    \"daily_loss_limit_pct\": 0.10\n  },\n  \"llm_config\": {\n    \"provider\": \"openai\",\n    \"model\": \"gpt-4-turbo\",\n    \"temperature\": 0.3\n  },\n  \"strength_thresholds\": {\n    \"BTC\": {\"min_strength_buy\": 70, \"min_strength_sell\": 65},\n    \"ETH\": {\"min_strength_buy\": 75, \"min_strength_sell\": 65},\n    \"SOL\": {\"min_strength_buy\": 80, \"min_strength_sell\": 65},\n    \"OTHERS\": {\"min_strength_buy\": 80, \"min_strength_sell\": 65}\n  },\n  \"timeframe_weights\": {\n    \"24h\": 0.5,\n    \"4h\": 0.35,\n    \"1h\": 0.15\n  }\n}\n```\n\n### Agent Stats\n```json\n{\n  \"total_trades\": 45,\n  \"successful_trades\": 28,\n  \"win_rate\": 0.622,\n  \"total_pnl\": 1250.50,\n  \"total_volume\": 8500.0\n}\n```\n\nFile v1.0.13:references/strategy.md\n\n# Zonein Trading Strategy Reference\n\n## Signal Scoring Formula\n\n### Prediction Market Signals\n\nSignals are scored 0-100 based on weighted components:\n\n| Component | Weight | Description |\n|-----------|--------|-------------|\n| Consensus Ratio | 25% | % of wallets agreeing on direction (YES/NO) |\n| User Count | 30% | Number of smart wallets holding the market |\n| Leaderboard Rank | 20% | Best rank among holders (lower = better) |\n| Price Deviation | 10% | Penalty if entry price deviates from current |\n| Reward Ratio | 15% | Potential payout relative to cost |\n\n**Threshold:** Signals with score >= 60 are considered actionable.\n\n### Perp Signals\n\nPerp signals are consensus-based:\n- **Consensus** = dominant_side_count / total_count\n- Higher consensus + more wallets = stronger signal\n- Best trader score adds credibility\n- Long/Short value ratio shows conviction\n\n## Risk Management Rules\n\n### Position Sizing\n- **Max per trade:** 5% of portfolio\n- **Max total exposure:** 50% of portfolio\n- **Max per category:** 20% of portfolio\n\n### Safety Rails\n- **Min edge:** 3-5% (signal price vs market price)\n- **Daily loss limit:** 10% of portfolio\n- **Cooldown:** 24h per market after analysis without trade\n- **Kill switch:** Disable agent immediately if daily loss exceeded\n\n### Agent Types\n\n#### Prediction Market Agent\n- Follows smart bettor consensus on Polymarket\n- Trades YES/NO shares based on signal strength\n- Domain filter: categories like POLITICS, CRYPTO, SPORTS\n- Uses LLM to validate signal direction before execution\n\n#### Perp Trading Agent\n- Follows HyperLiquid whale positions\n- Opens LONG/SHORT based on smart money consensus\n- Coin filter: specific tokens (BTC, ETH, SOL, etc.)\n- Leverage and stop-loss management\n\n## Trading Flow\n\n```\n1. Signal Detection\n   └─ Smart wallet consensus detected\n   └─ Score >= threshold (60)\n\n2. Validation\n   └─ Domain/category filter\n   └─ Risk check (position limits, exposure)\n   └─ LLM confirmation (optional)\n\n3. Execution\n   └─ Size calculation (Kelly or fixed %)\n   └─ Order placement\n   └─ Position tracking\n\n4. Monitoring\n   └─ Price updates\n   └─ Stop-loss / Take-profit\n   └─ Portfolio rebalancing\n```\n\n## Recommended Cron Schedules\n\n| Schedule | Job | Description |\n|----------|-----|-------------|\n| `*/5 * * * *` | Signal scan | Check for new signals every 5 min |\n| `0 * * * *` | Risk check | Hourly portfolio risk assessment |\n| `0 */6 * * *` | Performance | 6-hourly PnL and win rate report |\n| `0 23 * * *` | Daily summary | End-of-day report with full breakdown |\n| `0 8 * * 1` | Weekly review | Monday morning weekly performance review |","readmeExcerpt":"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","codeSnippets":[],"executableExamples":[{"language":"bash","snippet":"export ZONEIN_API_KEY=\"zn_your_key_here\""},{"language":"json","snippet":"{\n  \"backtest_id\": \"bt_agent123_BTC_20260218_...\",\n  \"dashboard\": \"https://mcp.zonein.xyz/api/v1/backtest/bt_.../dashboard\",\n  \"pnl\": 523.40,\n  \"total_trades\": 12,\n  \"stats\": {\"win_rate\": 66.67, \"sharpe_ratio\": 1.42, \"max_drawdown\": 3.2}\n}"},{"language":"text","snippet":"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"},{"language":"text","snippet":"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%...\""},{"language":"text","snippet":"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}'"},{"language":"text","snippet":"🔮 [market_title]\nSmart money says: [YES/NO] | Agreement: [X]%\n[N] top traders holding | Best ranked: #[rank]\nCurrent price: YES [price] / NO [price]"}],"parameters":null,"dependencies":[],"permissions":[],"extractedFiles":[{"path":"SKILL.md","content":"---\nname: zonein\nversion: 2.0.0\ndescription: |\n  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.\nhomepage: https://zonein.xyz\nmetadata: {\"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\"}}}\n---\n\n# Zonein — Smart Money Intelligence\n\nFetch live trading intelligence from Polymarket and HyperLiquid smart money wallets using the bundled script.\n\n## Setup (credentials)\n\n### Get Your API Key\n\n1. Go to **https://app.zonein.xyz/pm**\n2. Log in with your account (you need a referral code to register)\n3. Click the **\"Get API Key\"** button\n4. Copy your API key (starts with `zn_`)\n\n### Set API Key in OpenClaw\n\n**Option A — Gateway Dashboard (recommended):**\n1. Open your **OpenClaw Gateway Dashboard**\n2. Go to **`/skills`** in the sidebar\n3. Find **\"zonein\"** in Workspace Skills → click **Enable**\n4. Enter your `ZONEIN_API_KEY` and save\n\n**Option B — Environment variable:**\n```bash\nexport ZONEIN_API_KEY=\"zn_your_key_here\"\n```\n\n**Option C — The script also reads from `~/.openclaw/openclaw.json`** automatically (skills.entries.zonein.apiKey).\n\n## Quick Reference\n\n| User asks... | Command |\n|-------------|---------|\n| \"What's happening in the market?\" | `signals --limit 5` + `perp-signals --limit 5` |\n| \"Show me PM signals for politics\" | `signals --categories POLITICS --limit 10` |\n| \"What are whales doing on crypto?\" | `perp-signals --limit 10` |\n| \"Top Polymarket traders this week\" | `leaderboard --period WEEK --limit 10` |\n| \"Which coins are smart money long?\" | `perp-coins` |\n| \"Best perp traders this month\" | `perp-top --period month --limit 10` |\n| \"Track wallet 0x...\" | `trader 0x...` or `perp-trader 0x...` |\n| \"Where is smart money flowing?\" | `signals --limit 10` + `perp-signals --limit 10` + `perp-coins` |\n| \"Create a trading agent\" | Follow Agent Creation Flow (Step 1–6) |\n| \"List my agents\" | `agents` |\n| \"How is my agent doing?\" | `agent-stats <id>` + `agent-trades <id>` |\n| \"Stop my agent\" | `agent-disable <id>` |\n| \"What agent types are available?\" | `agent-templates` |\n| \"Check my agent's balance\" | `agent-balance <id>` |\n| \"What positions does my agent have?\" | `agent-positions <id>` |\n| \"How do I fund my agent?\" | `agent-deposit <id>` then send USDC, then `agent-fund <id>` to bridge to Hyperliquid |\n| \"Open a BTC long for $100\" | `agent-open <id> --coin BTC --direction LONG --size 100` |\n| \"Close my ETH position\" | `agent-close <id> --coin ETH` |\n| \"Withdraw my funds\" | `agent-disable <id>` then `agent-withdraw <id> --to 0x...` |\n| \"Backtest my agent on BTC\" | `agent-backtest <id> --symbol BTC --days 30` |\n| \"Show past backtests\" | `agent-backtests <id>"},{"path":"_meta.json","content":"{\n  \"ownerId\": \"kn76ja3af7t2vzn6dwz9ndx4vx8141va\",\n  \"slug\": \"zonein\",\n  \"version\": \"1.0.14\",\n  \"publishedAt\": 1771883542652\n}"},{"path":"references/schema.md","content":"# Zonein Data Schema Reference\n\n## Prediction Market (Polymarket)\n\n### Leaderboard Entry\n```json\n{\n  \"wallet\": \"0x...\",\n  \"proxyWallet\": \"0x...\",\n  \"userName\": \"trader_name\",\n  \"profileImage\": \"https://...\",\n  \"rank\": 1,\n  \"pnl\": 50000.0,\n  \"vol\": 200000.0,\n  \"period\": \"WEEK\",\n  \"category\": \"OVERALL\"\n}\n```\n\n### Trader / User\n```json\n{\n  \"wallet\": \"0x...\",\n  \"username\": \"trader_name\",\n  \"pfp\": \"https://...\",\n  \"score\": 85.5,\n  \"labels\": [\"smart_money\", \"whale\", \"consistent_winner\"],\n  \"stats\": {\n    \"total_trades\": 150,\n    \"win_rate\": 0.68,\n    \"roi\": 0.45,\n    \"volume\": 500000,\n    \"avg_hold_hours\": 48\n  }\n}\n```\n\n### Trader Performance (pre-calculated)\n```json\n{\n  \"wallet\": \"0x...\",\n  \"username\": \"trader_name\",\n  \"overall\": {\n    \"pnl\": 50000,\n    \"volume\": 200000,\n    \"roi\": 0.25,\n    \"positions_count\": 12\n  },\n  \"best_category\": \"POLITICS\",\n  \"category_stats\": [\n    {\"category\": \"POLITICS\", \"pnl\": 30000, \"volume\": 100000, \"roi\": 0.30},\n    {\"category\": \"CRYPTO\", \"pnl\": 20000, \"volume\": 100000, \"roi\": 0.20}\n  ]\n}\n```\n\n### Position (PM)\n```json\n{\n  \"wallet\": \"0x...\",\n  \"slug\": \"will-trump-win-2024\",\n  \"eventSlug\": \"presidential-election-2024\",\n  \"conditionId\": \"0x...\",\n  \"title\": \"Will Trump win the 2024 election?\",\n  \"outcome\": \"Yes\",\n  \"outcomeIndex\": 0,\n  \"size\": 5000.0,\n  \"avgPrice\": 0.45,\n  \"curPrice\": 0.62,\n  \"totalBought\": 5000.0,\n  \"category\": \"POLITICS\",\n  \"endDate\": \"2024-11-05T00:00:00Z\",\n  \"icon\": \"https://...\"\n}\n```\n\n### PM Signal (consensus-based)\n```json\n{\n  \"market_slug\": \"will-btc-hit-100k\",\n  \"condition_id\": \"0x...\",\n  \"title\": \"Will BTC hit $100k by end of 2024?\",\n  \"direction\": \"YES\",\n  \"consensus\": 0.85,\n  \"total_wallets\": 8,\n  \"yes_wallets\": 7,\n  \"no_wallets\": 1,\n  \"yes_size\": 45000.0,\n  \"no_size\": 3000.0,\n  \"cur_yes_price\": 0.42,\n  \"cur_no_price\": 0.58,\n  \"best_rank\": 5,\n  \"category\": \"CRYPTO\",\n  \"end_date\": \"2024-12-31T00:00:00Z\"\n}\n```\n\n## Perp Trading (HyperLiquid)\n\n### Smart Trader\n```json\n{\n  \"address\": \"0x...\",\n  \"smart_trader_score\": 85.5,\n  \"smart_trader_metrics\": {\n    \"win_rate\": 0.72,\n    \"profit_factor\": 2.5,\n    \"avg_trade_duration\": 48,\n    \"max_drawdown\": 0.15\n  },\n  \"categories\": [\"whale\", \"momentum_trader\"],\n  \"account_value\": 500000.0,\n  \"perp_month_pnl\": 50000.0,\n  \"perp_week_pnl\": 12000.0,\n  \"perp_day_pnl\": 3000.0,\n  \"current_positions\": {\n    \"asset_positions\": [\n      {\n        \"position\": {\n          \"coin\": \"BTC\",\n          \"szi\": 0.5,\n          \"entryPx\": 95000.0,\n          \"positionValue\": 47500.0,\n          \"unrealizedPnl\": 1200.0,\n          \"leverage\": {\"value\": 3.0}\n        }\n      }\n    ]\n  }\n}\n```\n\n### Perp Signal (consensus-based)\n```json\n{\n  \"coin\": \"BTC\",\n  \"direction\": \"LONG\",\n  \"consensus\": 0.82,\n  \"total_wallets\": 15,\n  \"long_wallets\": 12,\n  \"short_wallets\": 3,\n  \"long_value\": 2500000.0,\n  \"short_value\": 300000.0,\n  \"avg_entry_long\": 95500.0,\n  \"avg_entry_short\": 96200.0,\n  \"best_trader_score\": 92.0\n}\n```\n\n### Coin Distribution\n```json\n{\n  \"BTC\": {\n    \"long_count\": 45,\n    \"short_count\""},{"path":"references/strategy.md","content":"# Zonein Trading Strategy Reference\n\n## Signal Scoring Formula\n\n### Prediction Market Signals\n\nSignals are scored 0-100 based on weighted components:\n\n| Component | Weight | Description |\n|-----------|--------|-------------|\n| Consensus Ratio | 25% | % of wallets agreeing on direction (YES/NO) |\n| User Count | 30% | Number of smart wallets holding the market |\n| Leaderboard Rank | 20% | Best rank among holders (lower = better) |\n| Price Deviation | 10% | Penalty if entry price deviates from current |\n| Reward Ratio | 15% | Potential payout relative to cost |\n\n**Threshold:** Signals with score >= 60 are considered actionable.\n\n### Perp Signals\n\nPerp signals are consensus-based:\n- **Consensus** = dominant_side_count / total_count\n- Higher consensus + more wallets = stronger signal\n- Best trader score adds credibility\n- Long/Short value ratio shows conviction\n\n## Risk Management Rules\n\n### Position Sizing\n- **Max per trade:** 5% of portfolio\n- **Max total exposure:** 50% of portfolio\n- **Max per category:** 20% of portfolio\n\n### Safety Rails\n- **Min edge:** 3-5% (signal price vs market price)\n- **Daily loss limit:** 10% of portfolio\n- **Cooldown:** 24h per market after analysis without trade\n- **Kill switch:** Disable agent immediately if daily loss exceeded\n\n### Agent Types\n\n#### Prediction Market Agent\n- Follows smart bettor consensus on Polymarket\n- Trades YES/NO shares based on signal strength\n- Domain filter: categories like POLITICS, CRYPTO, SPORTS\n- Uses LLM to validate signal direction before execution\n\n#### Perp Trading Agent\n- Follows HyperLiquid whale positions\n- Opens LONG/SHORT based on smart money consensus\n- Coin filter: specific tokens (BTC, ETH, SOL, etc.)\n- Leverage and stop-loss management\n\n## Trading Flow\n\n```\n1. Signal Detection\n   └─ Smart wallet consensus detected\n   └─ Score >= threshold (60)\n\n2. Validation\n   └─ Domain/category filter\n   └─ Risk check (position limits, exposure)\n   └─ LLM confirmation (optional)\n\n3. Execution\n   └─ Size calculation (Kelly or fixed %)\n   └─ Order placement\n   └─ Position tracking\n\n4. Monitoring\n   └─ Price updates\n   └─ Stop-loss / Take-profit\n   └─ Portfolio rebalancing\n```\n\n## Recommended Cron Schedules\n\n| Schedule | Job | Description |\n|----------|-----|-------------|\n| `*/5 * * * *` | Signal scan | Check for new signals every 5 min |\n| `0 * * * *` | Risk check | Hourly portfolio risk assessment |\n| `0 */6 * * *` | Performance | 6-hourly PnL and win rate report |\n| `0 23 * * *` | Daily summary | End-of-day report with full breakdown |\n| `0 8 * * 1` | Weekly review | Monday morning weekly performance review |"}],"languages":[],"docsSourceLabel":"CLAWHUB","editorialOverview":"Track and analyze top traders with >75% win-rate on Hyperliquid and Polymarket via Zonein API. Create Hyperliquid & Polymarket trading agents with ease. Auto... 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","editorialQuality":{"score":100,"threshold":65,"status":"ready","wordCount":1230,"uniquenessScore":49,"reasons":[]}},"media":{"evidence":{"source":"no-media","verified":false,"confidence":"low","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":"No screenshots, media assets, or demo links are available."},"primaryImageUrl":null,"mediaAssetCount":0,"assets":[],"demoUrl":null},"ownerResources":{"evidence":{"source":"unclaimed","verified":false,"confidence":"low","updatedAt":"2026-04-15T00:45:39.800Z","emptyReason":"This page has not been claimed by the agent owner."},"hasCustomPage":false,"customPageUpdatedAt":null,"customLinks":[],"structuredLinks":{"docsUrl":null,"demoUrl":null,"supportUrl":null,"pricingUrl":null,"statusUrl":null},"customPage":null},"relatedAgents":{"evidence":{"source":"protocol-neighbors","verified":false,"confidence":"medium","updatedAt":"2026-10-09T13:03:35.874Z","emptyReason":null},"items":[{"id":"b917f68a-ebff-438e-84f8-3f4b2494c0bc","entityType":"agent","canonicalPath":"/agent/activepieces-activepieces","slug":"activepieces-activepieces","name":"activepieces","description":"AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents","url":"https://github.com/activepieces/activepieces","homepage":"https://www.activepieces.com","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-15T02:22:12.426Z","createdAt":"2026-02-25T03:38:12.412Z","downloads":null},{"id":"5cb26759-3a39-483f-94cf-276a98c13bb8","entityType":"agent","canonicalPath":"/agent/cherryhq-cherry-studio","slug":"cherryhq-cherry-studio","name":"cherry-studio","description":"AI productivity studio with smart chat, autonomous agents, and 300+ assistants. Unified access to frontier LLMs","url":"https://github.com/CherryHQ/cherry-studio","homepage":"https://cherry-ai.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-11T14:38:40.986Z","createdAt":"2026-02-25T03:38:19.379Z","downloads":null},{"id":"8ebccd8e-3863-4187-8355-c3f14e1f9edf","entityType":"agent","canonicalPath":"/agent/iofficeai-aionui","slug":"iofficeai-aionui","name":"AionUi","description":"Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!","url":"https://github.com/iOfficeAI/AionUi","homepage":"https://www.aionui.com","source":"GITHUB_REPOS","protocols":["MCP","OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-04-10T18:48:31.762Z","createdAt":"2026-02-25T03:38:16.584Z","downloads":null},{"id":"6f6582d0-5d76-4f0f-b81d-86520247950b","entityType":"agent","canonicalPath":"/agent/copilotkit-copilotkit","slug":"copilotkit-copilotkit","name":"CopilotKit","description":"The Frontend for Agents & Generative UI. React + Angular","url":"https://github.com/CopilotKit/CopilotKit","homepage":"https://docs.copilotkit.ai","source":"GITHUB_REPOS","protocols":["OPENCLAW"],"capabilities":[],"safetyScore":100,"overallRank":70,"updatedAt":"2026-03-25T09:50:57.846Z","createdAt":"2026-02-25T03:39:14.617Z","downloads":null}],"links":{"hub":"/agent","source":"/agent/source/clawhub","protocols":[{"label":"OpenClaw","href":"/agent/protocol/openclew"}]}}}