Active player discovery (site master key):

TornW3B uses the site master API key to download Torn's daily public /v2/user/snapshot CSV of recently active players. That directory seeds names (and null-only faction/company) so unregistered bazaars can be covered — it does not use your personal API key and does not overwrite live status, last-seen activity, or federal-jail fields.

API Endpoint: api.torn.com/v2/user/snapshot

Unregistered Bazaar Scanning:

If enabled, your API key is used to scan bazaars of players who haven't registered with TornW3B. This helps build a more complete database of available items across the entire Torn community.

API Endpoint: api.torn.com/user/{playerId}?selections=profile,bazaar

Item Market Scanning:

If enabled, your API key helps scan item market details for regular items. This is separate from bazaar listings and is used to provide broader market pricing data for the community.

API Endpoint: api.torn.com/market/{itemId}

Ranked Weapon Scanning:

If enabled, your API key is used to fetch detailed stats about ranked weapons across all bazaars. This helps other players find weapons with specific stats they're looking for.

API Endpoint: api.torn.com/v2/torn/{uids}/itemdetails (up to 25 UIDs per call)

Faction Scanning:

If enabled, your API key is used to scan faction member lists. This helps identify active players whose bazaars need timely updates, and the member scan history is also used to infer user activity patterns that are shown in admin-only activity views and heatmaps. The site master key separately downloads Torn's daily faction directory snapshot to keep the faction pool complete.

API Endpoints:

• api.torn.com/v2/faction/{factionID}/members?striptags=true (your key, when faction scanning is enabled)
• api.torn.com/v2/faction/snapshot (site master key, daily directory seed)

Personal Stats:

If enabled, your API key is used to fetch your personal stats once daily. This data is collected for all active users in TornW3B's database and is used to accurately populate leaderboards and each user's personal activity history. The data is public on Torn and includes categories such as drugs used, online activity, and similar statistics.

API Endpoint: api.torn.com/v2/user/personalstats?cat=all

Display Case Scanning:

If enabled, your API key may be used to fetch public display case contents via Torn's user display selection (OpenAPI lists this as a V1 fallback selection, alongside bazaar). Display cases are public on Torn; this opt-in helps catalog collectibles across the community.

API Endpoint: api.torn.com/user/{playerId}?selections=display

Faction Hub Key Contribution (factions.weav3r.dev):

Signing in on the Factions hub may add your API key to that faction's rotation to refresh its Torn data (roster, attacks, and other faction endpoints your key already allows). Keys are never used beyond their permissions and are never sold or shown to other players. For 39th Street factions this can work before the full hub UI is unlocked; other factions will need a separate premium subscription when that product ships.

API Endpoints (examples): api.torn.com/v2/faction/... selections your key allows (such as attacks or members)

Battle Stat Estimates (opt-in / BSS):

If you enable battle-stat estimate features (when available), TornW3B may read your battle stats and attack log to improve fair-fight style estimates for you and consented observers. This only runs while the relevant opt-in is enabled.

API Endpoints:

• api.torn.com/v2/user/battlestats
• api.torn.com/v2/user/attacks

Eliminations (opt-in):

If you enable Eliminations scanning, your API key may be used to read public Torn elimination and elimination-team data so TornW3B can power the Eliminations board and related tooling.

API Endpoints:

• api.torn.com/v2/torn/elimination
• api.torn.com/v2/torn/{id}/eliminationteam

Premium Trade Tools (Paid Beta):

With an active Premium subscription and premium trade sync enabled, your API key reads Torn log entries to build cost basis (including $0 acquires), track sells/consumes, compute FIFO profit, power ledger / overflow / museum views, expand museum set exchanges, and keep receipt trade status in sync. Item-movement pulls only the log groups you enable in Settings (market & bazaar on by default; other groups opt-in). Trade economics use trade logs (category 94). Sync runs only while Premium sync is on and your subscription is active. To save calls, item-movement pulls may skip when you have been offline ~20+ minutes unless you still have an open bazaar with listings; Sync Now, first enable, and truncated catch-up always pull fully. Trade-status sync is not skipped for offline users.

API Endpoints:

• api.torn.com/v2/user/log?log=…&comment=TornW3B (enabled item-movement log types)
• api.torn.com/v2/user/log?cat=94&comment=TornW3B (Trades)