GET /leaderboards/top-providers

Get content creators ranked by total revenue earned.

GET/v1/leaderboards/top-providers

Authentication

Required: No
Payment: No

Query Parameters

Parameter	Type	Required	Description
`page_size`	number	No	Results per page (default: 20)
`period`	string	No	Time period: `1d`, `7d`, `30d`, `all` (default: `all`)

Response

Status: 200 OK

{
  "data": [
    {
      "rank": "1",
      "user_id": "user-uuid",
      "username": "cryptoanalyst",
      "wallet_address": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
      "total_feeds": "5",
      "total_entries": "750",
      "total_purchases": "15000",
      "total_revenue": "200000000000",
      "unique_buyers": "4500",
      "joined_at": 1690000000
    }
  ],
  "period": "all"
}

Example Requests

# Top providers all-time
curl "https://api.grapevine.fyi/v1/leaderboards/top-providers"
 
# Top providers this week
curl "https://api.grapevine.fyi/v1/leaderboards/top-providers?period=7d"
 
# Top 50 providers this month
curl "https://api.grapevine.fyi/v1/leaderboards/top-providers?period=30d&page_size=50"

Response Fields

Field	Description
`rank`	Position in the leaderboard
`user_id`	Unique user/wallet identifier
`username`	Display name (null if not set)
`wallet_address`	Ethereum wallet address
`total_feeds`	Number of feeds created
`total_entries`	Total entries published
`total_purchases`	Number of purchases of their content
`total_revenue`	Total revenue earned (in wei)
`unique_buyers`	Number of unique buyers
`joined_at`	Account creation timestamp

Notes

Ranked by total revenue (highest first)
Revenue is in wei (USDC has 6 decimals, so 1000000 = $1)
Period filters revenue earned within the timeframe