web3.okx.com APIweb3.okx.com ↗
Access OKX Web3 copy trading leaderboard data: top wallet addresses, PnL, ROI, win rate, volume, and transaction counts across Solana, Ethereum, BNB, Base, and X Layer.
curl -X GET 'https://api.parse.bot/scraper/3b24c4ed-6fe2-4441-9da9-00277d9222f9/get_leaderboard?chain=solana&period=7D&max_results=5' \ -H 'X-API-Key: $PARSE_API_KEY'
Get copy trading leaderboard for a specific blockchain network. Returns paginated trader data ranked by PnL, including wallet addresses, performance metrics, labels, and top tokens traded.
| Param | Type | Description |
|---|---|---|
| chain | string | Blockchain network. Accepted values: solana, ethereum, bnb, base, xlayer. |
| period | string | Time period for performance metrics. Accepted values: 24H, 7D, 30D, 90D. |
| max_results | integer | Maximum number of traders to return. |
{
"type": "object",
"fields": {
"chain": "string - blockchain network queried",
"count": "integer - number of traders returned",
"period": "string - time period used",
"traders": "array of trader objects with wallet_address, wallet_name, wallet_page_url, chain, pnl, roi, win_rate, total_transactions, volume, labels, last_update_time, and top_tokens"
},
"sample": {
"data": {
"chain": "solana",
"count": 2,
"period": "7D",
"traders": [
{
"pnl": 95340.09,
"roi": 106.16,
"chain": "solana",
"labels": [
"kol"
],
"volume": 265518.46,
"win_rate": 41.67,
"top_tokens": [
{
"pnl": 69755.86,
"roi": 1281.49,
"symbol": "HANTA",
"address": "2tXpgu2DLTsPUf9zFmuZmA4xrYxXKBTpVq9wAM7hzs9y"
}
],
"wallet_name": "RC",
"wallet_address": "DxM1hfY8FQ8dNGrucuJzhJcF8KRbjk8WBwrgKvQ9spPv",
"wallet_page_url": "https://web3.okx.com/address/DxM1hfY8FQ8dNGrucuJzhJcF8KRbjk8WBwrgKvQ9spPv",
"last_update_time": 1778734139000,
"total_transactions": 213
}
]
},
"status": "success"
}
}About the web3.okx.com API
The OKX Web3 API exposes 2 endpoints for retrieving copy trading leaderboard data across five blockchain networks. get_leaderboard returns paginated trader rankings for a single chain — including wallet addresses, PnL, ROI, win rate, total transactions, and volume — while get_all_chains aggregates the same metrics across Solana, Ethereum, BNB, Base, and X Layer in a single response.
Endpoints and Parameters
The get_leaderboard endpoint accepts a chain parameter (solana, ethereum, bnb, base, xlayer), a period parameter (24H, 7D, 30D, 90D), and a max_results integer. It returns a traders array ranked by PnL for the specified chain and time window, with each trader object carrying wallet_address, wallet_name, wallet_page_url, chain, pnl, roi, win_rate, total_transactions, and volume. The response also surfaces count and the period used, making it straightforward to track how many results were returned and under what time horizon.
Multi-Chain Aggregation
The get_all_chains endpoint fetches leaderboard data from all five supported networks in one call. Results are returned under a by_chain object keyed by network name, each value being an array of trader objects with the same fields as get_leaderboard. A total_count field gives the aggregate trader count across all chains. The period and max_results parameters work the same way — they apply uniformly to every chain in the response.
Data Coverage and Scope
Trader objects include a wallet_page_url field that links directly to the trader's profile on the OKX Web3 copy trading interface. Performance metrics reflect the chosen time period rather than all-time figures, so comparing 24H vs. 90D windows for the same wallet shows how recent activity diverges from longer-term trends. Win rate and total transaction counts are useful for distinguishing high-frequency traders from low-frequency high-conviction positions.
- Identify top-performing wallets on Solana over 7-day and 30-day periods for copy trading strategy research
- Compare ROI and win rate across chains to spot which networks have the most consistent smart-money traders
- Build alerting systems that flag when specific wallet addresses appear or rise in the PnL rankings
- Aggregate multi-chain leaderboard data with
get_all_chainsto benchmark trader performance across Ethereum, BNB, Base, and X Layer simultaneously - Track volume and total transaction counts to differentiate high-frequency traders from low-frequency ones
- Feed leaderboard wallet addresses into on-chain analytics pipelines for deeper portfolio inspection
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does OKX Web3 have an official developer API for copy trading data?+
What does `get_leaderboard` return, and how do I narrow results to a specific time window?+
traders array ranked by PnL for the chain you specify. Use the period parameter to set the time window: 24H, 7D, 30D, or 90D. Each trader object includes pnl, roi, win_rate, total_transactions, volume, wallet_address, and a wallet_page_url. Use max_results to cap how many traders are returned.