Skip to main content
GET
Perps - Wallet List
  • Returns ranked perp-trader wallets on Hyperliquid with performance and exposure metrics.
  • Use this endpoint for wallet discovery, leaderboard views, and trader screening.
  • This is a wallet ranking surface, not a transaction log or a single-wallet detail page.
  • Follow with wallet overview or wallet open positions when you need a deeper read on one trader.
  • This endpoint consumes 10 CU per request.
  • Build perp trader leaderboards based on equity, PnL, ROI, ROE, volume, or directional bias.
  • Discover high-conviction or high-performing wallets for deeper research.
  • Feed copy-trading research, trader intelligence, and leaderboard-style product experiences.
  • Screen for notable wallets before loading wallet-level open-position detail.
  • Start here when you need a ranked universe of Hyperliquid perp wallets.
  • Apply supported sorting and filters to isolate the trader profile you care about.
  • Use the returned wallet address with Perps Wallet Overview or Perps Wallet Open Positions.
  • Use ranked lists for discovery, then move to single-wallet endpoints for any serious interpretation.
  • Compare performance fields over consistent snapshots if you are building your own leaderboard history.
  • Avoid mixing spot-wallet metrics and perp-wallet metrics without explicit labeling.

Authorizations

X-API-KEY
string
header
required

API key for authentication

Headers

x-perp
enum<string>
default:hyperliquid

Specify the perpetuals exchange. Currently supports hyperliquid.

Available options:
hyperliquid

Query Parameters

last_trade_duration
enum<string>
default:all
Available options:
1d,
7d,
30d,
90d,
all
sort_by
enum<string>
default:total_pnl
Available options:
perp_equity,
long_value,
short_value,
unrealized_pnl,
order_count,
order_count_90d,
win,
win_90d,
loss,
loss_90d,
volume_usd,
volume_90d_usd,
open_volume_usd,
open_volume_90d_usd,
realized_pnl,
realized_pnl_90d,
funding_fee,
funding_fee_90d,
first_trade,
last_trade,
win_rate,
win_rate_90d,
open_value,
total_pnl,
total_pnl_90d,
roe,
roi,
roi_90d,
bias,
leverage
sort_type
enum<string>
default:desc

Specify the sort order.

Available options:
desc,
asc
offset
integer
default:0

Specify the offset for pagination. Filter for records with offset greater than the specified offset value, including those with offset equal to the specified offset.

limit
integer
default:10

Number of items per page.

Required range: 1 <= x <= 20

Response

JSON object containing a list of wallets with certain fields

success
boolean
required

Whether the request succeeded.

data
object[]
required

Wallets ranked by the requested perp performance or activity metric.