TokenPanda 1.4.0 Beta

⚠ TOKENPANDATRAY 1.4.0 BETA IS STRONGLY RECOMMENDED

NOTE: TokenPandaTray is a portable companion app that keeps TokenPanda data synchronized, up to date, and protected.

If you are updating TokenPanda, updating TokenPandaTray to 1.4.0 Beta is strongly recommended.

TokenPanda 1.4.0 introduces realm-aware Purchase History features and Realm autocomplete powered by the new RealmData catalogs synchronized by TokenPandaTray.

Older TokenPandaTray versions remain compatible with TokenPanda 1.4.0 through the legacy fallback system, but some realm-aware functionality may be unavailable or incomplete.

TokenPandaTray fallback support will be removed in the next TokenPanda version. Please update TokenPandaTray to the latest available version to keep full functionality.

View the TokenPandaTray release and release notes

What is TokenPanda?

TokenPanda is an independent addon for World of Warcraft Classic and Retail that displays the current WoW Token price, historical price information, previous-period comparisons, approximate trend projections, alerts, and your own WoW Token Purchase History directly inside the game.

TokenPandaTray is the portable Windows companion application used to synchronize and protect the HistoricalData and RealmData used by the addon.

Current release:

TokenPanda 1.4.0 Beta
TokenPandaTray 1.4.0 Beta

TokenPanda Visual Guide

Click any image to view it at full size.

Main Window	Purchase History	Add / Edit Purchase	Journalator Import
Purchase Markers	Matchbox 2.0	Price Projection	TokenPandaTray

Main features

• Support for World of Warcraft Classic and Retail
• Current WoW Token price
• Historical periods: 3D, 7D, 14D, 1M, 3M, 6M, and ALL
• Previous-period comparison
• Approximate 6- and 12-hour trend projection in the 3D chart
• Extended comparison information across the projected area
• Possible rebound and trend-change detection
• Independent upper and lower notification areas
• Visual alerts for trends, proximity to lows, and new lows
• Minimized, normal, analysis, and integrated views
• Independent saved position for each view
• Matchbox 2.0 Flavor + Region selector
• Independent historical data for Classic and Retail
• Account-wide WoW Token Purchase History
• Automatic capture of successful WoW Token purchases
• Manual Add, Edit, and Delete purchase management
• Journalator CSV import
• Built-in Journalator Import Help
• Optional purchase markers on the historical chart
• Character and Realm purchase metadata
• Realm-aware purchase records
• Realm autocomplete with free-text support
• RealmData synchronization through TokenPandaTray
• Regions: US, EU, KR, and TW
• Eleven supported interface languages

Compatibility

• World of Warcraft Classic
• World of Warcraft Retail
• Windows 10 or Windows 11, 64-bit, for TokenPandaTray
• Regions: US, EU, KR, and TW

Supported interface languages:

enUS · deDE · esES · esMX · frFR · itIT · koKR · ptBR · ruRU · zhCN · zhTW

Installation

1. Install the addon

1. Close World of Warcraft.
2. Extract TokenPanda-1.4.0-beta.zip.
3. Copy the included TokenPanda folder into the appropriate AddOns directory.

Classic:

World of Warcraft/_classic_/Interface/AddOns/

Retail:

World of Warcraft/_retail_/Interface/AddOns/

The final path must be:

Interface/AddOns/TokenPanda/TokenPanda.toc

2. Start TokenPandaTray

1. Download and extract TokenPandaTray-1.4.0-beta.zip.
2. Run TokenPandaTray.exe.
3. Select your World of Warcraft folder.
4. Configure the Classic and Retail regions you want to synchronize.
5. Enable synchronization.

TokenPandaTray is portable and requires no traditional installation.

Open TokenPanda

Enter:

/tokenpanda

or use the minimap icon.

Controls

