Skip to main content
GET
Get leaderboard

Authorizations

Authorization
string
header
required

Bearer token from Geomi. See Authentication for setup instructions.

Query Parameters

limit
integer<int32>
default:10

Page size

Required range: 0 <= x <= 1000
offset
integer<int32>
default:0

Page offset

Required range: 0 <= x <= 10000
sort_key
enum<string>
Available options:
account_value,
realized_pnl,
volume,
roi
sort_dir
enum<string>
Available options:
ASC,
DESC
search_term
string

Optional search term to filter accounts by address prefix

window
enum<string>

Rank by realized PnL over a rolling window (24h, 7d, 30d) instead of all time. Sorts by realized_pnl when sort_key is left out; another sort key is a 400. all (the default) is the all-time board. A rolling window for the leaderboard; All is the all-time board.

Available options:
24h,
7d,
30d,
all

Response

Paginated leaderboard entries with rankings

items
object[]
required

The items in the current page

total_count
integer<int32> | null

The total number of items across all pages. Optional: history endpoints omit this field to avoid expensive COUNT(*) queries.

Required range: x >= 0