> For the complete documentation index, see [llms.txt](https://documentation.kodiak.finance/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.kodiak.finance/protocol/perp-bots.md).

# Perp Bots

### What Are Perp Bots? <a href="#what-is-perp-bots" id="what-is-perp-bots"></a>

Perp Bots are persistent automated strategies that automate perpetual futures orders on Kodiak Perps and Hyperliquid.

The initial strategy uses a price grid: a selected market range is divided into levels where the bot can buy at lower prices and sell at higher prices. This approach is intended for markets that move repeatedly through the configured range. It does not predict price direction or guarantee profit, and strong directional movement may create an open long or short position.

Each bot trades through an existing exchange account. Its orders and positions share that account’s margin and leverage settings, so activity from other bots or manual trades can change the account’s available margin and total exposure.

### Availability <a href="#what-is-perp-bots" id="what-is-perp-bots"></a>

Perp bots can be accessed on desktop and mobile via [bots.kodiak.finance](https://bots.kodiak.finance) or in-app on mobile via [Matrix](https://docs.trymatrix.xyz/).

### How it works

A user defines the grid’s price range, spacing method, order size, and activity limits. Arithmetic grids maintain equal price differences between levels, while geometric grids maintain equal percentage differences.

After deployment, the bot uses authorized trading credentials to manage orders on the selected exchange. Filled orders change the position held by that account, and the bot continues managing the grid according to its configuration. The automation runs independently after deployment, so the dashboard does not need to remain open.

The dashboard provides visibility into the running strategy, including its orders, fills, grid state, position, margin, PNL, and operational health. The bot can be paused, resumed, or stopped. When stopping it, the user can choose whether to retain the current position or request that it be closed.

### Security features

* Credential validation: Credentials are validated before an account is linked and checked periodically afterwards. Accounts with invalid or expired credentials cannot be used to deploy new bots.
* Passphrase-protected credential storage: Before linked account credentials are saved to Kodiak Bots, the stored credential record is encrypted in your browser using a key derived from your passphrase. The passphrase remains on your device and is not sent to the Kodiak Bots service.
* Separate trading credentials: Perp Bots use exchange-specific credentials, a Kodiak Perps API key or a Hyperliquid agent wallet, rather than your connected wallet's private key.

### Limitations

* 5 active bots per user - number of active bots a user can run across all accounts.
* 4 active bots per account - number of active bots that can run on a single exchange account .
* 3 active bots per trading pair per account - number of active bots that can run on the same exact trading pair for the same account.

### Support

For additional assistance or feature requests, please contact the Kodiak support team via [Discord](https://discord.gg/vhZmNFNbCZ).

### User guide?

See [Perp Bots](/user-guide/perp-bots.md).