# Send Supurr Hyperliquid Algorithmic Trading to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "supurr-hyperliquid", "name": "Supurr Hyperliquid Algorithmic Trading", "source": "tencent", "type": "skill", "category": "AI 智能", "sourceUrl": "https://clawhub.ai/yashagarwal1994/supurr-hyperliquid", "canonicalUrl": "https://clawhub.ai/yashagarwal1994/supurr-hyperliquid", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/supurr-hyperliquid", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=supurr-hyperliquid", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "README.md", "SKILL.md", "tutorials/dca.md", "tutorials/arb.md", "tutorials/grid.md", ".claude-plugin/plugin.json" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-30T16:55:25.780Z", "expiresAt": "2026-05-07T16:55:25.780Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/supurr-hyperliquid" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/supurr-hyperliquid", "downloadUrl": "https://openagent3.xyz/downloads/supurr-hyperliquid", "agentUrl": "https://openagent3.xyz/skills/supurr-hyperliquid/agent", "manifestUrl": "https://openagent3.xyz/skills/supurr-hyperliquid/agent.json", "briefUrl": "https://openagent3.xyz/skills/supurr-hyperliquid/agent.md" } } ``` ## Documentation ### Supurr CLI — Complete Command Reference For LLMs: This is the authoritative reference. Use exact syntax. Config files are in ~/.supurr/configs/. ### Quick Reference CommandPurposesupurr initSetup wallet credentialssupurr whoamiShow current walletsupurr new gridGenerate grid strategy configsupurr new arbGenerate spot-perp arb configsupurr new dcaGenerate DCA strategy configsupurr configsList saved configssupurr config View config detailssupurr backtestRun historical simulationsupurr deployDeploy bot to productionsupurr monitorView active botssupurr historyView historical bot sessionssupurr stopStop a running bot (signed)supurr pricesDebug price datasupurr updateUpdate CLI to latest ### Global Options supurr --help # Show all commands supurr --version, -V # Show CLI version supurr -d, --debug # Enable debug logging (any command) ### 1. supurr init — Credential Setup # Interactive supurr init # Non-interactive supurr init --address 0x... --api-wallet 0x... # Overwrite existing supurr init --force OptionDescription-f, --forceOverwrite existing credentials--address
Wallet address (0x...)--api-wallet API wallet private key ### 2. supurr whoami — Show Identity supurr whoami # Shows: Address + masked key ### 3. supurr new — Config Generator Supports three strategies: grid, arb, dca. supurr new grid [options] # Grid trading supurr new arb [options] # Spot-perp arbitrage supurr new dca [options] # Dollar-cost averaging ### 3a. supurr new grid — Grid Strategy Market Types TypeQuoteRequiresExamplenativeUSDC—--asset BTCspotVariable--quote--asset HYPE --type spot --quote USDChip3Per-DEX--dex--asset BTC --type hip3 --dex hyna Grid Options OptionDefaultDescription-a, --asset BTCBase asset (BTC, ETH, HYPE, etc.)-o, --output config.jsonOutput filename--type nativeMarket type: native, spot, hip3--dex —Required for hip3: hyna, xyz, km, vntl--quote —Required for spot: USDC, USDE, USDT0, USDH--mode longGrid mode: long, short, neutral--levels 20Number of grid levels--start-price —Grid start price--end-price —Grid end price--investment 1000Max investment in quote currency--leverage 2Leverage (1 for spot)--testnetfalseUse Hyperliquid testnet Grid Examples # Native Perp (BTC-USDC) supurr new grid --asset BTC --levels 4 --start-price 88000 --end-price 92000 --investment 100 --leverage 20 # USDC Spot (HYPE/USDC) supurr new grid --asset HYPE --type spot --quote USDC --levels 3 --start-price 29 --end-price 32 --investment 100 # Non-USDC Spot (HYPE/USDH) supurr new grid --asset HYPE --type spot --quote USDH --levels 3 --start-price 29 --end-price 32 --investment 100 # HIP-3 (hyna:BTC) supurr new grid --asset BTC --type hip3 --dex hyna --levels 4 --start-price 88000 --end-price 92000 --investment 100 --leverage 20 HIP-3 DEXes DEXQuoteAssetshynaUSDECrypto perps (BTC, ETH, HYPE, etc.)xyzUSDEStocks (AAPL, TSLA, etc.)kmUSDTKinetiq MarketsvntlUSDEAI/tech tokens ### 3b. supurr new arb — Spot-Perp Arbitrage Strategy Generates a config that simultaneously trades the spot and perp legs of the same asset, capturing spread differentials. Market Constraint: Only assets that have both a spot token AND a perp market on Hyperliquid are eligible. The CLI auto-resolves the spot counterpart. Spot Resolution Logic Hyperliquid spot tokens for major assets use a U-prefix naming convention: You pass --assetCLI resolves spot tokenSpot pairPerp pairBTCUBTCUBTC/USDCBTC perpETHUETHUETH/USDCETH perpSOLUSOLUSOL/USDCSOL perpENAUENAUENA/USDCENA perpWLDUWLDUWLD/USDCWLD perpMONUMONUMON/USDCMON perpMEGAUMEGAUMEGA/USDCMEGA perpZECUZECUZEC/USDCZEC perpXPLUXPLUXPL/USDCXPL perpPUMPUPUMPUPUMP/USDCPUMP perpHYPEHYPE (exact name)HYPE/USDCHYPE perpTRUMPTRUMP (exact name)TRUMP/USDCTRUMP perpPURRPURR (exact name)PURR/USDCPURR perpBERABERA (exact name)BERA/USDCBERA perp Resolution order: try U{ASSET} first → fallback to exact name → fail if neither exists. ⚠️ U-prefix Hazard: Do NOT pass asset names that already start with U (e.g., UNIT). The CLI will prepend another U and look for UUNIT, which doesn't exist. Always use the perp ticker name (e.g., BTC, not UBTC). Arb Options OptionDefaultDescription-a, --asset BTCPerp asset name (BTC, ETH, HYPE, etc.)--amount 100Order amount in USDC per leg--leverage 1Leverage for perp leg--open-spread 0.003Min opening spread (0.003 = 0.3%)--close-spread -0.001Min closing spread (-0.001 = -0.1%)--slippage 0.001Slippage buffer for both legs (0.001 = 0.1%)-o, --output {asset}-arb.jsonOutput filename--testnetfalseUse Hyperliquid testnet Arb Examples # BTC spot-perp arb (default $100/leg) supurr new arb --asset BTC # HYPE arb with $50 per leg, 2x leverage on perp supurr new arb --asset HYPE --amount 50 --leverage 2 # ETH arb with tighter spreads supurr new arb --asset ETH --open-spread 0.002 --close-spread -0.0005 --slippage 0.0005 # SOL arb on testnet supurr new arb --asset SOL --testnet Balance Requirement: Arb bots require USDC balance in both Spot and Perps wallets on Hyperliquid, since the bot trades on both sides simultaneously. ### 3c. supurr new dca — DCA Strategy Generates a Dollar-Cost Averaging config that opens positions in steps when price deviates, then takes profit on the averaged entry. DCA Options OptionDefaultDescription-a, --asset BTCBase asset--mode longDirection: long or short--type nativeMarket type: native, spot, hip3--trigger-price 100000Price to trigger base order--base-order 0.001Base order size in base asset--dca-order 0.001DCA order size in base asset--max-orders 5Max number of DCA orders--size-multiplier 2.0Size multiplier per DCA step--deviation 0.01Price deviation % to trigger first DCA (0.01 = 1%)--deviation-multiplier 1.0Deviation multiplier for subsequent steps--take-profit 0.02Take profit % from avg entry (0.02 = 2%)--stop-loss —Optional stop loss as absolute PnL threshold--leverage 2Leverage (1 for spot)--restartfalseRestart cycle after take profit--cooldown 60Cooldown between cycles in seconds-o, --output config.jsonOutput filename--testnetfalseUse Hyperliquid testnet DCA Examples # BTC DCA long, trigger at $95k supurr new dca --asset BTC --trigger-price 95000 # ETH DCA short with custom deviation supurr new dca --asset ETH --mode short --deviation 0.02 # HYPE DCA with auto-restart supurr new dca --asset HYPE --restart --cooldown 120 --take-profit 0.03 # DCA on spot market supurr new dca --asset HYPE --type spot --quote USDC --trigger-price 25 ### 4. supurr configs — List Saved Configs supurr configs # Lists all configs in ~/.supurr/configs/ Output: 📁 Configs (/Users/you/.supurr/configs): btc-grid.json grid BTC-USDC hype-usdc-spot.json grid HYPE-USDC hyna-btc.json grid BTC-USDE ### 5. supurr config — View Config supurr config btc-grid # View btc-grid.json supurr config btc-grid.json # Same ### Syntax supurr backtest -c [options] ### Options OptionDescription-c, --config Required. Config file (name or path)-s, --start Start date (YYYY-MM-DD)-e, --end End date (YYYY-MM-DD)-p, --prices Use local prices file-o, --output Save results to JSON--no-cacheDisable price caching ### Examples # By config name (looks in ~/.supurr/configs/) supurr backtest -c btc-grid.json -s 2026-01-28 -e 2026-02-01 # By full path supurr backtest -c ~/.supurr/configs/btc-grid.json -s 2026-01-28 -e 2026-02-01 # Save results supurr backtest -c btc-grid.json -s 2026-01-28 -e 2026-02-01 -o results.json ### Archive Data Availability DexAsset FormatExamplehyperliquidBTC, HYPENative perp + Spothynahyna:BTC, hyna:ETHHIP-3 DEX Note: Archive data available from 2026-01-28 onwards. Important: Backtests use Supurr's price archive (tick-level) or a user-provided prices file (-p). Do not use Hyperliquid Info API mids/candles for backtests; they don't provide tick-level historical data and will produce inaccurate results. ### 7. supurr deploy — Deploy Bot supurr deploy -c [-s
| -v
] OptionDescription-c, --config Required. Config file (name or path)-s, --subaccount
Trade from a subaccount (validates master ownership)-v, --vault
Trade from a vault (validates you are the vault leader) Subaccount vs Vault: Subaccount = personal trading account under your master wallet. Verified via subAccounts API (checks master field). Vault = shared investment pool you manage. Verified via vaultDetails API (checks leader field). Both set vault_address in the bot config on success. Cannot use both --subaccount and --vault simultaneously. ### Examples # Deploy from main wallet supurr deploy -c btc-grid.json # Deploy from subaccount supurr deploy -c btc-grid.json -s 0x804e57d7baeca937d4b30d3cbe017f8d73c21f1b # Deploy from vault (you must be the vault leader) supurr deploy -c config.json --vault 0xdc89f67e74098dd93a1476f7da79747f71ccb5d9 # HL: prefix is auto-stripped (copy-paste from Hyperliquid UI) supurr deploy -c config.json -s HL:0x804e57d7baeca937d4b30d3cbe017f8d73c21f1b Output: ✔ Loaded config for grid strategy ✔ Subaccount verified: 0x804e57d7... ✔ Bot deployed successfully! 📦 Deployment Details Bot ID: 217 Pod Name: bot-217 Bot Type: grid Market: BTC-USDC ### Gotchas IssueSolutionHL: prefix in addressAuto-stripped — safe to paste from Hyperliquid explorer"Subaccount not owned"Ensure the subaccount's master matches your supurr whoami address"Vault not found"Check the vault address exists on the correct network (mainnet vs testnet)"Vault leader mismatch"Only the vault leader can deploy — check vaultDetails APIsubAccounts returns nullNormal — means no subaccounts exist for that address ### Syntax supurr monitor [options] ### Options OptionDescription-w, --wallet
Filter by wallet address--watchLive mode (refreshes every 2s) ### Examples supurr monitor # List all active bots supurr monitor --watch # Live monitoring (Ctrl+C to exit) supurr monitor -w 0x1234... # Filter by wallet Output Columns: ID — Bot identifier Type — Strategy (grid, dca, mm, arb) Market — Trading pair (BTC-USDC, HYPE-USDH) Position — Size + direction (L=Long, S=Short) PnL — Total profit/loss ### 9. supurr history — View Bot History supurr history # Show last 20 bot sessions supurr history -n 50 # Show last 50 bot sessions OptionDefaultDescription-n, --limit 20Number of bots to show Output Columns: ID — Bot identifier Market — Trading pair (from config.markets[0]) Type — Strategy (grid, dca, mm, arb) PnL — Total profit/loss (realized + unrealized) Stop Reason — Why the bot stopped (shutdown:graceful → "User stopped the bot Successfully") ### 10. supurr stop — Stop Bot (Signature Auth) Signs Stop with your API wallet private key (EIP-191 personal_sign) and sends the signature to the bot API. supurr stop # Interactive - select from list supurr stop --id 217 # Stop specific bot by ID OptionDescription--id Bot ID to stop (from supurr monitor) Crypto: Uses @noble/curves/secp256k1 + @noble/hashes/sha3 (pure JS, no native deps). Signature format: 0x{r}{s}{v} (65 bytes). ### 11. supurr prices — Debug Price Data supurr prices -a BTC # Fetch BTC prices (7 days) supurr prices -a hyna:BTC --dex hyna # HIP-3 prices supurr prices -a HYPE -s 2026-01-28 # From specific date OptionDescription-a, --asset Required. Asset symbol--dex DEX name (default: hyperliquid)-s, --start Start date-e, --end End date--no-cacheDisable caching ### 12. supurr update — Self-Update supurr update # Check and install latest version ### Workflow 1: Grid — Backtest → Deploy → Monitor # 1. Initialize (first time only) supurr init --address 0x... --api-wallet 0x... # 2. Create config supurr new grid --asset BTC --levels 4 --start-price 88000 --end-price 92000 --investment 100 --leverage 20 --output btc-grid.json # 3. Backtest supurr backtest -c btc-grid.json -s 2026-01-28 -e 2026-02-01 # 4. Deploy supurr deploy -c btc-grid.json # 5. Monitor supurr monitor --watch # 6. Stop when done supurr stop --id ### Workflow 2: Arb — Setup → Deploy → Monitor # 1. Initialize supurr init --address 0x... --api-wallet 0x... # 2. Generate arb config (auto-resolves spot counterpart) supurr new arb --asset BTC --amount 200 --leverage 1 --output btc-arb.json # 3. Review the generated config supurr config btc-arb # 4. Ensure USDC balance in BOTH Spot and Perps wallets on Hyperliquid # 5. Deploy supurr deploy -c btc-arb.json # 6. Monitor supurr monitor --watch ### Workflow 3: DCA — Configure → Deploy # 1. Create DCA config supurr new dca --asset BTC --trigger-price 95000 --base-order 0.001 --max-orders 5 --take-profit 0.02 --output btc-dca.json # 2. Deploy supurr deploy -c btc-dca.json # 3. Monitor supurr monitor --watch ### Workflow 4: Test All Market Types # Native Perp supurr new grid --asset BTC --output native-btc.json supurr backtest -c native-btc.json -s 2026-01-28 -e 2026-02-01 # USDC Spot supurr new grid --asset HYPE --type spot --quote USDC --output hype-usdc.json supurr backtest -c hype-usdc.json -s 2026-01-30 -e 2026-01-31 # Non-USDC Spot supurr new grid --asset HYPE --type spot --quote USDH --output hype-usdh.json supurr backtest -c hype-usdh.json -s 2026-01-30 -e 2026-01-31 # HIP-3 supurr new grid --asset BTC --type hip3 --dex hyna --output hyna-btc.json supurr backtest -c hyna-btc.json -s 2026-01-28 -e 2026-02-01 ### Config Storage ~/.supurr/ ├── credentials.json # { address, private_key } ├── configs/ # Saved bot configs │ ├── btc-grid.json │ ├── hype-usdc.json │ └── ... └── cache/ # Price data cache └── hyperliquid/ ├── BTC/ └── HYPE/ ### API Endpoints Used PurposeEndpointAuthBot DeployPOST /bots/create/—Active BotsGET /dashboard/active_bots—Bot HistoryGET /dashboard/user_bots/
(Python)—Stop BotPOST /bots//stop (Node)EIP-191 signaturePrice DataGET /prices?dex=X&asset=Y&start_time=Z—Price ArchiveGET /{dex}/{asset}/{date}.json— ### Troubleshooting IssueSolution"Config not found"Use supurr configs to list available configs"No credentials"Run supurr init first"0 prices fetched"Check date range (data from 2026-01-28+)"API wallet not valid"Register API wallet on Hyperliquid firstHIP-3 backtest failsUse format --dex hyna --asset BTC"No spot market found"Asset has no spot counterpart — arb not available for this assetArb asset starts with UUse the perp name (e.g., BTC not UBTC) — CLI adds U prefix ### Appendix: Hyperliquid Info API Backtesting note: This appendix is for live metadata and user state lookups. It is not a source of tick-level historical data for supurr backtest. Get address via: supurr whoami — returns the configured wallet address. All endpoints use POST https://api.hyperliquid.xyz/info with Content-Type: application/json. ### Market Data (No Address Required) QueryRequest BodyAll Mid Prices{"type": "allMids"}Sub-DEX Prices{"type": "allMids", "dex": "hyna"}Perp Metadata{"type": "metaAndAssetCtxs"}Spot Metadata{"type": "spotMeta"}L2 Order Book{"type": "l2Book", "coin": "BTC"}List HIP-3 DEXes{"type": "perpDexs"} ### User Data (Address Required) QueryRequest BodyPerp Positions{"type": "clearinghouseState", "user": "0x..."}Spot Balances{"type": "spotClearinghouseState", "user": "0x..."}Open Orders{"type": "openOrders", "user": "0x..."}Order History{"type": "historicalOrders", "user": "0x..."}Trade Fills{"type": "userFills", "user": "0x...", "aggregateByTime": true}Funding History{"type": "userFunding", "user": "0x...", "startTime": , "endTime": }Sub-Accounts{"type": "subAccounts", "user": "0x..."}Vault Details{"type": "vaultDetails", "vaultAddress": "0x..."} ### HIP-3 Sub-DEXes DEXQuoteAssetshynaUSDECrypto perps (BTC, ETH, HYPE)xyzUSDEStocks (AAPL, TSLA, NVDA)vntlUSDEAI/tech tokenskmUSDTKinetiq MarketscashUSDCTech stocks ### TypeScript Helper const HL = "https://api.hyperliquid.xyz/info"; async function query(body: object): Promise { const res = await fetch(HL, { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify(body), }); return res.json(); } // Examples const mids = await query({ type: "allMids" }); const positions = await query({ type: "clearinghouseState", user: "0x..." }); const spotBal = await query({ type: "spotClearinghouseState", user: "0x..." }); const dexes = await query({ type: "perpDexs" }); ### Common Hazards IssueSolutionszDecimals truncationTruncate qty to szDecimals before submitHIP-3 price prefixSub-DEX prices keyed as hyna:BTC, not BTCSub-DEX asset indexUse local index from DEX's universe, not globalFill limitsuserFills max 2000 — paginate with time ranges ### Tutorials Step-by-step deployment guides with parameter selection advice and practical tips: Grid Bot Tutorial — Range trading with buy/sell grids Arb Bot Tutorial — Market-neutral spot-perp arbitrage DCA Bot Tutorial — Dollar-cost averaging with auto-restart ## Trust - Source: tencent - Verification: Indexed source record - Publisher: yashagarwal1994 - Version: 1.0.0 ## Source health - Status: healthy - Source download looks usable. - Yavira can redirect you to the upstream package for this source. - Health scope: source - Reason: direct_download_ok - Checked at: 2026-04-30T16:55:25.780Z - Expires at: 2026-05-07T16:55:25.780Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/supurr-hyperliquid) - [Send to Agent page](https://openagent3.xyz/skills/supurr-hyperliquid/agent) - [JSON manifest](https://openagent3.xyz/skills/supurr-hyperliquid/agent.json) - [Markdown brief](https://openagent3.xyz/skills/supurr-hyperliquid/agent.md) - [Download page](https://openagent3.xyz/downloads/supurr-hyperliquid)