PLYR GAMING UNIVERSE
  • API Endpoint
  • API Quickstart
  • API REFERENCE
    • Users
      • Authentication
        • PLYR[ID]
          • Login
          • Login and Approve
          • Logout
        • InstantPlayPass
          • RegisterIPP
          • RevealClaimingCode
          • VerifyClaimingCode
        • PLYR[CONNECT]
      • Check Session JWT
      • Get Basic User Info
      • Get Avatar
    • Game room
      • Create Game Room
      • Join Game Room
      • Pay Game Room
      • Earn Game Room
      • Leave Game Room
      • End Game Room
      • Helpers
        • Is Joined Game Room
        • Join and Pay
        • Earn and Leave
        • Create, Join and Pay
        • Earn, Leave and End
    • Assets
      • Tokens ( ERC-20 )
        • Get PLYR L1 Token List
        • Get User Token Balance
        • Get User Token Allowance
        • Approve User Token Spending
        • Revoke User Token Allowance
        • In-Game Chips
          • Create Chip
          • Mint Chip
          • Burn Chip
          • Transfer Chip
          • Get Chip Balance
          • Get Chip Info
      • NFTs ( ERC-721 )
        • Create NFT
        • Mint NFT
        • Transfer NFT
        • Burn NFT
        • Get NFT Balance
        • List NFTs
        • Check NFT Holding
        • Get NFT Credit
        • Get NFT Info
        • Get Zoo Genes
        • Official PLYR NFTs
          • Get User Zoo Genes
          • Get User Zoo Boosters
          • Get User Zoo Elixirs
      • Badge
        • Create Badge
        • Mint Badge
        • Remove Badge
        • Burn Badge
        • Transfer Badge
        • Get Badge Balance
        • List Badges
        • Get Badge Info
        • Get Badge Count
        • Get Badge by ID
        • Get Badge Owner
        • Check Badge Burn Status
    • Misc
      • Get Session JWT Public Key
      • Verify JWT Locally
      • Activity Logs
      • Get Task Message Status
Powered by GitBook
On this page
  1. API REFERENCE
  2. Assets
  3. NFTs ( ERC-721 )

Burn NFT

Burn (destroy) an NFT

Burns (destroys) an NFT, removing it from circulation permanently.

Endpoint: /game/nft/burn Method: POST

{
    nfts: string[];            // Array of NFT contract addresses
    tokenIds: string[];        // Array of token IDs to burn
    chainId?: string;          // Optional chain ID
}
{
	taskId: string;
	data: {
		transactionHash: string; // The hash of the burn transaction
	}
	status: string;
}
{
  error: string;
  details?: any;
}

The `nfts` and `tokenIds` arrays must have the same length. Each index represents a burn operation.

Example Usage

// Setup request parameters
const timestamp = Date.now().toString();
const body = {
	nfts: ['0x1234567890123456789012345678901234567890'], // NFT contract address
	tokenIds: ['123'], // Token ID to burn
	chainId: '43114' // Avalanche C-Chain
};

// Generate HMAC signature
const hmac = generateHmacSignature(timestamp, body, secretKey);

// Make the API request
const response = await axios.post(apiEndpoint + '/game/nft/burn', body, {
	headers: {
		apikey: apiKey,
		signature: hmac,
		timestamp: timestamp
	}
});

// Process the response
console.log('Burn Task ID:', response.data.taskId);
console.log('Transaction Hash:', response.data.data.transactionHash);
PreviousTransfer NFTNextGet NFT Balance

Last updated 12 days ago