Torn API Guidelines, TOS Table & Safe Trading
Official Torn API permission tiers, third-party TOS requirements, and practical checks to trade with complete peace of mind.
Per the official Torn API Documentation (torn.com/api.html), the Torn API is strictly a one-way read channel. An API key is technically incapable of initiating attacks, spending cash, transferring items, or altering your account.
Torn Trade Hub strictly adheres to Torn third-party developer rules: we never request or require Full Access keys for marketplace or calculator features, never store keys in plain public view, and you can revoke access at any second with 1 click in Torn.
| Torn Key Level | What Torn Data Is Exposed | How Torn Trade Hub Uses It | Hub Requirement | Privacy & Safety |
|---|---|---|---|---|
Public Only Type 0 (Lowest) | Public player identity (Name, Torn ID, Level, Status), public item catalog, item market values, company & faction rosters. | Browse market listings, search live bazaars, view public trader pricelists, calculate museum sets, use margin simulator. | NO KEY REQUIRED | Zero Risk · 100% Public Data |
Minimal Access Type 1 | Public info plus player basic status, travel destination timers, education progress, and basic cooldown indicators. | Basic identity verification and player flight detection. | Optional | Read-Only · No Inventory |
Limited Access HUB RECOMMENDED | Minimal info plus Tradeable Inventory, Bazaar items & prices, weapon/armor displays, and personal stats. Excludes private logs & cash balances. | 1-click Sell Planner (quotes your whole inventory), automatic Bazaar Explorer indexing, $1 bargain radar, and trade partner matching. | DEFAULT FOR SYNC | Read-Only |
Custom Key (v2) Principle of Least Privilege | Exact checkboxes configured by the player in Torn Settings (e.g. only user:inventory and user:bazaar). | Supported 100%! Customize exact data scopes and name the key "Torn Trade Hub" in Torn. | SUPPORTED | Full Player Control |
Full Access Type 3 (Highest) | Limited info plus personal trade logs, event history, messages, bank balances, and attack records. | Never required for trading or browsing. Only used if you choose to activate the optional Profit Ledger to import past trade receipts automatically. | OPTIONAL ONLY | Read-Only (Sensitive Logs) |
Torn City Third-Party API Developer Requirements
Third-party tools may never interact with game actions (e.g. auto-buying items, auto-accepting trades, or auto-reviving). All physical item and cash exchanges occur manually on Torn.com.
Torn enforces a strict ceiling of 100 API calls per minute per player. Hub aggregates requests, caches catalog data, and prevents spam to safeguard your key health.
You can terminate access at any instant. Visit Torn API Preferences and delete or pause the key. It immediately invalidates all connections.
Never give a tool more permission than needed. Hub works flawlessly with a Limited Access key. Never paste a Full Access key unless specifically importing historical logs.
Your API key acts like an authenticating token. We never display your key in client source, never share it with other users, and verify signatures server-side.
If an API key is missing required permissions, Torn responds with Error 16 (Access level not high enough). Hub gracefully handles errors without locking your account.