Hyperliquid Trading Performance by Wallet

Review a Hyperliquid account's recorded trading performance. Returns account value, open positions and recorded trading-performance totals with available partial/error context. Use one Toolmu account and a shared prepaid balance across available Tools. Pay per use; no separate supplier subscription is required. The current execution ceiling for this Tool is 0.0288 Toolmu credits per call. This is a maximum, not the settled charge. Before execution, get the current Tool contract and check availability, the latest maximumCredits, your balance and budget. Supplier response credits_used, when present, describes supplier API credits and is not the Toolmu customer charge.

Your AI

Use with your AI

For tasks with several steps, continue in the AI you already use.

CodexClaude CodeCursorWindsurfCline

View instructions

Use Toolmu’s wallet-trading-performance-surf to review one Hyperliquid wallet. If the user shares a public wallet page link, extract a clearly shown 0x wallet address or ENS name; a supported ENS name can also be used directly. Do not guess or treat an arbitrary social nickname as a wallet identifier. If no supported identifier is clear, ask for a public wallet page link or public wallet name that identifies the account. Explain the returned account value, open positions, trading-performance totals and any partial/error context. Net PnL is gross PnL minus fees and excludes funding. Preserve partial/error information and do not describe an incomplete result as comprehensive. Before a paid call, check current availability, maximum cost, balance, budget and authorization; do not retry an uncertain call.

Task:
Share a public page link for a Hyperliquid wallet or its public wallet name. I’ll look up its account value, open positions and recorded trading performance.

Paste into your connected AI's conversation.

Connection guide

Up to 0.0288 credits / call

The final charge is based on confirmed usage. Unused reserved credits return to your available balance.

Surf

Hyperliquid Trading Performance by Wallet

You receive

Returns account value, open positions and recorded trading-performance totals with available partial/error context. Performance net PnL is gross PnL minus fees and excludes funding. Preserve partial and errors rather than presenting incomplete results as comprehensive.

Start with your task

Share a public page link for a Hyperliquid wallet or its public wallet name. I’ll look up its account value, open positions and recorded trading performance.

Inputs & outputs

Inspect the current inputs, availability, and maximum charge before starting.

Input schema

Input schema
Field / Path	Type	Requirement	Meaning
queryParams`queryParams`	`object`	Required	Required fields `address`
address`queryParams.address`	`string`	Required	Wallet address: a 0x EVM address or an ENS name (e.g. vitalik.eth). Solana addresses are not supported. Minimum length `1`

View raw JSON

