Sell back cards

Sell pulled cards back to CatchBack for CatchCoins, at the same rates as every customer.

POST /api/partner/v1/cards/sell-back

cURL

curl -X POST https://catchbackcards.com/api/partner/v1/cards/sell-back \
  -H "Authorization: Bearer $CATCHBACK_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "items": [{ "card_id": "bee48cce-…", "pull_id": "873deb80-…" }] }'

200

{
  "total_paid": 16.2,
  "remaining_balance": 189937,
  "results": [
    {
      "card_id": "bee48cce-…",
      "pull_id": "873deb80-…",
      "status": "sold",
      "transaction_id": "93727497-…",
      "payout_amount": 16.2,
      "payout_rate": 0.9
    }
  ]
}

Scope: sell:cards · MCP tool: sell_back_cards

Pays the same rate a customer gets: the pull’s fresh rate (90%) within 5 minutes of the pull, then 80% of the value at pull for 7 days, then 80% of market value. See Liquidity.

Items run in order, and one failing doesn’t stop the rest. A pull pays out only once: selling it again returns already_sold with the earlier sale, so a retry is always safe. Cards only; sealed packs from consolation pulls can’t be sold back through the API yet. Sell-back is not rate-limited.

items · object[] · required

1–10 cards, each { card_id, pull_id }: the item id and pull_id from Buy packs, or card_id and pull_id from Get vault. A listed card must be delisted first.

Response

total_paid · number

USD credited across all items.

remaining_balance · number

results · object[]

Show result

card_id · string

pull_id · string

status · string

sold, already_sold (paid earlier; the earlier sale is returned), or failed (with error).

transaction_id · string

payout_amount · number

payout_rate · number

error · string

Why it failed, when status is failed.

cURL

curl -X POST https://catchbackcards.com/api/partner/v1/cards/sell-back \
  -H "Authorization: Bearer $CATCHBACK_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "items": [{ "card_id": "bee48cce-…", "pull_id": "873deb80-…" }] }'

200

{
  "total_paid": 16.2,
  "remaining_balance": 189937,
  "results": [
    {
      "card_id": "bee48cce-…",
      "pull_id": "873deb80-…",
      "status": "sold",
      "transaction_id": "93727497-…",
      "payout_amount": 16.2,
      "payout_rate": 0.9
    }
  ]
}