Claude MarketplacesSubmit
br0ski777 avatar

HL Portfolio API

br0ski777/hl-portfolio-x402

Connects Claude to Hyperliquid portfolio data for any wallet address via x402 micropayments. You get four endpoints: account state with positions and margin, recent fills with realized PnL, open orders on the book, and funding payment history. Useful when you need to analyze a trader's actual performance before copy trading, monitor leverage and liquidation risk across positions, or calculate net funding income from carry strategies. Calls cost $0.002 to $0.003 each, paid automatically in USDC on Base L2. No API keys required since payment gates access directly through the x402 protocol.

tools
4
transport
SSE
last updated
May 16, 2026
View on GitHub

Tools

4 tools

Public tool metadata for what this MCP can expose to an agent.

hyperliquid_get_account_stateUse this when you need to retrieve the full portfolio state of a Hyperliquid perpetuals account. Returns the complete clearinghouse state for any wallet address including account-level metrics and per1 params

Use this when you need to retrieve the full portfolio state of a Hyperliquid perpetuals account. Returns the complete clearinghouse state for any wallet address including account-level metrics and per

Parameters* required
addressstring
Hyperliquid wallet address (0x...) to retrieve account state for
hyperliquid_get_trade_fillsUse this when you need to retrieve recent trade executions (fills) for a Hyperliquid perpetuals account. Returns the most recent trades with full execution details including realized PnL on closed pos2 params

Use this when you need to retrieve recent trade executions (fills) for a Hyperliquid perpetuals account. Returns the most recent trades with full execution details including realized PnL on closed pos

Parameters* required
addressstring
Hyperliquid wallet address (0x...) to retrieve trade fills for
limitnumber
Maximum number of fills to return (default: 20, max: 100)
hyperliquid_get_open_ordersUse this when you need to see all pending/open orders for a Hyperliquid perpetuals account. Returns every resting order on the book with full order parameters. Returns: 1. coin: the perpetual market1 params

Use this when you need to see all pending/open orders for a Hyperliquid perpetuals account. Returns every resting order on the book with full order parameters. Returns: 1. coin: the perpetual market

Parameters* required
addressstring
Hyperliquid wallet address (0x...) to retrieve open orders for
hyperliquid_get_user_fundingUse this when you need to retrieve funding payment history for a Hyperliquid perpetuals account. Returns all funding rate payments received or paid, useful for calculating funding income/expense and e2 params

Use this when you need to retrieve funding payment history for a Hyperliquid perpetuals account. Returns all funding rate payments received or paid, useful for calculating funding income/expense and e

Parameters* required
addressstring
Hyperliquid wallet address (0x...) to retrieve funding history for
startTimenumber
Unix timestamp in milliseconds to start from (optional, default: last 7 days)

Sponsors

Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthlyAgent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any language

Readme

HL Portfolio API

MCP Server x402 License: MIT

Analyze Hyperliquid accounts: positions, PnL, fills, open orders, funding. Full clearinghouse state for any wallet. The portfolio layer agents need for Hyperliquid trading intelligence. Pay-per-call via x402 (USDC on Base L2) -- no API key, no signup, no rate-limit wall.

Part of the klymax402 marketplace -- 100 x402 micropayment APIs for AI agents, one wallet, USDC on Base.

Quickstart -- MCP

Add to your MCP client config (Claude Desktop, Cursor, ElizaOS, etc.):

{
  "mcpServers": {
    "hl-portfolio": {
      "url": "https://hl-portfolio.api.klymax402.com/mcp"
    }
  }
}

Quickstart -- HTTP (x402)

View the full README on GitHub

Details

Repository
github.com/br0ski777/hl-portfolio-x402
Website
github.com/Br0ski777/hl-portfolio-x402
Transport
SSE
Registry
MCP registry, active

More from br0ski777