← 返回 Skills 市场

Hyperliquid DEX Integration

Name: Hyperliquid DEX Integration
Author: chipagosfinest

作者 Alec Gutman · GitHub ↗ · v1.1.0

cross-platform ⚠ suspicious

1142

总下载

当前安装

版本数

在 OpenClaw 中安装

/install hyperliquid-dex

功能描述

Query Hyperliquid DEX for account balances, positions, PnL, and margin data via ClawdBot API

使用说明 (SKILL.md)

Hyperliquid DEX Integration

Query your Hyperliquid perpetuals account for real-time balances, open positions, unrealized PnL, and margin data.

ClawdBot Integration

This skill is designed for ClawdBot - it calls ClawdBot's internal API server which proxies requests to the official Hyperliquid API at https://api.hyperliquid.xyz.

Architecture:

User → ClawdBot Gateway → ClawdBot API Server → Hyperliquid Public API
                         (Railway)              (api.hyperliquid.xyz)

The ClawdBot API server handles:

Timeout protection (15s)
Response parsing and formatting
Default wallet address from env vars

Capabilities

Account Overview: Get total account value, free collateral, and margin usage
Position Tracking: View all open perpetual positions with size, direction, entry price
PnL Monitoring: Real-time unrealized PnL and return on equity per position
Risk Management: Liquidation prices and leverage info for each position
Multi-Wallet: Query any wallet address or use configured trading wallet

Environment Variables

Variable	Required	Description
`TRADING_WALLET_ADDRESS`	No	Default wallet address (0x format) to query when none provided

API Endpoint

ClawdBot Internal API:

POST {CLAWDBOT_API_URL}/api/hyperliquid/account

Upstream API (called by ClawdBot):

POST https://api.hyperliquid.xyz/info

Request (Optional Body)

{
  "walletAddress": "0x..."
}

If no wallet address provided, uses TRADING_WALLET_ADDRESS env var.

Response

{
  "timestamp": "2026-02-10T03:30:00.000Z",
  "walletAddress": "0x...",
  "account": {
    "accountValue": 10523.45,
    "totalPositionNotional": 25000.00,
    "freeCollateral": 5200.00,
    "totalMarginUsed": 5323.45
  },
  "positions": [
    {
      "coin": "ETH",
      "direction": "long",
      "size": 2.5,
      "entryPrice": 2450.00,
      "positionValue": 6250.00,
      "unrealizedPnl": 125.50,
      "returnOnEquity": 0.024,
      "leverage": { "type": "cross", "value": 5 },
      "liquidationPrice": 1850.00,
      "marginUsed": 1250.00
    }
  ],
  "positionCount": 1
}

Security Notes

Read-only: This skill only reads account data, no trading/signing capabilities
Public API: Uses Hyperliquid's public info API (no authentication required)
No private keys: Only wallet addresses (public) are used
Timeout protected: 15-second timeout prevents hanging requests

Example Usage

Check Account Balance

"What's my Hyperliquid balance?"
"Show my HL account value"

View Positions

"What positions do I have open on Hyperliquid?"
"Am I in profit on my perps?"
"What's my unrealized PnL?"

Risk Check

"What are my liquidation prices on Hyperliquid?"
"How much margin am I using?"
"What leverage am I running?"

Hyperliquid Docs
ichimoku - Ichimoku Cloud trading signals
wallet-tracker - Monitor wallet balances across chains
crypto-tracker - Track crypto prices and portfolios

安全使用建议

This skill appears to be a read-only adapter that queries Hyperliquid through a ClawdBot proxy — that is reasonable for the described purpose. However: (1) SKILL.md references {CLAWDBOT_API_URL} but the registry does not declare that environment variable; ask the publisher where the ClawdBot API base URL comes from and whether the platform will supply it. (2) Confirm whether the ClawdBot proxy requires authentication or will add headers; if it does, understand what credentials are used and where they are stored. (3) Verify the source/homepage or request source code before installing — the package has no public repo or homepage. (4) Test with a public wallet address first (no private keys) to confirm only public read-only data is transmitted. If the publisher cannot explain the CLAWDBOT_API_URL or provide provenance for the proxy, treat the skill as untrusted.

功能分析

Type: OpenClaw Skill Name: hyperliquid-dex Version: 1.1.0 The skill is designed to query public Hyperliquid DEX data (balances, positions, PnL) via an internal ClawdBot API server, which then proxies to the public Hyperliquid API. The `SKILL.md` explicitly states it's read-only, uses public wallet addresses (not private keys), and makes no direct external network calls or system commands from the agent. There is no evidence of prompt injection attempts, data exfiltration, malicious execution, or obfuscation. The instructions are clear, align with the stated purpose, and do not contain any manipulative directives for the AI agent.

能力评估

ℹ Purpose & Capability

The SKILL.md describes a read-only Hyperliquid query flow via a ClawdBot API proxy which matches the skill name and description. However, the SKILL.md expects an internal service (ClawdBot API) to exist and be callable; the registry metadata does not declare the required CLAWDBOT_API_URL (or any primary credential). This is an implementation gap: calling an internal proxy is plausible for a ClawdBot-targeted skill, but the required base URL must be declared.

⚠ Instruction Scope

Runtime instructions tell the agent to POST to {CLAWDBOT_API_URL}/api/hyperliquid/account and rely optionally on TRADING_WALLET_ADDRESS. The registry did not declare CLAWDBOT_API_URL; SKILL.md lists only TRADING_WALLET_ADDRESS as an env var (optional). The instructions do not ask for private keys and claim read-only access to public Hyperliquid endpoints, but they will transmit wallet addresses (public) to the ClawdBot proxy — the trustworthiness and authentication of that proxy are not described.

✓ Install Mechanism

No install spec and no code files — instruction-only. This minimizes on-disk risk; nothing is downloaded or executed locally by the skill itself.

⚠ Credentials

The skill declares only an optional TRADING_WALLET_ADDRESS but the instructions require a CLAWDBOT_API_URL base endpoint which is not declared. No secrets or private keys are requested (good), but the undeclared dependency on a ClawdBot internal API endpoint is a proportionality/mis-declaration issue and could hide assumptions about authentication or headers that aren't documented.

✓ Persistence & Privilege

The skill is not always-enabled, is user-invocable, and allows model invocation (normal). It requests no persistent presence or elevated system privileges.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install hyperliquid-dex
安装完成后，直接呼叫该 Skill 的名称或使用 /hyperliquid-dex 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.1.0

v1.1.0: Added ClawdBot integration context, declared env vars, clarified upstream API (api.hyperliquid.xyz), added security notes

v1.0.0

Initial release: Query Hyperliquid account balances, positions, PnL, and margin data

元数据

Slug hyperliquid-dex

版本 1.1.0

许可证 —

累计安装 0

当前安装数 0

历史版本数 2

常见问题