Skip to main content

The card object

Attributes#

id string#

Unique identifier for the object.


name string#

The name of the card.


supertype string#

The supertype of the card, such as Pokémon, Energy, or Trainer.


subtypes list(string)#

A list of subtypes, such as Basic, EX, Mega, Rapid Strike, etc.


level string#

The level of the card. This only pertains to cards from older sets and those of supertype Pokémon.


hp string#

The hit points of the card.


types list(string)#

The energy types for a card, such as Fire, Water, Grass, etc.


evolvesFrom string#

Which Pokémon this card evolves from.


evolvesTo list(string)#

Which Pokémon this card evolves to. Can be multiple, for example, Eevee.


rules list(string)#

Any rules associated with the card. For example, VMAX rules, Mega rules, or various trainer rules.


ancientTrait hash#

The ancient trait for a given card. An ancient trait has the following fields:

PropertyDescription
name stringThe name of the ancient trait
text stringThe text value of the ancient trait

abilities list(hash)#

One or more abilities for a given card. An ability has the following fields:

PropertyDescription
name stringThe name of the ability
text stringThe text value of the ability
type stringThe type of the ability, such as Ability or Pokémon-Power

attacks list(hash)#

One or more attacks for a given card. An attack has the following fields:

PropertyDescription
cost list(string)The cost of the attack represented by a list of energy types.
name stringThe name of the attack
text stringThe text or description associated with the attack
damage stringThe damage amount of the attack
convertedEnergyCost integerThe total cost of the attack. For example, if it costs 2 fire energy, the converted energy cost is simply 2.

weaknesses list(hash)#

One or more weaknesses for a given card. A weakness has the following fields:

PropertyDescription
type stringThe type of weakness, such as Fire or Water.
value stringThe value of the weakness

resistances list(hash)#

One or more resistances for a given card. A resistance has the following fields:

PropertyDescription
type stringThe type of resistance, such as Fire or Water.
value stringThe value of the resistance

retreatCost list(string)#

A list of costs it takes to retreat and return the card to your bench. Each cost is an energy type, such as Water or Fire.


convertedRetreatCost integer#

The converted retreat cost for a card is the count of energy types found within the retreatCost field. For example, ["Fire", "Water"] has a converted retreat cost of 2.


set hash#

The set details embedded into the card. See the set object for more details.


number string#

The number of the card.


artist string#

The artist of the card.


rarity string#

The rarity of the card, such as "Common" or "Rare Rainbow".


flavorText string#

The flavor text of the card. This is the text that can be found on some Pokémon cards that is usually italicized near the bottom of the card.


nationalPokedexNumbers list(integer)#

The national pokedex numbers associated with any Pokémon featured on a given card.


legalities hash#

The legalities for a given card. A legality will not be present in the hash if it is not legal. If it is legal or banned, it will be present.

PropertyDescription
standard stringThe legality ruling for Standard. Can be either Legal, Banned, or not present.
expanded stringThe legality ruling for Expanded. Can be either Legal, Banned, or not present.
unlimited stringThe legality ruling for Unlimited. Can be either Legal, Banned, or not present.

regulationMark string#

A letter symbol found on each card that identifies whether it is legal to use in tournament play. Regulation marks were introduced on cards in the Sword & Shield Series.


images hash#

The images for a card.

PropertyDescription
small stringA smaller, lower-res image for a card. This is a URL.
large stringA larger, higher-res image for a card. This is a URL.

tcgplayer hash#

The TCGPlayer information for a given card. ALL PRICES ARE IN US DOLLARS.

PropertyDescription
url stringThe URL to the TCGPlayer store page to purchase this card.
updatedAt stringA date that the price was last updated. In the format of YYYY/MM/DD
prices hashA hash of price types. All prices are in US Dollars. See below for possible values.

The following price types are available:

normal, holofoil, reverseHolofoil, 1stEditionHolofoil and 1stEditionNormal.

Each price type can have the following fields (all provided via TCGPlayer):

PropertyDescription
low decimalThe low price of the card
mid decimalThe mid price of the card
high decimalThe high price of the card
market decimalThe market value of the card. This is usually the best representation of what people are willing to pay.
directLow decimalThe direct low price of the card

cardmarket hash#

The cardmarket information for a given card. ALL PRICES ARE IN EUROS.

PropertyDescription
url stringThe URL to the cardmarket store page to purchase this card.
updatedAt stringA date that the price was last updated. In the format of YYYY/MM/DD
prices hashA hash of price types. All prices are in Euros. See below for possible values.

