# Position Management Tools

> Source: https://www.archr.bot/docs/position-tools
> Section: Advanced Features
> Last 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

| Status | Icon | Description |
|--------|------|-------------|
| 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