TitanStump Travel Advisor v6.3
This script uses the Torn API and YATA API. It does not scrape Torn pages or make automated non-API requests to Torn.
🔑 What is the Torn API key used for?
The API key allows the advisor to read the Torn data it needs to make accurate travel recommendations.
- Loads Torn's item database and current item values.
- Reads your current travel status so the advisor can calculate travel and restock information correctly.
Each user’s API key is stored locally in that individual user’s own browser through Tampermonkey/browser storage. It is not stored by TitanStump.
Use a Limited Access API key. Public Access may not allow the advisor to read your personal travel status, while Full Access is not needed.
The script only makes read-only requests directly to the official Torn API. The API key does not control your account, buy or sell items, send messages, or perform actions on your behalf.
TitanStump Travel Advisor is designed to make foreign travel faster, smarter and more profitable.
The complete smart travel system is now free for everyone.
It works on PC and supported mobile userscript setups.
🆕 What's New in v6.3
• 🧳 Manual travel capacity is now the single source of truth — enter your real capacity once and every recommendation, Smart Score and mixed load uses that value.
• ✅ Removed unreliable automatic capacity detection and its warning messages.
• 🛒 Upgraded Mixed Load Optimiser with a bounded exact optimisation pass and a fast fallback for large stock lists.
• 🔑 More reliable API-key saving through supported userscript-manager storage, with browser storage as a fallback.
• 👁 Added a Show / Hide button so mobile users can confirm that their API key was pasted correctly.
• 📱 Improved compatibility with supported iPhone and mobile userscript setups.
• 🌐 Added request timeouts and clearer network/API error messages.
• ⚡ Prevented duplicate loads and overlapping requests, and improved performance on Torn pages.
• 💾 Safer, size-limited travel history storage.
• 🆓 Removed subscription checks and unlocked the complete advisor for every user.
• 🔒 API keys remain stored locally in the browser or supported userscript manager.
• ✈️ Added selectable Standard, Airstrip, Private and Business flight types.
• 🧠 TST remembers the selected flight type and uses the correct flight time for arrival risk, profit/hour, Smart Trip Score, restock timing and alerts.
• 📊 Updated Top Trades cards with flight type/time, carry amount, cash needed, ROI, stock age, arrival risk, trip profit and profit/hour.
• 💵 Renamed “Torn value” to Market value.
🆓 Full Free Features
• 📍 Live foreign stock data
• 💰 Best Profit / Hour
• 💰 Best Affordable Trip
• 📦 Best Well-Stocked Trip
• ⭐ Smart Trip Score
• 🔎 Full Item Finder with live travel information
• 🌸 Plushie & Flower mode
• 💊 Drug mode
• 📊 Stock level warnings
• 📡 Stock freshness information
• ⏱ Predicted restock times
• ✈ Recommended departure time
• 🛬 Target arrival time
• ⚠ Arrival risk prediction
• 🕒 Torn City Time (TCT) support
• 🧳 User-controlled travel capacity
• ✈️ Standard / Airstrip / Private / Business flight selection
• 🛒 Improved Mixed Load Optimiser
• 🌍 Landed Mode
• 🔔 Opportunity Alerts
• 📈 Local restock learning and predictions
The advisor analyses live foreign stock data and recommends the best country and load based on your selected mode, helping you maximise profits without checking every country manually.
The advisor learns from your local stock history to improve restock predictions over time.
✈️ Flight Type Support
At the top of TST, choose Standard, Airstrip, Private or Business. TST remembers your choice and uses that flight's travel time throughout the calculations.
For example, an Airstrip flight to South Africa uses 3h 17m instead of the Standard 4h 42m. This changes the arrival-risk estimate, Smart Trip Score, profit/hour, restock timing and alerts—not just the text displayed on screen. No extra Torn API calls are needed.
Torn's WLT benefit appears as Private in the Travel Agency, so select Private when that is the flight type you are using.
INSTALL TITANSTUMP TRAVEL ADVISOR
Click below to install:
How to use
• Install the userscript.
• A green ✈️ TST button will appear on Torn.
• Click the TST button.
• Enter your own Personal Torn API Key when prompted.
• The complete smart travel system is available immediately.
• Enter your current travel capacity manually so all recommendations use the correct value.
• Landed Mode requires the appropriate User travel API permission.
• Your API key is stored locally in your browser or supported userscript manager.
• The key is only used to retrieve the Torn data required by the advisor.
Smart Travel System
The advisor doesn't simply show foreign stock. It analyses the available trips using stock levels, item profit, selected flight time, your carrying capacity, stock freshness, predicted restocks and arrival risk.
⭐ Smart Trip Score combines this information to help identify the strongest travel opportunities.
🛒 Mixed Load Optimiser can calculate a profitable combination of different items instead of filling your entire capacity with a single item.
🌍 Landed Mode detects when you are already in a foreign country and recommends what to buy while you are there.
📈 Local Learning combines your stock history to improve restock predictions over time.
🔔 Opportunity Alerts can alert you when a travel opportunity reaches the Smart Score and conditions you choose.
Works On
• PC
• Supported mobile userscript setups
Future Updates
• ⭐ Further Smart Trip improvements
• 📈 Improved prediction accuracy from local history
• 🔧 Additional travel tools and improvements
I'm constantly improving TitanStump Travel Advisor. If you find any bugs or have suggestions for new features, please post them below.
TitanStump Travel Advisor
Travel smarter. Earn more.