Position Management Tools

Advanced Features · Updated 2026-07-27

Ghost Position Detection

  • Wallet Reconciliation: Compare database records with actual blockchain balances
  • Automatic Detection: Identify discrepancies between recorded and actual holdings
  • Smart Analysis: Distinguish between sold tokens and scam/rug pulled tokens
  • Real-Time Sync: Continuous monitoring for position accuracy

Cleanup & Maintenance

  • Clear Dust: Remove positions with negligible value (< $0.01)
  • Clean Ghosts: Resolve positions with zero wallet balance but database records
  • Sync Wallet: Full reconciliation between database and blockchain reality
  • Batch Operations: Efficiently process multiple position corrections
  • Manual Overrides: Tools for correcting complex position discrepancies

Position Recovery

What It Does

Position Recovery scans your wallet for tokens that exist on-chain but don't have corresponding positions in the database. This can happen when:

  • Auto-buys complete but position creation fails (RPC issues)
  • Manual buys made outside the bot (Jupiter web app, Phantom, etc.)
  • System interruptions during trading operations

When to Use

  • After experiencing RPC errors during auto-buys
  • If you notice tokens in your wallet without positions showing in the bot
  • After buying tokens externally that you want to track in ARCHR

How to Access

Positions → 🔧 Recover Positions

Recovery Flow

  1. Scan: Bot scans your wallet for all tokens (dust < $0.01 ignored)
  2. Identify: Compares wallet to database, finds orphan tokens
  3. Select: Shows list of recoverable tokens with status
  4. Confirm: Review entry price data before recovering each token
  5. Create: Position created with recovered entry data

Recovery Types

StatusIconDescription
No Position🔴Token in wallet with no database record
Balance Mismatch⚠️Position exists but balance differs from wallet
Closed (has tokens)🔄Position was closed but tokens remain

What Gets Recovered

  • Entry price: Calculated from on-chain transaction history
  • Token amount: Current wallet balance
  • Buy date: From original transaction timestamp
  • P&L tracking: Starts immediately after recovery

Limitations

  • Airdrops and transferred tokens cannot be recovered (no buy transaction)
  • Historical SOL price uses current price (minor P&L variance possible)
  • Requires valid on-chain buy transaction to determine entry price