360 Secure SkillHub
360 安全技能中心

Hyperliquid DEX Integration

核心功能：查询Hyperliquid账户总价值、持仓信息、实时盈亏、清算价格等，支持多钱包，可使用默认配置地址。典型场景：查看账户余额、持仓状态、盈亏情况、风险指标。输入为自然语言指令，可指定钱包地址；输出为结构化JSON数据，含账户概览、仓位明细等。工具为只读，仅用公开API，无需私钥，安全可靠。

chipagosfinest
chipagosfinest
热度 94.98
最近更新 2026-05-11 16:23:40
分类：数据依赖：第三方 API应用场景：财务 / 数据处理 / 个人理财

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add hyperliquid-dex
Metadata
name
hyperliquid
version
1.1.0
description
Query Hyperliquid DEX for account balances, positions, PnL, and margin data via ClawdBot API
author
ClawdBot
category
finance
tags
["defi","trading","perpetuals","hyperliquid","crypto","portfolio","positions","margin-trading","dex","derivatives"]
env
[{"name":"TRADING_WALLET_ADDRESS","description":"Default wallet address to query (0x format)","required":false}]
keywords
["hyperliquid account","perp positions","unrealized pnl","margin usage","liquidation price","cross margin","leverage trading"]
triggers
["hyperliquid","my perp positions","hyperliquid balance","check my HL account","show positions on hyperliquid"]

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?"

Related

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