Scenes

Scene discovery and popularity endpoints

Get hot scenes across all realms

get

Returns up to 100 scenes sorted by total user count across all realms. Each scene includes its ID, name, coordinates, parcels, user count, and realm distribution.

Responses

200

Successful response with list of hot scenes

application/json

Information about a popular scene across all realms

idstringRequired

Unique scene identifier

Example: 0xScene1

namestringOptional

Display name of the scene (may be absent when scene metadata lacks a display title)

Example: Genesis Plaza

baseCoordsnumber[] · min: 2 · max: 2Required

Base coordinates of the scene [x, y]

Example: [0,0]

usersTotalCountnumberRequired

Total number of users across all realms in this scene

Example: 87

thumbnailstring · uriOptional

Optional thumbnail URL for the scene

Example: https://content.decentraland.org/thumbnail.png

400

Bad request

application/json

500

Internal server error

application/json

get/hot-scenes

GET /hot-scenes HTTP/1.1
Host: realm-provider.decentraland.org
Accept: */*

[
  {
    "id": "0xScene1",
    "name": "Genesis Plaza",
    "baseCoords": [
      0,
      0
    ],
    "parcels": [
      [
        0,
        0
      ],
      [
        0,
        1
      ],
      [
        1,
        0
      ],
      [
        1,
        1
      ]
    ],
    "usersTotalCount": 87,
    "realms": [
      {
        "serverName": "main",
        "usersCount": 50
      },
      {
        "serverName": "catalyst-1",
        "usersCount": 37
      }
    ],
    "thumbnail": "https://content.decentraland.org/thumbnail.png"
  }
]