Sign in

v1

latestOpenAPI 3.1.02026-07-13143194365.4 KB
leaderboard

Get top tippers leaderboard

Get the top tippers leaderboard (public, no auth).

  • Ranks by total amount tipped (USD) in the requested window.
  • Always returns the tipper's Grove custodial address.
  • window examples:
    • 24h: tips in the last 24 hours
    • 7d: tips in the last 7 days
    • 30d: tips in the last 30 days
    • all: all-time rollup (fast path, no aggregation)
  • aggregate: When true, entries for accounts with multiple linked wallets are combined into a single entry with linked_addresses showing all wallets.
get/v1/leaderboard/tippers

Query parameters

window'24h' | '7d' | '30d' | 'all'

Time window: '24h', '7d', '30d', or 'all' (all time).

Time window: '24h', '7d', '30d', or 'all' (all time).

tokenstring

Token symbol to filter by.

Token symbol to filter by.

limitinteger

Maximum number of entries to return.

Maximum number of entries to return.

aggregateboolean

If true, aggregate entries by account (combine multiple linked wallets).

If true, aggregate entries by account (combine multiple linked wallets).

Response

Successful Response

windowstring required
tokenstring required
aggregatedboolean