v1
latestOpenAPI 3.1.02026-07-13143194365.4 KBGet top tippees (tip recipients) leaderboard
Get the top tippees (tip recipients) leaderboard (public, no auth).
- Ranks by total amount received (USD) in the requested window.
- Includes recipients without a Grove account (address only).
- window examples:
- 24h: tips received in the last 24 hours
- 7d: tips received in the last 7 days
- 30d: tips received in the last 30 days
- all: all-time rollup (fast path, no aggregation)
- aggregate: Defaults to true (grove-api#617). Entries for accounts with multiple linked wallets are combined into a single entry with linked_addresses showing all contributing wallets, and unique_counterparty_count is a correct distinct-sender count across those wallets (not a per-wallet sum). Pass aggregate=false to get the legacy per-(address, token) behavior.
Query parameters
Time window: '24h', '7d', '30d', or 'all' (all time).
Time window: '24h', '7d', '30d', or 'all' (all time).
Token symbol to filter by.
Token symbol to filter by.
Maximum number of entries to return.
Maximum number of entries to return.
Aggregate entries by Grove account (combine multiple linked wallets). Default: true — a creator with multiple receiving wallets appears once, with summed totals and a linked_addresses list showing every contributing wallet. Pass aggregate=false to opt out and receive one row per (address, token) pair instead — the pre-grove-api#617 behavior, kept as an escape hatch for admin tooling and per-wallet debugging.
Aggregate entries by Grove account (combine multiple linked wallets). Default: true — a creator with multiple receiving wallets appears once, with summed totals and a linked_addresses list showing every contributing wallet. Pass aggregate=false to opt out and receive one row per (address, token) pair instead — the pre-grove-api#617 behavior, kept as an escape hatch for admin tooling and per-wallet debugging.
Response
Successful Response