GRgrove
leaderboard

Get 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.
get/v1/leaderboard/tippees

Request

  • Base URL
    https://api.grove.city (the document declares no server; this is the origin it was published from)
  • URL
    https://api.grove.city/v1/leaderboard/tippees
  • Auth
    none declared

Query parameters

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

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

tokenstring

Token symbol to filter by.

limitinteger

Maximum number of entries to return.

aggregateboolean

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

windowstring required
tokenstring required
aggregatedboolean

Changes

No recorded changes to this operation across all 1 revision of this API.