Torn Travel Planner
🤝 Help the community

Boost stock prediction accuracy with a one-click install

Travel Planner depends on abroad shop stock data. The Torn API does not expose this data — the only way to get it is for players to visit shops and report what they see. More contributors = sharper restock predictions = planner recommendations everyone can trust.

Stock snapshots (7 days)
5.6M
From user contributors
2.2K
0.0% of total
Unique items tracked
203
Restock events detected
6.6K
📡

How to install (2 minutes)

One-time setup. Runs automatically whenever you open an abroad shop.

  1. 1
    Desktop: install the Tampermonkey extension in Chrome / Firefox / Edge.
    Mobile: use TornPDA (iOS / Android) — userscript manager is built in. Settings → Userscripts → Add → paste the script URL.
  2. 2
    Click the button below — Tampermonkey will auto-detect the script and prompt to install.
  3. 3
    Open Torn's travel agency / abroad shop page — the script asks for your TORN API KEY (16 characters, Limited Access is enough). It immediately exchanges the key for a panel-issued token via /api/contribute/register and discards the API key. From then on, only the token is used. The widget badge appears at the bottom-right on successful upload.
Advanced: reporter token (optional)Most users skip this — the script auto-handles auth
🔑

Active device tokens

Each script install (desktop / TornPDA / etc.) creates its own token. Revoke individual devices, or generate a new one to paste manually.

Loading…

Adding a token does NOT invalidate existing ones.

FAQ

Is it safe? What gets sent?
Only item name + price + stock count from shops you open on Torn, plus your Torn ID for attribution. No passwords, no personal inventory, no chat / messages. Full data policy.
Torn API key vs Reporter token — what's the difference?
Torn API key (16 chars) is issued by torn.com itself — gives access to your account data via Torn\'s API. The script asks for it ONCE during setup, immediately exchanges it for a Reporter token via our /api/contribute/register endpoint, and discards the API key (unless you keep it for the in-flight detection feature).

Reporter token (32 hex chars) is issued by THIS panel — works only here, only for the contribute endpoints, revocable anytime via Advanced section below. The widget and stock-upload calls use this token, never your Torn API key directly.

You normally see neither — just paste your Torn API key once and forget. The Advanced section exists only if you don\'t want the script to touch your Torn API key at all (paste a manually-generated token instead).
What's in it for me?
Stock predictions in your planner get sharper because the data is fresher. On top of that you automatically contribute to every other user — other Torn players using this planner benefit from your data too. A contributor leaderboard will be added once enough people are participating.
Is it complicated? Any settings to configure?
No. Install once + paste API key the first time — the script runs in the background. You just open shops as usual; the script does its work without you clicking anything.
Does keeping the shop tab open capture more data?
Yes, it really helps. Since v1.2.0, the script auto-rescans every 10 seconds while the shop tab is open. That's 6×/minute resolution — fast enough to capture the restock spike + sellout speed that DroqsDB (7-13 min poll interval) and YATA (3-3.5 min) can't see. The badge shows dwell #2, #3, … every time a stock change is captured. Unchanged stock is not re-uploaded — zero waste.
Does it run on TornPDA (mobile)?
Yes. The script has two extraction modes: strict for desktop Tampermonkey (exact React class-name selectors), loose for TornPDA mobile (heuristic walker that tolerates the different mobile HTML layout). Auto-detects environment; the status badge shows which mode is active (e.g. ✓ 28 Mexico (loose)).
How does it compare to DroqsDB Overseas Stock Reporter?
The DroqsDB script is good and you can run both side-by-side — its data goes to DroqsDB. Our script sends data directly to travel.clovanzo.com with no middleman, so our planner gets realtime updates without waiting for the once-a-minute DroqsDB poll.
Can I uninstall anytime?
Yes. Open Tampermonkey → Dashboard → disable or delete the script. Data you have already contributed stays in the database (anonymized), but no new uploads will be made.

Questions / bug reports → DM clovanzo on Torn.