---
title: "Get top funders leaderboard"
method: GET
path: "/v1/leaderboard/funders"
tags: ["leaderboard"]
---

# Get top funders leaderboard

`GET /v1/leaderboard/funders`

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

- Ranks accounts by total funds deposited into Grove custodial wallets.
- Includes first/last funded timestamps for context.
- `window` examples:
    - `24h`: funding events in the last 24 hours
    - `7d`: funding events in the last 7 days
    - `30d`: funding events in the last 30 days
    - `all`: all-time rollup (fast path, no aggregation)

## Query parameters

- `window` '24h' | '7d' | '30d' | 'all' — Time window: '24h', '7d', '30d', or 'all' (all time).
- `token` string — Token symbol to filter by.
- `limit` integer — Maximum number of entries to return.

## Response `200`

Successful Response

- FundersLeaderboardResponse — Response model for funders leaderboard.
  - `window` string, required
  - `token` string, required
  - `entries` FunderEntry[], required
    - `rank` integer, required
    - `account_id` string, required
    - `address` string, required
    - `earning_address` string, nullable
    - `handle` string, nullable
    - `ens_name` string, nullable
    - `base_name` string, nullable
    - `avatar_url` string, nullable — Funder's selected avatar URL
    - `description` string, nullable — Funder's profile bio
    - `total_amount_usd` string, required
    - `total_amount_raw` string, required
    - `fund_count` integer, required
    - `first_funded_at` string, required
    - `last_funded_at` string, required
    - `client_address` string, nullable, required
    - `earnings_address` string, nullable, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/grove/apis/grove-api.md) · [All operations](https://skmtc.net/grove/apis/grove-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/grove/grove-api/versions/f286b48a8105/schema)