Perps - Wallet List

get

https://public-api.birdeye.so/perps/v1/wallet/list

Recent Requests

Log in to see full request history

Time	Status	User Agent
Retrieving recent requests…

Loading…

Ranked wallet list for perp traders on the selected venue.
The response combines lifetime metrics and 90-day metrics in the same row, so read the suffix carefully.
bias, leverage, roi, roe, and total_pnl are portfolio-level aggregates, not position-level values.
Data availability begins on May 25, 2026 at 15:00 UTC.

Use Cases 💡

Find the biggest perp wallets by activity, profitability, or open exposure.
Rank traders for copy-research, leaderboard views, and risk concentration analysis.
Screen for wallets with strong 90-day performance, high leverage, or directional skew.
Build venue intelligence dashboards around top perp participants.

How to Use 🛠️

Set x-perp, choose sort_by, and optionally constrain by last_trade_duration.
Use offset and limit for pagination.
Compare lifetime metrics with *_90d metrics to separate long-term size from recent performance.

Best Practices ✅

Avoid ranking on a single metric alone; combine PnL, win rate, leverage, and current open exposure.
Use wallet overview after shortlist selection to inspect one trader in more detail.
Treat very high ROI or ROE alongside funding and open exposure before concluding true skill.

Limitations ⚠️

Hyperliquid only.

Query Params

last_trade_duration

string

enum

Defaults to all

Allowed:

sort_by

string

enum

Defaults to total_pnl

sort_type

string

enum

Defaults to desc

Specify the sort order.

Allowed:

offset

integer

Defaults to 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

1 to 20

Defaults to 10

Number of items per page.

Headers

x-perp

string

enum

Defaults to hyperliquid

Specify the perpetuals exchange. Currently supports hyperliquid.

Allowed:

Responses

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json