/api/v1/mystery/buyback packs:buyback POOL MODEL ONLY — this is the marketplace-offer buyback for partners who hold their OWN inventory in the pool, and it is a different mechanism from the native /sellback/* family above (which is the only sell-back path when you sell CardOS tiers; a TIER-model key calling here gets a 403 "Not available on your plan"). CardOS signs a priced EIP-712 offer against the token; when the holder accepts, CardOS fronts the USDC and the amount lands on your bill (see Billing). Creating an offer again while one is active is idempotent: you get the existing offer back with idempotent: true rather than a re-signed one.
POST /api/v1/mystery/buyback write These inputs are shared across all docs pages, so an id entered here carries over.
{
"token_id": ""
}Not run yet. Press Run to make a live call against https://service.rip.fun (through this demo's server-side proxy; the API key never reaches the browser).
curl -X POST 'https://service.rip.fun/api/v1/mystery/buyback' \
-H 'X-API-Key: rip_…' \
-H 'Content-Type: application/json' \
-d '{"token_id":""}' | Field | Type | Required | Description |
|---|---|---|---|
token_id | string | yes | Card token to offer on |
offer_price_usdc | string | — | Override price — capped at the card's market value |
item_type | string | — | CARD | GRADED_CARD, to disambiguate a token id that exists as both |
data)| Field | Description |
|---|---|
offer_signature / offer_id / deadline | The signed offer and when it expires |
price / price_usdc / seller_receives_usdc / marketplace_fee_usdc | Offer economics (micros + decimals) |
contract_address / requester / target / chain_id | On-chain parties: the marketplace, the signing requester, and the holder |
value_usdc / value_source | The market value the price was derived from (absent on idempotent replay) |
idempotent | true when an existing active offer was returned instead of re-signing |
| Status | Code | When |
|---|---|---|
| 400 | token_required | no token_id |
| 400 | price_too_high | offer_price_usdc exceeds the card's market value |
| 404 | token_not_found | unknown token |
| 409 | value_unknown | the card has no market value to price the offer from |
| 409 | not_eligible | the token is not eligible (burned, frozen, not whitelisted, …) |
| 403 | Not available on your plan | your key is on the TIER model — use /sellback/* instead |
See Errors for the response envelope and the full code list.