OKX 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.
What is the OKX 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.
curl -X GET 'https://api.parse.bot/scraper/3b24c4ed-6fe2-4441-9da9-00277d9222f9/get_leaderboard?chain=solana&period=24H&max_results=5' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace web3-okx-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.okx_web3_copy_trading_leaderboard_api import OKXLeaderboard, Chain, Period
client = OKXLeaderboard()
# List top traders on Solana for the past week
for trader in client.traders.list(chain=Chain.SOLANA, period=Period.WEEK, limit=5):
print(trader.wallet_address, trader.pnl, trader.roi, trader.win_rate)
for token in trader.top_tokens:
print(" ", token.symbol, token.pnl, token.roi)
# Get aggregated leaderboard across all chains
group = client.chaingroups.get(period=Period.MONTH, max_results=10)
print(group.total_count, group.period)
Get copy trading leaderboard for a specific blockchain network. Returns trader data ranked by PnL, including wallet addresses, performance metrics, labels, and top tokens traded. Supports solana, ethereum, bnb, base, and xlayer chains with configurable time periods (24H, 7D, 30D, 90D). The scraper handles internal pagination against the upstream API and returns up to max_results traders in a single response.
| Param | Type | Description |
|---|---|---|
| chain | string | Blockchain network. |
| period | string | Time period for performance metrics. |
| max_results | integer | Maximum number of traders to return (1-1000). |
{
"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": 5,
"period": "7D",
"traders": [
{
"pnl": 67689.05,
"roi": 12.56,
"chain": "solana",
"labels": [
"kol"
],
"volume": 1277093.91,
"win_rate": 50,
"top_tokens": [
{
"pnl": 67689.05,
"roi": 12.56,
"symbol": "CARDS",
"address": "CARDSccUMFKoPRZxt5vt3ksUbxEFEcnZ3H2pd3dKxYjp"
}
],
"wallet_name": "Chubbicorn230",
"wallet_address": "B5hcNUxRw625xWKhZk7eahekR2PZGbWNvvbEVvoXTmh8",
"wallet_page_url": "https://web3.okx.com/address/B5hcNUxRw625xWKhZk7eahekR2PZGbWNvvbEVvoXTmh8",
"last_update_time": 1781056878000,
"total_transactions": 316
}
]
},
"status": "success"
}
}About the OKX API
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.
The OKX API is a managed, monitored endpoint for web3.okx.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when web3.okx.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official web3.okx.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- 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 | 100 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.