GET /leaderboards/category-stats

Get aggregated statistics for all categories on the platform.

GET/v1/leaderboards/category-stats

Authentication

Required: No
Payment: No

Query Parameters

None

Response

Status: 200 OK

{
  "data": [
    {
      "category_id": "category-uuid-1",
      "category_name": "Cryptocurrency",
      "category_description": "Crypto trading and analysis",
      "category_icon_url": "https://...",
      "total_feeds": "125",
      "total_providers": "85",
      "total_entries": "5600",
      "total_purchases": "45000",
      "total_revenue": "350000000000",
      "unique_buyers": "12000",
      "avg_purchase_amount": "7777778"
    },
    {
      "category_id": "category-uuid-2",
      "category_name": "Technology",
      "category_description": "Tech news and tutorials",
      "category_icon_url": "https://...",
      "total_feeds": "200",
      "total_providers": "150",
      "total_entries": "8500",
      "total_purchases": "30000",
      "total_revenue": "180000000000",
      "unique_buyers": "8500",
      "avg_purchase_amount": "6000000"
    }
  ]
}

Example Request

curl "https://api.grapevine.fyi/v1/leaderboards/category-stats"

Response Fields

Field	Description
`category_id`	Unique category identifier
`category_name`	Display name
`category_description`	Category description
`category_icon_url`	URL to category icon
`total_feeds`	Number of feeds in category
`total_providers`	Unique content creators
`total_entries`	Total entries across all feeds
`total_purchases`	Total purchase transactions
`total_revenue`	Total revenue generated (in wei)
`unique_buyers`	Unique buyers in category
`avg_purchase_amount`	Average transaction amount (in wei)

Use Cases

Category browser/selector
Platform analytics dashboard
Identifying popular content areas
Comparing category performance

Notes

Returns statistics for all active categories
All monetary values are in wei (USDC has 6 decimals)
Results may be cached for performance