> 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/api.md).

# API Overview

Connect scripts and AI tools to your Fluvion trading account. Start with read-only requests before enabling live execution.

## Connection settings

| Setting            | Value                                  |
| ------------------ | -------------------------------------- |
| Website            | <https://fluvion.io>                   |
| API key management | <https://fluvion.io/portfolio/api-key> |
| Broker ID          | `fluvion`                              |
| Mainnet REST       | `https://api.orderly.org`              |
| Testnet REST       | `https://testnet-api.orderly.org`      |

These are the actual infrastructure endpoints, not URLs under the Fluvion website. Protocol header names must remain unchanged. The broker ID is used in account registration/lookup, not added arbitrarily to every trading request. Mainnet and testnet credentials are separate.

## Start here

Start with the [API Quickstart](/sol-perps-bot-docs/api-trading/quickstart.md), then:

1. [Create an API key](/sol-perps-bot-docs/api-trading/api-keys.md).
2. [Sign your first read request](/sol-perps-bot-docs/api-trading/authentication.md).
3. [Inspect account state](/sol-perps-bot-docs/api-trading/account-data.md).
4. [Preview and submit a trade](/sol-perps-bot-docs/api-trading/trading.md).
5. Review [security and troubleshooting](/sol-perps-bot-docs/api-trading/security.md) and [AI agent integration](/sol-perps-bot-docs/api-trading/agents.md).

## Verification status

Mainnet integration checks completed on 2026-09-07: signed account/holdings/positions/orders reads, key scope lookup, single-symbol leverage update, and an IOC order filled successfully. This is not a guarantee of future execution. Cancellation, amendment, closing, TP/SL and private streaming require separate integration tests before being exposed by an automated agent.

API trading uses real funds on mainnet. An API key is not a wallet seed phrase. Revoking a key does not cancel orders or close positions.