> For the complete documentation index, see [llms.txt](https://docs.fluvion.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fluvion.io/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](/api-trading/trading.md) and [Security](/api-trading/security.md) before enabling writes.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.fluvion.io/api-trading/agents.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.