OpenClaw

hyperliquid

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

chipagosfinest0 来源安装数☆ 0 仓库 Starsv1.1.0

查看来源 ↗安装与使用 SKILL.md ↗

安装与使用

请根据来源仓库和你的 AI 工具说明安装此技能。先阅读技能文件和依赖要求，再添加到工作流。

SkillHub CLI

skillhub install chipagosfinest/hyperliquid-dex

打开来源仓库，查看说明和兼容环境后，按来源提供的命令或步骤安装。

将来源链接提供给你的 Agent，让它先读取说明、核对依赖，并向你说明将执行的安装步骤。

查看来源 ↗使用指南

技能说明

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": 62...

来源信息

Source: github
Repository: openclaw/skills
Path: skills/chipagosfinest/hyperliquid-dex
Version: 1.1.0
Commit: 16bdfc3a29e11286f80540fdbba195fe63f4f641
分类来源: rules
状态: active
可见性: public

这些信息来自收录时的来源分析，可能滞后；使用前请核对最新来源文件。

来源内容

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)

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

If no wallet address provided, uses `TRADING_WALLET_ADDRESS` env var.

### Response

```json
{
  "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": 62...

搜索