Developer API

https://api.hoplex.xyz/public-assets

Service

GET/Service index

Version and canonical links.

Request
GET /public-assets/
GET/v1Version index

Versioned service index.

Request
GET /public-assets/v1
GET/healthHealth

Service status and version.

Request
GET /public-assets/health

Profiles

GET/v1/users/{identifier}User

identifier: username or user ID.

JavaScript
const user = await fetch("https://api.hoplex.xyz/public-assets/v1/users/Builderman").then(r => r.json());
GET/v1/users/{identifier}/profileProfile

Stats, modes, tiers, appearance, guild, matches, and privacy state.

curl
curl https://api.hoplex.xyz/public-assets/v1/users/Builderman/profile
GET/v1/users/{identifier}/headHeadshot

size, format, circular, redirect.

ImageOpen
GET /v1/users/Builderman/head?size=150x150&format=webp&redirect=1
GET/v1/users/{identifier}/avatarAvatar

Full-body thumbnail.

Request
GET /v1/users/Builderman/avatar?format=webp
GET/v1/users/{identifier}/hoplex-avatarHoplex avatar

Equipped Hoplex skin as a transparent 3D bust PNG.

ImageOpen
GET /v1/users/Ggggt444rrr/hoplex-avatar
GET/v1/users/{identifier}/previewPreview

Avatar bust thumbnail.

Request
GET /v1/users/Builderman/preview
GET/v1/users/{identifier}/skinSkin

Roblox avatar appearance.

Request
GET /v1/users/Builderman/skin

Leaderboards

GET/v1/leaderboardsCatalog

Available boards and mode keys.

Request
GET /public-assets/v1/leaderboards
GET/v1/leaderboards/{stat}Standings

stat: catalog key. limit: 1-100. Player entries include avatar links and public tier details; guild entries include their icon, description, level, and XP.

curl
curl "https://api.hoplex.xyz/public-assets/v1/leaderboards/Wins?limit=10"

Resource packs

POST/uploadUpload

JSON body, up to 500 KB.

curl
curl -X POST -H "Content-Type: application/json" -d @pack.json https://api.hoplex.xyz/public-assets/upload
GET/packs/{code}.jsonRaw pack

Stored pack JSON.

Request
GET /public-assets/packs/AB12CD34.json
GET/v1/packsCatalog

page: 1+. limit: 1-250.

Request
GET /v1/packs?limit=25&page=1
GET/v1/packs/{code}Pack

Pack data and version.

Request
GET /public-assets/v1/packs/AB12CD34
GET/v1/packs/{code}/metadataMetadata

Pack metadata without the payload.

Request
GET /public-assets/v1/packs/AB12CD34/metadata
400 Invalid request404 Not found429 Rate limited5xx Retry later