latestOpenAPI 3.1.02026-08-1013317298.0 KB

d94e0e0f1821

Rankings

Get marketplace rankings

Retrieves ranked lists of marketplace entities based on various metrics and timeframes.

Entity types:

  • collections: Top-performing collections
  • creators: Most active or highest-earning creators
  • items: Best-selling items
  • sellers: Top sellers by volume

Timeframes:

  • day: Last 24 hours
  • week: Last 7 days
  • month: Last 30 days
  • all: All-time rankings

Rankings are calculated based on sales volume, transaction count, and other relevant metrics.

get/v1/rankings/{entity}/{timeframe}

Path parameters

entity'collections' | 'creators' | 'items' | 'sellers' required

Type of entity to rank (collections, creators, items, sellers)

timeframe'day' | 'week' | 'month' | 'all' required

Time period for rankings (day, week, month, all)

Response

Rankings data

entitystring required

Entity type

timeframestring required

Timeframe

rankingsobject[] required

Rankings data