Burn

Builds a transaction that permanently burns an asset. authority must be the current owner and is the only signer; the asset's rent is returned to them.

Supports nft, pnft, cnft, cnft-v2, core and core-collection. Printed editions can be burned as nft but not as pnft. A compressed NFT that is listed or in an auction can't be burned.

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Permanently destroys an asset and reclaims its rent. Accepts nft, pnft, cnft, cnft-v2, core and core-collection only.

authority*string

Wallet burning the asset (base58). Must be its current owner and is the only signer.

asset*string

Mint/asset address to burn (base58).

tokenStandard*TokenStandard

Asset standard. Solana: nft (Token Metadata), pnft (programmable NFT), cnft and cnft-v2 (compressed NFTs, Bubblegum v1 and v2), core and core-collection (Metaplex Core). Tezos: objkt. EVM: native, erc20, erc721, erc1155. Each endpoint accepts only some of these and returns 400 for the rest.

Value in

"nft"
"core"
"core-collection"
"pnft"
"cnft"
"cnft-v2"
"objkt"
"native"
"erc20"
"erc721"
"erc1155"

targetPriorityFeeLamports?integer

Priority fee per transaction, in lamports. By default it is a cap: mallow pays what the network currently needs, up to this amount (50,000 when omitted). Set exactPriorityFee to pay exactly this amount instead. The fee is never less than 15,000 lamports.

Formatuint64

exactPriorityFee?boolean

Pay targetPriorityFeeLamports exactly instead of treating it as a cap. Defaults to false.

blockhash?string

Recent blockhash to build the transaction with (base58). Omit it to let mallow supply one; identical requests a few seconds apart then return the same transaction.

Response Body

`application/json`

curl -X POST "https://example.com/v2/tx/assets/burn" \  -H "Content-Type: application/json" \  -d '{    "authority": "string",    "asset": "string",    "tokenStandard": "nft"  }'

{  "result": {    "tx": "string"  }}

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

429application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`