List Xerial NFT

Endpoint allows you to list a specific Xerial NFT from a collection for sale on the Polygon Network.

Overview

Endpoint

• Method: POST

• URL: /wallet/{address}/{chain}/list-nft

Parameters

• address: (Path Parameter): Seller's wallet address (string).

• chain: (Path Parameter): Blockchain (string). Available values: polygon.

Request Body

• Media Type: application/json

• Example Value:

{
  "collectionAddress": "0xf6797c479c7b18de2ea7493291d5f21fede8ff29",
  "tokenId": 2,
  "price": 10
}

Responses

Success (Code 200)

{
  "transactionHash": "0xe2e830fcc13af572c0cbe970e69c2ebd873cc85b9984099a072709f1ee62305b"
}

• Media Type: application/json

• Example Value: An object containing the transaction hash for the successful listing.

Unauthorized (Code 401)

{
  "code": 401,
  "message": "Please Authenticate"
}

• Media Type: application/json

• Example Value: An error response indicating unauthorized access.

Forbidden (Code 403)

{
  "code": 403,
  "message": "Forbidden"
}

• Media Type: application/json

• Example Value: An error response indicating forbidden access.

Not Found (Code 404)

{
  "code": 404,
  "message": "Wallet Not Found"
}

• Media Type: application/json

• Example Value: An error response indicating that the sender's wallet was not found.

Method Not Allowed (Code 405)

{
  "code": 405,
  "message": "This Method Is Not Supported For Non-Custodial Wallets"
}

• Media Type: application/json

• Example Value: An error response indicating that the method is not allowed for non-custodial wallets.

Precondition Failed (Code 412)

{
  "code": 412,
  "message": "You Don't Have This NFT"
}

• Media Type: application/json

• Example Value: An error response indicating that the seller does not have the NFT.

Internal Server Error (Code 500)

{
  "error": "Internal Server Error"
}

• Media Type: application/json

• Example Value: An error response indicating an internal server error.

Usage

1. Send a POST request to the /wallet/{address}/{chain}/list-nft endpoint to list a specific Xerial NFT for sale.

2. Include the required parameters and request body in the request.

3. Handle the response accordingly based on success, unauthorized access, forbidden access, not found, method not allowed, precondition failed, or internal server error.

Note: Ensure the seller's wallet address and blockchain chain are valid. Verify the user's authentication status and permissions before listing the NFT.