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,
  "pnl": {
    "total": 123,
    "perChain": {
      "base": 123,
      "solana": 123,
      "ethereum": 123,
      "hyperliquid": 123
    }
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.clicker.xyz/llms.txt

Use this file to discover all available pages before exploring further.

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
​
onlyWithComments
enum<string>
default:false
Available options:
true,
false
​
timeframe
enum<string>
default:30d
Available options:
7d,
30d

Response

200

​
ranking
number | null
required
​
pnl
object
required