Position Management Tools
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
Scan: Bot scans your wallet for all tokens (dust < $0.01 ignored)
Identify: Compares wallet to database, finds orphan tokens
Select: Shows list of recoverable tokens with status
Confirm: Review entry price data before recovering each token
Create: Position created with recovered entry data
Recovery Types
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
Portfolio Optimization
Position Consolidation: Merge related positions for cleaner tracking
Performance Analysis: Detailed breakdown of successful vs failed positions
Tax Preparation: Export position data for cryptocurrency tax reporting
Historical Tracking: Maintain complete records of all trading activity
Last updated