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

# User roles

> Roles and permissions across the Perps Agent platform.

Perps Agent is designed so each role has the **minimum** privilege needed.

## Trader

The end user running an agent.

* Connects their own Bybit account using **trade-only** API keys.
* Configures markets, risk caps, and strategy templates from Telegram.
* Can start, stop, and inspect their own runs.
* Cannot access other users' keys, runs, or balances.

## Agent (the bot itself)

The automated process that proposes params, places orders, and submits proofs.

* Can read market data and the trader's risk caps.
* Can place and cancel orders **only** on markets and within caps that match the on-chain commit.
* Cannot withdraw funds, change risk caps, or rewrite history.

## Observer

Anyone reading the on-chain record.

* Can verify any past commit and attestation on Mantle.
* Can recompute risk-adjusted metrics from the public attestations.
* Cannot see private trader identity beyond what is voluntarily linked.

<Note>
  This role split is what makes the track record meaningful: the agent only ever does what was committed, and any observer can check it.
</Note>