csid_callout_leaderboard
The best callers of YOUR CabalSpy ID instance for a period (6h, 1d, 7d, 30d):
each user's callouts in the period, scored by their peak multiples (score_x),
with average, median, best and summed peak multiple, hits and hit rate (share
of callouts that reached hit_x), and their best call. Entries carry your own
user id (external_id). Use for "Who are the best callers this week?".
Callouts are an extra switched on per instance on request; otherwise this
returns feature_not_enabled. Needs your own CabalSpy API key with a CabalSpy
ID instance (no demo).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | avg_peak_x (default), best_peak_x, sum_peak_x, hit_rate, callouts or median_peak_x. | avg_peak_x |
| chain | No | Restrict to one blockchain: solana, bnb, base, eth or rh. Leave empty for all. | |
| hit_x | No | The peak multiple that counts as a hit for hits and hit_rate_percent, e.g. 2 for a 2x (default 2, above 1 and at most 1000). | |
| limit | No | How many callers (1-50, default 10). | |
| cursor | No | Pagination cursor taken from the previous response. Leave empty for the first page. | |
| period | No | Callouts made in the last 6h, 1d, 7d (default) or 30d. | 7d |
| instance | No | Your CabalSpy ID instance (its client_id, e.g. 'csid_1a2b…'). Only needed when your account has several instances. Leave empty otherwise. | |
| min_callouts | No | Only callers with at least this many callouts in the period (1-1000, default 1). Raise it to keep one lucky call from topping the average. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||