Burn an NFT
/v3/nft/burn
2 credits per API call
Destroy an NFT. Burning the NFT transfers it to an un-spendable blockchain address that no one can access.
This API is supported for the following blockchains:
- Algorand
- BNB Smart Chain
- Celo
- Ethereum
- Harmony
- Klaytn
- KuCoin Community Chain
- Polygon
- Solana
- TRON
- Tezos
- Flare
- Cronos
- Base
- Avalanche
- Fantom
- Optimism
Burning NFTs on Algorand
You can burn only the NFTs that were minted with the address of the manager account specified in the manager parameter in the minting call (see the MintNftExpressAlgorand, MintNftAlgorand, and MintNftAlgorandKMS schemas of the request body).
Burning NFTs on Tezos
You can burn only the NFTs if you are admin or minter of the contract
Signing a transaction
When burning an NFT, you are charged a fee for the transaction, and you must sign the transaction with the private key of the blockchain address from which the fee will be deducted.
Providing the private key in the API is not a secure way of signing transactions, because the private key can be stolen or exposed. Your private keys should never leave your security perimeter. You should use the private keys only for testing a solution you are building on the testnet of a blockchain.
For signing transactions on the mainnet, we strongly recommend that you use the Tatum Key Management System (KMS) and provide the signature ID instead of the private key in the API. Alternatively, you can use the Tatum JavaScript client.
Request
- Base URLhttps://api.tatum.io
- URLhttps://api.tatum.io/v3/nft/burn
- AuthAPI key in header x-api-key
Query parameters
Specifies the testnet type. The default is ethereum-sepolia for Ethereum (ETH) currency and flare-coston for Flare (FLR) currency. Valid testnet types depend on the specified currency.
Type of testnet in query. The default type is based on the currency: ethereum-sepolia for ETH, and flare-coston for FLR. This parameter is valid only for ETH or FLR invocations with a testnet API Key. For mainnet API Key, this value is ignored. The currency/chain must be specified to determine the applicable set of testnet types.
Headers
Type of testnet in header. The default type is based on the currency: ethereum-sepolia for ETH, and flare-coston for FLR. This parameter is valid only for ETH or FLR invocations with a testnet API Key. For mainnet API Key, this value is ignored. The currency/chain must be specified to determine the applicable set of testnet types.
Request body
Example request
{
"chain": "ETH",
"tokenId": "123",
"contractAddress": "0x687422eEA2cB73B5d3e242bA5456b782919AFc85",
"fromPrivateKey": "0x05e150c73f1920ec14caa1e0b6aa09940899678051a78542840c2668ce5080c2",
"fee": {
"gasPrice": "20",
"gasLimit": "40000"
}
}Response
OK
Example response
{
"txId": "c83f8818db43d9ba4accfe454aa44fc33123d47a4f89d47b314d6748eb0e9bc9"
}Changes
No recorded changes to this operation across all 1 revision of this API.