Currency & Economy API (Retail — Patch 12.0.0)

Comprehensive reference for currency, auction house, store, token, trading post, mail, and trade APIs.

Source: https://warcraft.wiki.gg/wiki/World_of_Warcraft_API Current as of: Patch 12.0.0 (Build 65655) — January 28, 2026 Scope: Retail only.

Scope

• •C_CurrencyInfo — Currency data, tracking, backpack display
• •Auction House — Listing, bidding, buying, selling, commodities
• •C_WowTokenPublic / C_WowTokenUI — WoW Token market
• •AccountStore / StorePublic — In-game shop
• •CatalogShop — Catalog shop system
• •C_PerksProgram — Trading Post (Trader's Tender)
• •BlackMarket — Black Market Auction House
• •TradeInfo — Player-to-player trading
• •MailInfo — Mailbox system

C_CurrencyInfo — Currency System

Currency Data

Currency Info Fields

• •name — Currency name
• •description — Description text
• •currencyID — Unique ID
• •iconFileID — Icon texture
• •quantity — Current amount
• •maxQuantity — Max cap (0 = none)
• •canEarnPerWeek — Has weekly cap?
• •quantityEarnedThisWeek — Earned this week
• •maxWeeklyQuantity — Weekly max
• •totalEarned — Total ever earned
• •isTradeable — Can be traded?
• •quality — Item quality
• •isDiscovered — Has been discovered?
• •isShowInBackpack — Shown in Backpack?

Backpack & Tracking

Currency List Management

Gold Functions (Global)

Auction House

Browse & Search

Commodities

Listing & Selling

Bidding & Buying

Own Auctions

Auction House State

C_WowTokenPublic — WoW Token

AccountStore / StorePublic — In-Game Shop

C_PerksProgram — Trading Post

Black Market

Trade (Player-to-Player)

Mail System

Common Patterns

Display Currency with Cap

local function ShowCurrency(currencyID)
    local info = C_CurrencyInfo.GetCurrencyInfo(currencyID)
    if info then
        local text = info.name .. ": " .. info.quantity
        if info.maxQuantity > 0 then
            text = text .. " / " .. info.maxQuantity
        end
        if info.canEarnPerWeek and info.maxWeeklyQuantity > 0 then
            text = text .. " (Weekly: " .. info.quantityEarnedThisWeek .. "/" .. info.maxWeeklyQuantity .. ")"
        end
        print(text)
    end
end

Auction House Search

-- Register for results
local f = CreateFrame("Frame")
f:RegisterEvent("ITEM_SEARCH_RESULTS_UPDATED")
f:SetScript("OnEvent", function(self, event, itemKey, ...)
    local numResults = C_AuctionHouse.GetNumItemSearchResults(itemKey)
    for i = 1, numResults do
        local result = C_AuctionHouse.GetItemSearchResultInfo(itemKey, i)
        if result then
            print(result.buyoutAmount, "copper -", result.quantity, "available")
        end
    end
end)

-- Initiate search
local itemKey = C_AuctionHouse.MakeItemKey(12345) -- itemID
C_AuctionHouse.SendSearchQuery(itemKey, {}, false)

Check WoW Token Price

C_WowTokenPublic.UpdateMarketPrice()

local f = CreateFrame("Frame")
f:RegisterEvent("TOKEN_MARKET_PRICE_UPDATED")
f:SetScript("OnEvent", function()
    local price = C_WowTokenPublic.GetCurrentMarketPrice()
    if price then
        print("WoW Token: " .. GetCoinTextureString(price))
    end
end)

Key Events

Gotchas & Restrictions

1. •Auction House hardware event — Posting, buying, and bidding require hardware events (user clicks).
2. •Commodity vs. item — Commodities (stackable) use a different API path than equipment/unique items.
3. •AH throttling — Searches are rate-limited. Rapid queries get throttled by the server.
4. •Mail COD — COD mail auto-deducts gold when attachment is taken. Test with InboxItemCanDelete().
5. •GetMoney() returns copper — Divide by 100 for silver, 10000 for gold.
6. •Currency caps — Always check maxQuantity and maxWeeklyQuantity before displaying progress.
7. •WoW Token price is async — Call UpdateMarketPrice() then wait for TOKEN_MARKET_PRICE_UPDATED.
8. •ReplicateItems() is slow — Full AH scan is expensive. Use sparingly and handle results incrementally.