mcp server
HL Portfolio API
Hyperliquid account analysis: positions, PnL, fills, orders, funding. x402 pay-per-call.
Description as published by the maintainer. Source
- version 1.1.0
- active
active — Most recent push to the repository was 2026-07-19.
What this server can do
4 functions, named and described by the server itself. Parameter names are shown because they say more about what a function does than its name usually does.
hyperliquid_get_account_state(address)- 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-position details. Returns: 1. accountValue: total account equity in USD 2. totalNtlPos: total notional position size across all open positions 3. totalMarginUsed: margin currently locked in positions 4. withdrawable: available balance that can be withdrawn 5. positions[]: array of open positions, each with coin, size, entryPrice, unrealizedPnl, leverage, liquidationPrice, marginType (cross/isolated) Example output: { accountValue: "125430.50", totalNtlPos: "89200.00", withdrawable: "36230.50", positions: [{ coin: "BTC", size: "1.5", entryPrice: "67500.00", unrealizedPnl: "2340.00", leverage: 5, liquidationPrice: "54200.00", marginType: "cross" }] } Use this BEFORE analyzing a trader's risk exposure, checking margin health, or evaluating portfolio allocation on Hyperliquid. Essential for copy-trading evaluation and risk monitoring. Do NOT use for trade history -- use hyperliquid_get_trade_fills instead. Do NOT use for open orders -- use hyperliquid_get_open_orders instead. Do NOT use for funding payments -- use hyperliquid_get_user_funding instead. Do NOT use for vault performance -- use hyperliquid_get_vault_details instead. Do NOT use for whale tracking -- use hyperliquid_detect_whale_trades instead. Required: address.
hyperliquid_get_open_orders(address)- 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 (BTC, ETH, SOL, etc.) 2. side: buy (bid) or sell (ask) 3. limitPx: limit price of the order 4. sz: order size 5. orderType: limit, stop-market, stop-limit, take-profit, etc. 6. reduceOnly: whether the order can only reduce an existing position 7. timestamp: when the order was placed 8. oid: unique order ID Example output: { orders: [{ coin: "BTC", side: "buy", limitPx: "65000.00", sz: "0.5", orderType: "limit", reduceOnly: false, oid: 123456 }], count: 3 } Use this to understand a trader's pending strategy, detect limit orders near current price, evaluate order-to-position ratio, or monitor stop-loss placement on Hyperliquid. Do NOT use for executed trades -- use hyperliquid_get_trade_fills instead. Do NOT use for current positions -- use hyperliquid_get_account_state instead. Do NOT use for market-level orderbook -- use hyperliquid_get_market_data instead. Required: address.
hyperliquid_get_trade_fills(limit, address)- 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 positions. Returns: 1. coin: the perpetual market (BTC, ETH, SOL, etc.) 2. side: buy or sell (A = sell/ask, B = buy/bid) 3. size: position size filled 4. price: execution price 5. fee: trading fee paid in USD 6. closedPnl: realized PnL if the trade closed a position (0 if opening) 7. timestamp: execution time in milliseconds 8. hash: transaction hash for the fill 9. crossed: whether the order crossed the spread (taker) Example output: { fills: [{ coin: "ETH", side: "buy", size: "10.0", price: "3450.50", fee: "0.69", closedPnl: "0.00", timestamp: 1712000000000 }], count: 20 } Use this to analyze a trader's recent activity, calculate realized PnL, evaluate trading frequency, or audit trade execution quality on Hyperliquid. Do NOT use for current positions -- use hyperliquid_get_account_state instead. Do NOT use for open/pending orders -- use hyperliquid_get_open_orders instead. Do NOT use for funding payments -- use hyperliquid_get_user_funding instead. Do NOT use for market-wide whale trades -- use hyperliquid_detect_whale_trades instead. Required: address.
hyperliquid_get_user_funding(address, startTime)- 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 evaluating carry trade profitability. Returns: 1. coin: the perpetual market (BTC, ETH, SOL, etc.) 2. fundingRate: the funding rate applied (positive = longs pay shorts) 3. payment: USD amount received (positive) or paid (negative) 4. timestamp: when the funding payment occurred 5. positionSize: the position size at time of funding Example output: { funding: [{ coin: "BTC", fundingRate: "0.0001", payment: "-1.35", timestamp: 1712000000000, positionSize: "1.5" }], totalReceived: "45.20", totalPaid: "-12.30", netFunding: "32.90" } Use this to evaluate funding income for carry/basis trades, calculate total cost of holding positions, or analyze the profitability of a delta-neutral funding strategy on Hyperliquid. Do NOT use for current positions -- use hyperliquid_get_account_state instead. Do NOT use for market-wide funding rates -- use hyperliquid_get_funding_rates instead. Do NOT use for funding arbitrage opportunities -- use funding_arb_find_opportunities instead. Do NOT use for trade execution history -- use hyperliquid_get_trade_fills instead. Required: address.
Last successful function declaration observed on . Source: https://hl-portfolio.api.klymax402.com/mcp. We list what the server declared; we do not call any of these functions.
Endpoint status observed on . Source: https://hl-portfolio.api.klymax402.com/mcp.
Signals
These are separate measurements of different things. They are deliberately not combined into one score, because a popularity number that mixes website traffic with saves and stars cannot be checked or acted on.
| Signal | Value | What it measures | Window | Observed | Source |
|---|---|---|---|---|---|
| GitHub stars | 1 | Number of GitHub accounts that bookmarked this repository since it was created. It is a bookmark count, not installs, not active users and not quality. | cumulative, all time | GitHub | |
| Last commit | 2026-07-19 | Date of the most recent push to any branch. This is the strongest cheap indicator of whether the project is still maintained. | point in time | GitHub | |
| Open issues | 0 | Open issues plus open pull requests, as GitHub counts them together. A high number can mean an active project or an abandoned one. | as of fetch | GitHub | |
| Latest published version | 1.1.0 | Latest version string the maintainer published to the registry. | as of fetch | Model Context Protocol | |
| Registry record last updated | 2026-05-16 | When the registry record was last updated by its maintainer. | point in time | Model Context Protocol | |
| License | MIT | Licence GitHub detected in the repository. Detection can be wrong; the LICENSE file is authoritative. | as of fetch | GitHub | |
| First listed in the MCP Registry | 2026-05-16 | Date this server was first published to the official MCP Registry. Not a usage or quality measure. | point in time | Model Context Protocol | |
| repository status | active | The repository exists on GitHub and is not archived. This says nothing about how recently it was worked on. | as of fetch | GitHub | |
| mcp tools declared | 4 tools | Number of functions the server itself declared when asked to list them. This is what the server offers an agent, not a measure of how well any of them work. | as of probe | hl-portfolio.api.klymax402.com | |
| mcp endpoint status | ok | The server listed 4 functions when asked. | as of probe | hl-portfolio.api.klymax402.com |
Where to get it
Related, by what their authors tagged them
-
DeFi Liquidation Oracle API
— last commit 2026-07-31, shares crypto, defi, portfolio
Real-time DeFi liquidation risk levels by protocol and asset. DeFiLlama-powered. x402.
-
Wallet Portfolio Tracker API
— last commit 2026-07-31, shares crypto, defi, portfolio
Crypto wallet balances, ERC-20 tokens, USD values across Base and Ethereum. x402.
-
AllocContext
— last commit 2026-07-10, shares crypto, portfolio
Self-host MCP: portfolio crypto context for agents. PyPI stdio; MIT.
-
eToro MCP Server
— last commit 2026-04-29, shares crypto, portfolio
Connect AI assistants to eToro for portfolio analysis, market research, and trading.
-
IBKR Portfolio Builder
— last commit 2026-06-08, shares portfolio
Top-down IBKR research: 468 typed screeners tagged by strategy intent, news, account access.
-
Angel One
— last commit 2026-05-22, shares portfolio
Angel One SmartAPI MCP for orders, portfolio, market data, GTT rules, charges, and margin.
-
io.github.ayush-s-tomar/portfolio-mcp-server
— last commit 2026-07-21, shares portfolio
MCP server exposing Ayush Tomar's AI portfolio -- ask what he built or his flagship project.
-
io.github.fnobbe/crashtestyourstrategy
— last commit 2026-08-01, shares portfolio
Portfolio and strategy stress diagnostics with hedge-break detection and regime outlook. Free tier.
-
Cerebrus Pulse MCP
— last commit 2026-04-18, shares crypto, defi, x402
Real-time crypto intelligence: technical analysis, sentiment, and funding rates
-
AlgoVault — Crypto Quant Trade Calls
— last commit 2026-08-06, shares crypto, defi, x402
The Brain Layer for AI Trading Agents — quant calls + cross-venue arb across perp venues via MCP.
These share tags the maintainers applied themselves, such as crypto, defi, portfolio, x402. Common tags like "mcp" or "ai" are ignored for this: agreeing with six hundred other projects is not a similarity.
This is not a recommendation and not a test result. It is a map of what the authors said their work is about.
Also from br0ski777
-
Address Validator API
— last commit 2026-07-19
Parse, validate and normalize postal addresses. Detect country, verify format. x402.
-
AI Text Summarizer API
— last commit 2026-07-19
Summarize text or URLs into key points with compression ratio and reading time. x402 USDC.
-
Airdrop Checker API
— last commit 2026-07-19
Check wallet eligibility for active crypto airdrops — LayerZero, EigenLayer, Scroll. x402.
-
Barcode Generator API
— last commit 2026-07-18
Generate barcodes — EAN-13, UPC-A, Code128, Code39. Returns SVG. x402 micropayment.
-
Base DeFi Yield Optimizer API
— last commit 2026-07-19
Base chain DeFi yields — Aerodrome, Moonwell, APY, TVL, risk scores. x402.
-
Base64 Codec API
— last commit 2026-07-18
Encode/decode base64 and URL-safe base64. x402 micropayment.
-
Cross-Chain Bridge Route API
— last commit 2026-07-19
Best cross-chain bridge routes with fees, time, providers. LI.FI-powered. x402.
-
Code Sandbox API
— last commit 2026-07-31
Execute Python, JavaScript, SQL code in a sandbox. x402 micropayment.
-
Color Palette Generator API
— last commit 2026-07-18
Generate harmonious color palettes — complementary, analogous, triadic. x402 micropayment.
-
Company Enrichment API
— last commit 2026-07-31
Company firmographics from domain: name, socials, tech stack, emails, phone, address
How the author describes it
Topics the maintainer set on GitHub: ai-agents, crypto, defi, mcp, mcp-server, portfolio, x402.
This record as data
Every field on this page, with its source and observation date, is in the catalog JSON. Fetch the whole kind at once instead of parsing this HTML.
GET /api/v1/entries/mcp_server.json