Substitution macros

${AUCTION_PRICE}

Available since 2.x core

What it expands to

Clearing price in the same currency and units as the bid; the final price after discount.

Expands in nurl, burl, lurl, and adm with the clearing price, in the same currency and units as the bid. Since 2.6-202606 it is defined as the final price after any seller discount.

What to watch for

This is the money macro. Two traps: exchanges may require it encrypted (agree on the scheme out of band), and in first-price auctions the clearing price is the bid, so a bidder that hardcodes second-price assumptions misreads its own win data. Pair it with the discount macros where the exchange applies seller discounts.

Encoding

When a macro rides inside another URL as a query parameter, the expanded value must survive URL parsing: exchanges support suffixed forms like ${AUCTION_PRICE:B64} (base64) where documented, and values containing reserved characters must be percent-encoded. An unencoded expansion is the most common reason a notice URL truncates at the first ampersand.

Related