# Hyperliquid Portfolio — Account State & Trade History

Hyperliquid Portfolio — Account State & Trade History is a Claude Code MCP server that retrieves wallet-level account data and trade history. Use it to inspect positions, orders, and PnL.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · 1178 installs
- Author: axel-belfort
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://smithery.ai/server/axel-belfort/hl-portfolio
- Updated: 2026-04-13
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/hyperliquid-portfolio-account-state-trade-history

## What it does

The server returns a Hyperliquid account snapshot with open positions and PnL, timestamped trade fills, resting orders, funding payments, margin usage, and account value. Its tools fetch account state, fills, open orders, and funding records.

No API key is needed. Calls cost $0.003 each through x402 on Base L2. Market-wide information requires the separate `hyperliquid_get_market_data` tool; this server is for account data.

## Requirements
- Remote server: `https://hl-portfolio--axel-belfort.run.tools`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http hl-portfolio https://hl-portfolio--axel-belfort.run.tools
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add hyperliquid-portfolio-account-state-trade-history --url https://hl-portfolio--axel-belfort.run.tools
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "hyperliquid-portfolio-account-state-trade-history": {
            "url": "https://hl-portfolio--axel-belfort.run.tools"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "hyperliquid-portfolio-account-state-trade-history": {
            "type": "http",
            "url": "https://hl-portfolio--axel-belfort.run.tools"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http hyperliquid-portfolio-account-state-trade-history https://hl-portfolio--axel-belfort.run.tools
```

## When to use it
- retrieve a Hyperliquid account snapshot by wallet address
- review trade fills and realized PnL
- inspect pending account orders
- check funding payments and margin usage

## Example prompts
- Show the Hyperliquid account state for wallet `0x...`.
- Review this account’s recent fills and realized PnL.
- List its open orders and funding payments.

## Similar
- [Hyperliquid Market Data — Orderbooks, Prices, OHLCV](https://affpapa.org/en/nevibecode/mcp/hyperliquid-market-data-orderbooks-prices-ohlcv.md) — MCP server · 6097 installs
- [Hyperliquid Spot — 454 Tokens, Prices, Balances](https://affpapa.org/en/nevibecode/mcp/hyperliquid-spot-454-tokens-prices-balances.md) — MCP server · 3947 installs
- [hyperliquid](https://affpapa.org/en/nevibecode/skills/hyperliquid.md) — skill · 8700 installs
- [grimoire-hyperliquid](https://affpapa.org/en/nevibecode/skills/grimoire-hyperliquid.md) — skill · 1100 installs
- [Vectorial Data Terminal: Hyperliquid, Polymarket & yield for AI agents](https://affpapa.org/en/nevibecode/mcp/vectorial-data-terminal-hyperliquid-polymarket-yield-for-ai-agents.md) — MCP server
- [Hyperliquid Vaults — APR, TVL, Performance Rankings](https://affpapa.org/en/nevibecode/mcp/hyperliquid-vaults-apr-tvl-performance-rankings.md) — MCP server · 2481 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
