Skip to content

Card price

A card price is a CardReference with the following properties added to it:

Property Type Is required Description
currencyCode string Yes Available values: USD, EUR, GBP, CAD, AUD, JPY.
vendor string Yes Available values: TCGplayer.
marketPrice int32 Yes The market price in cents.
lowSellingPrice int32|null No The low selling price in cents.
midSellingPrice int32|null No The mid selling price in cents.
highSellingPrice int32|null No The high selling price in cents.
priceDateTime string Yes An ISO 8601 formatted UTC date/time.
vendorExpansionUrl string|null No
vendorCardUrl string|null No

The price values of a card price are defined by the lowest values across the prices of all its variants.

When used as a file, the card-price suffix is required, e.g., international/base-set/1-102.usd.tcgplayer.card-price.json.

Example

{
  "cardName": "Articuno",
  "expansion": {
    "name": "Fossil",
    "series": "Original Series",
    "tcgRegion": "International",
    "codes": [
        "FO"
    ],
    "releaseDate": "1999-10-10T00:00:00Z",
    "cardNumberRightPart": "62"
  },
  "cardNumber": "2/62",
  "cardNumberSortingOrder": 2,
  "cardRarity": "Rare Holo",
  "isCardRaritySet": true,
  "cardIllustrators": [
    "Mitsuhiro Arita"
  ],
  "currencyCode": "USD",
  "vendor": "TCGplayer",
  "marketPrice": 3011,
  "lowSellingPrice": 1674,
  "midSellingPrice": 2423,
  "highSellingPrice": 5499,
  "priceDateTime": "2021-12-24T09:41:45Z",
  "vendorExpansionUrl": "https://www.tcgplayer.com/search/pokemon/fossil",
  "vendorCardUrl": "https://www.tcgplayer.com/product/106518/pokemon-fossil-articuno-2"
}