Skip to main content

Price Variables Reference

This is a complete list of every price variable available in the repricing rule builder. You can use these in conditions (to filter which items a rule applies to) and as the price source in the Set Price action.

All price variables are numeric. Some represent external market prices, others represent data from your own store.


Your Listings

These variables come from your ManaPool store data.

Variable Visual Builder Label Description
CURRENT_PRICE Current Price Your listing's current price on ManaPool. Useful in conditions to target items above or below a threshold, or as a price source to keep the existing price.
CURRENT_QUANTITY Current Quantity How many copies of this card you currently have listed. Use this in conditions, not as a price source. For example, CURRENT_QUANTITY >= 4 could trigger a bulk discount rule.

TCGPlayer

TCGPlayer is one of the largest trading card marketplaces. These variables reflect real-time pricing data from TCGPlayer listings.

Variable Visual Builder Label Description
TCGPLAYER_LOW_NM TCGPlayer Low (NM) The lowest listing price on TCGPlayer for a Near Mint copy. This is the most commonly used price variable — it represents the cheapest NM option a buyer can find on TCGPlayer.
TCGPLAYER_LOW_LP TCGPlayer Low (LP) The lowest listing price on TCGPlayer for a Lightly Played copy.
TCGPLAYER_LOW_WITH_SHIPPING_NM TCGPlayer Low w/ Shipping (NM) The lowest NM listing on TCGPlayer including shipping costs. More accurate for comparing total buyer cost.
TCGPLAYER_LOW_WITH_SHIPPING_LP TCGPlayer Low w/ Shipping (LP) The lowest LP listing on TCGPlayer including shipping costs.
TCGPLAYER_MARKET_NM TCGPlayer Market (NM) TCGPlayer's calculated market price for Near Mint copies. This is a weighted average of recent sales, not just the current lowest listing. It's more stable than the Low price.
TCGPLAYER_MARKET_LP TCGPlayer Market (LP) TCGPlayer's calculated market price for Lightly Played copies.
TCGPLAYER_DIRECT_LOW_NM TCGPlayer Direct Low (NM) The lowest price among TCGPlayer Direct sellers (verified sellers with faster shipping) for Near Mint.
TCGPLAYER_DIRECT_LOW_LP TCGPlayer Direct Low (LP) The lowest TCGPlayer Direct price for Lightly Played.

Which TCGPlayer Variable Should I Use?

  • TCGPlayer Low (NM) is the most popular choice. It lets you compete directly with the cheapest seller.
  • TCGPlayer Market (NM) is more stable. It smooths out temporary price dips from fire sales or listing errors. Good for stores that don't want to chase every price drop.
  • TCGPlayer Low w/ Shipping (NM) is the most accurate comparison for total buyer cost, but it's higher than the plain Low price because it includes shipping.
  • TCGPlayer Direct Low is relevant if your buyers compare you mostly against Direct sellers.

Card Kingdom

Card Kingdom is a major single-seller retailer. Their prices are curated and tend to be more stable than marketplace prices.

Variable Visual Builder Label Description
CARDKINGDOM_RETAIL_NM Card Kingdom Retail (NM) Card Kingdom's retail price for a Near Mint copy. Represents what CK charges buyers.
CARDKINGDOM_RETAIL_LP Card Kingdom Retail (LP) Card Kingdom's retail price for a Lightly Played copy.
CARDKINGDOM_RETAIL_QTY_NM Card Kingdom Qty (NM) Card Kingdom's quantity-adjusted retail price for Near Mint. This factors in their current stock levels.
CARDKINGDOM_RETAIL_QTY_LP Card Kingdom Qty (LP) Card Kingdom's quantity-adjusted retail price for Lightly Played.
CARDKINGDOM_BUYLIST_NM Card Kingdom Buylist (NM) Card Kingdom's buylist price for Near Mint. This is what CK is willing to pay for the card — it's a useful absolute floor reference. If CK buys a card at $5, you probably shouldn't sell it for less.
CARDKINGDOM_BUYLIST_QTY_NM Card Kingdom Buylist Qty (NM) Card Kingdom's buylist quantity for Near Mint. How many copies CK is currently buying.

Card Kingdom Tips

  • CK Buylist makes an excellent natural floor. A rule like LIMIT MIN set to the CK Buylist price ensures you never sell a card for less than what CK would pay you for it.
  • CK Retail tends to track higher than TCGPlayer Low. It's a good reference for premium pricing or as a secondary data point.

ManaPool

ManaPool is HippoLink's own marketplace. These variables reflect prices from other sellers on the platform.

Variable Visual Builder Label Description
MANAPOOL_LOW_NM ManaPool Low (NM) The lowest listing from other ManaPool sellers for Near Mint. Lets you stay competitive within ManaPool specifically.
MANAPOOL_LOW_LP ManaPool Low (LP) The lowest listing from other ManaPool sellers for Lightly Played.
MANAPOOL_MARKET ManaPool Market ManaPool's market price, independent of condition. A general market indicator for the platform.

CardTrader

CardTrader is a European-focused trading card marketplace with a global seller base.

Variable Visual Builder Label Description
CARDTRADER_LOW_NM CardTrader Low (NM) The lowest listing price on CardTrader for a Near Mint copy.
CARDTRADER_LOW_LP CardTrader Low (LP) The lowest listing price on CardTrader for a Lightly Played copy.
CARDTRADER_MEDIAN_NM CardTrader Median (NM) The median listing price on CardTrader for Near Mint. More stable than the low price.
CARDTRADER_MEDIAN_LP CardTrader Median (LP) The median listing price on CardTrader for Lightly Played.

Null Values

Any price variable can be null — meaning the data isn't available. This happens when:

  • A card doesn't exist on a particular marketplace.
  • The marketplace hasn't provided pricing data yet.
  • The card has no listings in the specified condition.

If a price variable is null and your rule uses it as a price source, the rule's price action can't execute. That's why null checks in conditions and FIRST_DEFINED fallback chains in price actions are so important.

Handling Nulls

In conditions: Use an is not null condition to ensure data exists before using it.

IF TCGPLAYER_LOW_NM IS_NOT_NULL AND CONDITION IS 'NM'
THEN SET PRICE TCGPLAYER_LOW_NM

In price actions: Use FIRST_DEFINED to try multiple sources.

SET PRICE FIRST_DEFINED(TCGPLAYER_LOW_NM, CARDKINGDOM_RETAIL_NM, MANAPOOL_LOW_NM, 0.99)

This tries each variable in order and uses the first one that has a value. The final number (0.99) is a hardcoded fallback that's never null. See Building Conditions for more on null checks.


Using Variables in Conditions vs. Actions

Context What You Can Use Example
Condition (IF side) Any price variable with a comparison operator TCGPLAYER_LOW_NM >= 1.00
Set Price (THEN side) Any price variable, a fixed number, or FIRST_DEFINED SET PRICE TCGPLAYER_MARKET_NM
Limit Fixed dollar amounts only LIMIT MIN 0.25 MAX 500.00
Guard Percentage values only GUARD MAX_DECREASE 15%

What's Next