GET /leaderboards/top-revenue

Get feeds ranked by total revenue generated within a specified time period.

GET/v1/leaderboards/top-revenue

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",
      "feed_id": "feed-uuid",
      "feed_name": "Elite Market Insights",
      "owner_id": "owner-uuid",
      "owner_username": "marketpro",
      "owner_wallet": "0x...",
      "category_id": "category-uuid",
      "category_name": "Finance",
      "description": "Premium market analysis and insights",
      "image_cid": "Qm...",
      "is_active": true,
      "tags": ["finance", "analysis"],
      "total_entries": 300,
      "total_purchases": "8500",
      "total_revenue": "125000000000",
      "unique_buyers": "2100",
      "feed_created_at": 1698000000,
      "feed_updated_at": 1704153600
    }
  ],
  "period": "30d"
}

Example Requests

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

Notes

Ranked by total revenue (highest first)
Revenue is in wei (USDC has 6 decimals)
Period defaults to all (all-time) if not specified