Marketplace and Shops
Last updated
Last updated
Asset Layer allows apps to create and manage listings in order to create marketplaces. By storing listings on Asset Layer, multiple marketplaces can have access to the same listings. This means your assets could be listed for sale on many marketplaces at once.
By default, new listings will be accessible through the . For details on how to use the marketplace, check out Marketplace
Listings are used to list assets for sale in marketplaces. All listings specify an asset for sale, a seller of the asset, a price, and the curency in which that price is denominated. Listings can have one of four statuses: active, inactive, sold, or canceled. An inactive listing can also have a liveTime which specifies when the listing will become active. This is a great way to schedule a release for a new collection.
listingId: a UUID for the listing
assetId: the UUID of the asset being listed
price: the price of the listing in the chosen currency
currencyId: the currency that the listing is priced in if the chosen currency is an app currency
currency: the currency code if the chosen currency is a universal currency (BSV, for example)
appId: the app from which the asset being listed belongs
slotId: the slot from which the asset being listed belongs
collectionId: the collection from which the asset being listed belongs
serial: the serial number of the asset being listed
userId: the user who is selling the asset
status: whether the listing is active, inactive, sold, or canceled
liveTime: date-time when the listing will become or became active
createdAt: date-time when the listing was created
updatedAt: date-time when the listing was last updated
soldTime: date-time when the listing was purchased (if applicable)
Shops are used to make it easy for apps to create storefronts where they are listing new assets for sale. Instead of adding individual assets to a shop the way that listings add individual assets to the marketplace, apps can add shop items to their shop. A shop item specifies a collection and a price. Users can pay the price to get a newly minted asset from the specified collection.
itemId: a UUID for the shop item
collectionId: the colletionId of the shop item
currencyId: the currencyId of the currency the shop item is priced in
price: the price of the shop item
appId: the appId this shop item belongs to
status: active or inactive
paymentUserId: the userId of the user who receives payments when new assets are purchased using this shop item
createdAt: date-time when the listing was created
updatedAt: date-time when the listing was last updated