latestOpenAPI 3.1.02026-08-1013317298.0 KB

d94e0e0f1821

Users

Get user's wearables

Retrieves all on-chain wearables owned by a specific Ethereum address. Supports pagination, filtering by category/rarity/name, and sorting. Optionally includes definitions or entity metadata.

get/users/{address}/wearables

Path parameters

addressstring required

Ethereum address (0x-prefixed)

Query parameters

pageNuminteger

Page number (1-indexed)

pageSizeinteger

Number of items per page (max 1000)

categorystring[]

Filter by category (can be specified multiple times)

rarity'common' | 'uncommon' | 'rare' | 'epic' | 'legendary' | 'mythic' | 'unique'

Filter by rarity

namestring

Filter by name (case-insensitive substring match)

orderBy'date' | 'rarity' | 'name'

Sort field

direction'ASC' | 'DESC'

Sort direction

includeDefinitionsboolean

Include item definitions in response

includeEntitiesboolean

Include entity metadata in response (cannot be used with includeDefinitions)

Response

List of user's wearables

totalAmountinteger

Total number of items across all pages

pageNuminteger

Current page number

pageSizeinteger

Number of items per page