> ## 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.
# Get Quote
> How to request a swap quote and interpret routing, price impact, and slippage fields.
# Get Quote
`GET /api/v1/quote` returns the best swap route for a token pair, including estimated amounts, price impact, fee breakdown, and route details.
## Parameters
Input token mint address (Solana base58 public key).
Output token mint address (Solana base58 public key).
Amount in smallest token units. For SOL (9 decimals): `1000000000` = 1 SOL. For USDC (6 decimals): `1000000` = 1 USDC.
`ExactIn`: amount is the exact input, output is estimated.
`ExactOut`: amount is the exact desired output, input is estimated.
Slippage tolerance in basis points (1 bps = 0.01%). Default: 50 (0.5%).
## Example
```bash cURL theme={"theme":"github-dark"}
curl "https://api.argyros.xyz/api/v1/quote?\
inputMint=So11111111111111111111111111111111111111112&\
outputMint=uSd2czE61Evaf76RNbq4KPpXnkiL3irdzgLFUMe3NoG&\
amount=1000000000&\
swapMode=ExactIn&\
slippageBps=50"
```
```typescript TypeScript theme={"theme":"github-dark"}
const params = new URLSearchParams({
inputMint: "So11111111111111111111111111111111111111112",
outputMint: "uSd2czE61Evaf76RNbq4KPpXnkiL3irdzgLFUMe3NoG",
amount: "1000000000",
swapMode: "ExactIn",
slippageBps: "50",
});
const response = await fetch(
`https://api.argyros.xyz/api/v1/quote?${params}`
);
const { success, data, error } = await response.json();
if (!success) throw new Error(error);
console.log(`Output: ${data.amountOut}`);
console.log(`Price impact: ${data.priceImpactPercent}`);
console.log(`Route: ${data.hopCount} hop(s) via ${data.routes.map(r => r.poolType).join(" → ")}`);
```
```python Python theme={"theme":"github-dark"}
import requests
resp = requests.get("https://api.argyros.xyz/api/v1/quote", params={
"inputMint": "So11111111111111111111111111111111111111112",
"outputMint": "uSd2czE61Evaf76RNbq4KPpXnkiL3irdzgLFUMe3NoG",
"amount": "1000000000",
"swapMode": "ExactIn",
"slippageBps": "50",
})
result = resp.json()
if not result["success"]:
raise Exception(result["error"])
data = result["data"]
print(f"Output: {data['amountOut']}")
print(f"Price impact: {data['priceImpactPercent']}")
pool_types = " → ".join(r["poolType"] for r in data["routes"])
print(f"Route: {data['hopCount']} hop(s) via {pool_types}")
```
## Response
```json 200 — Success theme={"theme":"github-dark"}
{
"success": true,
"data": {
"inputMint": "So11111111111111111111111111111111111111112",
"outputMint": "uSd2czE61Evaf76RNbq4KPpXnkiL3irdzgLFUMe3NoG",
"amountIn": "1000000000",
"amountOut": "145320000",
"priceImpactBps": 25,
"priceImpactPercent": "0.25%",
"priceImpactSeverity": "low",
"priceImpactWarning": "Price impact is low",
"feeBps": 25,
"routes": [
{
"poolAddress": "HJPjoWUrhoZzkNfRpHuieeFk9WcZWjwy6PBjZ81ngndJ",
"poolType": "Vortex",
"percent": 100,
"inputMint": "So11111111111111111111111111111111111111112",
"outputMint": "uSd2czE61Evaf76RNbq4KPpXnkiL3irdzgLFUMe3NoG"
}
],
"routePath": [
"So11111111111111111111111111111111111111112",
"uSd2czE61Evaf76RNbq4KPpXnkiL3irdzgLFUMe3NoG"
],
"hopCount": 1,
"otherAmountThreshold": "144593400"
}
}
```
```json 404 — No route theme={"theme":"github-dark"}
{
"success": false,
"error": "no route found"
}
```
## Response fields
Input token mint address.
Output token mint address.
Input amount in smallest units. For `ExactIn`: same as requested. For `ExactOut`: calculated.
Output amount in smallest units. For `ExactIn`: calculated. For `ExactOut`: same as requested.
Price impact in basis points.
Human-readable price impact (e.g., `"0.25%"`).
Severity classification:
| Value | Range |
| ---------- | --------- |
| `none` | \< 0.1% |
| `low` | 0.1% – 1% |
| `moderate` | 1% – 3% |
| `high` | 3% – 5% |
| `extreme` | > 5% |
Warning message. Empty if impact is negligible.
Total pool fee across all hops in basis points.
Array of hops in the route.
Pool address for this hop.
Pool type. On Fogo: `Vortex`, `Fluxbeam`, `Fogo.fun`, `Moonit`. When Solana launches: also `Raydium`, `Orca`, `Meteora`.
Percentage of amount routed through this pool (100 for single route).
Input token for this hop.
Output token for this hop.
Token path from input to output. Direct: `[inputMint, outputMint]`. Multi-hop: `[inputMint, ...intermediates, outputMint]`.
Number of hops. 1 = direct swap, 2+ = multi-hop.
Slippage-adjusted threshold. `ExactIn`: minimum output you'll receive. `ExactOut`: maximum input you'll spend.
## Price impact guidance
* **`none` / `low`**: Safe to proceed.
* **`moderate`**: Consider splitting into smaller trades.
* **`high` / `extreme`**: Large trade relative to available liquidity. Review carefully before proceeding. The `priceImpactWarning` field will contain a human-readable message.