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

# Quote

> Get optimal swap quotes with routing information

# Quote API

Get the best available swap quote for a token pair. The API finds the optimal route across V2 and V3 pools, including multi-hop paths.

## GET /api/v1/quote

### Parameters

| Parameter | Type | Required | Description |
| - | - | - | - |
| `tokenIn` | `string` | Yes | Input token address |
| `tokenOut` | `string` | Yes | Output token address |
| `amountIn` | `string` | Conditional | Input amount in raw units (required when `tradeType=0`) |
| `amountOut` | `string` | Conditional | Output amount in raw units (required when `tradeType=1`) |
| `tradeType` | `string` | No | `0` = Exact Input (default), `1` = Exact Output |

<Note>
  For native KAS, use the **WKAS address**, not the zero address.
</Note>

### Response

```json theme={null}
{
  "tokenIn": "0xb190...",
  "tokenOut": "0x3ac3...",
  "amountIn": "1000000000000000000",
  "amountOut": "1007249042881810956",
  "tradeType": 0,
  "route": {
    "path": ["0xb190...", "0x3ac3..."],
    "protocol": "v2",
    "hops": 1,
    "fees": [0]
  },
  "priceImpact": 0.3,
  "gasCost": "100000",
  "executionPrice": 1.007249
}
```

| Field | Description |
| - | - |
| `amountIn` | Input amount (user-specified for Exact Input, calculated for Exact Output) |
| `amountOut` | Output amount (calculated for Exact Input, user-specified for Exact Output) |
| `route.path` | Ordered list of token addresses in the swap path |
| `route.protocol` | `"v2"`, `"v3"`, or `"mixed"` |
| `route.hops` | Number of pools in the path |
| `route.fees` | Fee tier for each hop (0 for V2, 100/500/3000/10000 for V3) |
| `priceImpact` | Estimated price impact as a percentage |
| `gasCost` | Estimated gas cost |
| `executionPrice` | Output per input ratio |

### Examples

<CodeGroup>
  ```bash Exact Input theme={null}
  # I want to sell 1 token — how much do I get?
  curl "https://dex.kasplex.org/swap-api/api/v1/quote?\
  tokenIn=0xB190a6A7fC2873f1Abf145279eD664348d5Ef630&\
  tokenOut=0x3Ac3B30b7f18AEFD4590D7FE4d9C5944aaeB7220&\
  amountIn=1000000000000000000&\
  tradeType=0"
  ```

  ```bash Exact Output theme={null}
  # I want to buy 1 token — how much do I need?
  curl "https://dex.kasplex.org/swap-api/api/v1/quote?\
  tokenIn=0xB190a6A7fC2873f1Abf145279eD664348d5Ef630&\
  tokenOut=0x3Ac3B30b7f18AEFD4590D7FE4d9C5944aaeB7220&\
  amountOut=1000000000000000000&\
  tradeType=1"
  ```
</CodeGroup>

### Multi-Hop Routes

When no direct pool exists or a multi-hop path provides better pricing, the API returns a multi-hop route:

```json theme={null}
{
  "route": {
    "path": ["0xb190...", "0x0baf...", "0x3ac3..."],
    "protocol": "mixed",
    "hops": 2,
    "fees": [0, 500]
  }
}
```

This means: token A → (V2 pool) → intermediate token → (V3 0.05% pool) → token B.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.