Skip to main content
POST
Scope: nft:orders For a holder with no native coin on the mint chain. The holder signs the quote (a signature, not a transaction, so no gas), you send us that signature, and our wallet sends burnWithQuoteFor(quote, signature, holderSignature). It works for a sell-back quote and for each token’s burn in a paid shipment. The payout or shipment then follows exactly as for a burn the holder sent. How the holder signs: Sell-back.
  • The signature authorizes only that quote: its token, payout, amount and expiry, once. It is checked on chain, so we can’t burn a token without it.
  • We check the burn before sending it, so a refusal sends nothing and burns nothing.
  • Smart-contract wallets (ERC-1271) can sign too.
  • Retrying after a 202 can send a second transaction, which reverts harmlessly with QuoteAlreadyUsed. Follow the quote instead of retrying.
string
required
The token’s decimal token_id.
string
required
The quote to burn with: a sell-back quote_id, or the token’s quote_id in a paid shipment.
string
required
The holder’s EIP-712 signature over the quote exactly as returned, 0x hex.

Response

202. The burn is sent, not yet final. Follow the quote (Get a quote, the sellback.updated webhook) or the shipment as usual.
string
string
The burn transaction on the mint chain.

Errors