> For the complete documentation index, see [llms.txt](https://docs.proxima.tools/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.proxima.tools/live-settings/auto-buy.md).

# Auto-Buy

<div align="left"><figure><img src="/files/ctnPiSyvYMWpaTcaEvJ8" alt="" width="563"><figcaption></figcaption></figure></div>

***

### How It Works

You might replicate outgoing sells early on to counter dumps, buy fixed SOL amounts at regular intervals, and ladder into position at specific mcap levels, all within the same session.

Three modes are available :

* **Replication** : buys in response to incoming sells
* **Time Based** : buys on fixed or randomized intervals
* **Market Cap** : buys at specific mcap thresholds

{% hint style="info" %}
You can stack as many strategies as you need, as long as two of the **same mode** don't cover overlapping market cap ranges. Different modes can run over the same range without conflict.
{% endhint %}

Each strategy triggers on its own logic and can be added, edited, or removed without interrupting the others. They all share the same wallets, start delay, **slippage**, and global stop conditions, configured once in Advanced Options.

***

### <i class="fa-reflect-horizontal">:reflect-horizontal:</i>  Replication Mode

*This mode triggers buy executions in response to detected on-chain sell events.*

<div align="left"><figure><img src="/files/ODoyQ8S4UG7zt1F9CFJJ" alt="" width="563"><figcaption></figcaption></figure></div>

#### **Replication Factor&#x20;**<mark style="color:$info;">**(%)**</mark>

How much SOL you buy relative to each sell

> At 50%, a 1 SOL sell triggers a 0.5 SOL buy

#### **Swap Rate&#x20;**<mark style="color:$info;">**(%)**</mark>

How often replication triggers.

> *At 50%, roughly **1 out of 2 sells** triggers a buy.*

#### **Minimum amount per Buy**

Minimum SOL required to execute a buy

> *If buys are too small, they **accumulate** and execute together.*

***

### <i class="fa-hourglass-start">:hourglass-start:</i> Time-Based Mode&#x20;

*This mode executes buys on a fixed or randomized schedule, independent of market activity.*

<div align="left"><figure><img src="/files/1Qg2mBRA1HFg6XLaudj3" alt="" width="563"><figcaption></figcaption></figure></div>

#### **Amount&#x20;**<mark style="color:$info;">**(SOL)**</mark>

How much SOL is spent per interval.

> At 0.1 SOL per interval, each trigger buys 0.1 SOL worth of tokens

#### **Delay**

Interval between each buy. Fixed (constant) or Randomized (variable within a range).

> At a 30s fixed delay, a buy fires every 30 seconds. \
> At a 20–40s randomized delay, buys fire at irregular intervals within that window.

***

### <i class="fa-bullseye-arrow">:bullseye-arrow:</i> Marketcap Mode

*This mode triggers* buys *when the token reaches specific market cap thresholds.*

<div align="left"><figure><img src="/files/bbep94A4FCzDXyMrl1xJ" alt="" width="563"><figcaption></figcaption></figure></div>

#### **Amount&#x20;**<mark style="color:$info;">**(SOL)**</mark>

How much SOL is spent when a threshold is reached

> At 0.1 SOL per target, each triggered threshold buys 0.1 SOL worth of tokens

#### **Market Cap&#x20;**<mark style="color:$info;">**(USD)**</mark>

The mcap threshold that triggers the buy. Multiple targets can be stacked within a single strategy.

> Targets at $100K, $500K, and $1M fire one buy each as the mcap crosses them, in order.

***

### Strategy Scope

Each strategy has its own scope and stop conditions, independent from the others.

<div align="left"><figure><img src="/files/aCAKHbhkB8E6yv5Kgqg4" alt="" width="375"><figcaption></figcaption></figure></div>

#### **Market Cap Range** *<mark style="color:$info;">(optional)</mark>*

*Defines the activation window. The strategy only runs while the current mcap falls inside the range.*

> A strategy set to $10K → $25K stays idle below $10K, runs between $10K and $25K, and stops above.

<div align="left"><figure><img src="/files/rjYOdi1Nr3Vlf0xo1W9e" alt="" width="375"><figcaption></figcaption></figure></div>

#### **End Conditions** *<mark style="color:$info;">(optional)</mark>*

* **Max Amount (SOL)** : strategy stops once this amount has been spent
* **Duration (seconds)** : strategy stops after this time elapses

{% hint style="info" %}
If both are set, the strategy stops as soon as either is reached.
{% endhint %}

#### **Whitelist** *<mark style="color:$info;">(optional)</mark>*

*Addresses excluded from this strategy's trigger logic. Sells from whitelisted wallets won't fire a Replication* bu&#x79;*.*

***

### Advanced Options

*Global settings shared by all strategies in the session.*

<div align="left"><figure><img src="/files/Dj6juokQ8Pn5eq1NuH7C" alt="" width="375"><figcaption></figcaption></figure></div>

#### **Start Delay** *<mark style="color:$info;">(optional)</mark>*&#x20;

*Seconds to wait before Auto-Buy begins executing.*

> A 60s delay holds all strategies idle for one minute after launch, then activates them.

#### **Slippage** *<mark style="color:$info;">(optional)</mark>*&#x20;

*Maximum acceptable price deviation between the moment a buy is sent and the moment it lands on-chain.*&#x20;

> *At 5%, buys revert if the execution price is more than 5% above the expected price.*

#### **Wallets** *<mark style="color:$info;">(optional)</mark>*&#x20;

*Restrict execution to a selected wallet pool. Defaults to all funded wallets if unset.*

#### **End Conditions** *<mark style="color:$info;">(optional)</mark>*&#x20;

*Stops the entire Auto-Buy session.*

* **Max Amount (SOL)** : total SOL ceiling across all strategies combined
* **Duration (seconds)** : maximum total execution window

{% hint style="warning" %}
Global end conditions override per-strategy conditions. When a global threshold is reached, every strategy stops at once, regardless of their individual state.
{% endhint %}

***

### Live Panel

Once running, Auto-Buy stays accessible as a persistent panel on the Live page. It shows the session status, P\&L, total Bought, and a range bar with the current mcap position.

<div align="left"><figure><img src="/files/KiAQM22xuRskdmXTbdbL" alt="" width="275"><figcaption></figcaption></figure></div>

Each strategy is listed with its live parameters and tagged **In-Range** when active or **Off-Range** when waiting for the mcap to enter its window. Expanding a card reveals live values : Replication Factor and Swap Rate for Replication, Amount and Delay for Time Based.

From the panel you can **Edit** the session mid-run, **Pause** it, or **End** it permanently.

{% hint style="info" %}
Swap Rate is the observed execution rate, not a configured setting.
{% endhint %}


---

# 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, and the optional `goal` query parameter:

```
GET https://docs.proxima.tools/live-settings/auto-buy.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
