HL Portfolio API

io.github.Br0ski777由 GitHub 帳號 Br0ski777 發布v1.1.0更新於 Oct 24, 2026

Hyperliquid account analysis: positions, PnL, fills, orders, funding. x402 pay-per-call.

發布方自己的服務：PortfolioFit

已驗證SSE可網頁執行金融資料與分析

概覽

AI 產生的概覽

透過遠端 MCP 端點唯讀分析 Hyperliquid 永續合約帳戶：持倉、損益、成交、掛單與資金費，按次付費。

可以做什麼
  • 取得錢包的完整清算所狀態：持倉、保證金、損益、槓桿與強制平倉價
  • 列出近期成交明細，含幣種、方向、數量、價格、手續費與已平倉損益
  • 列出未成交掛單，含價格、數量、訂單類型與只減倉標記
  • 查詢已收或已付的資金費，並提供總額與淨額
適用情境
適合需要檢視 Hyperliquid 永續合約帳戶的風險曝險、保證金狀況、跟單評估、資金費成本或掛單情形時使用。它僅做唯讀分析，不執行交易。
執行需求
透過 SSE 連線的遠端 MCP 端點，不需 API 金鑰、註冊或環境變數。每次呼叫透過 x402 協定以 Base L2 上的 USDC 付費，用戶端需具備能回應 402 付款挑戰的 x402 錢包或付款處理能力。
安裝前請注意
每次工具呼叫都會產生費用（約每次 0.005 至 0.008 美元，以 Base 上的 USDC 計），自動化迴圈可能持續花費。付款由支援錢包的用戶端完成，並經第三方結算方（Coinbase CDP、PayAI）處理。所查詢的錢包地址會傳送到該遠端服務。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 HL Portfolio API，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 SSE。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.Br0ski777%2Fhl-portfolio/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

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

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.):

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

Quickstart -- HTTP (x402)

bash
curl -X POST "https://hl-portfolio.api.klymax402.com/api/account" \  -H "Content-Type: application/json" \  -d '{"address":"0x0000000000000000000000000000000000dEaD"}'# -> 402 Payment Required, with an x402 payment challenge in the response body

Any x402-aware client (@x402/fetch, x402-agent-tools, ATXP) handles the 402 -> sign -> retry cycle automatically.

Tools

ToolMethodPathPriceDescription
hyperliquid_get_account_statePOST/api/account$0.008Full clearinghouse state for a Hyperliquid wallet: positions, margin, PnL, leverage, liquidation prices.
hyperliquid_get_trade_fillsPOST/api/fills$0.008Recent trade fills for a Hyperliquid wallet: coin, side, size, price, fee, closedPnl, timestamp.
hyperliquid_get_open_ordersPOST/api/orders$0.005Open orders for a Hyperliquid wallet: coin, side, size, price, order type, reduce-only flag.
hyperliquid_get_user_fundingPOST/api/funding$0.005Funding payments received/paid by a Hyperliquid wallet: coin, amount, rate, timestamp.

hyperliquid_get_account_state

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.

Parameters

NameTypeRequiredDescription
addressstringyesHyperliquid wallet address (0x...) to retrieve account state for

Example response:

