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