{
  "type": "object",
  "required": [
    "queryParams"
  ],
  "properties": {
    "queryParams": {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "required": [
        "address"
      ],
      "~standard": {
        "vendor": "zod",
        "version": 1,
        "jsonSchema": {}
      },
      "properties": {
        "address": {
          "type": "string",
          "minLength": 1,
          "description": "Wallet address: a 0x EVM address or an ENS name (e.g. vitalik.eth). Solana addresses are not supported."
        }
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}

Result schema

Output fields have not been documented yet.

Additional notes

Review a Hyperliquid account's recorded trading performance

How to use this Tool

Use the deployed input fields below. Required fields must be supplied; optional filters narrow the result.

queryParams.address (Required): Wallet address: a 0x EVM address or an ENS name (e.g. vitalik.eth). Solana addresses are not supported.

What this Tool returns

Returns account value, open positions and recorded trading-performance totals with available partial/error context.

Response fields and how to read them

The table follows the official response contract, including nested fields and useful response metadata. [] denotes an array item. Required means required within its parent object, not that a conditional parent always exists. A nullable type permits null; an optional field can be absent. Use the documented conditions below to distinguish missing, empty and zero values. Units and reporting windows apply only where explicitly documented.

Field, type and presence	Meaning and conditions
data.account_value number; Optional within parent; format: double	Live PERP clearinghouse equity, USD (from the snapshot) — not total portfolio (spot/vault excluded; see /hyperliquid/account.total_value_usd). A genuinely flat/empty perp account returns 0 with NO errors[] entry; the field is OMITTED only when the snapshot section degraded (which also adds an errors[] entry) — so detect degradation via errors[], not a 0 value.
data.address string; Required within parent	Wallet address (lowercased)
data.errors array \| null; Optional within parent	Sections whose fetch failed (gap_fill, snapshot, ledger); omitted when everything succeeded
data.errors.[].reason string; Required within parent	Short reason for the failure
data.errors.[].section string; Required within parent	Section that failed: perp, spot, vaults, staking, or pricing (the HYPE-mark lookup that values total_value_usd)
data.open_positions array \| null; Required within parent	Live open positions from the clearinghouse snapshot (empty when the snapshot section degraded — see errors[])
data.open_positions.[].cum_funding object; Required within parent	Funding paid/received, USD
data.open_positions.[].cum_funding.all_time number; Required within parent; format: double	Funding since the account opened, USD
data.open_positions.[].cum_funding.since_change number; Required within parent; format: double	Funding since this position last changed, USD
data.open_positions.[].cum_funding.since_open number; Required within parent; format: double	Funding since this position was opened, USD
data.open_positions.[].distance_to_liquidation number; Optional within parent; format: double	Fraction the mark must move to reach the liquidation price (e.g. 0.05 = 5%), always positive — a RELATIVE fraction, not an absolute price/USD distance. Omitted when there is no liquidation price.
data.open_positions.[].entry_price number; Required within parent; format: double	Average entry price, USD
data.open_positions.[].leverage_type string; Required within parent	cross or isolated
data.open_positions.[].leverage_value integer; Required within parent; format: int64	Leverage used
data.open_positions.[].liquidation_price number; Optional within parent; format: double	Liquidation price, USD. Omitted when Hyperliquid returns none upstream — common for cross positions whose spot collateral backstops them; fall back to the account-level margin_ratio for proximity.
data.open_positions.[].margin_used number; Required within parent; format: double	Margin on this position, USD
data.open_positions.[].mark_price number; Required within parent; format: double	Current mark price, USD (= position_value / \|size\|)
data.open_positions.[].max_leverage integer; Required within parent; format: int64	Max allowed leverage for this market
data.open_positions.[].position_value number; Required within parent; format: double	Current value, USD
data.open_positions.[].return_on_equity number; Required within parent; format: double	Return on equity (0.45 = 45%)
data.open_positions.[].side string; Required within parent	long or short
data.open_positions.[].size number; Required within parent; format: double	Position size; positive = long, negative = short
data.open_positions.[].symbol string; Required within parent	Market id (BTC, kPEPE, xyz:GOLD)
data.open_positions.[].unrealized_pnl number; Required within parent; format: double	Unrealized profit/loss, USD
data.partial boolean; Required within parent	true when one or more upstream sections degraded (= errors[] is non-empty); the present sections are still returned
data.performance object; Optional within parent	Lifetime performance re-rolled over the warehouse aggregate + the live gap-fill tail; omitted when the wallet has never traded. A lower bound when errors[] contains gap_fill (the live tail was truncated or unavailable).
data.performance.avg_loss number; Optional within parent; format: double	Average net_pnl of losing trades, USD (negative); omitted when there are no losses
data.performance.avg_win number; Optional within parent; format: double	Average net_pnl of winning trades, USD; omitted when there are no wins
data.performance.fees number; Required within parent; format: double	Sum of episode fees, USD
data.performance.first_trade integer; Required within parent; format: int64	Earliest episode close (Unix seconds); 0 when no trades
data.performance.gross_pnl number; Required within parent; format: double	Sum of episode gross_pnl, USD
data.performance.last_trade integer; Required within parent; format: int64	Latest episode close (Unix seconds); 0 when no trades
data.performance.losses integer; Required within parent; format: int64	Episodes with net_pnl < 0
data.performance.net_pnl number; Required within parent; format: double	Sum of episode net_pnl, USD (funding excluded)
data.performance.profit_factor number; Optional within parent; format: double	Total win PnL / total loss PnL; omitted when there are no losses
data.performance.scratches integer; Required within parent; format: int64	Episodes with net_pnl == 0
data.performance.trades integer; Required within parent; format: int64	Closed episodes (trades)
data.performance.volume_usd number; Required within parent; format: double	Notional volume traded, USD
data.performance.win_rate number; Required within parent; format: double	wins / trades (0-1)
data.performance.wins integer; Required within parent; format: int64	Episodes with net_pnl > 0
data.total_unrealized_pnl number; Optional within parent; format: double	Sum of unrealized PnL across the live open positions, USD. Omitted when the snapshot section degraded (see errors[]); 0 for a flat account.
data.traded_pairs integer; Required within parent; format: int64	Distinct markets this wallet has closed trades in (warehouse + live tail), e.g. for a breadth badge. 0 when the wallet has never traded.
data.watermark integer; Required within parent; format: int64	Warehouse episode watermark = the boundary the live gap-fill resumes from (Unix SECONDS); 0 means full backfill
meta.cached boolean; Required within parent	Whether this response was served from cache
meta.credits_used integer; Required within parent; format: int64	Credits deducted for this request
meta.empty_reason string; Optional within parent	Hint explaining why the data array is empty, when applicable

Coverage, units and freshness

Performance net PnL is gross PnL minus fees and excludes funding. Preserve partial and errors rather than presenting incomplete results as comprehensive.

Inspect any returned observation time, cache status, watermark, pagination and errors using their documented meanings. A successful request alone does not establish complete coverage. Where no freshness or completeness guarantee is documented, treat it as unknown. Saved Examples are historical and viewing them does not refresh data or execute a new call.

Data source and references

Surf supplies this endpoint through its Data API. Response contract and deployed Tool inputs reviewed on 2026-10-03 against official OpenAPI v0.2.102. This is a contract review date, not a data observation time. Coverage depends on the selected endpoint and request.

Surf Data API documentation

Official Surf OpenAPI contract

Use one Toolmu account and a shared prepaid balance across available Tools. Pay per use; no separate supplier subscription is required. The current execution ceiling for this Tool is 0.0288 Toolmu credits per call. This is a maximum, not the settled charge. Before execution, get the current Tool contract and check availability, the latest maximumCredits, your balance and budget. Supplier response credits_used, when present, describes supplier API credits and is not the Toolmu customer charge.

Questions about this tool.

Inputs, results and details to know before running it.

Get connected

Share a public wallet page link or its public wallet name. A wallet name ending in .eth can be used if it identifies the account. A social nickname alone may not be enough.

Hyperliquid Trading Performance by Wallet

Hyperliquid Trading Performance by Wallet

You receive

Start with your task

Inputs & outputs

Input schema

Result schema

How to use this Tool

What this Tool returns

Response fields and how to read them

Coverage, units and freshness

Data source and references

See account value and open positions

Review trading performance

Explain incomplete results

Questions about this tool.

You receive

Start with your task

Inputs & outputs

Input schema

Result schema

How to use this Tool

What this Tool returns

Response fields and how to read them

Coverage, units and freshness

Data source and references

See account value and open positions

Review trading performance

Explain incomplete results

Questions about this tool.

What link or name should I share?

What does the response contain?

How should I interpret coverage and units?

How is this Tool charged?

How can my agent complete this task?

Does opening this page or Example return current data?