> For the complete documentation index, see [llms.txt](https://docs.wowswap.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.wowswap.io/howtoguide/running-wowswap-liquidation-bot.md).

# 🩺Running WOWswap liquidation bot

## Liquidation BOT

### Installation

To simplify your experience we are using Heroku to deploy liquidation bots.

#### 1. Prepare Heroku account

To get started, you should sign up to [Heroku](https://heroku.com/) and login to the dashboard (1 minute).

#### 2. Create a liquidation wallet

Create a new wallet (if you are using Metamask, click on the circle in the top right corner and then + Create Account), deposit a small amount of BNB/Matic to this wallet ($100 should be enough), and obtain its Private key (in Metamask: click on 3 dots in the top right corner ->Account details ->Export Private Key -> Enter your password to see the Private Key).

> If you still have a question [check here](https://metamask.zendesk.com/hc/en-us/articles/360015289632-How-to-Export-an-Account-Private-Key)

#### 3. Deploy and run bot

Select a bot for BNB Chain or Polygon Network:

* [**BNB Chain**](https://signup.heroku.com/deploy?redirect-url=https%3A%2F%2Fdashboard.heroku.com%2Fnew%3Fbutton-url%3Dhttps%253A%252F%252Fapp.gitbook.com%252Fs%252F-MYhYcw9WN6xTQqOD_-A%252F~%252Fchanges%252FZYLPonIVGrczwDXSeApf%252Fhowtoguide%252Frunning-wowswap-liquidation-bot%26template%3Dhttps%253A%252F%252Fgithub.com%252Fwowswap-io%252Fliquidation-bot%252Ftree%252Fbinance-smart-chain)
* [**Polygon** (formerly Matic)](https://heroku.com/deploy?template=https://github.com/wowswap-io/liquidation-bot/tree/matic)

In the field "App name" provide a name for your bot and paste the Private Key obrained at the previous step - the bot requires Private Key from your liquidation wallet because it will be submitting transactions on your behalf and pay for gas from this wallet. Don't change other parameters. Click "Deploy app".

![](https://camo.githubusercontent.com/c0fde5a955ec57dd5673eea610b60ded0298b2ba1034c6354a89dbacfc037370/68747470733a2f2f692e696d6775722e636f6d2f496443554953682e706e67)

#### 4. Prepare for continuous work

The Heroku stops instances with no incoming requests. To prevent undesired halting of the liqudation bot, enter [Heroku Dashboard](https://dashboard.heroku.com/apps) and find your bot.

On the configuration page of selected bot click on "Configure Dynos": 

![](https://camo.githubusercontent.com/ab61a23478391c2258158978d84064c4c673faa6d8ae99fc3659083c22956f7f/68747470733a2f2f692e696d6775722e636f6d2f554a696d6278312e706e67)

And then click on "Change Dyno Type".

Select **Hobby** plan ($7/ month) and complete the payment. If you running 2 bots both on BSC and Polygon you will need to pay twice.

### Monitor your bot

You can check the bot's activity on Heroku by going to <https://dashboard.heroku.com/apps> -> Click on your bot's name -> Click on More… (in the top right corner) -> Click on "View Logs".

![](https://camo.githubusercontent.com/1650924365b4a4f01e567bdb5eac6ecb1842d723348561cc751a3f5b2dd023e3/68747470733a2f2f692e696d6775722e636f6d2f6a3033766855322e706e67)


---

# 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.wowswap.io/howtoguide/running-wowswap-liquidation-bot.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.