🤝 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.
- 1Desktop: 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. - 2Click the button below — Tampermonkey will auto-detect the script and prompt to install.
- 3Open 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.
📥Install Stock Reporter Script
File: torn-stock-reporter.user.js · ~21 KB · MIT license
▶⚙ 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).
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.