• Minimap left-click: show or hide TokenPanda
• Minimap right-click: show or hide the menu
• Drag minimap icon: move it
• Minimize button: compact view
• Right-click minimize button: switch between normal and analysis views
• [H]: open Purchase History
• Flavor / Region selector, such as [C · US]: open Matchbox 2.0
• Each main view keeps its own saved position

Chart

Available periods:

3D · 7D · 14D · 1M · 3M · 6M · ALL

• Yellow line: current period
• Red line: previous equivalent period
• Gray line: approximate projected trend
• Purchase marker: optional personal WoW Token purchase indicator

Move the mouse over the graph to inspect contextual information such as:

• date and time
• current-period price
• previous-period price
• absolute and percentage differences
• projected values
• personal Token purchase information

The approximate projection is available in the 3D chart and can display a 6- or 12-hour horizon.

Price and rebound alerts

TokenPanda uses two independent notification areas.

Upper notification

The upper notification focuses on price behavior, including situations such as:

• proximity to a minimum
• reaching a minimum
• detecting a new minimum

Lower notification

The lower notification focuses on chart behavior and rebound/trend signals, including:

• possible upward rebound
• possible downward rebound
• confirmed upward rebound
• confirmed downward trend change

These signals are based on recent historical data and can change when new values arrive.

Purchase History

Click on:

[H]

to open the account-wide WoW Token Purchase History.

Purchase records can include:

• Date
• Time
• Price
• Character
• Realm
• Flavor
• Region
• Origin

TokenPanda can automatically record successful WoW Token purchases after Blizzard confirms the purchase.

Each successful purchase is stored as an independent record.

Add, Edit, and Delete purchases

Add

Use:

[ Add ]

to manually create a purchase record.

Available fields include:

• Date
• Time
• Price
• Character
• Realm

Price can be left blank.

When suitable historical data exists, TokenPanda resolves the most recent historical price at or before the specified purchase timestamp.

It never uses a future historical sample.

Edit

Click an existing Purchase History row to edit it.

Delete

Use the red:

[x]

beside a record.

TokenPanda asks for confirmation before deleting the purchase.

Show purchases on the chart

Purchase History includes:

[ Show on chart ]

When enabled, personal WoW Token purchases can appear on the historical graph as purchase markers.

The marker uses the exact purchase timestamp and can provide contextual information when hovering over the graph.

Journalator CSV import

Purchase History includes:

[ Import ]

to import WoW Token purchase history from Journalator CSV exports.

Typical workflow:

1. Open Journalator.
2. Select WoW Tokens.
3. Choose the desired period.
4. Wait for Journalator to finish loading the requested data.
5. Click Export Results.
6. Copy the CSV.
7. Return to TokenPanda.
8. Open Purchase History.
9. Click Import.
10. Paste the CSV.
11. Import the records.

TokenPanda also includes:

[ ? ]

beside Import to open built-in Import Help.

Journalator may change its interface or workflow in future versions. If the current Journalator interface no longer matches these instructions, refer to the current Journalator documentation.

Realm-aware Purchase History

Purchase records can retain both Character and Realm information.

The Realm field supports autocomplete using available realm information while always remaining a free-text field.

TokenPandaTray 1.4.0 can maintain separate RealmData catalogs for supported Classic and Retail versions across:

US · EU · KR · TW

RealmData improves features such as:

• Realm selection
• Realm autocomplete
• Realm-aware Purchase History metadata

Matchbox 2.0

Press the Flavor + Region selector, for example:

[C · US]

to open Matchbox 2.0.

Available tuples:

Classic

US · EU · KR · TW

Retail

US · EU · KR · TW

Matchbox 2.0 shows:

• available and unavailable data sources
• current WoW client Flavor and Region
• currently displayed data source
• manual selection state

Manual selections remain active only for the current session.

After /reload or a complete restart, TokenPanda returns to the data source matching the current WoW client.

HistoricalData

Modern historical data is stored independently by Flavor and Region:

