> ## 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 API reference — quote, swap & instructions

> Base URL, response format, and conventions for the Argyros API.

**Base URL**: `https://api.argyros.xyz`

All swap endpoints are under `/api/v1`. The API currently operates on **Fogo**.

<Info>
  **Solana support coming soon.** When available, all endpoints will accept a `chain` query parameter to select between Fogo and Solana. See [Supported Chains](/concepts/chains).
</Info>

## Response format

All responses use a consistent envelope:

**Success:**

```json theme={"theme":"github-dark"}
{
  "success": true,
  "data": { ... }
}
```

**Error:**

```json theme={"theme":"github-dark"}
{
  "success": false,
  "error": "error message describing what went wrong"
}
```

## HTTP status codes

| Code  | Meaning                                                    |
| ----- | ---------------------------------------------------------- |
| `200` | Success                                                    |
| `400` | Bad request: invalid parameters, missing required fields   |
| `404` | Not found: no route exists for the given token pair/amount |
| `429` | Rate limited: too many requests                            |
| `500` | Internal error: transaction build or simulation failed     |

## Endpoints

| Endpoint                                           | Method | Description                         |
| -------------------------------------------------- | ------ | ----------------------------------- |
| `GET https://api.argyros.xyz/api/v1/quote`         | GET    | Get swap quote with routing details |
| `POST https://api.argyros.xyz/api/v1/swap`         | POST   | Build unsigned swap transaction     |
| `POST https://api.argyros.xyz/api/v1/instructions` | POST   | Get raw swap instructions           |
| `GET https://api.argyros.xyz/health`               | GET    | Service health check                |