Sign in
latestOpenAPI 3.1.02026-08-1013317298.0 KB

d94e0e0f1821

Catalog

Get marketplace catalog (v1)

Retrieves the marketplace catalog with items available for browsing and purchase. Supports filtering by category, price range, and various item attributes. Authentication is optional but recommended for personalized results.

Note: Consider using /v2/catalog for enhanced features and performance.

Pagination: Uses first and skip parameters.

This endpoint shares all the same filter parameters as /v1/items, plus catalog-specific options.

get/v1/catalog

Query parameters

firstnumber

Maximum number of items to return (default: 20)

skipnumber

Number of items to skip for pagination (default: 0)

sortBy'newest' | 'recently_sold' | 'cheapest' | 'most_expensive' | 'recently_listed'

Sort results by specified criteria

sortDirection'asc' | 'desc'

Sort direction

onlyListingboolean

Show only items with active listings

onlyMintingboolean

Show only items available for minting

category'wearable' | 'emote'

Filter by NFT category

creatorstring[]

Filter by creator wallet address(es). Can be repeated.

isSoldOutboolean

Filter by sold out status

isOnSaleboolean

Filter by whether item is currently on sale

searchstring

Text search across item names and descriptions

isWearableHeadboolean

Filter for head wearables only

isWearableAccessoryboolean

Filter for accessory wearables only

isWearableSmartboolean

Filter for smart wearables only

wearableCategory'eyebrows' | 'eyes' | 'facial_hair' | 'hair' | 'body_shape' | 'mouth' | 'upper_body' | 'lower_body' | 'feet' | 'earring' | 'eyewear' | 'hat' | 'helmet' | 'mask' | 'tiara' | 'top_head' | 'skin' | 'hands_wear'

Filter by specific wearable category

raritystring[]

Filter by rarity. Can be repeated for multiple rarities.

wearableGenderstring[]

Filter by wearable gender compatibility. Can be repeated.

emoteCategory'dance' | 'stunt' | 'greetings' | 'fun' | 'poses' | 'reactions' | 'horror' | 'miscellaneous'

Filter by emote category

emoteGenderstring[]

Filter by emote gender compatibility. Can be repeated.

emotePlayModestring[]

Filter by emote play mode. Can be repeated.

emoteHasGeometryboolean

Filter for emotes with geometry/props

emoteHasSoundboolean

Filter for emotes with sound

contractAddressstring[]

Filter by collection contract address(es). Can be repeated.

itemIdstring

Filter by specific item ID within a collection

network'ETHEREUM' | 'MATIC'

Filter by blockchain network

minPricestring

Minimum price filter in ETH/MATIC

maxPricestring

Maximum price filter in ETH/MATIC

urnstring[]

Filter by item URN(s). Can be repeated.

idstring[]

Filter by item ID(s). Can be repeated.

Response

Marketplace catalog

totalnumber required

Total number of items