json
{ 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" }] }

When to use: analyzing a trader's risk exposure, checking margin health, or evaluating portfolio allocation on Hyperliquid. Essential for copy-trading evaluation and risk monitoring.

Not for: trade history (use hyperliquid_get_trade_fills), open orders (use hyperliquid_get_open_orders), funding payments (use hyperliquid_get_user_funding), vault performance (use hyperliquid_get_vault_details), whale tracking (use hyperliquid_detect_whale_trades).

hyperliquid_get_trade_fills

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.

Parameters

NameTypeRequiredDescription
addressstringyesHyperliquid wallet address (0x...) to retrieve trade fills for
limitnumbernoMaximum number of fills to return (default: 20, max: 100)

Example response:

json
{ fills: [{ coin: "ETH", side: "buy", size: "10.0", price: "3450.50", fee: "0.69", closedPnl: "0.00", timestamp: 1712000000000 }], count: 20 }

Not for: current positions (use hyperliquid_get_account_state), open/pending orders (use hyperliquid_get_open_orders), funding payments (use hyperliquid_get_user_funding).

hyperliquid_get_open_orders

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.

Parameters

NameTypeRequiredDescription
addressstringyesHyperliquid wallet address (0x...) to retrieve open orders for

Example response:

json
{ orders: [{ coin: "BTC", side: "buy", limitPx: "65000.00", sz: "0.5", orderType: "limit", reduceOnly: false, oid: 123456 }], count: 3 }

Not for: executed trades (use hyperliquid_get_trade_fills), current positions (use hyperliquid_get_account_state).

hyperliquid_get_user_funding

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.

Parameters

NameTypeRequiredDescription
addressstringyesHyperliquid wallet address (0x...) to retrieve funding history for
startTimenumbernoUnix timestamp in milliseconds to start from (optional, default: last 7 days)

Example response:

json
{ funding: [{ coin: "BTC", fundingRate: "0.0001", payment: "-1.35", timestamp: 1712000000000, positionSize: "1.5" }], totalReceived: "45.20", totalPaid: "-12.30", netFunding: "32.90" }

Not for: current positions (use hyperliquid_get_account_state), funding arbitrage opportunities (use funding_arb_find_opportunities), trade execution history (use hyperliquid_get_trade_fills).

Example agent prompts

  • "Retrieve the full portfolio state of a Hyperliquid perpetuals account"
  • "Retrieve recent trade executions (fills) for a Hyperliquid perpetuals account"
  • "See all pending/open orders for a Hyperliquid perpetuals account"

Payment

  • Protocol: x402 -- HTTP-native pay-per-call, no signup, no API key
  • Network: Base L2 (eip155:8453)
  • Asset: USDC
  • Facilitator: Coinbase CDP (primary), PayAI (fallback)
  • Also reachable via ATXP (OAuth-wrapped x402, RFC 9728 protected-resource metadata)

Part of klymax402

100 x402 micropayment APIs for AI agents -- one wallet, USDC on Base, zero signup.

License

MIT

來源：README.md，提交 23ba94d

工具

0
SourceWeft 尚未讀取此伺服器的工具。

版本歷史

1
  1. v1.1.0最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式必需10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Portfolio 整合

PortfolioFit

fit.portfolio官方發布者

PortfolioFit 是遠端 MCP 伺服器，讓助理依投資指令核對標準化投資組合，並計算配置限制與統計指標。

Streamable HTTP可網頁執行
金融10 個工具Oct 24, 2026

Cameron Rye Portfolio MCP Server

dev.rye官方發布者

遠端 MCP 端點，提供 Cameron Rye 的部落格、作品集專案、簡介、閱讀清單與網站即時統計，以及聯絡與訂閱工具。

Streamable HTTP可網頁執行
知識與記憶12 個工具Oct 24, 2026

Shlok Bam's portfolio

由 GitHub 帳號 shlokbam 發布

瞭解AI工程師Shlok Bam：專案、經驗、技能、專利。即時、唯讀。AI 翻譯

Streamable HTTP可網頁執行
金融10 個工具Nov 3, 2026

Harshith Nayaka L portfolio docs

由 GitHub 帳號 HarshithNayakaL 發布

唯讀 MCP 伺服器，提供某作品集網站 JSON API、MCP、A2A 與 NLWeb 的開發者文件。

Streamable HTTP可網頁執行
知識與記憶3 個工具Oct 30, 2026

Harshith Nayaka L portfolio

由 GitHub 帳號 HarshithNayakaL 發布

以唯讀方式存取 Harshith Nayaka L 的作品集網站，讓助理查詢其個人簡介、專案、案例研究、常見問題與 agent 技能。

Streamable HTTP可網頁執行
網頁搜尋與抓取6 個工具Oct 30, 2026