Transfer NFT

Transfer an NFT between addresses

Transfers an NFT from one address to another.

Endpoint: /game/nft/transfer Method: POST

Request Parameters

{
    nfts: string[];             // Array of NFT contract addresses
    fromAddresses: string[];    // Array of source addresses
    toAddresses: string[];      // Array of destination addresses
    tokenIds: string[];         // Array of token IDs to transfer
    chainId?: string;           // Optional chain ID
}

Success Response

{
	taskId: string;
	data: {
		transactionHash: string; // The hash of the transfer transaction
	}
	status: string;
}

Error Response

{
  error: string;
  details?: any;
}

The `nfts`, `fromAddresses`, `toAddresses`, and `tokenIds` arrays must have the same length. Each index represents a transfer operation.

Example Usage

// Setup request parameters
const timestamp = Date.now().toString();
const body = {
	nfts: ['0x1234567890123456789012345678901234567890'], // NFT contract address
	fromAddresses: ['0xabcdef1234567890abcdef1234567890abcdef'], // Source address
	toAddresses: ['0x0987654321098765432109876543210987654321'], // Destination address
	tokenIds: ['123'], // Token ID to transfer
	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/transfer', body, {
	headers: {
		apikey: apiKey,
		signature: hmac,
		timestamp: timestamp
	}
});

// Process the response
console.log('Transfer Task ID:', response.data.taskId);
console.log('Transaction Hash:', response.data.data.transactionHash);