---
title: "Get marketplace rankings"
method: GET
path: "/v1/rankings/{entity}/{timeframe}"
tags: ["Rankings"]
---

# 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

- `entity` 'collections' | 'creators' | 'items' | 'sellers', required
- `timeframe` 'day' | 'week' | 'month' | 'all', required

## Response `200`

Rankings data

- object
  - `entity` string, required — Entity type
  - `timeframe` string, required — Timeframe
  - `rankings` object[], required — Rankings data

---

[API](https://skmtc.net/decentraland/apis/realm-provider-api.md) · [All operations](https://skmtc.net/decentraland/apis/realm-provider-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/decentraland/realm-provider-api/revisions/d94e0e0f1821/schema)