GET /leaderboards/most-popular

Get feeds ranked by purchase count within a specified time period.

GET/v1/leaderboards/most-popular

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": "Premium Trading Signals",
      "owner_id": "owner-uuid",
      "owner_username": "signalmaster",
      "owner_wallet": "0x...",
      "category_id": "category-uuid",
      "category_name": "Finance",
      "description": "High-accuracy trading signals",
      "image_cid": "Qm...",
      "is_active": true,
      "tags": ["trading", "signals"],
      "total_entries": 500,
      "total_purchases": "12500",
      "total_revenue": "75000000000",
      "unique_buyers": "3200",
      "avg_revenue_per_purchase": "6000000",
      "created_at": 1700000000,
      "updated_at": 1704153600
    }
  ],
  "period": "7d"
}

Example Requests

# All-time most popular
curl "https://api.grapevine.fyi/v1/leaderboards/most-popular"
 
# Most popular this week
curl "https://api.grapevine.fyi/v1/leaderboards/most-popular?period=7d&page_size=10"
 
# Most popular today
curl "https://api.grapevine.fyi/v1/leaderboards/most-popular?period=1d"

Notes

Ranked by total purchase count in the specified period
Period defaults to all (all-time) if not specified
Only active feeds are included