HL Portfolio API
Let your coding agent pull Hyperliquid positions, PnL, fills, orders, and funding from a wallet address without writing exchange API glue.
Overview
HL Portfolio API is an MCP server for the Grow phase that exposes Hyperliquid account analysis—positions, PnL, fills, orders, and funding—via a remote SSE endpoint with x402 pay-per-call billing.
What is this MCP server?
- Remote SSE MCP endpoint at hl-portfolio.api.klymax402.com
- Account-level views: open positions, realized/unrealized PnL, fill history, open orders, funding
- x402 pay-per-call micropayment model (no flat subscription in the server manifest)
- Server schema v2025-12-11, package version 1.1.0
- Open-source reference repo: Br0ski777/hl-portfolio-x402 on GitHub
- MCP server version 1.1.0
- Remote SSE transport (single published endpoint)
- x402 pay-per-call pricing model
Community signal: 1 GitHub stars.
What problem does it solve?
Builders waste time wiring Hyperliquid read APIs and normalizing portfolio data just so an agent can answer simple “what is my exposure?” questions.
Who is it for?
Solo builders building Hyperliquid-aware agents, journaling tools, or performance summaries who only need read-only account analytics.
Skip if: Teams that need guaranteed uptime SLAs, bulk historical backfills, or programmatic trade execution without a separate signing stack.
What do I get? / Deliverables
After registering the remote MCP server, your agent can fetch consolidated Hyperliquid account metrics on demand without you maintaining a custom data client.
- Agent-accessible Hyperliquid position and PnL snapshots
- Fill, order, and funding summaries for a targeted account
- Reduced custom exchange polling code in your project
Recommended MCP Servers
Journey fit
Portfolio and PnL telemetry fits the Grow phase where builders measure trading performance and account health after shipping tooling. Analytics is the canonical shelf for read-only account metrics rather than trade execution or infra monitoring.
How it compares
Remote finance data MCP integration, not an agent skill or a local Hyperliquid SDK.
Common Questions / FAQ
Who is HL Portfolio API for?
Indie developers and traders using Claude Code, Cursor, or similar agents who want Hyperliquid positions, PnL, fills, orders, and funding in chat without building API clients.
When should I use HL Portfolio API?
Use it during Grow analytics work when an agent must explain live portfolio state, reconcile fills, or summarize funding against a known wallet on Hyperliquid.
How do I add HL Portfolio API to my agent?
Add the remote MCP server URL https://hl-portfolio.api.klymax402.com/mcp (type sse) in your client’s MCP config, complete x402 payment setup per the klymax402 docs, then invoke the server tools from your agent.