Rankings

View marketplace rankings by various metrics

Get marketplace rankings

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

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.

Path parameters
entitystring · enumRequired

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

Possible values:
timeframestring · enumRequired

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

Possible values:
Responses
chevron-right
200

Rankings data

application/json
entitystringRequired

Entity type

timeframestringRequired

Timeframe

rankingsobject[]Required

Rankings data

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

Rankings data

Last updated