Skip to main content
GET
Get Trading Leaderboard

Overview

Retrieve ranked leaderboards of top traders based on different performance metrics. This endpoint provides competitive rankings perfect for building leaderboards, competitions, and showcasing top performers.
Use this endpoint to display top traders, create competitions, and motivate users to improve their trading performance through gamification.

Parameters

string
Ranking metric
  • volume - Total trading volume (default)
  • profit - Total profit/loss
  • winRate - Win rate percentage
  • trades - Number of trades
  • efficiency - Profit per volume ratio
  • consistency - Consistency score
  • riskAdjusted - Risk-adjusted returns
string
Time period for rankings
  • 7d - Last 7 days
  • 30d - Last 30 days (default)
  • 90d - Last 90 days
  • 1y - Last year
  • all - All time
number
Filter by specific blockchain
  • 1 - Ethereum mainnet
  • 137 - Polygon
  • 56 - BSC
  • 42161 - Arbitrum
  • 10 - Optimism
  • 250 - Fantom
  • 43114 - Avalanche
string
Filter by specific protocol
  • uniswap - Uniswap
  • sushiswap - SushiSwap
  • 1inch - 1inch
  • curve - Curve
  • balancer - Balancer
  • pancakeswap - PancakeSwap
string
Trader category
  • all - All traders (default)
  • whale - High volume traders
  • retail - Retail traders
  • professional - Professional traders
  • institutional - Institutional traders
number
Number of traders to return (default: 100, max: 1000)
number
Number of traders to skip for pagination (default: 0)
boolean
Include detailed statistics for each trader (default: true)
boolean
Include ranking information (default: true)

Response

boolean
Indicates if the request was successful
array
Array of ranked traders
object
Pagination information
object
Leaderboard metadata
string
ISO 8601 timestamp of the response

Examples

Response Example

Use Cases

1. Trading Competition Dashboard

Create a competitive trading dashboard:

2. Trader Profile Analysis

Analyze individual trader performance:
Analyze leaderboard trends over time:

4. Category Analysis

Analyze different trader categories:

5. Badge System

Implement a badge system for achievements:

Best Practices

1. Caching

Cache leaderboard data for performance:

2. Real-time Updates

Subscribe to leaderboard updates:

3. Pagination

Handle large leaderboards with pagination:

4. Performance Optimization

Optimize for large datasets:

Troubleshooting

”No traders found”

Cause: No traders match the criteria or invalid filters. Solution:
  • Remove restrictive filters
  • Check if the timeframe has trading activity
  • Verify metric and category values

”Invalid metric”

Cause: Unsupported metric value. Solution:
  • Use supported metrics: volume, profit, winRate, trades, efficiency, consistency, riskAdjusted
  • Check for typos

”Invalid category”

Cause: Unsupported category value. Solution:
  • Use supported categories: all, whale, retail, professional, institutional
  • Check for typos

Rate Limits

Leaderboard requests are subject to rate limits:
  • Free tier: 60 requests per minute
  • Starter tier: 300 requests per minute
  • Professional tier: 1,000 requests per minute
  • Enterprise tier: Custom limits
Implement caching to reduce API calls.