hyperliquid

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