---
title: "Trade in duplicate collectibles for set points"
method: POST
path: "/api/collectible-sets/{setId}/trade-in"
tags: ["Collectibles"]
---

# Trade in duplicate collectibles for set points

`POST /api/collectible-sets/{setId}/trade-in`

## Request

- Base URL: `https://app.d-sports.org`
- URL: `https://app.d-sports.org/api/collectible-sets/{setId}/trade-in`
- Auth: HTTP bearer

Authenticated. Burns quantity extra copies of a set member for set points. Never burns the last copy, a listed or offered copy (lockedBy listing:<id> or offer:<id>, including a whole-row lock), or a minted/minting copy, or a pending/failed mint that already has an Engine job. A pending or failed mint with no Engine job can be burned, and that row is marked burned so it is not submitted. Points are not coins and cannot be converted. The same idempotencyKey replays the stored receipt. A reused key with a different set, card, or quantity is 409 IDEMPOTENCY_KEY_CONFLICT.

## Path parameters

- `setId` string, required

## Request body

- object
  - `collectibleId` string, required
  - `quantity` integer, required
  - `idempotencyKey` string, required

## Response `200`

{ alreadyRecorded, pointsDelta, pointsBalance, setId, collectibleId, quantity, ownedAfter, set, reward }. pointsDelta is positive. reward is set only when this call granted the cosmetic badge.

- object
  - `success` true, required
  - `data` SetPointMutation, required
    - `alreadyRecorded` boolean, required: True when this idempotency key replayed a stored receipt.
    - `pointsDelta` integer, required: Positive on trade-in, negative on redeem. Never zero.
    - `pointsBalance` integer, required
    - `setId` string, required
    - `collectibleId` string, required
    - `quantity` integer, required
    - `ownedAfter` integer, required: Copies of this card the fan holds after the mutation.
    - `set` object, required
      - `setId` string, required
      - `owned` integer, required
      - `total` integer, required
      - `missingCollectibleIds` string[], required
      - `completed` boolean, required
      - `newlyCompleted` boolean, required
    - `reward` object, nullable, required: Set when this call granted the cosmetic badge. Null otherwise.
      - `rewardId` string, required
      - `title` string, required

## Other responses

- `400`: VALIDATION_ERROR — body is not a JSON object, or the card is not in the set, or quantity / idempotencyKey is invalid.
- `401`: Authentication required (UNAUTHORIZED)
- `404`: Collectible set not found or inactive (NOT_FOUND)
- `409`: LAST_COPY, ITEM_LOCKED, COPIES_MINTED, INSUFFICIENT_QUANTITY, or IDEMPOTENCY_KEY_CONFLICT.

## Changes

- **2026-11-18** `6de639c52609`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/changes/api/collectible-sets/:setId/trade-in/post.md)

---

[API](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api.md) - [All operations](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/llms.txt) - [OpenAPI document](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/revisions/63735cf90a04?raw)
