# Buy Bot Widget

The Buy Bot Widget allows you to display real-time buy transactions on your stream, providing an engaging and interactive experience for your audience. Here's how you can configure each setting:

### 1. Token Address

Input your specific Pump.fun token address into the designated field. This ensures that the widget tracks and displays transactions related to your token. &#x20;

<div align="left"><figure><img src="https://1384157746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fdwtr2xi4GuTY5E5OizO2%2Fuploads%2FTlIuLNj4qFjUs3ENPm9O%2FScreenshot%202025-07-09%20at%2023.59.40.png?alt=media&#x26;token=2c53a8c2-8d48-47cb-9688-3af83ea85482" alt=""><figcaption></figcaption></figure></div>

### 2. Tier Buy Sizes

The Buy Bot Widget lets you set **three tiers of buy notifications**, each triggered by a minimum buy size. This allows bigger buys to trigger different animations, making your stream more engaging and highlighting significant transactions.

In these fields, **specify the minimum buy amounts for each tier**. This determines when each alert triggers.

<figure><img src="https://1384157746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fdwtr2xi4GuTY5E5OizO2%2Fuploads%2F8NrgcB8Ja5v9FQeeXinw%2FScreenshot%202025-05-31%20at%2017.51.11.png?alt=media&#x26;token=a82d1d20-d668-4492-8ed5-4d523b52d345" alt=""><figcaption></figcaption></figure>

### 3. Color and Style

In this section, you can customize the **look and feel** of your widget by selecting a color theme and enabling additional background styling if needed.

There are three style options to choose from:

* **Light**
* **Dark**
* **Bright**

Each style changes the overall appearance of the widget.

You can also enable the **"Add background opacity"** option, which applies a semi-transparent background behind the widget. This helps the widget stand out on complex or bright stream layouts.

<figure><img src="https://1384157746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fdwtr2xi4GuTY5E5OizO2%2Fuploads%2FYU7Ftxi883Gonf4baqa5%2FScreenshot%202025-06-02%20at%2002.23.59.png?alt=media&#x26;token=9c2b1d67-5ff2-430c-a055-3da9de9d0a0b" alt=""><figcaption></figcaption></figure>

### 4. Animations

In this section, you assign a **GIF animation to each buy tier**. Click on a GIF to add it - each click assigns it to the next tier (Tier 1 → Tier 2 → Tier 3). Click the 'X' to remove a GIF from a tier.

This lets you match different animations to different buy sizes, creating a more exciting stream experience.

Have your own custom animations? DM us to get them added to the site!

<figure><img src="https://1384157746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fdwtr2xi4GuTY5E5OizO2%2Fuploads%2Fkgo3xHrHn12AnfWjBxuP%2FScreenshot%202025-06-07%20at%2013.13.01.png?alt=media&#x26;token=083b856e-719c-418a-95b4-7c3a38389763" alt="" width="375"><figcaption></figcaption></figure>

### 5. Sounds

In this section, you can select the **audio notification** that plays with each buy alert. Start by choosing a **general audio style** from the presets or turn sounds off entirely. You can manually adjust the audio level with the volume slider.

Once you select a style, each buy tier will automatically get its own unique sound, shown below under **Tier 1 Audio**, **Tier 2 Audio**, and **Tier 3 Audio**. These sounds will play when a buy of that tier’s size happens.

Custom audio uploads coming soon.

<figure><img src="https://1384157746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fdwtr2xi4GuTY5E5OizO2%2Fuploads%2FLDUEvrCnxsroxqEcDfel%2FScreenshot%202025-07-10%20at%2000.00.23.png?alt=media&#x26;token=e0e5bb75-a73d-40ad-bf0c-5b5dd786e6de" alt="" width="563"><figcaption></figcaption></figure>

### 6. Preview

This section shows a **preview of your Buy Bot widget**. It reflects the current settings for each tier so you can quickly see how everything will look during your stream.

Switch between Tier 1, Tier 2, and Tier 3 tabs to view how the alerts will appear for different buy sizes.

<figure><img src="https://1384157746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fdwtr2xi4GuTY5E5OizO2%2Fuploads%2FWrb3wT2HA38agN6jrtM0%2FScreenshot%202025-05-31%20at%2018.05.14.png?alt=media&#x26;token=d7d07672-f21c-4c24-b4d3-d81904df12dd" alt="" width="355"><figcaption></figcaption></figure>

### 7. Widget's URL

This section provides the **Widget URL**, which you’ll use to display your Buy Bot widget in your streaming software (like OBS, Streamlabs, or XSplit).&#x20;

If you enable **Generate temporary preview link**, the widget will show a cycling preview of all tiers on loop. This is useful for testing and positioning the widget on your stream layout before going live.

<figure><img src="https://1384157746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fdwtr2xi4GuTY5E5OizO2%2Fuploads%2F1xxQkh6roXBeoFEuG4D8%2FScreenshot%202025-07-10%20at%2000.02.01.png?alt=media&#x26;token=b4c09165-8db6-4e6e-ae73-cf8e8a42273e" alt="" width="360"><figcaption></figcaption></figure>

{% hint style="warning" %}
Make sure to **disable the preview option** and use the original Widget URL when you’re ready to stream live. The preview link is only for setup and doesn’t react to actual buys on Pump.fun.
{% endhint %}

Once you’re ready, move on to the next part for the integration guide.

<table data-view="cards"><thead><tr><th></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td>Integration with OBS</td><td><a href="https://1384157746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fdwtr2xi4GuTY5E5OizO2%2Fuploads%2FdTj0HIeBHqYOpRwJhhQd%2Fobs.png?alt=media&#x26;token=d8d3e0cb-cf27-4c98-b2d9-cd03dd0f72fb">obs.png</a></td><td><a href="../integration/obs">obs</a></td></tr><tr><td>Integration with StreamLabs</td><td><a href="https://1384157746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fdwtr2xi4GuTY5E5OizO2%2Fuploads%2FKrC1CBLLdMVeyw6TKwdf%2FStreamlabs.png?alt=media&#x26;token=0319effa-88c9-40f7-83d4-10e69a78c6bb">Streamlabs.png</a></td><td><a href="../integration/streamlabs">streamlabs</a></td></tr><tr><td>Integration with XSplit</td><td><a href="https://1384157746-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fdwtr2xi4GuTY5E5OizO2%2Fuploads%2F2pg7q3VsH96ulbm4M3IQ%2FXsplit.png?alt=media&#x26;token=dc849d05-daba-40e4-98d2-ec91d7bb13f8">Xsplit.png</a></td><td><a href="../integration/xsplit">xsplit</a></td></tr></tbody></table>
