Get Quote

Find the best quote to exchange tokens via AKKA router. Returns expected output amount and optional token/protocol information. The Pathfinder algorithm splits transactions across multiple protocols and market depths to find the most efficient swap route.

GET /swap/v1/{chainId}/quote

Get quote for token swap

cURL

curl --request GET \
  --url https://api.akka.finance/swap/v1/{chainId}/quote \
  --header 'apikey: <api-key>'

200

basic

{
  "dstAmount": "205340622987446484992"
}

The quote endpoint returns the best available rate but does not generate transaction data. To execute the swap, use the swap endpoint.

Optional response fields

By default, the response only includes dstAmount. Use these flags to include additional data:

Flag	What it adds
includeTokensInfo=true	srcToken and dstToken metadata (symbol, name, decimals, logo)
includeGas=true	gas — estimated gas amount
includeRoutes=true	routes — parallel path breakdown with pools and tokens
includeGraph=true	graph — flat list of on-chain DAG hops (mirrors the actual router execution)

Authorizations

apikey · string · header · required

API key for authentication. Contact AKKA on Telegram to obtain your key.

Path Parameters

chainId · enum<integer> · required

Blockchain chain ID

Available options: 999

Example:

999

Query Parameters

src · string · required

Source token contract address. Use 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee for the native token (HYPE on HyperEVM).

Pattern: ^0x[a-fA-F0-9]{40}$

Example:

"0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee"

dst · string · required

Destination token contract address.

Pattern: ^0x[a-fA-F0-9]{40}$

Example:

"0xB8CE59FC3717ada4C02eaDF9682A9e934F625ebb"

amount · string · required

Amount to swap in the smallest unit (wei). For example, 1 HYPE = 1000000000000000000 (18 decimals).

Example:

"1000000000000000000"

includeTokensInfo · boolean · default: false

Include srcToken and dstToken metadata (symbol, name, decimals, logo) in the response.

includeGas · boolean · default: false

Include estimated gas amount in the response.

includeRoutes · boolean · default: false

Include the details of the swap routes (pools, tokens, percentages) in the response.

includeGraph · boolean · default: false

Include the on-chain DAG step list (one entry per pool hop) under graph. Mirrors what the AkkaRouter actually executes, including fan-in/fan-out at intermediate tokens.

exactQuote · enum<string>

Override the per-chain quote policy for this request. yes forces the full graph walk (MegaQuoter); no returns the upstream pre-computed sum. Useful for benchmarking.

Available options: yes, no

Response

200

application/json

Quote retrieved successfully

dstAmount · string · required

Expected output amount in the smallest unit (wei)

Example:

"205340622987446484992"

srcToken · object

Source token information (when includeTokensInfo=true)

Show child attributes

dstToken · object

Destination token information (when includeTokensInfo=true)

Show child attributes

routes · object[]

Swap routes (when includeRoutes=true)

Show child attributes

gas · string

Estimated gas amount (when includeGas=true)

Example:

"2419157"

graph · object[]

On-chain DAG step list (when includeGraph=true). One entry per pool hop.

Show child attributes