Sign in
latestOpenAPI 3.1.02026-08-1013317298.0 KB

d94e0e0f1821

Items

List marketplace items

Retrieves items from marketplace collections. Items are templates/blueprints for NFTs in collections (e.g., wearable designs, emote templates).

Filter capabilities:

  • Specific contract address and item ID
  • Category (wearable, emote)
  • Creator addresses (multiple allowed)
  • Sale and sold-out status
  • Text search by name or description
  • Price range filtering
  • Wearable filters: category, gender, head/accessory/smart types
  • Emote filters: category, play mode, sound, geometry
  • Network selection (Ethereum, Polygon)
  • URN and ID filtering

Pagination: Uses first and skip parameters (NOT limit/offset).

Authentication is optional but may provide personalized results including pick statistics.

get/v1/items

Query parameters

firstnumber

Maximum number of items to return (default: 100)

skipnumber

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

category'wearable' | 'emote'

Filter by NFT category

creatorstring[]

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

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 (e.g., "0.1")

maxPricestring

Maximum price filter in ETH/MATIC (e.g., "100")

urnstring[]

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

idstring[]

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

Response

List of items with total count

totalnumber required

Total number of items matching the filters