Perps - Wallet Overview

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
  • Returns one trader's perp performance and exposure summary on the selected venue.
  • Includes lifetime and 90-day metrics in the same object.
  • This is the fastest way to inspect a single wallet before loading its open positions.
  • Data availability begins on May 25, 2026 at 15:00 UTC.
Use Cases 💡
  • Show a compact perp trader profile for one wallet.
  • Review performance, exposure, leverage, and bias before deciding whether a wallet is worth tracking.
  • Add perp-trader summary cards to internal research or monitoring tools.
  • Compare one trader's current stance against the broader leaderboard.
How to Use 🛠️
  • Set x-perp and pass the wallet address in wallet.
  • Read perp_equity, open_value, total_pnl, win_rate, and leverage first for a quick profile.
  • Use the *_90d fields to see whether recent behavior matches lifetime behavior.
Best Practices ✅
  • Follow this overview with wallet open positions when you need token-level exposure.
  • Compare unrealized_pnl and open_value together to understand how much current PnL depends on still-open risk.
  • Use bias and bias_text as summary signals, then validate with position details.
Limitations ⚠️
  • Hyperliquid only.

Query Params
string
required

The address of the wallet.

Headers
string
enum
Defaults to hyperliquid

Specify the perpetuals exchange. Currently supports hyperliquid.

Allowed:
Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json