The following prices are provided by cardmarket and made available via this API:

PropertyDescription
averageSellPrice decimalThe average sell price as shown in the chart at the website for non-foils
lowPrice decimalThe lowest price at the market for non-foils
trendPrice decimalThe trend price as shown at the website (and in the chart) for non-foils
germanProLow decimalThe lowest sell price from German professional sellers
suggestedPrice decimalA suggested sell price for professional users, determined by an internal algorithm; this algorithm is controlled by cardmarket, not this API
reverseHoloSell decimalThe average sell price as shown in the chart at the website for reverse holos
reverseHoloLow decimalThe lowest price at the market as shown at the website (for condition EX+) for reverse holos
reverseHoloTrend decimalThe trend price as shown at the website (and in the chart) for reverse holos
lowPriceExPlus decimalThe lowest price at the market for non-foils with condition EX or better
avg1 decimalThe average sale price over the last day
avg7 decimalThe average sale price over the last 7 days
avg30 decimalThe average sale price over the last 30 days
reverseHoloAvg1 decimalThe average sale price over the last day for reverse holos
reverseHoloAvg7 decimalThe average sale price over the last 7 days for reverse holos
reverseHoloAvg30 decimalThe average sale price over the last 30 days for reverse holos

Sample JSON#

{
"id": "swsh4-25",
"name": "Charizard",
"supertype": "Pokémon",
"subtypes": [
"Stage 2"
],
"hp": "170",
"types": [
"Fire"
],
"evolvesFrom": "Charmeleon",
"abilities": [
{
"name": "Battle Sense",
"text": "Once during your turn, you may look at the top 3 cards of your deck and put 1 of them into your hand. Discard the other cards.",
"type": "Ability"
}
],
"attacks": [
{
"name": "Royal Blaze",
"cost": [
"Fire",
"Fire"
],
"convertedEnergyCost": 2,
"damage": "100+",
"text": "This attack does 50 more damage for each Leon card in your discard pile."
}
],
"weaknesses": [
{
"type": "Water",
"value": "×2"
}
],
"retreatCost": [
"Colorless",
"Colorless",
"Colorless"
],
"convertedRetreatCost": 3,
"set": {
"id": "swsh4",
"name": "Vivid Voltage",
"series": "Sword & Shield",
"printedTotal": 185,
"total": 203,
"legalities": {
"unlimited": "Legal",
"standard": "Legal",
"expanded": "Legal"
},
"ptcgoCode": "VIV",
"releaseDate": "2020/11/13",
"updatedAt": "2020/11/13 16:20:00",
"images": {
"symbol": "https://images.pokemontcg.io/swsh4/symbol.png",
"logo": "https://images.pokemontcg.io/swsh4/logo.png"
}
},
"number": "25",
"artist": "Ryuta Fuse",
"rarity": "Rare",
"flavorText": "It spits fire that is hot enough to melt boulders. It may cause forest fires by blowing flames.",
"nationalPokedexNumbers": [
6
],
"legalities": {
"unlimited": "Legal",
"standard": "Legal",
"expanded": "Legal"
},
"images": {
"small": "https://images.pokemontcg.io/swsh4/25.png",
"large": "https://images.pokemontcg.io/swsh4/25_hires.png"
},
"tcgplayer": {
"url": "https://prices.pokemontcg.io/tcgplayer/swsh4-25",
"updatedAt": "2021/08/04",
"prices": {
"normal": {
"low": 1.73,
"mid": 3.54,
"high": 12.99,
"market": 2.82,
"directLow": 3.93
},
"reverseHolofoil": {
"low": 3,
"mid": 8.99,
"high": 100,
"market": 3.89,
"directLow": 4.46
}
}
},
"cardmarket": {
"url": "https://prices.pokemontcg.io/cardmarket/swsh4-25",
"updatedAt": "2021/08/04",
"prices": {
"averageSellPrice": 9.38,
"lowPrice": 8.95,
"trendPrice": 10.29,
"germanProLow": null,
"suggestedPrice": null,
"reverseHoloSell": null,
"reverseHoloLow": null,
"reverseHoloTrend": null,
"lowPriceExPlus": 8.95,
"avg1": 9.95,
"avg7": 9.35,
"avg30": 11.31,
"reverseHoloAvg1": null,
"reverseHoloAvg7": null,
"reverseHoloAvg30": null
}
}
}