GET /v1/callouts/leaderboard: your callers ranked for a period by average, median, best or summed peak multiple, hit rate or number of callouts, with their best call.
Callouts are switched on per instance on request. Contact us (contact@cabalspy.xyz) to enable them. Without them every endpoint answers 403 feature_not_enabled.
Every user of your instance who made callouts in the period, ranked. A period covers the callouts made in that window back from now, each counted with its current score. Each entry carries the user’s external_id, so you can render the leaderboard with your own user data.
The leaderboard is cached for 30 seconds. To page through it, pass pagination.next_cursor as cursor. An unknown or malformed cursor is answered with 400 invalid_parameter.
Query Parameters
string
default:"7d"
Ranking window, one of 6h, 1d, 7d or 30d.
string
Only callouts on this chain. One of solana, bnb, base, eth, rh. Empty means every chain.
string
default:"avg_peak_x"
Ranking order, highest first: avg_peak_x, median_peak_x, best_peak_x, sum_peak_x, hit_rate or callouts. Ties go to the user with more callouts.
integer
default:"1"
Callouts a user needs in the period to be listed, 1 to 1,000.
number
default:"2"
The multiple that counts as a hit, above 1 and at most 1000.
integer
default:"100"
Entries per page, 1 to 500.
string
Cursor for the next page, the pagination.next_cursor from the previous response.
string
Your Instance ID. Only needed when your account has several instances.
string
required
Your API key. Alternatively pass it as an Authorization Bearer header.