> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anumaan.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Importing an Existing Wallet

> Use your existing Polygon wallet with anumaan bot

## Overview

If you already have a Polygon wallet with USDC, you can import it into anumaan bot to start trading immediately. This is ideal for experienced users who want to use their existing funds.

<Warning>
  **For experienced users**: Importing a wallet requires your private key. Only proceed if you understand wallet security and private key management.
</Warning>

## Prerequisites

Before importing, make sure you have:

* ✅ A Polygon wallet address
* ✅ The wallet's private key (64 characters, hexadecimal)
* ✅ USDC balance on Polygon network (optional, but needed for trading)

<Note>
  Your wallet must be on the **Polygon network** (not Ethereum mainnet). If your USDC is on Ethereum, you'll need to bridge it first.
</Note>

## How to Import Your Wallet

<Steps>
  <Step title="Start the Import Process">
    When you first use the bot, select **"Import Existing Wallet"** from the welcome message.

    Or use the wallet import command:

    ```bash theme={null}
    /wallet_import
    ```
  </Step>

  <Step title="Prepare Your Private Key">
    Locate your wallet's private key. This is typically:

    * A 64-character hexadecimal string
    * Starting with `0x` (optional)
    * Stored in your wallet application or backup

    **Common wallet apps:**

    * MetaMask: Settings → Security & Privacy → Reveal Private Key
    * Trust Wallet: Wallet → Settings → Show Secret Phrase → View Private Key
    * Hardware Wallet: Export private key through device interface

    <Warning>
      **Critical Security**

      * Only send your private key in a **private chat** with the bot
      * Never share it in groups or with other users
      * Double-check you're messaging the correct bot username
      * Clear the message after successful import if possible
    </Warning>
  </Step>

  <Step title="Submit Your Private Key">
    When prompted, send your private key to the bot. The bot will:

    1. Validate the key format
    2. Derive your wallet address
    3. Link it to your Telegram account
    4. Confirm successful import

    <Info>
      The bot accepts private keys with or without the `0x` prefix.
    </Info>
  </Step>

  <Step title="Verify Import Success">
    After successful import, check your wallet:

    ```bash theme={null}
    /wallet
    ```

    You should see:

    * Your wallet address
    * Current USDC balance
    * Available trading funds

    <Tip>
      If your balance shows \$0, you may need to [fund your wallet](/wallet/funding) with USDC on Polygon.
    </Tip>
  </Step>
</Steps>

## Security Measures

### What Happens to Your Private Key?

When you import a wallet:

1. **Encrypted Storage**: Your private key is encrypted using industry-standard encryption
2. **Secure Operations**: All transactions are signed in a secure enclave
3. **Never Exposed**: The key is never logged, displayed, or transmitted unencrypted
4. **Database Security**: Keys are never stored in plain text

<Warning>
  While we implement strong security, you remain responsible for:

  * Securing your Telegram account (enable 2FA)
  * Keeping your device secure
  * Not sharing bot access with others
</Warning>

### Best Practices

<AccordionGroup>
  <Accordion title="Verify Bot Identity">
    Before sending your private key, verify you're talking to the official bot:

    * Official username: `@anumaan_bot`
    * Check for verified badge (if available)
    * Confirm via official website or social media
  </Accordion>

  <Accordion title="Use a Dedicated Trading Wallet">
    Consider importing a dedicated wallet for bot trading rather than your main wallet:

    * Create a new Polygon wallet
    * Transfer only the USDC you want to trade
    * Import this dedicated wallet to the bot
    * Keep your main funds in a separate wallet
  </Accordion>

  <Accordion title="Enable Telegram 2FA">
    Protect your Telegram account with two-factor authentication:

    * Open Telegram Settings
    * Go to Privacy and Security
    * Enable Two-Step Verification
    * Set a strong password
  </Accordion>

  <Accordion title="Regular Security Audits">
    Periodically check your wallet:

    * Review transaction history on PolygonScan
    * Verify all trades were authorized by you
    * Check balance matches expectations
    * Report any suspicious activity immediately
  </Accordion>
</AccordionGroup>

## Import vs Create New Wallet

| Consideration               | Import Wallet        | Create New Wallet     |
| --------------------------- | -------------------- | --------------------- |
| **Setup Difficulty**        | Moderate             | Easy                  |
| **Requires Private Key**    | Yes                  | No                    |
| **Use Existing USDC**       | Yes                  | No (need to deposit)  |
| **Security Responsibility** | Shared (you + bot)   | Managed by bot        |
| **Best For**                | Experienced users    | Beginners             |
| **Wallet Control**          | Already have control | Bot-managed initially |

