Overview

Here are some reminders about the purchase of a NFT for an End User, on both the primary and secondary markets:

1st reminder: in your Eniblock Admin Panel, as an Admin you can create Assets. From an Asset you can then create 1 or several Tokens:

  • If 1 Asset = 1 token, we talk about NFTs (non-fungible tokens)

  • If 1 Asset = x tokens, we talk about SFTs (semi-fungible tokens)

Asset vs token:

  • On the primary market, we talk about Asset, which is off-chain

  • On the secondary market, we talk about token, which is on-chain

When an End User wins an auction for a specific listing:

  • On the primary market: the token is minted for this End User

  • On the secondary market: the token is transferred to the new owner of the token

2nd reminder: once you created an Asset as an Admin, you can sell it on the primary market, we talk about a listing. The only way for the moment to create a listing from a new Asset is to create an auction on the primary market:

  • You define start and end dates (minutes, hours, days). When the end date is reached, the best order buys the NFT.

  • You define a floor price: the first order must be greater or equal to this floor price

The possibility to sell an Asset at a fixed price is on the product roadmap.

3rd reminder: you can offer 2 options to your End Users to place an order for a specific listing on the primary market:

  • The End User can pay in Tezos tokens (XTZ)

  • The End User can pay in EUR by credit card with our third party service Stripe

4th reminder:

  • When the End User places an order in EUR with Stripe, Stripe will contact the End User bank to get an imprint of bank card. Stripe will debit the End User bank account when he wins the auction.

  • When the End User places an order in XTZ, the XTZ listing amount is blocked by the application. If the order is superseded, then the End User recovers his XTZ order amount.

5th reminder: when an End User has a minted token, he can sell it on the secondary market by creating a listing. The only way for another End User to place an order and buy it on the secondary market is with XTZ.

In this page, we will check every steps to offer the possibility to your End Users to buy a NFT, on both the primary and secondary markets.

First we see how to display NFTs collections, listings and a specific listing, and then how an End User can make an order for a specific auction on the primary market and the secondary market.

Display a list of all collections

Use case

Here is an example of a collection: let’s say you run a fantasy football video game and as an Admin you created 2 collections of NFTs: 1 for players and 1 for football clubs.

In your user journey, you can display to your End Users the list of all your collections (example: “Players”, “Clubs”).

API

Here is the link to the API documentation to see the list of all your collections:

https://sandbox.nfts.eniblock.fr/redoc/users-wallets-operations-administration#operation/getCollections

Display the traits from a specific collection

Use case

Say that you are making a fantasy football video game: for a specific collection, let’s say “Players”, you want to be able to access the collection traits.

Reminder: collection traits are the properties that were defined in the smart contract. For instance, for a Player collection, it could be “Football Club”, “Price”, “Position”, “Season”, etc.

In your user journey, you can display to your End Users the list of all the collection traits, so End Users can then change/choose some of them as filters to display listings.

API

Here is the link to the API documentation to see the list of all your collection traits from a specific collection: https://sandbox.nfts.eniblock.fr/redoc/users-wallets-operations-administration#operation/getAllCollectionItem

Display a list of all listings

Reminder, a listing is:

  • An Asset that is currently being sold on the primary market

  • Or a token that is currently being sold on the secondary market

Use case

  • Say you are making fantasy football video game : you want to be able to display to your End Users all the current listings (example: all the listings from the “Players” collection, on the primary market only).

In your user journey, you can display to your End Users all the current listings, but with specific filters like: a specific market (primary or secondary market), a specific collection (“Players” for example), etc.

  • If you want to display the list of all NTFs that are currently for sale for this specific End User, you need to call the endpoint, for each assetId to check one by one if the NFT is for sale (so if there are 5 assetId, you need to call 5 times the following endpoint).

    When calling this endpoint, you will need to query the following parameters:

    • assetId

    • marketType: SECONDARY

    • state: COMING_SOON or LIVE

    • mine: true

    For a given asset, if the response from the endpoint gives result, it means the token is for sale.

API

Here is the link to the API documentation to display a list of all listings, with specific filters:

https://sandbox.nfts.eniblock.fr/redoc/listings-trades#operation/getListings

Display information of a specific listing

Use case

Let’s continue with the fantasy football video game example: when an End User chooses a specific listing on the listing page, you want to be able to display to your End User all the information regarding this specific listing: every value for each property.

For example: “Price” = “1 XTZ”, “Position” = “Striker”, “Season” = “2022”, etc.

API

Here is the link to the API documentation to display information of a specific listing:

https://sandbox.nfts.eniblock.fr/redoc/listings-trades#operation/getListingDetail

Display a list of the current orders for a specific listing

Use case

Say your are making a fantasy football video game: when an End User chose a specific listing on the listing page, you want to be able to display to your End User all the current orders regarding this specific listing.

For example, if there is one current order on the listing, you want to display specific information like the End User account name who made the order, the price and the daytime.

API

If we want to identify the auction winner, we need to query with the following parameters: "type": "CASH_HOLDER" in order to get the accountName and the transactionHash.

Here is the link to the API documentation to display a list of the current orders for a specific listing:

https://sandbox.nfts.eniblock.fr/redoc/listings-trades#operation/getOrderPayments

How to place a new order for this listing?

When an End User chooses a specific Asset/token on the listing page, if the Asset/token is currently for sale, as an End User you want to be able to place a new order for this specific listing.

→ Whether an End User wants to place an order in EUR or in XTZ, the user journey is different.

Here are the detailed user journey for each of those currencies:

Here are some actions that are needed for both user journeys (placing an order in EUR or XTZ):

Get the minimum order price

Use case

To offer your End Users a smooth user experience, when your End Users place an order, we advise you to compare in your front-end the amount of the order with the current listing price. Like we just saw before, the End User order must be:

  • greater or equal than the current price if this is the first order for this specific Asset/token,

  • greater than the current price if there is at least 1 order for this specific Asset/token.

Otherwise, the End User should not be able to place an action.

We will see it later but when the endpoint to create an order is called, the back-end checks the order price with the current listing price.

API

Here is the link to the API documentation to get a minimum order price for a specific listing:

https://sandbox.nfts.eniblock.fr/redoc/listings-trades#operation/computeAuctionOrderMinimumPrice

Convert EUR amount in XTZ and vice versa

Use case

To offer your End Users a smooth user experience, when your End Users place an order, we advise you to convert it in the other currency. If the order is in EUR, you can display the price in XTZ and conversely if the order is in XTZ, you can display the price in EUR.

  • As an End User, when I type an amount in XTZ to withdraw to an external Tezos wallet, I might want to be able to check how much is this amount in EUR.

  • When an End User places an order in EUR (by credit card) for a specific listing, he can wonder how much it is worth in XTZ and conversely

  • when an End User places an order in XTZ for a specific listing, he can wonder how much it is worth in EUR.

API

Here is the link to the API documentation to convert a price in another specific currency:

https://sandbox.nfts.eniblock.fr/redoc/listings-trades#operation/getExchangeRate

Calculate the fees

Display the list of all order(s) for this specific End User

Use cases

  • As an End User, I want to be able to check the list of all my orders(s).

  • As an End User, I want to be able to check all my current orders and probably sort them by superseded or still winning the auction.

This list is of course not mandatory but highly recommended for a smooth End User experience.

When you display the list of his orders for a specific End User, you have the possibility to make the difference between orders that are currently winning the listing and the others that have been superseded.

API

Here is the link to the API documentation to check the list of all order(s) of a specific user:

https://sandbox.nfts.eniblock.fr/redoc/listings-trades#operation/getOrdersByAccountId