List a card

Put a card you hold up for sale on the CatchBack marketplace at a fixed price.

POST /api/partner/v1/listings

cURL

curl -X POST https://catchbackcards.com/api/partner/v1/listings \
  -H "Authorization: Bearer $CATCHBACK_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "card_id": "0e94dc61-…", "price": 45 }'

200

{ "listing_id": "5f1c…", "card_id": "0e94dc61-…", "price": 45 }

Scope: write:listings · MCP tool: list_card

Runs the same listing rules as our app: you must hold the card, the price must be above the marketplace minimum and at most 2x the card’s market value, and the title is the card’s name. A listed card can’t be sold back until you delist it.

card_id · string · required

A card_id from Get vault.

price · number · required

Asking price in USD.

Response

listing_id · string

card_id · string

price · number

cURL

curl -X POST https://catchbackcards.com/api/partner/v1/listings \
  -H "Authorization: Bearer $CATCHBACK_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "card_id": "0e94dc61-…", "price": 45 }'

200

{ "listing_id": "5f1c…", "card_id": "0e94dc61-…", "price": 45 }