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 MINset 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
- Date Variables Reference — date-based variables for time-sensitive rules.
- Real-World Examples — complete rules using these variables.