Leaderboards API

The Leaderboards API provides platform-wide rankings, trending content, and discovery features. All endpoints are public and do not require authentication.

Base URL

Environment	URL
Mainnet	`https://api.grapevine.fyi/v1/leaderboards`
Testnet	`https://api.grapevine.markets/v1/leaderboards`

Endpoints

Endpoint	Description	Period Filter
GET /trending	Feeds by revenue velocity	No
GET /most-popular	Feeds by purchase count	Yes
GET /top-revenue	Feeds by total revenue	Yes
GET /top-feeds	Feeds by entry count	No
GET /top-providers	Creators by revenue	Yes
GET /top-buyers	Users by purchase volume	Yes
GET /category-stats	Aggregated category statistics	No
GET /recent-entries	Latest entries platform-wide	No

Period Filter

Endpoints that support period filtering accept these query parameter values:

Value	Description
`1d`	Last 24 hours
`7d`	Last 7 days
`30d`	Last 30 days
`all`	All time (default)

Quick Examples

# Get trending feeds
curl https://api.grapevine.fyi/v1/leaderboards/trending
 
# Get most popular feeds this week
curl "https://api.grapevine.fyi/v1/leaderboards/most-popular?period=7d&page_size=10"
 
# Get top content providers this month
curl "https://api.grapevine.fyi/v1/leaderboards/top-providers?period=30d"
 
# Get category statistics
curl https://api.grapevine.fyi/v1/leaderboards/category-stats
 
# Get recent entries with pagination
curl "https://api.grapevine.fyi/v1/leaderboards/recent-entries?page_size=50"

Response Format

Most leaderboard endpoints return data in this format:

{
  "data": [...],
  "period": "7d"
}

The recent-entries endpoint returns paginated data:

{
  "data": [...],
  "pagination": {
    "page_size": 20,
    "next_page_token": "...",
    "has_more": true
  }
}

Use Cases

Homepage Discovery

Display trending feeds and recent content on your homepage.

Category Browser

Show category statistics to help users find interesting content areas.

Creator Profiles

Display provider rankings and statistics.

Analytics Dashboard

Track platform activity and identify top performers.

SDK Leaderboards - TypeScript SDK reference
Feeds API - Browse all feeds
Categories API - List categories