---
title: "GET /v1/route"
method: GET
path: "/v1/route"
---

# GET /v1/route

`GET /v1/route`

Calculate the optimal swap route and generate execution parameters for a token exchange

## Query parameters

- `amountIn` string, required
- `tokenIn` string, required
- `tokenOut` string, required
- `slippageBps` integer
- `timeout` integer

## Response `200`

Successfully calculated swap route with execution details

- RouteV1Response — Successfully created route with execution details
  - `requestId` string, hex, required — Unique request identifier (16 bytes) encoded as hexadecimal with 0x prefix
  - `amountOut` string, required — Amount of an ERC20 token as a decimal string (no scientific notation)
  - `minAmountOut` string, required — Amount of an ERC20 token as a decimal string (no scientific notation)
  - `target` string, required — Ethereum contract address (20 bytes) encoded as hexadecimal with 0x prefix
  - `callData` string, required — Arbitrary byte data encoded as hexadecimal with 0x prefix
  - `gasUsed` integer, required — Actual gas consumed by the swap simulation
  - `gasLimit` integer, required — Recommended gas limit for the swap transaction (gasUsed * 1.3)

## Other responses

- `400` — Bad request due to invalid parameters
- `401` — Unauthorized access due to invalid or missing credentials
- `404` — No viable swap route found for the given parameters
- `500` — Internal server error

---

[API](https://skmtc.dev/sprintertech/apis/swap-by-blanc.md) · [All operations](https://skmtc.dev/sprintertech/apis/swap-by-blanc/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sprintertech/swap-by-blanc/revisions/ef3da6b1425b/schema)