curl -X POST https://catchbackcards.com/api/partner/v2/tokens/81264573985362058461377125337283195667/quote \
-H "Authorization: Bearer $CATCHBACK_KEY" \
-H "Content-Type: application/json" \
-d '{ "kind": "sellback", "holder": "0x8f3c...e21a", "payout_chain": "evm:8453", "payout_address": "0x8f3c...e21a" }'
{
"quote_id": "0x5e0c...91ab",
"chain": "evm:196",
"amount_usd": 330,
"expires_at": "2026-11-16T18:30:00.000Z",
"payout": { "chain": "evm:8453", "address": "0x8f3c...e21a" },
"family": "evm",
"contract": "0x7b1e...c0de",
"quote": {
"tokenId": "81264573985362058461377125337283195667",
"kind": 1,
"quoteId": "0x5e0c...91ab",
"holder": "0x8f3c...e21a",
"payoutHash": "0x2c71...",
"amount": "330000000",
"expiresAt": "1795372200"
},
"signature": "0x4a1f...1b"
}
{
"quote_id": "0x5e0c...91ab",
"chain": "solana:mainnet",
"amount_usd": 330,
"expires_at": "2026-11-16T18:30:00.000Z",
"payout": { "chain": "evm:8453", "address": "0x8f3c...e21a" },
"family": "solana",
"collection": "CoLL...",
"asset": "AsSt...",
"vault": "VauL...",
"transaction": "<base64 unsigned transaction>",
"last_valid_block_height": 312345678
}
Tokens & sell-back
Quote a sell-back
A signed sell-back quote (EVM) or an unsigned transaction (Solana) for the holder to burn with. Pays exactly amount_usd in USDC.
POST
/
api
/
partner
/
v2
/
tokens
/
{tokenId}
/
quote
curl -X POST https://catchbackcards.com/api/partner/v2/tokens/81264573985362058461377125337283195667/quote \
-H "Authorization: Bearer $CATCHBACK_KEY" \
-H "Content-Type: application/json" \
-d '{ "kind": "sellback", "holder": "0x8f3c...e21a", "payout_chain": "evm:8453", "payout_address": "0x8f3c...e21a" }'
{
"quote_id": "0x5e0c...91ab",
"chain": "evm:196",
"amount_usd": 330,
"expires_at": "2026-11-16T18:30:00.000Z",
"payout": { "chain": "evm:8453", "address": "0x8f3c...e21a" },
"family": "evm",
"contract": "0x7b1e...c0de",
"quote": {
"tokenId": "81264573985362058461377125337283195667",
"kind": 1,
"quoteId": "0x5e0c...91ab",
"holder": "0x8f3c...e21a",
"payoutHash": "0x2c71...",
"amount": "330000000",
"expiresAt": "1795372200"
},
"signature": "0x4a1f...1b"
}
{
"quote_id": "0x5e0c...91ab",
"chain": "solana:mainnet",
"amount_usd": 330,
"expires_at": "2026-11-16T18:30:00.000Z",
"payout": { "chain": "evm:8453", "address": "0x8f3c...e21a" },
"family": "solana",
"collection": "CoLL...",
"asset": "AsSt...",
"vault": "VauL...",
"transaction": "<base64 unsigned transaction>",
"last_valid_block_height": 312345678
}
Scope:
On an EVM program:
On a Solana program:
nft:orders
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. This endpoint takes no Idempotency-Key.
What the holder does with it: Sell-back.
sellback. Shipments start at Create a shipment.evm:8453 (Base) or solana:mainnet. Default: the token’s family, Base for an EVM program and Solana for a Solana program. Solana payouts answer PAYOUT_CHAIN_NOT_ENABLED until they are switched on.Where the USDC goes. Defaults to
holder when the payout chain is the same family as your mint chain. Required when the payout chain isn’t your mint chain’s family, so today a Solana program sends payout_chain: "evm:8453" with a Base payout_address.Response
201. Both families have:Follow it with Get a quote.
The
Quote tuple: tokenId, kind (1 = sell-back), quoteId, holder, payoutHash, amount (USDC with 6 decimals) and expiresAt (unix seconds). tokenId, amount and expiresAt are decimal strings: convert them to bigints. Pass it exactly as returned.A base64 unsigned transaction that moves the asset to our vault, with the quote id as a memo. The holder is its fee payer and only signer.
Errors
| Status | Code | When |
|---|---|---|
400 | BAD_JSON | The body isn’t JSON |
400 | USE_SHIPMENT_ENDPOINT | kind: "shipment"; shipments start at POST /shipments |
400 | kind is something other than sellback | |
400 | BAD_HOLDER | holder is not a wallet address on your mint chain |
400 | PAYOUT_CHAIN_NOT_SUPPORTED | payout_chain is not evm:8453 or solana:mainnet |
400 | PAYOUT_CHAIN_NOT_ENABLED | Payouts on that chain aren’t switched on yet (today: solana:mainnet) |
400 | BAD_PAYOUT_ADDRESS | No usable payout_address for the payout chain |
403 | NOT_HOLDER | That wallet does not hold the token on chain right now |
403 | WALLET_REFUSED | The holder or payout address failed sanctions screening |
404 | UNKNOWN_TOKEN | No such token on your program’s contract |
409 | TOKEN_NOT_MINTED | The token’s mint hasn’t confirmed yet |
409 | TOKEN_BURNED | The token was already sold back or shipped |
409 | NO_OFFER | The item has no sell-back offer right now |
409 | Your program has no contract yet | |
503 | CHAIN_UNAVAILABLE | We couldn’t read the token’s owner from the chain; retry shortly |
503 | SCREENING_UNAVAILABLE | Wallet screening is briefly unavailable; retry shortly |
curl -X POST https://catchbackcards.com/api/partner/v2/tokens/81264573985362058461377125337283195667/quote \
-H "Authorization: Bearer $CATCHBACK_KEY" \
-H "Content-Type: application/json" \
-d '{ "kind": "sellback", "holder": "0x8f3c...e21a", "payout_chain": "evm:8453", "payout_address": "0x8f3c...e21a" }'
{
"quote_id": "0x5e0c...91ab",
"chain": "evm:196",
"amount_usd": 330,
"expires_at": "2026-11-16T18:30:00.000Z",
"payout": { "chain": "evm:8453", "address": "0x8f3c...e21a" },
"family": "evm",
"contract": "0x7b1e...c0de",
"quote": {
"tokenId": "81264573985362058461377125337283195667",
"kind": 1,
"quoteId": "0x5e0c...91ab",
"holder": "0x8f3c...e21a",
"payoutHash": "0x2c71...",
"amount": "330000000",
"expiresAt": "1795372200"
},
"signature": "0x4a1f...1b"
}
{
"quote_id": "0x5e0c...91ab",
"chain": "solana:mainnet",
"amount_usd": 330,
"expires_at": "2026-11-16T18:30:00.000Z",
"payout": { "chain": "evm:8453", "address": "0x8f3c...e21a" },
"family": "solana",
"collection": "CoLL...",
"asset": "AsSt...",
"vault": "VauL...",
"transaction": "<base64 unsigned transaction>",
"last_valid_block_height": 312345678
}

