Primary Purchase Xerial NFT

Endpoint allows you to purchase Xerial NFTs from specific collections on the Polygon Network.

Overview

Endpoint

• Method: POST

• URL: /wallet/{address}/{chain}/primary-purchase

Parameters

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

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

Request Body

• Media Type: application/json

• Example Value:

{
  "purchases": {
    "collectionAddress": "0xf6797c479c7b18de2ea7493291d5f21fede8ff29",
    "typeId": 2,
    "quantity": 2
  }
}

Responses

Success (Code 200)

{
  "transactionHash": "0xe2e830fcc13af572c0cbe970e69c2ebd873cc85b9984099a072709f1ee62305b"
}

• Media Type: application/json

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

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 buyer 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}/primary-purchase endpoint to initiate the purchase of one or more Xerial NFTs.

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