Perps - Wallet List
curl --request GET \
--url https://public-api.birdeye.so/perps/v1/wallet/list \
--header 'X-API-KEY: <api-key>'import requests
url = "https://public-api.birdeye.so/perps/v1/wallet/list"
headers = {"X-API-KEY": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};
fetch('https://public-api.birdeye.so/perps/v1/wallet/list', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"data": [
{
"wallet": "0x5b5d51203a0f9079f8aeb098a6523a13f298c060",
"perp_equity": 4820256.661112,
"long_value": 7711796.4816,
"short_value": 27162652.130878,
"unrealized_pnl": 519753.636517,
"order_count": 528268,
"order_count_90d": 40946,
"win": 204298,
"win_90d": 18111,
"loss": 50566,
"loss_90d": 2810,
"volume_usd": 2877059275.010704,
"volume_90d_usd": 287016529.073075,
"open_volume_usd": 1317279026.67999,
"open_volume_90d_usd": 155549308.313184,
"realized_pnl": 171489764.775849,
"realized_pnl_90d": 9018515.858766,
"funding_fee": -1923466.812288,
"funding_fee_90d": -2530808.146744,
"first_trade": 1748185475,
"last_trade": 1778818326,
"open_value": 34874448.612478,
"total_pnl": 172009518.412366,
"total_pnl_90d": 9538269.495283,
"win_rate": 0.8015961453951912,
"win_rate_90d": 0.8656851966923187,
"roe": 0.11145774849176364,
"roi": 0.13018484413895512,
"roi_90d": 0.05797850184333872,
"bias": -4.035232357272615,
"leverage": 7.234977525954543,
"bias_text": "Very Bearish"
}
]
}{
"success": false,
"message": "Bad request"
}{
"success": false,
"message": "Unauthorized"
}{
"success": false,
"message": "Access Denied"
}{
"success": false,
"message": "Too many requests"
}{
"success": false,
"message": "Internal Server Error"
}Perps Wallet
Perps Wallet List
GET
/
perps
/
v1
/
wallet
/
list
Perps - Wallet List
curl --request GET \
--url https://public-api.birdeye.so/perps/v1/wallet/list \
--header 'X-API-KEY: <api-key>'import requests
url = "https://public-api.birdeye.so/perps/v1/wallet/list"
headers = {"X-API-KEY": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};
fetch('https://public-api.birdeye.so/perps/v1/wallet/list', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"data": [
{
"wallet": "0x5b5d51203a0f9079f8aeb098a6523a13f298c060",
"perp_equity": 4820256.661112,
"long_value": 7711796.4816,
"short_value": 27162652.130878,
"unrealized_pnl": 519753.636517,
"order_count": 528268,
"order_count_90d": 40946,
"win": 204298,
"win_90d": 18111,
"loss": 50566,
"loss_90d": 2810,
"volume_usd": 2877059275.010704,
"volume_90d_usd": 287016529.073075,
"open_volume_usd": 1317279026.67999,
"open_volume_90d_usd": 155549308.313184,
"realized_pnl": 171489764.775849,
"realized_pnl_90d": 9018515.858766,
"funding_fee": -1923466.812288,
"funding_fee_90d": -2530808.146744,
"first_trade": 1748185475,
"last_trade": 1778818326,
"open_value": 34874448.612478,
"total_pnl": 172009518.412366,
"total_pnl_90d": 9538269.495283,
"win_rate": 0.8015961453951912,
"win_rate_90d": 0.8656851966923187,
"roe": 0.11145774849176364,
"roi": 0.13018484413895512,
"roi_90d": 0.05797850184333872,
"bias": -4.035232357272615,
"leverage": 7.234977525954543,
"bias_text": "Very Bearish"
}
]
}{
"success": false,
"message": "Bad request"
}{
"success": false,
"message": "Unauthorized"
}{
"success": false,
"message": "Access Denied"
}{
"success": false,
"message": "Too many requests"
}{
"success": false,
"message": "Internal Server Error"
}- Usage Note
- Accessibility
- Chain Supported
- 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.
- Lite
- Starter
- Premium
- Business
- Enterprise
Hyperliquid
Compute Unit ⚙️
Compute Unit ⚙️
- This endpoint consumes
10 CUper request.
Use Cases 💡
Use Cases 💡
- 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.
How to Use 🛠️
How to Use 🛠️
- 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 OvervieworPerps Wallet Open Positions.
Best Practices ✅
Best Practices ✅
- 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
API key for authentication
Headers
Specify the perpetuals exchange. Currently supports hyperliquid.
Available options:
hyperliquid Query Parameters
Available options:
1d, 7d, 30d, 90d, all 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 Specify the sort order.
Available options:
desc, asc 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.
Number of items per page.
Required range:
1 <= x <= 20Was this page helpful?

