ProductListing

One seller's Marketplace listing for a product: price, quantity for sale, the card's condition and language, the seller's photos of the card, and the seller behind it.

comment
Type: stringnullable
required

The seller's note about this listing. null when there is none.
condition
Type: enumnullable
required

The card's condition: NM, LP, MP, HP, or DMG. null when the card is graded or the product is sealed.
values
- NM
  
  Near Mint.
- LP
  
  Lightly Played.
- MP
  
  Moderately Played.
- HP
  
  Heavily Played.
- DMG
  
  Damaged.
finish
Type: string
required

The card's finish, e.g. Standard, Foil, Reverse Holo.
graded
Type: nullable
required

Grading details when the card is graded. null for raw cards and sealed products.

Properties: 3
language
Type: stringnullable
required

The card's language as a two-letter code, e.g. en, fr. null when the listing has no language.
listedAt
Type: stringFormat: date-time
required

When the seller put this listing up.
listingId
Type: string
required

Stable opaque identifier for this listing. Pass it to POST /v1/cart/items to buy from it. Do not parse.
marketPrice
Type: objectnullable
required

The listing's own market price, adjusted for its condition. For a graded card or a sealed product it is the market price of the finish, so the grade is not taken into account. Quoted for the region of deliveryCountry, otherwise of region, otherwise of the seller's own region. null when the finish has no market price in that region.

Properties: 3
photos
Type: array of object
required

Photos the seller attached to this listing, in the order they set. Empty when there are none.

Properties: 3
price
Type:
required

A monetary amount as a decimal in the currency's major unit paired with its currency code — { amount: 14.99, currency: "USD" } means $14.99.

Properties: 2
priceVsMarketPercent
Type: numbernullable
required

How far price is from marketPrice, in percent to one decimal: -12.4 is 12.4 percent below the market price. null when marketPrice is null.
quantity
Type: integer
min:
-9007199254740991
max:
9007199254740991
required

How many units this listing has for sale.
seller
Type: object
required

The seller behind a listing, with their rating and verified sales.

Properties: 7

Examples

{
  "listingId": "665f3a2b1c8d4e9f7a6b5c52",
  "price": {
    "amount": 4.5,
    "currency": "EUR"
  },
  "quantity": 3,
  "condition": "NM",
  "language": "en",
  "finish": "Standard",
  "graded": null,
  "comment": "Pack fresh, straight into a toploader",
  "photos": [
    {
      "url": "https://ik.imagekit.io/cardnexus/cardpicture/2026-06-01T17-40-02-3f9c1a7b2e4d-front.jpg",
      "width": 1600,
      "height": 1200
    }
  ],
  "marketPrice": {
    "amount": 5.1,
    "currency": "EUR",
    "region": "eu"
  },
  "priceVsMarketPercent": -11.8,
  "listedAt": "2026-10-20T14:03:11.000Z",
  "seller": {
    "id": "665f3a2b1c8d4e9f7a6b5c4d",
    "username": "north_arena_tcg",
    "country": "DE",
    "type": "pro",
    "rating": {
      "average": 4.9,
      "count": 214
    },
    "verifiedSalesCount": 1534,
    "shipping": {
      "amount": 3.5,
      "currency": "EUR"
    }
  }
}

ListingSeller

Cart