Skip to main content
GET
/
v2
/
leaderboard
/
ranking
Get User Leaderboard Ranking (V2)
curl --request GET \
  --url https://api.clicker.xyz/v2/leaderboard/ranking \
  --header 'Authorization: Bearer <token>'
{
  "ranking": 123
}
Get a specific user’s ranking position based on combined PnL across selected chains.

​
Usage

# Get ranking across all chains
GET /v2/leaderboard/ranking?address=0x1234...

# Get ranking for specific chains
GET /v2/leaderboard/ranking?address=0x1234...&chains=base&chains=solana

​
Response

{
  "ranking": 42
}
Returns null if the user is not on the leaderboard (either not a trader or below the minimum threshold).

​
Notes

  • Ranking is 1-indexed (rank 1 = top trader)
  • When multiple chains are specified, PnL is summed across those chains for ranking
  • Omitting chains parameter uses all supported chains

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
address
string
default:0xa4e221aa5a7ba51b5d5c7d5c923bfb9bcebcb252
required

The address / public key.

​
chains
Available options:
base,
solana,
ethereum,
hyperliquid

Response

200

​
ranking
number | null
required