Transfer Xerial NFT

The "Transfer Xerial NFT" endpoint allows you to transfer a specific Xerial NFT from one wallet address to another on the Polygon Network. Use this endpoint to initiate the transfer of an NFT.

Overview

Endpoint

  • Method: POST

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

Parameters

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

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

Request Body

  • Media Type: application/json

  • Example Value:

{
  "collectionAddress": "0xf6797c479c7b18de2ea7493291d5f21fede8ff29",
  "tokenId": 2,
  "to": "0x8e9DD3c1Db3254d968967CbC367542C343273629"
}

Responses

Success (Code 200)

{
  "transactionHash": "0xe2e830fcc13af572c0cbe970e69c2ebd873cc85b9984099a072709f1ee62305b"
}
  • Media Type: application/json

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

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 sender 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}/transfer-nft endpoint to initiate the transfer of an Xerial NFT.

  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 wallet address and blockchain chain are valid. Verify the user's authentication status and permissions before initiating the transfer.

Last updated

Change request #16: lucenaluis137's Dec 28 changes