Skip to main content
GET
/
swap
/
v1
/
{chainId}
/
dex-compare
Compare quotes across individual DEX pools
curl --request GET \
  --url https://api.akka.finance/swap/v1/{chainId}/dex-compare \
  --header 'apikey: <api-key>'
{
  "akkaQuote": "205340622987446484992",
  "decimalsOut": 18,
  "pools": [
    {
      "poolAddress": "0x1234567890abcdef1234567890abcdef12345678",
      "poolType": "uni_v3",
      "amountOut": "204200000000000000000",
      "decimalsOut": 18
    },
    {
      "poolAddress": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcd",
      "poolType": "algebra_v4",
      "amountOut": "203800000000000000000",
      "decimalsOut": 18
    }
  ]
}
This endpoint is useful for demonstrating the value of AKKA’s aggregated routing compared to swapping through a single DEX pool.

​
How it works

  1. Finds the top pools by reserve for the given token pair
  2. Quotes each pool individually
  3. Returns results sorted by output amount (descending)
  4. Includes the AKKA aggregator’s exact quote (akkaQuote) for comparison
The akkaQuote will typically be higher than any individual pool because AKKA splits the swap across multiple pools for better pricing.

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.

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

"0x5555555555555555555555555555555555555555"

​
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).

Example:

"1000000000000000000"

Response

DEX comparison results

​
akkaQuote
string
required

AKKA aggregator's exact quote for the same pair and amount

Example:

"205340622987446484992"

​
decimalsOut
integer
required

Decimals of the output token

Example:

18

​
pools
object[]
required

Individual pool quotes sorted by output amount (descending)