Generate Swap Transaction

Generate complete transaction data for executing a token swap via the AKKA router. The endpoint performs a full exact quote (graph walk), validates the user’s token balance and allowance, and returns a ready-to-sign transaction object.

GET /swap/v1/{chainId}/swap

Generate swap transaction data

cURL

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

200

Example

{
  "dstAmount": "12723902882990271",
  "tx": {
    "from": "0xD3C0F471488523b378F2D9C21939c97300c510F5",
    "to": "0xcce7452db4392b40aa0e1592a7c486e13bf69654",
    "data": "0x...",
    "value": "1000000000000000000",
    "gasPrice": "1000000000",
    "gas": "231973"
  },
  "encodedTx": "0x..."
}

This endpoint always performs an exact quote (full graph walk) regardless of the chain’s default quote policy. The returned dstAmount is the precise expected output.

Using the response

The response includes a tx object that is ready to sign and broadcast:

const { tx } = swapResponse;

const hash = await walletClient.sendTransaction({
  to: tx.to,
  data: tx.data,
  value: BigInt(tx.value),
  gasPrice: BigInt(tx.gasPrice),
  gas: BigInt(tx.gas),
});

Slippage recommendations

Swap type	Recommended slippage
Stable-to-stable	0.1 — 0.5%
Major tokens	0.5 — 1%
Low-liquidity tokens	1 — 5%

Balance and allowance validation

When from is provided, the API validates:

• Balance: The wallet has enough tokens to cover the swap amount
• Allowance: The AKKA Router is approved to spend enough tokens

If either check fails, the API returns a 400 error with a descriptive message.

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:

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

Example:

"1000000000000000000"

from · string

Wallet address executing the swap. When provided, the API validates that the wallet has sufficient token balance and allowance.

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

Example:

"0xD3C0F471488523b378F2D9C21939c97300c510F5"

slippage · number · required

Maximum acceptable slippage as a percentage. Range: 0 to 50. Recommended: 0.5 to 3 for most swaps.

Required range: 0 <= x <= 50

Example:

1

gasPrice · string

Custom gas price in wei. If omitted, the current network gas price is used.

Example:

"1000000000"

gasLimit · integer

Custom gas limit. If omitted, the API estimates gas with a 20% safety buffer.

Example:

500000

includeTokensInfo · boolean · default: false

Include srcToken and dstToken metadata in the response.

includeGas · boolean · default: false

Include estimated gas amount in the response.

Response

200

application/json

Swap transaction data generated successfully

dstAmount · string · required

Expected output amount in the smallest unit (wei)

Example:

"12723902882990271"

tx · object · required

Ready-to-sign transaction object. Send this directly to the blockchain.

Show child attributes

encodedTx · string · required

ABI-encoded transaction tuple (from, to, data, value, gasPrice, gas) as a hex string. Allows decoding and executing the swap without needing the contract ABI.

Example:

"0x..."

srcToken · object

Source token information (when includeTokensInfo=true)

Show child attributes

dstToken · object

Destination token information (when includeTokensInfo=true)

Show child attributes

gas · string

Estimated gas amount (when includeGas=true)

Example:

"231973"