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 2 months ago