> For the complete documentation index, see [llms.txt](https://sol-perps-bot.gitbook.io/sol-perps-bot-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://sol-perps-bot.gitbook.io/sol-perps-bot-docs/api-trading/agents.md).

# AI Agents & Trading Skills

Fluvion skills provide reusable instructions for an AI assistant: account setup, authentication, account reads, order preflight and execution reporting. Skills are not a hosted bot, a trading strategy, or an execution permission.

## Architecture

```
User-approved intent
    → Fluvion skill / AI assistant
    → Trusted execution tool with enforced risk limits
    → Local signer / protected credentials
    → Trading API
    → Order reconciliation and user report
```

## Official skills repository

The Fluvion skills are available at [**fluvion-dex/fluvion-skills**](https://github.com/fluvion-dex/fluvion-skills).

| Skill                                                                                                                    | Purpose                                                     |
| ------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------- |
| [Onboarding](https://github.com/fluvion-dex/fluvion-skills/blob/main/skills/fluvion-onboarding/SKILL.md)                 | Setup, broker configuration and safe first steps            |
| [API Authentication](https://github.com/fluvion-dex/fluvion-skills/blob/main/skills/fluvion-api-authentication/SKILL.md) | Signing requests and diagnosing authentication              |
| [Account Data](https://github.com/fluvion-dex/fluvion-skills/blob/main/skills/fluvion-account-data/SKILL.md)             | Reading balances, positions and orders                      |
| [Trading Orders](https://github.com/fluvion-dex/fluvion-skills/blob/main/skills/fluvion-trading-orders/SKILL.md)         | Order preflight, authorization and execution reconciliation |
| [Positions & Risk](https://github.com/fluvion-dex/fluvion-skills/blob/main/skills/fluvion-positions-risk/SKILL.md)       | Margin, leverage and position management                    |

### Get the skills locally

```bash
git clone https://github.com/fluvion-dex/fluvion-skills.git
cd fluvion-skills
```

Read the repository README and start with `skills/fluvion-onboarding/SKILL.md`. Load the relevant skill using your AI client's supported local-skill mechanism, or provide the file as procedural context. Preserve the directory layout so relative references remain available. Cloning the repository does not automatically install skills into an AI client or grant account access.

This repository is a documentation/skill package, not an implemented CLI or MCP execution server. A documentation MCP searches reference material; it does not by itself submit orders. A separate trusted execution tool and protected signer are required for API actions. Never paste API secrets into an AI conversation or into the skills repository.

## Required execution contract

Before live trading, capture the account/network, market, side, margin mode, leverage, quantity or maximum notional, order type and price/slippage bounds. Clarify margin versus notional. If the requested minimum cannot fit within the approved budget, stop and ask; do not independently raise leverage or spend.

The tool—not just the prompt—must enforce:

* Allowlisted API hosts and actions, no secret exposure to the model.
* Fresh balances/positions and market constraints.
* Decimal-safe quantity and price validation.
* Per-order and aggregate exposure limits.
* Unique client IDs, durable audit records and reconciliation after ambiguous failures.
* Explicit authorization for changing leverage, canceling orders or closing positions.
* No withdrawals, automatic top-ups or asset operations in a basic trading agent.

Return actual order IDs, final status, executed quantity, average price and fees. Never manufacture fills or interpret zero-quantity rows as open positions. Disclose if no stop loss is attached. Do not describe configuration of leverage as a guarantee of limited losses.

Start with read-only tools, then testnet execution. An authorized mainnet test is not blanket permission for autonomous strategy trading. Review [Trading](/sol-perps-bot-docs/api-trading/trading.md) and [Security](/sol-perps-bot-docs/api-trading/security.md) before enabling writes.