Update royalty for contract

This guide describes how to add/update the royalties for an NFT contract.

Update royalty for NFT contract

This endpoint is used to add/update the royalties for an NFT contract. You can add a royalty recipient wallet address and specify the royalty percentage. (only for contracts created with the NFT v3)

Request Endpoint: reference

 PUT /api/v3/erc1155/contracts/{chain}/{contractAddress}/royalties

Example Request

 PUT /api/v3/erc1155/contracts/MATIC/0x44260f782c8ae2cf62e31051920d206d19b475e5/royalties

Request Body

Parameter	Param Type	Description	Data Type	Required
`chain`	Path	This is the blockchain of the NFT contract.	String	✅
`contractAddress`	Path	The NFT contract address whose royalties you wish to update.	String	✅
`royalties`	Request Body	The royalties object includes the royalty recipient's wallet address and percentage.	Object	✅
royalties.`receiver`	Request Body	The recipient wallet address where the royalties will be transferred.	String	✅
royalties.`percentage`	Request Body	The percentage royalties that will be paid out automatically with each succeeding sale of an NFT in the secondary market. The royalty percentage can only contain up to 2 decimals.	Number `>= 0 <= 100`	✅

{
    "royalties": {
        "receiver": "0x7312750DF4d2057b758a61C7017729c6Ec9bB3E9",
        "percentage": "2.5"
    }
}

Response Body

👍
You can check the transaction hash in a blockchain explorer to verify that the royalty of the NFT contract was updated successfully.

{
    "success": true,
    "result": {
        "transactionHash": "0x18642e49b6a677d0c431c65d99760e74d0d4393376530c2f0ebbf9881e9f7586"
    }
}

Updated 3 months ago