Data/<Flavor>/<Region>/HistoricalData.lua

Examples:

Data/Classic/US/HistoricalData.lua
Data/Retail/EU/HistoricalData.lua

This keeps Classic and Retail data isolated from each other.

TokenPanda 1.4.0 also includes a neutral root:

HistoricalData.lua

only for legacy TokenPandaTray fallback compatibility.

This legacy fallback path will be removed in the next TokenPanda version.

RealmData

TokenPandaTray 1.4.0 maintains realm catalogs at:

Data/<Flavor>/<Region>/RealmData.lua

These catalogs are maintained independently for supported Classic and Retail versions and regions.

Updating TokenPandaTray to 1.4.0 Beta is strongly recommended so these RealmData files are available to TokenPanda.

TokenPandaTray

TokenPandaTray synchronizes and protects the data used by TokenPanda.

It maintains:

Data/<Flavor>/<Region>/HistoricalData.lua
Data/<Flavor>/<Region>/RealmData.lua

TokenPandaTray can manage multiple Classic and Retail region combinations independently.

Smart mode

Smart mode detects whether World of Warcraft is running.

Normal periodic synchronization can pause while WoW is running and resume when WoW is not running.

Critical data protection remains available independently of the normal synchronization pause.

“No history”

If TokenPanda shows no historical data:

1. Check that TokenPandaTray is running.
2. Confirm synchronization is enabled.
3. Verify the World of Warcraft folder.
4. Verify the correct Classic/Retail Flavor and region.
5. Wait for the first synchronization.
6. Check the current Matchbox 2.0 data source.
7. Use /reload if WoW was already open when the data file changed.

Updating

1. Fully close World of Warcraft and TokenPandaTray.
2. Replace the old TokenPanda addon folder with the new version.
3. Replace the old TokenPandaTray executable with the latest available version.
4. Start TokenPandaTray.
5. Review the configured Classic and Retail regions.
6. Synchronize the enabled data sources.
7. Start World of Warcraft.

Do not mix files from different addon versions.

Common problems

The addon does not appear

Avoid a duplicated folder:

Incorrect: AddOns/TokenPanda/TokenPanda/TokenPanda.toc
Correct:   AddOns/TokenPanda/TokenPanda.toc

Locale keys appear on screen

Fully close WoW, replace the complete addon folder, and restart the game.

The chart does not update

Confirm that TokenPandaTray is synchronizing the correct Flavor and Region.

If Tray still reports that WoW is running after the game closes, restart TokenPandaTray and synchronize again.

Realm autocomplete is unavailable or incomplete

Update TokenPandaTray to 1.4.0 Beta and synchronize the corresponding Classic/Retail + Region tuple.

The Realm field always remains available for manual text entry.

Projection disclaimer

TokenPanda includes approximate value projections intended only to represent a possible trend.

Projected values:

• are not guaranteed future prices
• can change when new historical data is received
• should not be used as the sole basis for a decision

Every decision must be made under the user's own judgment and must not depend exclusively on the trend prediction provided by the addon.

Security and privacy

TokenPandaTray:

• does not request World of Warcraft or Battle.net passwords
• does not sign in to Battle.net
• does not modify the World of Warcraft executable
• does not require an account
• downloads public data and maintains TokenPanda local data files

Bug reports

Use the project's GitHub Issues section.

When reporting a synchronization or data issue, include:

• TokenPanda version
• TokenPandaTray version
• game Flavor: Classic or Retail
• selected region
• whether World of Warcraft was running
• relevant TokenPandaTray log information when available

Independent project

TokenPanda is independent and unofficial.

It is not affiliated with, sponsored by, authorized by, or endorsed by Blizzard Entertainment or by the operators of any public data service used by the project.

World of Warcraft, WoW, and Blizzard Entertainment are trademarks or registered trademarks of Blizzard Entertainment, Inc.

Author

EZ-Mouse Dev.

Obsessed with perfection.