Endpoints for leveraging some native blockchain features connected to NFT Marketplaces like on-chain listing of assets to sell or on-chain auction of specific NFTs.
Deploy new smart contract for NFT marketplace logic. Smart contract enables marketplace operator to create new listing for NFT (ERC-721/1155).
Operator can set a fee in percentage, which will be paid on top of the price of the asset.
Listing can be offered for native asset - ETH, BSC, etc. - or any ERC20 token - this is configurable during listing creation.
Once the listing is created, seller must send the NFT asset to the smart contract.
Buyer will buy the asset from the listing using native asset - send assets along the buyAssetFromListing() smart contract call, or via ERC20 token.
Buyer of the listing must perform approval for the smart contract to access ERC20 token, before the actual buyAssetFromListing() method is called.
Once both assets - from buyer and seller - are in the smart contract, NFT is sent to the buyer, price is sent to the seller
and marketplace fee is set to the operator.
This operation deploys a smart contract on the blockchain.
Supported blockchains:
OK
Bad Request. Validation failed for the given object in the HTTP Body or Request parameters.
Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
Forbidden. The request is authenticated, but it is not possible to perform the required operation due to a logical error or invalid permissions.
Internal server error. There was an error on the server while processing the request.
{- "chain": "ETH",
- "feeRecipient": "0x687422eEA2cB73B5d3e242bA5456b782919AFc85",
- "marketplaceFee": 150,
- "fromPrivateKey": "0x05e150c73f1920ec14caa1e0b6aa09940899678051a78542840c2668ce5080c2",
- "nonce": 1,
- "fee": {
- "gasLimit": "40000",
- "gasPrice": "20"
}
}
{- "txId": "c83f8818db43d9ba4accfe454aa44fc33123d47a4f89d47b314d6748eb0e9bc9",
- "failed": false
}
Create new listing on the marketplace. Only marketplace operator can establish those on behalf of the seller of the NFT.
After listing is created, seller must approve the asset for spending to the marketplace smart contract.
Only listing for existing NFTs can be created - seller must be owner of the NFT asset.
Supported blockchains:
You can ignore the above warning, this has no impact on the functionality and is a response of internal transaction
OK
Bad Request. Validation failed for the given object in the HTTP Body or Request parameters.
Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
Forbidden. The request is authenticated, but it is not possible to perform the required operation due to a logical error or invalid permissions.
Internal server error. There was an error on the server while processing the request.
{- "chain": "ETH",
- "contractAddress": "0x687422eEA2cB73B5d3e242bA5456b782919AFc85",
- "nftAddress": "0x687422eEA2cB73B5d3e242bA5456b782919AFc85",
- "seller": "0x687422eEA2cB73B5d3e242bA5456b782919AFc85",
- "erc20Address": "0x687422eEA2cB73B5d3e242bA5456b782919AFc85",
- "listingId": "string",
- "amount": "1",
- "tokenId": "100000",
- "price": "100000",
- "isErc721": true,
- "fromPrivateKey": "0x05e150c73f1920ec14caa1e0b6aa09940899678051a78542840c2668ce5080c2",
- "nonce": 1,
- "fee": {
- "gasLimit": "40000",
- "gasPrice": "20"
}
}
{- "txId": "c83f8818db43d9ba4accfe454aa44fc33123d47a4f89d47b314d6748eb0e9bc9",
- "failed": false
}
Buy listing on the marketplace. Buyer must either send native assets with this operation, or approve ERC20 token spending before using Approve spending for marketplace.
Supported blockchains:
You can ignore the above warning, this has no impact on the functionality and is a response of internal transaction
OK
Bad Request. Validation failed for the given object in the HTTP Body or Request parameters.
Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
Forbidden. The request is authenticated, but it is not possible to perform the required operation due to a logical error or invalid permissions.
Internal server error. There was an error on the server while processing the request.
{- "chain": "ETH",
- "contractAddress": "0x687422eEA2cB73B5d3e242bA5456b782919AFc85",
- "erc20Address": "0x687422eEA2cB73B5d3e242bA5456b782919AFc85",
- "buyer": "0x587422eEA2cB73B5d3e242bA5456b782919AFc85",
- "listingId": "string",
- "amount": "1",
- "fromPrivateKey": "0x05e150c73f1920ec14caa1e0b6aa09940899678051a78542840c2668ce5080c2",
- "nonce": 1,
- "fee": {
- "gasLimit": "40000",
- "gasPrice": "20"
}
}
{- "txId": "c83f8818db43d9ba4accfe454aa44fc33123d47a4f89d47b314d6748eb0e9bc9",
- "failed": false
}
Canceling the auction is only possible for the seller or the operator.
The auction cannot be canceled if a buyer already purchased an NFT.
Once the auction is canceled, the NFT asset is reverted to the seller.
Supported blockchains:
You can ignore the above warning, this has no impact on the functionality and is a response of internal transaction
OK
Bad Request. Validation failed for the given object in the HTTP Body or Request parameters.
Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
Forbidden. The request is authenticated, but it is not possible to perform the required operation due to a logical error or invalid permissions.
Internal server error. There was an error on the server while processing the request.
{- "chain": "ETH",
- "contractAddress": "0x687422eEA2cB73B5d3e242bA5456b782919AFc85",
- "erc20Address": "0x687422eEA2cB73B5d3e242bA5456b782919AFc85",
- "listingId": "string",
- "fromPrivateKey": "0x05e150c73f1920ec14caa1e0b6aa09940899678051a78542840c2668ce5080c2",
- "nonce": 1,
- "fee": {
- "gasLimit": "40000",
- "gasPrice": "20"
}
}
{- "txId": "c83f8818db43d9ba4accfe454aa44fc33123d47a4f89d47b314d6748eb0e9bc9",
- "failed": false
}
Get list of listings in this marketplace.
OK
Bad Request. Validation failed for the given object in the HTTP Body or Request parameters.
Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
Forbidden. The request is authenticated, but it is not possible to required perform operation due to logical error or invalid permissions.
Internal server error. There was an error on the server while processing the request.
curl -i -X GET \ 'https://api-eu1.tatum.io/v3/blockchain/marketplace/listing/{chain}/{contractAddress}/{type}' \ -H 'x-api-key: YOUR_API_KEY_HERE'
[- "12345"
]
Get detail of the specific listing.
OK
Bad Request. Validation failed for the given object in the HTTP Body or Request parameters.
Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
Forbidden. The request is authenticated, but it is not possible to required perform operation due to logical error or invalid permissions.
Internal server error. There was an error on the server while processing the request.
curl -i -X GET \ 'https://api-eu1.tatum.io/v3/blockchain/marketplace/listing/{chain}/{contractAddress}/listing/{id}' \ -H 'x-api-key: YOUR_API_KEY_HERE'
{- "amount": "1",
- "buyer": "0xc21C81ef03f98898Fb155E00C364e8a7b9D158b8",
- "erc20Address": "0xc21C81ef03f98898Fb155E00C364e8a7b9D158b8",
- "isErc721": true,
- "listingId": "12345",
- "nftAddress": "0xc21C81ef03f98898Fb155E00C364e8a7b9D158b8",
- "price": "1.234",
- "seller": "0xc21C81ef03f98898Fb155E00C364e8a7b9D158b8",
- "state": "1"
}
Get fee of the marketplace.
OK
Bad Request. Validation failed for the given object in the HTTP Body or Request parameters.
Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
Forbidden. The request is authenticated, but it is not possible to required perform operation due to logical error or invalid permissions.
Internal server error. There was an error on the server while processing the request.
curl -i -X GET \ 'https://api-eu1.tatum.io/v3/blockchain/marketplace/listing/{chain}/{contractAddress}/fee' \ -H 'x-api-key: YOUR_API_KEY_HERE'
2.25
Get fee recipient of the marketplace.
OK
Bad Request. Validation failed for the given object in the HTTP Body or Request parameters.
Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
Forbidden. The request is authenticated, but it is not possible to required perform operation due to logical error or invalid permissions.
Internal server error. There was an error on the server while processing the request.
curl -i -X GET \ 'https://api-eu1.tatum.io/v3/blockchain/marketplace/listing/{chain}/{contractAddress}/recipient' \ -H 'x-api-key: YOUR_API_KEY_HERE'
{- "address": "0xe6e7340394958674cdf8606936d292f565e4ecc4"
}
Update fee recipient of the marketplace.
Supported blockchains:
OK
Bad Request. Validation failed for the given object in the HTTP Body or Request parameters.
Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
Forbidden. The request is authenticated, but it is not possible to perform the required operation due to a logical error or invalid permissions.
Internal server error. There was an error on the server while processing the request.
{- "chain": "ETH",
- "contractAddress": "0x687422eEA2cB73B5d3e242bA5456b782919AFc85",
- "feeRecipient": "0x687422eEA2cB73B5d3e242bA5456b782919AFc85",
- "fromPrivateKey": "0x05e150c73f1920ec14caa1e0b6aa09940899678051a78542840c2668ce5080c2",
- "nonce": 1,
- "fee": {
- "gasLimit": "40000",
- "gasPrice": "20"
}
}
{- "txId": "c83f8818db43d9ba4accfe454aa44fc33123d47a4f89d47b314d6748eb0e9bc9",
- "failed": false
}
Update fee of the marketplace.
Supported blockchains:
OK
Bad Request. Validation failed for the given object in the HTTP Body or Request parameters.
Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
Forbidden. The request is authenticated, but it is not possible to perform the required operation due to a logical error or invalid permissions.
Internal server error. There was an error on the server while processing the request.
{- "chain": "ETH",
- "contractAddress": "0x687422eEA2cB73B5d3e242bA5456b782919AFc85",
- "marketplaceFee": 150,
- "fromPrivateKey": "0x05e150c73f1920ec14caa1e0b6aa09940899678051a78542840c2668ce5080c2",
- "nonce": 1,
- "fee": {
- "gasLimit": "40000",
- "gasPrice": "20"
}
}
{- "txId": "c83f8818db43d9ba4accfe454aa44fc33123d47a4f89d47b314d6748eb0e9bc9",
- "failed": false
}