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"
    }
}