Summary
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.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
Tools
Public tool metadata for what this MCP can expose to an agent.
4 tools
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
addressstringHyperliquid 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
limitnumberMaximum number of fills to return (default: 20, max: 100)
addressstringHyperliquid wallet address (0x...) to retrieve trade fills for
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
addressstringHyperliquid 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
addressstringHyperliquid wallet address (0x...) to retrieve funding history for
startTimenumberUnix timestamp in milliseconds to start from (optional, default: last 7 days)
HL Portfolio API
Full Hyperliquid account/portfolio analysis for AI agents. Retrieve positions, PnL, trade fills, open orders, and funding payments for any wallet via x402 micropayments.
Endpoints
| Endpoint | Price | Description |
|---|---|---|
POST /api/account | $0.003 | Full clearinghouse state: positions, margin, PnL, leverage |
POST /api/fills | $0.003 | Recent trade fills with realized PnL and fees |
POST /api/orders | $0.002 | All open/pending orders on the book |
POST /api/funding | $0.002 | Funding payments received and paid |
Example Requests & Responses
Account State
curl -X POST https://hl-portfolio-production.up.railway.app/api/account \
-H "Content-Type: application/json" \
-d '{"address": "0x1234567890abcdef1234567890abcdef12345678"}'
{
"address": "0x1234...",
"accountValue": "125430.50",
"totalNtlPos": "89200.00",
"totalMarginUsed": "52100.00",
"withdrawable": "36230.50",
"positions": [
{
"coin": "BTC",
"size": "1.5",
"entryPrice": "67500.00",
"unrealizedPnl": "2340.00",
"leverage": 5,
"liquidationPrice": "54200.00",
"marginType": "cross"
}
],
"positionCount": 1
}
Trade Fills
curl -X POST https://hl-portfolio-production.up.railway.app/api/fills \
-H "Content-Type: application/json" \
-d '{"address": "0x1234...", "limit": 10}'
{
"address": "0x1234...",
"fills": [
{
"coin": "ETH",
"side": "buy",
"size": "10.0",
"price": "3450.50",
"fee": "0.69",
"closedPnl": "0.00",
"timestamp": 1712000000000
}
],
"count": 10,
"totalFees": "6.90",
"totalClosedPnl": "234.50"
}
Open Orders
curl -X POST https://hl-portfolio-production.up.railway.app/api/orders \
-H "Content-Type: application/json" \
-d '{"address": "0x1234..."}'
{
"address": "0x1234...",
"orders": [
{
"coin": "BTC",
"side": "buy",
"limitPx": "65000.00",
"sz": "0.5",
"orderType": "limit",
"reduceOnly": false
}
],
"count": 1
}
Funding History
curl -X POST https://hl-portfolio-production.up.railway.app/api/funding \
-H "Content-Type: application/json" \
-d '{"address": "0x1234...", "startTime": 1711000000000}'
{
"address": "0x1234...",
"funding": [
{
"coin": "BTC",
"fundingRate": "0.0001",
"payment": "-1.35",
"timestamp": 1712000000000,
"positionSize": "1.5"
}
],
"totalReceived": "45.20",
"totalPaid": "-12.30",
"netFunding": "32.90"
}
Use Cases
- Copy-trading evaluation: Analyze a trader's positions, PnL, and execution quality before copying
- Risk monitoring: Track margin usage, leverage, and liquidation prices across positions
- Funding income tracking: Calculate net funding income for carry/basis trade strategies
- Trade journaling: Pull recent fills with realized PnL for performance analysis
- Portfolio dashboards: Build real-time Hyperliquid portfolio views for clients
MCP Integration
Add to your Claude Desktop or Cursor config:
{
"mcpServers": {
"hl-portfolio": {
"type": "sse",
"url": "https://hl-portfolio-production.up.railway.app/sse"
}
}
}
Payment
All endpoints are gated by x402 protocol. Agents pay automatically in USDC on Base L2 per call. No API key needed.
Related APIs
- hyperliquid-data -- Market data, prices, orderbook for Hyperliquid
- hyperliquid-whales -- Whale trade detection and large position tracking
- hl-vaults -- Vault performance, TVL, and depositor data
- hl-funding -- Market-wide funding rates and arbitrage opportunities
- wallet-portfolio -- Multi-chain EVM wallet portfolio analysis
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →