Wallet - Leaderboard
curl --request GET \
--url https://public-api.birdeye.so/wallet/v2/leaderboard \
--header 'X-API-KEY: <api-key>'import requests
url = "https://public-api.birdeye.so/wallet/v2/leaderboard"
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/wallet/v2/leaderboard', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"data": [
{
"owner": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
"total_value": 3352489812.278252
},
{
"owner": "A3znyaRYUvi7GbQv1pp9CqqiVo7anddU9rPKFH55V28R",
"total_value": 1564819917.2911928
},
{
"owner": "2RH6rUTPBJ9rUDPpuV9b8z1YL56k1tYU6Uk5ZoaEFFSK",
"total_value": 1483130883.5045538
},
{
"owner": "5tzFkiKscXHK5ZXCGbXZxdw7gTjjD1mBwuoFbhUvuAi9",
"total_value": 1147108284.7334204
},
{
"owner": "7VHUFJHWu2CuExkJcJrzhQPJ2oygupTWkL2A2For4BmE",
"total_value": 945760499.1432049
},
{
"owner": "7s1da8DduuBFqGra5bJBjpnvL5E9mGzCuMk1Qkh4or2Z",
"total_value": 875194731.5268117
},
{
"owner": "5Q544fKrFoe6tsEbD7S8EmxGTJYAKtTVhAW5Q5pge4j1",
"total_value": 809838920.8587894
},
{
"owner": "CbrKVVDv6irzm4SYv8YnhJkN6wCTnYw9S7SqdwavCrRt",
"total_value": 744786294.4507848
},
{
"owner": "WLHv2UAZm6z4KyaaELi5pjdbJh6RESMva1Rnn8pJVVh",
"total_value": 680821233.5398307
},
{
"owner": "9DrvZvyWh1HuAoZxvYWMvkf2XCzryCpGgHqrMjyDWpmo",
"total_value": 665974893.9983461
},
{
"owner": "7mhcgF1DVsj5iv4CxZDgp51H6MBBwqamsH1KnqXhSRc5",
"total_value": 642357546.305955
},
{
"owner": "AVzP2GeRmqGphJsMxWoqjpUifPpCret7LqWhD8NWQK49",
"total_value": 638620660.7627872
},
{
"owner": "Cfq1ts1iFr1eUWWBm8eFxUzm5R3YA3UvMZznwiShbgZt",
"total_value": 619044607.6657771
},
{
"owner": "S7vYFFWH6BjJyEsdrPQpqpYTqLTrPRK6KW3VwsJuRaS",
"total_value": 532792174.87978095
},
{
"owner": "FhVo3mqL8PW5pH5U2CN4XE33DokiyZnUwuGpH2hmHLuM",
"total_value": 503459404.00368106
},
{
"owner": "29koCwp2k6G8vnewSDJUdusWw6RKpi83CkAcXfokeF2A",
"total_value": 426470848.522809
},
{
"owner": "5gUuDFHswKi2QMA1qJHf6FEVhNCrHnyAdfWniMaUUPE4",
"total_value": 420289058.432106
},
{
"owner": "51yZyDSnec4xnUv7XLRVYcDyV4x3wUtzrDcRaYbmQU5j",
"total_value": 402965606.3338358
},
{
"owner": "H8BgJgae6qhMtf7BM2JtddywSQt11WdxHHxkGLNX5hss",
"total_value": 387663654.9940434
},
{
"owner": "6LY1JzAFVZsP2a2xKrtU6znQMQ5h4i7tocWdgrkZzkzF",
"total_value": 374231197.1905912
}
]
}{
"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"
}Wallet, Networth & PnL
Wallet - Leaderboard
’ Retrieve the wallet leaderboard sorted by total asset value in descending order.’
GET
/
wallet
/
v2
/
leaderboard
Wallet - Leaderboard
curl --request GET \
--url https://public-api.birdeye.so/wallet/v2/leaderboard \
--header 'X-API-KEY: <api-key>'import requests
url = "https://public-api.birdeye.so/wallet/v2/leaderboard"
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/wallet/v2/leaderboard', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"success": true,
"data": [
{
"owner": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
"total_value": 3352489812.278252
},
{
"owner": "A3znyaRYUvi7GbQv1pp9CqqiVo7anddU9rPKFH55V28R",
"total_value": 1564819917.2911928
},
{
"owner": "2RH6rUTPBJ9rUDPpuV9b8z1YL56k1tYU6Uk5ZoaEFFSK",
"total_value": 1483130883.5045538
},
{
"owner": "5tzFkiKscXHK5ZXCGbXZxdw7gTjjD1mBwuoFbhUvuAi9",
"total_value": 1147108284.7334204
},
{
"owner": "7VHUFJHWu2CuExkJcJrzhQPJ2oygupTWkL2A2For4BmE",
"total_value": 945760499.1432049
},
{
"owner": "7s1da8DduuBFqGra5bJBjpnvL5E9mGzCuMk1Qkh4or2Z",
"total_value": 875194731.5268117
},
{
"owner": "5Q544fKrFoe6tsEbD7S8EmxGTJYAKtTVhAW5Q5pge4j1",
"total_value": 809838920.8587894
},
{
"owner": "CbrKVVDv6irzm4SYv8YnhJkN6wCTnYw9S7SqdwavCrRt",
"total_value": 744786294.4507848
},
{
"owner": "WLHv2UAZm6z4KyaaELi5pjdbJh6RESMva1Rnn8pJVVh",
"total_value": 680821233.5398307
},
{
"owner": "9DrvZvyWh1HuAoZxvYWMvkf2XCzryCpGgHqrMjyDWpmo",
"total_value": 665974893.9983461
},
{
"owner": "7mhcgF1DVsj5iv4CxZDgp51H6MBBwqamsH1KnqXhSRc5",
"total_value": 642357546.305955
},
{
"owner": "AVzP2GeRmqGphJsMxWoqjpUifPpCret7LqWhD8NWQK49",
"total_value": 638620660.7627872
},
{
"owner": "Cfq1ts1iFr1eUWWBm8eFxUzm5R3YA3UvMZznwiShbgZt",
"total_value": 619044607.6657771
},
{
"owner": "S7vYFFWH6BjJyEsdrPQpqpYTqLTrPRK6KW3VwsJuRaS",
"total_value": 532792174.87978095
},
{
"owner": "FhVo3mqL8PW5pH5U2CN4XE33DokiyZnUwuGpH2hmHLuM",
"total_value": 503459404.00368106
},
{
"owner": "29koCwp2k6G8vnewSDJUdusWw6RKpi83CkAcXfokeF2A",
"total_value": 426470848.522809
},
{
"owner": "5gUuDFHswKi2QMA1qJHf6FEVhNCrHnyAdfWniMaUUPE4",
"total_value": 420289058.432106
},
{
"owner": "51yZyDSnec4xnUv7XLRVYcDyV4x3wUtzrDcRaYbmQU5j",
"total_value": 402965606.3338358
},
{
"owner": "H8BgJgae6qhMtf7BM2JtddywSQt11WdxHHxkGLNX5hss",
"total_value": 387663654.9940434
},
{
"owner": "6LY1JzAFVZsP2a2xKrtU6znQMQ5h4i7tocWdgrkZzkzF",
"total_value": 374231197.1905912
}
]
}{
"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
Wallet leaderboard by total asset value.
limitsupports1to100, andoffsetsupports up to10,000.from_valuedefaults to100,000and cannot go below that threshold.to_value, when provided, must be greater thanfrom_value.- Results are sorted by total asset value in descending order.
- Standard
- Lite
- Starter
- Premium
- Business
- Enterprise
Solana
Compute Unit ⚙️
Compute Unit ⚙️
- This endpoint consumes
25 CUper request.
Use Cases 💡
Use Cases 💡
- Build whale leaderboards and wallet-rich-list style screens.
- Slice wallet rankings by value bands for cohort analysis.
- Find large wallets worth investigating further with PnL or funding endpoints.
How to Use 🛠️
How to Use 🛠️
- Set
x-chain=solana. - Use
from_valueand optionalto_valueto define the wallet band. - Page through the leaderboard with
offsetandlimit.
Best Practices ✅
Best Practices ✅
- Use the leaderboard as a discovery layer, then drill into individual wallets with net-worth and PnL endpoints.
- Keep value bands explicit so comparisons stay meaningful across screens.
Limitations ⚠️
Limitations ⚠️
- Solana only.
from_valuehas a hard floor of100,000.
Authorizations
API key for authentication
Headers
Solana network only.
Available options:
solana Query Parameters
Minimum total value filter. Defaults to 100,000 and must be greater than or equal to 100,000.
Required range:
x >= 100000Maximum total value filter. Must be greater than or equal to 100,000 and greater than from_value.
Required range:
x >= 100000Required range:
1 <= x <= 100Make sure offset <= 10000
Required range:
0 <= x <= 10000Was this page helpful?