## Common Import Scenarios

### Scenario 1: MetaMask User

You have USDC in MetaMask on Polygon network:

1. Open MetaMask
2. Select your account → 3 dots → Account Details
3. Click "Export Private Key"
4. Enter MetaMask password
5. Copy the private key
6. Import to bot using `/wallet_import`

### Scenario 2: Trust Wallet User

You have USDC in Trust Wallet:

1. Open Trust Wallet
2. Go to Settings → Wallets
3. Tap the wallet you want to export
4. Select "Show Recovery Phrase"
5. Use the phrase to derive private key (or use Trust Wallet's export feature)
6. Import to bot

### Scenario 3: Hardware Wallet User

You use a Ledger or Trezor:

1. Connect your hardware wallet
2. Use companion software to export private key
3. Import to bot

<Warning>
  **Hardware Wallet Note**: Importing to the bot means keys leave the hardware wallet's security. Consider using a software wallet instead for bot trading.
</Warning>

## After Importing

Once your wallet is imported:

<CardGroup cols={2}>
  <Card title="Check Your Balance" icon="scale-balanced" href="/wallet/balance">
    Verify your USDC balance was imported correctly
  </Card>

  <Card title="Start Trading" icon="chart-line" href="/trading/placing-trades">
    Begin trading on Polymarket
  </Card>

  <Card title="Set Up Copy Trading" icon="copy" href="/copy-trade/overview">
    Automatically follow successful traders
  </Card>

  <Card title="Subscribe to Alerts" icon="bell" href="/insider/overview">
    Get insider trading notifications
  </Card>
</CardGroup>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Invalid Private Key Error">
    If you get an "invalid private key" error:

    * Ensure the key is 64 hexadecimal characters
    * Remove any spaces or line breaks
    * Try both with and without `0x` prefix
    * Verify you copied the entire key
    * Make sure it's the private key, not the seed phrase
  </Accordion>

  <Accordion title="Balance Shows $0 After Import">
    If your balance is zero after import:

    * Verify you imported the correct wallet address
    * Check your USDC is on Polygon network (not Ethereum)
    * View your address on PolygonScan to confirm balance
    * Wait a few minutes and try `/balance` again
    * Ensure USDC is in the wallet, not wrapped tokens
  </Accordion>

  <Accordion title="Can't Find Private Key">
    If you can't locate your private key:

    * Check your wallet app's export/backup options
    * Look for "Export Private Key" or "Show Secret Phrase"
    * Consult your wallet app's documentation
    * Consider creating a new wallet if key is lost

    <Warning>
      If you've lost your private key and don't have a seed phrase backup, those funds cannot be recovered.
    </Warning>
  </Accordion>

  <Accordion title="Imported Wrong Wallet">
    If you accidentally imported the wrong wallet:

    * Contact support to reset your wallet connection
    * You can then import the correct wallet
    * Note: One wallet per Telegram account
  </Accordion>
</AccordionGroup>

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="Can I import a wallet that's already linked to another bot?">
    Yes! Your wallet can be used with multiple applications simultaneously. Each signs transactions independently.
  </Accordion>

  <Accordion title="Can I switch to a different wallet later?">
    Contact support to disconnect your current wallet and import a different one. You can only have one wallet connected at a time.
  </Accordion>

  <Accordion title="What if I want to remove my wallet from the bot?">
    Contact support to disconnect your wallet. Your funds remain in your wallet; we just remove the connection.
  </Accordion>

  <Accordion title="Can I export my wallet after importing?">
    You already have the private key (you used it to import). You can use it with any Polygon-compatible wallet application.
  </Accordion>
</AccordionGroup>

## Security Reminders

<Warning>
  **Critical Security Tips**

  * ✅ Only send private key in private chat with official bot
  * ✅ Enable 2FA on your Telegram account
  * ✅ Consider using a dedicated trading wallet
  * ✅ Regularly monitor your transaction history
  * ❌ Never share private key in groups
  * ❌ Never share Telegram account access
  * ❌ Don't trust unofficial bots
</Warning>

## Next Steps

Ready to start trading? Learn about:

* [Funding your wallet](/wallet/funding) (if balance is low)
* [Placing trades](/trading/placing-trades)
* [Managing positions](/trading/positions)
* [Copy trading](/copy-trade/overview)
