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
chevron-right
200

List of parcels with peer counts

application/json
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
chevron-right
200

List of connected peers

application/json
get
/peers

Get specific peer information

get
/peers/{id}

Returns information about a specific peer

Path parameters
idstringRequired

Peer ID

Responses
chevron-right
200

Peer information

application/json
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
chevron-right
200

List of islands

application/json
get
/islands

Get specific island information

get
/islands/{id}

Returns information about a specific island

Path parameters
idstringRequired

Island ID

Responses
chevron-right
200

Island information

application/json
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
chevron-right
200

Hot scenes data

application/json
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
chevron-right
200

Core service status

application/json
get
/core-status
Deprecated

Get parcels (backwards compatibility)

get
/comms/parcels

Backwards compatibility endpoint for parcels

Responses
chevron-right
200

List of parcels with peer counts

application/json
get
/comms/parcels
Deprecated

Get peers (backwards compatibility)

get
/comms/peers

Backwards compatibility endpoint for peers

Responses
chevron-right
200

List of connected peers

application/json
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
chevron-right
200

Peer information

application/json
get
/comms/peers/{id}
Deprecated

Get islands (backwards compatibility)

get
/comms/islands

Backwards compatibility endpoint for islands

Responses
chevron-right
200

List of islands

application/json
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
chevron-right
200

Island information

application/json
get
/comms/islands/{id}

Last updated