> For the complete documentation index, see [llms.txt](https://docs.spartabot.pro/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.spartabot.pro/getting-started/gasless-spam.md).
# 📈 Gasless Spam
***
#### Ethereum Spam
Ethereum Spam is Sparta’s pre-launch buy tool for tokens that are not yet fully tradeable. It allows you to prepare a buy from an existing Ethereum trade wallet. Sparta then monitors the token and automatically attempts to land the transaction as soon as the token becomes tradeable.
You can access Spam from the Ethereum terminal under `/eth/spam`.
**What Spam Is For**
Use Spam when you want to prepare your buy **before** a token has a live pool or before trading opens. Instead of manually refreshing and racing to buy at launch, you configure the token, wallet, buy amount, gas, and entry behavior once. Sparta handles the rest by monitoring the token and submitting your prepared transaction at the earliest possible moment.
**Wallet Selection**
Each Ethereum spam job uses **one Ethereum trade wallet**.
You can select any existing ETH trade wallet from your managed wallets. The selected wallet must hold enough ETH to cover:
* The configured buy amount
* Estimated transaction gas
* Any additional reserves required by the chosen spam mode
**Only one active Ethereum spam job is allowed at a time.** To start a new spam job, the current one must be completed, failed, or stopped.
**Token Selection**
Paste the Ethereum token contract address into the **Contract** field and click **Check**.
Sparta will look up the token and display available limit information, including:
* Max Wallet
* Max TX
* Whether limits appear disabled or unavailable
You must select a valid token before starting a spam job.
**Buy Amount**
The buy amount sets the ETH cap for the spam transaction.
Quick preset options are available:
* 0.01 ETH
* 0.2 ETH
* 0.3 ETH
* 0.5 ETH
* 0.75 ETH
* Custom
In target-based modes (Max Wallet, Max TX, Custom %), this value represents the **maximum ETH** you are willing to spend to reach the target token amount. In **ETH Amount** mode, this is the exact ETH amount to spend.
**Target Modes**
The target toggle lets you cycle through the available modes:
**Max Wallet** Attempts to buy up to the token’s readable maximum wallet limit. Requires Sparta to detect a valid max wallet value.
**Max TX** Attempts to buy up to the token’s readable maximum transaction limit. Requires Sparta to detect a valid max transaction value.
**Custom %** Attempts to buy a specified percentage of the total token supply. Use the **Buy Percentage** field (must be > 0 and ≤ 100).
**ETH Amount** Spends exactly the configured ETH amount instead of targeting a token amount. Top Up mode is disabled in this setting.
**Gas**
The **Gwei** field sets the priority fee for the prepared transaction. Higher gas settings improve your job’s priority when Sparta bundles eligible spam transactions.
Sparta also automatically factors in current and projected base fees when finalizing the transaction.
**Entry Mode**
**Live Window** Sparta waits for the token to become tradeable, then attempts to land the transaction during the initial launch window. The job may fail if it does not land shortly after trading opens.
**Until Entry** Sparta continues attempting the transaction after the token becomes tradeable until it lands, you stop the job, or the spam job expires.
**Transaction Mode**
**Hybrid** (Default) Sparta prepares the transaction via the Sparta Ethereum spam route and submits eligible jobs through hybrid methods when the token becomes tradeable.
**Whitelist** Uses the direct Uniswap V2-style route, suitable for whitelist-style launches. This mode may require higher balance reserves for fees and post-buy handling.
**Top Up Mode**
**Normal** Sparta submits only the initial spam buy.
**Top Up (3)** After the first buy lands, Sparta checks the received token amount. If it is below the target, it will automatically submit up to three additional buys to top up toward the configured target.
Top Up is only available for target-based modes (Max Wallet, Max TX, Custom %). It is disabled for **ETH Amount** mode.
**Starting Spam**
To start an Ethereum spam job:
1. Connect your wallet.
2. Select one Ethereum trade wallet.
3. Paste and check the token contract.
4. Set the buy amount.
5. Choose the target mode.
6. Set your gas (Gwei).
7. Select Entry Mode, Transaction Mode, and Top Up behavior.
8. Click **Start Spam**.
Once started, Sparta creates an active job and begins monitoring the token.
* If it fails, expires, loses nonce eligibility, or the wallet has insufficient funds, the job is marked **Failed** or **Errored**.
**Stopping Spam**
Click **Stop** on the active job to cancel it.
This marks the job as stopped and prevents further submission attempts. If a transaction was already broadcast, Sparta may briefly continue watching for a receipt.
**Common Error States**
* **Select an ETH spam wallet** — No valid Ethereum trade wallet selected.
* **Select a token contract** — No valid token contract selected.
* **Select a valid ETH cap** — Buy amount is missing, zero, or invalid.
* **No readable max wallet found** — Max Wallet mode selected but no valid max wallet value detected.
* **No readable max tx found** — Max TX mode selected but no valid max transaction value detected.
* **Enter a valid Custom % between 0 and 100** — Invalid percentage entered.
* **Token already appears tradeable** — The token is already executable (spam is no longer needed).
* **Selected spam wallet has insufficient ETH** — Wallet lacks enough ETH for the buy, gas, and required reserves.
* **Stop your active spam job before starting another one** — Only one active ETH spam job is allowed at a time.
**Important Notes**
Ethereum Spam is optimized for early launch conditions. It may fail due to unexpected token contract behavior, rapid liquidity changes, low gas settings, insufficient wallet balance, or the transaction not landing in time.
**Spam does not guarantee entry.** It prepares and submits transactions according to your chosen settings. Final success depends on network conditions, builder inclusion, token behavior, liquidity, and wallet balance.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## 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://docs.spartabot.pro/getting-started/gasless-spam.md?ask=
```
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.