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

# Argyros architecture — how swaps are routed on Fogo

> How Argyros routes and executes swaps on Fogo.

<Frame caption="Your app calls the Argyros API, which finds the best-price route and returns an unsigned transaction; your wallet signs and submits it to Fogo.">
  <img src="https://mintcdn.com/argyros/r_t42XYOxJfxLnCX/images/architecture.png?fit=max&auto=format&n=r_t42XYOxJfxLnCX&q=85&s=4978421dc7cd88741f2b855537c254b3" alt="Argyros system overview: the widget, SDK, and your app call the Argyros API at api.argyros.xyz over HTTPS (GET /quote, POST /swap). The API finds the best-price route across all pools and returns an unsigned transaction. Your wallet signs and submits it on-chain to Fogo, where liquidity comes from Vortex, Fluxbeam, Fogo.fun, and Moonit." width="3239" height="1340" data-path="images/architecture.png" />
</Frame>

## Data flow

```
Client                    Argyros API                 Fogo
  │                           │                          │
  GET /quote                  │                          │
  ──────────────────────────> │                          │
                              │  find best route         │
  QuoteResponse               │  across all pools        │
  <────────────────────────── │                          │
                              │                          │
  POST /swap                  │                          │
  ──────────────────────────> │                          │
                              │  build transaction       │
  unsigned transaction        │                          │
  <────────────────────────── │                          │
                              │                          │
  sign + submit ────────────────────────────────────────>│
                              │                          │
  confirmation <─────────────────────────────────────────│
```

## Components

**API Server.** HTTP service that handles quote requests, builds swap transactions, and returns raw instructions. Stateless and horizontally scalable.

**Routing Engine.** Off-chain route search that evaluates routes across all supported DEXs on Fogo. Finds direct swaps, multi-hop paths (e.g., Token A → SOL → USDC → Token B), and split routes across multiple pools.

**Supported DEXs.** Vortex (concentrated liquidity), Fluxbeam (AMM), Fogo.fun (bonding curves), and Moonit (bonding curves).

**On-chain Program.** Verifies and executes the swap instructions atomically. If any hop fails or slippage is exceeded, the entire transaction reverts.

<Info>
  **Solana support coming soon** with additional DEXs including Raydium, Orca, and Meteora. See [Supported Chains](/concepts/chains).
</Info>

## Two integration paths

| Path             | Endpoint                    | Use case                                                                                                                  |
| ---------------- | --------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
| **Transaction**  | `POST /api/v1/swap`         | Get a ready-to-sign transaction. Sign it and submit. Simplest integration.                                                |
| **Instructions** | `POST /api/v1/instructions` | Get raw instructions to compose with your own transaction logic (e.g., adding custom instructions before/after the swap). |

Both paths start with `GET /api/v1/quote` to find the best route.