For the complete documentation index, see llms.txt. This page is also available as Markdown.

Stats Service

Get parcels with peer counts

get
/parcels

Returns a list of parcels with their current peer density information. Parcels represent geographic coordinates in Decentraland, and this endpoint helps identify areas with high user concentration. The peer count for each parcel indicates how many users are currently present in that geographic area, enabling crowd visualization and hotspot detection.

Responses
200

List of parcels with peer counts

application/json
peersCountnumberRequired

Number of peers in this parcel

get/parcels

Get all connected peers

get
/peers

Returns a list of all peers (users) currently active in the archipelago system. Each peer includes their unique identifier, Ethereum address, current position coordinates, assigned island, and last heartbeat timestamp. This endpoint provides a comprehensive view of all active users in the system at any given moment.

Responses
200

List of connected peers

application/json
okbooleanRequired

Success status

get/peers

Get specific peer information

get
/peers/{id}

Returns information about a specific peer

Path parameters
idstringRequired

Peer ID

Responses
200

Peer information

application/json
okbooleanRequired

Success status

get/peers/{id}

Get all islands

get
/islands

Returns a list of all active islands in the archipelago system. Islands are dynamic clusters of peers that are continuously recalculated based on user positions. Each island entry includes the island identifier, current peer count, maximum capacity, center coordinates (x, y, z), radius, and the list of peers currently assigned to that island. Islands are created, merged, and split dynamically to maintain optimal distribution of users across the metaverse.

Responses
200

List of islands

application/json
okbooleanRequired

Success status

get/islands

Get specific island information

get
/islands/{id}

Returns information about a specific island

Path parameters
idstringRequired

Island ID

Responses
200

Island information

application/json
idstringRequired

Island ID

maxPeersnumberRequired

Maximum number of peers allowed

centernumber[]Required

Center coordinates [x, y, z]

radiusnumberRequired

Island radius

get/islands/{id}

Get hot scenes data

get
/hot-scenes

Returns data about popular scenes (hot scenes) in Decentraland based on current user activity. This endpoint provides information about scenes that are currently attracting high user traffic, including scene metadata, user counts, geographic coordinates, thumbnails, and project details. Hot scenes help identify trending areas and popular destinations in the metaverse.

Responses
200

Hot scenes data

application/json
idstringRequired

Scene ID

namestringRequired

Scene name

baseCoordsnumber[]Required

Base coordinates [x, y]

usersTotalCountnumberRequired

Total number of users in scene

thumbnailstringOptional

Scene thumbnail URL

projectIdstringOptional

Project ID

creatorstringOptional

Creator name

descriptionstringOptional

Scene description

get/hot-scenes

Get core service status

get
/core-status

Returns the operational status of the Archipelago core service. The core service is responsible for implementing the archipelago clustering logic, managing island creation/merging/splitting, processing peer position updates, and publishing island change notifications. This endpoint allows monitoring of the core service health and availability.

Responses
200

Core service status

application/json
statusstringRequired

Core service status

timestampstring · date-timeOptional

Status timestamp

get/core-status
Deprecated

Get parcels (backwards compatibility)

get
/comms/parcels

Backwards compatibility endpoint for parcels

Responses
200

List of parcels with peer counts

application/json
peersCountnumberRequired

Number of peers in this parcel

get/comms/parcels
Deprecated

Get peers (backwards compatibility)

get
/comms/peers

Backwards compatibility endpoint for peers

Responses
200

List of connected peers

application/json
okbooleanRequired

Success status

get/comms/peers
Deprecated

Get specific peer (backwards compatibility)

get
/comms/peers/{id}

Backwards compatibility endpoint for specific peer

Path parameters
idstringRequired

Peer ID

Responses
200

Peer information

application/json
idstringRequired

Peer ID

addressstringRequired

Peer address

lastPingnumberRequired

Last ping timestamp

parcelnumber[]Required

Parcel coordinates [x, y]

positionnumber[]Required

Position coordinates [x, y, z]

get/comms/peers/{id}
Deprecated

Get islands (backwards compatibility)

get
/comms/islands

Backwards compatibility endpoint for islands

Responses
200

List of islands

application/json
okbooleanRequired

Success status

get/comms/islands
Deprecated

Get specific island (backwards compatibility)

get
/comms/islands/{id}

Backwards compatibility endpoint for specific island

Path parameters
idstringRequired

Island ID

Responses
200

Island information

application/json
idstringRequired

Island ID

maxPeersnumberRequired

Maximum number of peers allowed

centernumber[]Required

Center coordinates [x, y, z]

radiusnumberRequired

Island radius

get/comms/islands/{id}

Last updated