# Bots

### Earning Incentives

Anyone can run bots to earn these incentives. We've tried to make it as simple as possible to run these bots on GitHub Actions. What you will need:\
\
1\. Your own GitHub account\
2\. The private key of an account you want to use as your transaction relayer *- DO NOT share this publicly or with anyone!*\
3\. JSON RPC URIs for the networks you want to run on (currently: Optimism, Arbitrum and Base) from a provider such as [Alchemy](https://www.alchemy.com/), [Infura](https://www.infura.io/), etc.\
4\. A Covalent API key

Once you have those, head on over to one of the bot repositories on GitHub and fork (deploy) your own copy of the bot:

1\. [Liquidator bot](https://github.com/GenerationSoftware/pt-v5-liquidator-gh-action-bot/)\
2\. [Prize Claimer bot](https://github.com/GenerationSoftware/pt-v5-prize-claimer-gh-action-bot)\
3\. [Draw Auction bot](https://github.com/GenerationSoftware/pt-v5-draw-auction-gh-action-bot)

{% hint style="warning" %}
**These bots are meant for intermediates & experts to run and modify to their liking. There is a lot of prerequisite knowledge about blockchains, private keys, swaps, and GitHub infrastructure that should be known before running a bot.**
{% endhint %}

{% hint style="danger" %}
**If anyone ever asks you for your private key *****do not give it to them*****. Nobody from Generation Software, Pooltime, or PoolTogether will ever ask you for your private key.**
{% endhint %}

### Deployment

{% embed url="<https://www.youtube.com/watch?v=Dt-ibfZH-LU>" %}

{% hint style="info" %}
Feel free to reach out to [the PoolTogether community on Discord](https://pooltogether.com/discord) with any questions or help required with running PoolTogether bots.
{% endhint %}

### More Info

#### Liquidations:

PoolTogether accrues yield on prize vaults which can then be given away to depositors as prizes. The Liquidator bots can earn by finding profitable trades and swapping WETH for the yield tokens (DAI, USDC, LUSD, etc.). Profitable yield opportunities happen numerous times each day.

#### Prize Claiming:

Many prizes are claimed automatically each day on behalf of depositors by incentivized bots. Prize Claiming bots will earn rewards (in WETH, accrued in the Prize Pool contract) for each prize claimed.

#### Draw Auctions:

Once per day a random number is required to choose who the winners are. Draw Auction bots are rewarded (rewards accrue as WETH on the Prize Pool contract) for getting the random number and completing the daily draw.


---

# 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://docs.cabana.fi/protocol/bots.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.