Skip to main content
POST
Create a sell-back quote

Authorizations

Authorization
string
header
required

Your API key (cb_live_…), sent as a bearer token, with the scope nft:orders. Keep it on your servers: never in a browser, app or wallet. Use a separate key per environment. A request from a country on our sanctions list gets a 403 with Access denied, whether or not it has a valid key. See Authentication and keys.

Scopes

nft:orders

Path Parameters

tokenId
string
required

The token's decimal token_id, on either chain family. Keep it as a string or bigint, never a JS number.

Pattern: ^[0-9]{1,78}$

Body

application/json
holder
string
required

The wallet that holds the token now. Checked on chain.

kind
enum<string>
default:sellback
Available options:
sellback
payout_chain
enum<string>

Default: the token's family (Base for an EVM program, Solana for a Solana program). Solana payouts answer PAYOUT_CHAIN_NOT_ENABLED until they are switched on.

Available options:
evm:8453,
solana:mainnet
payout_address
string

Where the USDC goes. Required when the payout chain isn't your mint chain's family; otherwise defaults to holder.

Response

The quote to burn with.

quote_id
string
required

0x + 64 hex.

chain
string
required

A chain as <family>:<id>: evm:8453 is Base, evm:<chainId> any other EVM chain (e.g. evm:196, X Layer), solana:mainnet Solana. The sandbox uses a public testnet.

Pattern: ^(evm:[0-9]+|solana:(mainnet|devnet))$
Example:

"evm:196"

amount_usd
number
required

Exactly what the payout sends.

expires_at
string<date-time>
required

10 minutes after issue, or the end of the fresh window if sooner.

payout
object
required
family
enum<string>
required
Available options:
evm,
solana
Allowed value: "evm"
contract
string
required

The contract the holder calls burnWithQuote on.

quote
object
required

The EIP-712 Quote struct to pass to burnWithQuote exactly as returned. Domain: name CatchBackCards, version 1, your mint chain id, your contract. kind 1 is a sell-back, 2 a shipment. tokenId, amount (USDC, 6 decimals; "0" for a shipment) and expiresAt (unix seconds) are decimal strings: convert them to bigints.

signature
string
required