Zonein: Whale hunting for trading agents on Hyperliquid & Polymarket
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
Rank
62
Safety
84
Downloads
463
Updated
Apr 15, 2026
Version
1.0.14
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 463 downloads reported by the source. Last updated 4/15/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Apr 15, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Apr 15, 2026
- Adoption signal
- 463 downloadsadoption · observed Apr 15, 2026
- Latest release
- 1.0.14release · observed Feb 23, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install kn76ja3af7t2vzn6dwz9ndx4vx8141va:zonein- 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: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-phutt-bwai-zonein/snapshot"
Documentation
CLAWHUB
70,086 characters of source documentation, loaded on request.
Extracted files
4 files captured from the source.
SKILL.md
---
name: zonein
version: 2.0.0
description: |
Track and analyze top traders with >75% win-rate on Hyperliquid and Polymarket via Zonein API. Create Hyperliquid & Polymarket trading agents with ease. Automated trading process with human-in-the-loop.
homepage: https://zonein.xyz
metadata: {"clawdbot":{"emoji":"🧠","requires":{"bins":["python3"],"env":["ZONEIN_API_KEY"]},"primaryEnv":"ZONEIN_API_KEY","files":["scripts/*"],"installer":{"instructions":"1. Go to https://app.zonein.xyz/pm\n2. Log in with your refcode\n3. Click 'Get API Key' button\n4. Copy the key and paste it below"}}}
---
# Zonein — Smart Money Intelligence
Fetch live trading intelligence from Polymarket and HyperLiquid smart money wallets using the bundled script.
## Setup (credentials)
### Get Your API Key
1. Go to **https://app.zonein.xyz/pm**
2. Log in with your account (you need a referral code to register)
3. Click the **"Get API Key"** button
4. Copy your API key (starts with `zn_`)
### Set API Key in OpenClaw
**Option A — Gateway Dashboard (recommended):**
1. Open your **OpenClaw Gateway Dashboard**
2. Go to **`/skills`** in the sidebar
3. Find **"zonein"** in Workspace Skills → click **Enable**
4. Enter your `ZONEIN_API_KEY` and save
**Option B — Environment variable:**
```bash
export ZONEIN_API_KEY="zn_your_key_here"
```
**Option C — The script also reads from `~/.openclaw/openclaw.json`** automatically (skills.entries.zonein.apiKey).
## Quick Reference
| User asks... | Command |
|-------------|---------|
| "What's happening in the market?" | `signals --limit 5` + `perp-signals --limit 5` |
| "Show me PM signals for politics" | `signals --categories POLITICS --limit 10` |
| "What are whales doing on crypto?" | `perp-signals --limit 10` |
| "Top Polymarket traders this week" | `leaderboard --period WEEK --limit 10` |
| "Which coins are smart money long?" | `perp-coins` |
| "Best perp traders this month" | `perp-top --period month --limit 10` |
| "Track wallet 0x..." | `trader 0x...` or `perp-trader 0x...` |
| "Where is smart money flowing?" | `signals --limit 10` + `perp-signals --limit 10` + `perp-coins` |
| "Create a trading agent" | Follow Agent Creation Flow (Step 1–6) |
| "List my agents" | `agents` |
| "How is my agent doing?" | `agent-stats <id>` + `agent-trades <id>` |
| "Stop my agent" | `agent-disable <id>` |
| "What agent types are available?" | `agent-templates` |
| "Check my agent's balance" | `agent-balance <id>` |
| "What positions does my agent have?" | `agent-positions <id>` |
| "How do I fund my agent?" | `agent-deposit <id>` then send USDC, then `agent-fund <id>` to bridge to Hyperliquid |
| "Open a BTC long for $100" | `agent-open <id> --coin BTC --direction LONG --size 100` |
| "Close my ETH position" | `agent-close <id> --coin ETH` |
| "Withdraw my funds" | `agent-disable <id>` then `agent-withdraw <id> --to 0x...` |
| "Backtest my agent on BTC" | `agent-backtest <id> --symbol BTC --days 30` |
| "Show past backtests" | `agent-backtests <id>_meta.json
{
"ownerId": "kn76ja3af7t2vzn6dwz9ndx4vx8141va",
"slug": "zonein",
"version": "1.0.14",
"publishedAt": 1771883542652
}references/schema.md
# Zonein Data Schema Reference
## Prediction Market (Polymarket)
### Leaderboard Entry
```json
{
"wallet": "0x...",
"proxyWallet": "0x...",
"userName": "trader_name",
"profileImage": "https://...",
"rank": 1,
"pnl": 50000.0,
"vol": 200000.0,
"period": "WEEK",
"category": "OVERALL"
}
```
### Trader / User
```json
{
"wallet": "0x...",
"username": "trader_name",
"pfp": "https://...",
"score": 85.5,
"labels": ["smart_money", "whale", "consistent_winner"],
"stats": {
"total_trades": 150,
"win_rate": 0.68,
"roi": 0.45,
"volume": 500000,
"avg_hold_hours": 48
}
}
```
### Trader Performance (pre-calculated)
```json
{
"wallet": "0x...",
"username": "trader_name",
"overall": {
"pnl": 50000,
"volume": 200000,
"roi": 0.25,
"positions_count": 12
},
"best_category": "POLITICS",
"category_stats": [
{"category": "POLITICS", "pnl": 30000, "volume": 100000, "roi": 0.30},
{"category": "CRYPTO", "pnl": 20000, "volume": 100000, "roi": 0.20}
]
}
```
### Position (PM)
```json
{
"wallet": "0x...",
"slug": "will-trump-win-2024",
"eventSlug": "presidential-election-2024",
"conditionId": "0x...",
"title": "Will Trump win the 2024 election?",
"outcome": "Yes",
"outcomeIndex": 0,
"size": 5000.0,
"avgPrice": 0.45,
"curPrice": 0.62,
"totalBought": 5000.0,
"category": "POLITICS",
"endDate": "2024-11-05T00:00:00Z",
"icon": "https://..."
}
```
### PM Signal (consensus-based)
```json
{
"market_slug": "will-btc-hit-100k",
"condition_id": "0x...",
"title": "Will BTC hit $100k by end of 2024?",
"direction": "YES",
"consensus": 0.85,
"total_wallets": 8,
"yes_wallets": 7,
"no_wallets": 1,
"yes_size": 45000.0,
"no_size": 3000.0,
"cur_yes_price": 0.42,
"cur_no_price": 0.58,
"best_rank": 5,
"category": "CRYPTO",
"end_date": "2024-12-31T00:00:00Z"
}
```
## Perp Trading (HyperLiquid)
### Smart Trader
```json
{
"address": "0x...",
"smart_trader_score": 85.5,
"smart_trader_metrics": {
"win_rate": 0.72,
"profit_factor": 2.5,
"avg_trade_duration": 48,
"max_drawdown": 0.15
},
"categories": ["whale", "momentum_trader"],
"account_value": 500000.0,
"perp_month_pnl": 50000.0,
"perp_week_pnl": 12000.0,
"perp_day_pnl": 3000.0,
"current_positions": {
"asset_positions": [
{
"position": {
"coin": "BTC",
"szi": 0.5,
"entryPx": 95000.0,
"positionValue": 47500.0,
"unrealizedPnl": 1200.0,
"leverage": {"value": 3.0}
}
}
]
}
}
```
### Perp Signal (consensus-based)
```json
{
"coin": "BTC",
"direction": "LONG",
"consensus": 0.82,
"total_wallets": 15,
"long_wallets": 12,
"short_wallets": 3,
"long_value": 2500000.0,
"short_value": 300000.0,
"avg_entry_long": 95500.0,
"avg_entry_short": 96200.0,
"best_trader_score": 92.0
}
```
### Coin Distribution
```json
{
"BTC": {
"long_count": 45,
"short_count"references/strategy.md
# Zonein Trading Strategy Reference ## Signal Scoring Formula ### Prediction Market Signals Signals are scored 0-100 based on weighted components: | Component | Weight | Description | |-----------|--------|-------------| | Consensus Ratio | 25% | % of wallets agreeing on direction (YES/NO) | | User Count | 30% | Number of smart wallets holding the market | | Leaderboard Rank | 20% | Best rank among holders (lower = better) | | Price Deviation | 10% | Penalty if entry price deviates from current | | Reward Ratio | 15% | Potential payout relative to cost | **Threshold:** Signals with score >= 60 are considered actionable. ### Perp Signals Perp signals are consensus-based: - **Consensus** = dominant_side_count / total_count - Higher consensus + more wallets = stronger signal - Best trader score adds credibility - Long/Short value ratio shows conviction ## Risk Management Rules ### Position Sizing - **Max per trade:** 5% of portfolio - **Max total exposure:** 50% of portfolio - **Max per category:** 20% of portfolio ### Safety Rails - **Min edge:** 3-5% (signal price vs market price) - **Daily loss limit:** 10% of portfolio - **Cooldown:** 24h per market after analysis without trade - **Kill switch:** Disable agent immediately if daily loss exceeded ### Agent Types #### Prediction Market Agent - Follows smart bettor consensus on Polymarket - Trades YES/NO shares based on signal strength - Domain filter: categories like POLITICS, CRYPTO, SPORTS - Uses LLM to validate signal direction before execution #### Perp Trading Agent - Follows HyperLiquid whale positions - Opens LONG/SHORT based on smart money consensus - Coin filter: specific tokens (BTC, ETH, SOL, etc.) - Leverage and stop-loss management ## Trading Flow ``` 1. Signal Detection └─ Smart wallet consensus detected └─ Score >= threshold (60) 2. Validation └─ Domain/category filter └─ Risk check (position limits, exposure) └─ LLM confirmation (optional) 3. Execution └─ Size calculation (Kelly or fixed %) └─ Order placement └─ Position tracking 4. Monitoring └─ Price updates └─ Stop-loss / Take-profit └─ Portfolio rebalancing ``` ## Recommended Cron Schedules | Schedule | Job | Description | |----------|-----|-------------| | `*/5 * * * *` | Signal scan | Check for new signals every 5 min | | `0 * * * *` | Risk check | Hourly portfolio risk assessment | | `0 */6 * * *` | Performance | 6-hourly PnL and win rate report | | `0 23 * * *` | Daily summary | End-of-day report with full breakdown | | `0 8 * * 1` | Weekly review | Monday morning weekly performance review |
activepieces
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
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
AionUi
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!
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/phutt-bwai/zonein",
"sourceUrl": "https://clawhub.ai/phutt-bwai/zonein",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-04-15T00:45:39.800Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-phutt-bwai-zonein/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-phutt-bwai-zonein/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-04-15T00:45:39.800Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "463 downloads",
"href": "https://clawhub.ai/phutt-bwai/zonein",
"sourceUrl": "https://clawhub.ai/phutt-bwai/zonein",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-04-15T00:45:39.800Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.0.14",
"href": "https://clawhub.ai/phutt-bwai/zonein",
"sourceUrl": "https://clawhub.ai/phutt-bwai/zonein",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-02-23T21:52:22.652Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-phutt-bwai-zonein/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-phutt-bwai-zonein/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.0.14",
"description": "- 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.",
"href": "https://clawhub.ai/phutt-bwai/zonein",
"sourceUrl": "https://clawhub.ai/phutt-bwai/zonein",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-02-23T21:52:22.652Z",
"isPublic": true
}
]
}Record generated Oct 9, 2026.
