Skip to main content
Any holder can sell a token back to us for USDC. The flow:
  1. POST /tokens/{tokenId}/quote fixes the amount, the payer and the payout destination for 10 minutes.
  2. The holder burns the token with the quote: on EVM by calling burnWithQuote, on Solana by signing the returned transaction.
  3. We see the burn and send the USDC. Follow it with the sellback.updated webhook or GET /quotes/{quoteId}.

What a sell-back pays

The offer is anchored to the token, not to whoever holds it:
  • A trade changes nothing. A buyer on a secondary market gets exactly the offer the minter would have got.
  • Goods (streetwear, jewelry) never pay more than their value at pull.
  • GET /tokens/{tokenId} shows the phases ahead for any token in sellback.schedule, and GET /wallets/{address}/tokens shows today’s indicative amount for each token a wallet holds. Only a quote fixes the amount.

Get a quote

A quote fixes the amount, the payer and the payout destination, and expires 10 minutes after it is issued, or when the 5-minute fresh window ends if the quote is at the fresh rate (whichever is sooner). Every call issues a new quote; an unused quote just expires. Fields and errors: Quote a sell-back.

EVM: burn with the signed quote

On an EVM program the quote response carries contract, quote and signature:
The holder’s wallet calls burnWithQuote(quote, signature) on contract. tokenId, amount (USDC with 6 decimals) and expiresAt (unix seconds) are decimal strings: convert them to bigints. The Quote tuple, in order:

Check the quote before the customer signs

The quote is an EIP-712 message you can check before asking the customer to sign:

Reverts

The contract checks, in order, and reverts with:

Solana: sign the returned transaction

On a Solana program the quote response carries an unsigned transaction:
transaction moves the asset to our vault, with the quote id as a memo; the holder is its fee payer and only signer. Have the holder’s wallet sign and send it unchanged:
  • It must land before last_valid_block_height (about a minute) and before expires_at. If either passes, get a new quote and sign the new transaction.
  • A transfer into the vault that doesn’t match a valid quote (sent after expiry, from another wallet, without the memo) is not paid: we send the asset back to the wallet it came from.

Follow the payout

GET /quotes/{quoteId} returns the quote with its payout: We count a burn after a few block confirmations (EVM) or finalization (Solana), then pay within minutes. The amount paid is always exactly amount_usd. Every payout status change is also sent as a sellback.updated webhook.