# Getting Started

### **1. Onboarding & Wallet Security**

<figure><img src="/files/Oe2aAf7BI9C15Gq3hNKR" alt=""><figcaption></figcaption></figure>

You can't trade fast if your setup takes ten minutes. Getting started with Viper Bot takes less than 30 seconds.

When you send /start to the bot, you'll be greeted with two options:

<br>

* **Generate Wallet: The bot instantly spits out a fresh Tempo Chain wallet address and the raw Private Key.**
* **Import Wallet: If you already have a burner wallet with pathUSD loaded up, you can paste the private key here to sync it.**

<br>

The PIN System: Crypto is ruthless, and security matters. The moment your wallet is generated or imported, the bot forces you to set a 4-digit PIN. Why? Because we don't display your Private Key on the screen after the first setup step. If someone grabs your phone while Telegram is open, they can't drain your funds. Your keys are encrypted on the backend in an advanced way, and only our bot can sign transactions on your behalf when you interact with the UI.

If you ever need to export that wallet to MetaMask or Phantom later, simply tap the Wallet Details button, click Private Key, and enter your 4-digit PIN to briefly reveal it.

<br>

<figure><img src="/files/9gtgbnkTgFBrojRsk1Kd" alt=""><figcaption></figcaption></figure>

### **2. Funding: You Need pathUSD**

This is the most critical and not so critical step. Viper Bot trades entirely in pathUSD. You cannot buy Enshrined or Uniswap graduated tokens using standard ETH here.

How to fund your Viper Wallet: You don't need to deal with confusing centralized exchanges. We highly recommend using <https://relay.link/bridge/> to bridge directly into Tempo Chain.

1. Open relay.link and connect your primary Web3 wallet.
2. Choose your starting chain (Arbitrum, Base, Optimism, Ethereum, etc.) and your starting token.
3. Set your destination network exactly to Tempo Chain, and specify the output token as pathUSD.
4. In the receiving address bracket, paste the Viper Wallet address the bot just generated for you.
5. Hit bridge.

Transactions on relay.link usually clear within a few sec. Once done, tap the Refresh button on your Viper Bot main menu and you'll see your loaded pathUSD balance turn green.

<br>

<figure><img src="/files/pthmf1peEJRmTz4KkWA3" alt=""><figcaption></figcaption></figure>

### **3. High-Speed Execution & Mechanics**

The core reason people use Viper Bot is because it is stupidly fast.

When you paste a token smart contract (starting with 0x) into the chat, the bot triggers what we call a "parallel sweep." Within milliseconds, it simultaneously figures out exactly where the token is currently trading and drafts a real-time dashboard right in front of you.

**Executing Transactions**

Beneath your dashboard are preset Buy and Sell buttons. If you hit Buy 50 pathUSD, the bot does not ask you "Are you sure?" It just buys.

Fee Routing: Viper Bot charges a flat 1% fee on trading volume. Viper Bot processes your buy or sell transaction at maximum RPC speed.

Viper Bot utilizes a robust async architecture and an expanded database flow capable of handling Multiple concurrent trades at the exact same millisecond. Nobody waits in line.

<br>

<figure><img src="/files/ACvFS96OVURxVCFzcTKT" alt=""><figcaption></figcaption></figure>

### **4. The "Sell & Positions" Portfolio**

Keeping track of your bags shouldn't require opening DexScreener in another tab.

From the Main Menu, hit the 📝 Sell & Positions button. The bot will instantly query the blockchain and return a paginated list of every single token you currently hold in your Viper wallet.

The Positions menu shows:

* Your exact holding amount
* The real-time valuation of that holding in pathUSD
* A live PnL percentage (e.g., +45% 🟩 or -12% 🔻) calculated dynamically from your initial entry price.

If a coin is pumping and you want to lock in profits, simply tap the token from that list. This instantly pulls up the trading dashboard for that specific coin, presenting you with the 25%, 50%, and 100% Sell buttons to sell immediately.

<br>

<figure><img src="/files/gb9QGQ8Tl0VE1SgAR0lZ" alt=""><figcaption></figcaption></figure>

### **5. Referrals & Leaderboards**

We want to reward the community that helps grow the trenches. Viper Bot has a fully integrated viral loop.

Type the /referral command to instantly generate your unique Viper tracking link. When a friend clicks your link, you get an immediate "New Referral!" ping notifying you they joined. Whenever your referrals generate trading volume, a fraction of the collected fees gets funneled back into your wallet every month.

Additionally, every single pathUSD you trade earns you Viper Points. You can track your ranking against other degens by checking the 🏆 Leaderboard in the main menu to see who is pushing the most volume on Tempo Chain.

<br>

<figure><img src="/files/BS3YBXVnRMQuxzAXzEiT" alt=""><figcaption></figcaption></figure>

### **6. Advanced Tools**

* Wallet Updates: Want to start fresh? Hit the Wallet Details menu, click "Update Wallet", and you can safely overwrite your old burner with a newly generated or imported key<br>

* Auto-Orders: Don't sit at your screen all day. Set rigid Market Cap limit orders for buys or sells. The bot's background monitor scans prices every two seconds and will execute your trade flawlessly while you sleep.

* Enshrined Transitions: A massive watch point in Tempo trading is the "migration gap" when a token hits the $15,000+ graduation target and jumps from the launchpad to Uniswap. Viper Bot automatically detects graduation sweeps and recalibrates prices on the fly so you don't stall out during the volatility spike.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://vipertradingbot.gitbook.io/viper-bot/api-reference/readme.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
