Skip to main content

Documentation Index

Fetch the complete documentation index at: https://akkafinance-4d5a30d3.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

​
Error Response Format

All errors return a consistent JSON structure: 
{
  "statusCode": 400,
  "message": "Not enough balance. Current balance: 500000000000000000",
  "error": "Bad Request",
  "timestamp": "2025-01-15T12:00:00.000Z",
  "path": "/swap/v1/999/swap"
}
FieldTypeDescription
statusCodeintegerHTTP status code
messagestringHuman-readable error description
errorstringError category
timestampstringISO 8601 timestamp
pathstringRequest path that produced the error

​
Common Errors

​
400 Bad Request

MessageCauseFix
src must be an Ethereum addressInvalid source token addressUse a valid 0x-prefixed 40-character hex address
dst must be an Ethereum addressInvalid destination token addressSame as above
amount should be positive integer stringAmount is missing, negative, or not a numberPass a positive integer string in wei
No route found for the given token pairNo liquidity path exists between the two tokensVerify both tokens exist on the chain and have liquidity
Not enough balance. Current balance: ...Wallet balance is insufficient for the swap amountReduce the amount or fund the wallet
Not enough allowance. Current allowance: ...AKKA Router is not approved to spend enough tokensCall /approve/transaction first and submit the approval
slippage must not be greater than 50Slippage exceeds the 50% maximumUse a value between 0 and 50

​
404 Not Found

MessageCauseFix
Chain not foundUnsupported chain IDUse a supported chain ID
Token not foundToken does not exist on the specified chainVerify the token address on a block explorer
No spender contract foundNo AKKA Router deployed on this chainUse a chain with a deployed router

​
429 Too Many Requests

You exceeded the rate limit of 20 requests per 60 seconds. Wait for the rate limit window to reset.

​
500 Internal Server Error

An unexpected error occurred. If this persists, contact support on Telegram.

​
Troubleshooting

This usually means the price moved beyond your slippage tolerance between the quote and execution. Increase the slippage parameter (e.g., from 1 to 3) or execute the swap faster after getting the quote.
The token may exist on-chain but have no liquidity in any DEX pool that AKKA indexes. Check that the token has active trading pairs on at least one supported DEX.
Make sure the approval transaction was confirmed on-chain before checking the allowance. If you approved a specific amount and already swapped some tokens, the remaining allowance may be less than expected.
The API adds a 20% safety buffer to gas estimates. The actual gas used will typically be lower. You can override the gas limit using the gasLimit parameter on the swap endpoint.