> ## Documentation Index
> Fetch the complete documentation index at: https://flowlayer.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Automation & Alerts

> Real-time alerts for everyone, plus opt-in execution with user-defined slippage limits.

## Two Layers of Safety

Flowlayer protects reward income in two layers. Alerts ship in Tranche 1, are available to everyone, and never access the user's account. Opt-in execution and automation ship in Tranche 2 and run only when explicitly enabled.

***

## Alerts (Tranche 1)

Alerts flag conditions that require attention, leaving the user in full control. They deliver most of the safety value with none of the custody complexity.

<CardGroup cols={2}>
  <Card title="Volatility spike" icon="bolt">
    A sudden increase in price movement on a farmed market—the primary signal that an adverse fill may be imminent.
  </Card>

  <Card title="Order filled" icon="circle-check">
    A resting order has been hit, meaning the account now holds a position and directional risk.
  </Card>

  <Card title="Score drop" icon="arrow-trend-down">
    The reward score on a market has fallen, indicating orders may no longer be competitive.
  </Card>

  <Card title="Approaching resolution" icon="hourglass-end">
    A market is nearing resolution, where sudden, irreversible moves are most likely.
  </Card>
</CardGroup>

<Info>
  Alerts are the foundation. A timely, well-targeted alert delivers much of the protection of automated exit at a fraction of the risk and complexity.
</Info>

***

## Opt-In Execution & Automation (Tranche 2)

Tranche 2 enables Flowlayer to act on the user's behalf: fast execution, advanced order types, automated entry, and auto-exit. Because each of these places or cancels orders on the account, all are opt-in and run under access that is clearly disclosed, scoped, and revocable.

### User-Defined Slippage Limits

Automated exit never fills at any price to force an exit. The user sets a slippage limit, and Flowlayer treats it as a hard boundary.

<Steps>
  <Step title="Set the threshold">
    Define the maximum slippage acceptable on an exit, as a percentage or a tick distance from the expected price.
  </Step>

  <Step title="Execution respects it">
    Automated exit only fills within the limit. If the book has moved beyond the threshold, it will not close the position at a worse price than agreed.
  </Step>

  <Step title="Notify on breach">
    If an exit cannot complete within the limit, Flowlayer issues an alert so the user can decide how to proceed, rather than accepting a poor fill silently.
  </Step>
</Steps>

### Automated Entry

When enabled, automated entry opens positions on the user's behalf according to criteria they define.

<Steps>
  <Step title="Define the criteria">
    Set a target risk-score range and analytics filters that describe the markets worth entering.
  </Step>

  <Step title="Flowlayer scans and enters">
    Flowlayer continuously evaluates qualifying markets against the criteria and opens positions that match, sized within the limits the user sets.
  </Step>

  <Step title="Paired with auto-exit">
    Combined with auto-exit and slippage limits, automated entry closes the loop into a fully automated, opt-in strategy that the user can pause or revoke at any time.
  </Step>
</Steps>

### Execution Models

Automation can be delivered in three ways, each with a different trust profile. The full approach is documented on the [Security](/security) page.

<Tabs>
  <Tab title="Advisory (default)">
    Flowlayer alerts; the user acts manually. Lowest risk, no account access. This is the Tranche 1 default and remains available to everyone.
  </Tab>

  <Tab title="Delegated execution">
    A scoped API credential lets Flowlayer place and cancel orders but never withdraw funds. Fully opt-in, offered only once API terms and liability are settled.
  </Tab>

  <Tab title="Client-side">
    Automation runs in the user's own browser session with prior approval. Custody stays cleanest, but it operates only while the session is live.
  </Tab>
</Tabs>

***

## Limitations

<Warning>
  Automation is not a guarantee. A slippage limit caps how poor a fill can be, but in a fast-moving market a tight limit can prevent an exit from filling at all. No automation can act during an outage or, in client-side mode, while the session is closed, and resolution can occur faster than any system can react. Automation reduces risk; it does not remove it.
</Warning>