Partner Executable Quote - Akka Swap — Swap Tokens at Superior Prices

Get a partner-ready executable exact-input quote

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

const options = {method: 'GET', headers: {apikey: '<api-key>'}};

fetch('https://api.akka.finance/partner/v1/{chainId}/quote', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "dstAmount": "12723902882990271",
  "tx": {
    "to": "<string>",
    "data": "<string>",
    "value": "<string>",
    "gasPrice": "<string>",
    "gas": "<string>",
    "from": "<string>",
    "maxFeePerGas": "<string>",
    "maxPriorityFeePerGas": "<string>"
  },
  "encodedTx": "<string>",
  "chainId": 123,
  "sellToken": "<string>",
  "buyToken": "<string>",
  "sellAmount": "<string>",
  "buyAmount": "<string>",
  "payer": "<string>",
  "recipient": "<string>",
  "issues": [
    {
      "message": "<string>",
      "actual": "<string>",
      "expected": "<string>",
      "token": "<string>",
      "spender": "<string>"
    }
  ],
  "validation": {
    "balance": {
      "actual": "<string>",
      "expected": "<string>",
      "reason": "<string>"
    },
    "allowance": {
      "actual": "<string>",
      "expected": "<string>",
      "reason": "<string>"
    },
    "gas": {
      "actual": "<string>",
      "expected": "<string>",
      "reason": "<string>"
    }
  },
  "simulation": {
    "gas": "<string>",
    "blockNumber": "<string>"
  },
  "validForSeconds": 123,
  "partnerId": "<string>",
  "srcToken": {
    "address": "<string>",
    "symbol": "<string>",
    "name": "<string>",
    "decimals": 123,
    "logoUri": {}
  },
  "dstToken": {
    "address": "<string>",
    "symbol": "<string>",
    "name": "<string>",
    "decimals": 123,
    "logoUri": {}
  },
  "gas": "231973",
  "quoteId": "<string>",
  "blockNumber": "<string>",
  "generatedAt": "<string>",
  "expiresAt": "<string>",
  "minAmountOut": "<string>",
  "allowanceTarget": {},
  "simulationIncomplete": true,
  "quotedAtBlock": "<string>"
}

GET

partner

{chainId}

quote

Get a partner-ready executable exact-input quote

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

const options = {method: 'GET', headers: {apikey: '<api-key>'}};

fetch('https://api.akka.finance/partner/v1/{chainId}/quote', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "dstAmount": "12723902882990271",
  "tx": {
    "to": "<string>",
    "data": "<string>",
    "value": "<string>",
    "gasPrice": "<string>",
    "gas": "<string>",
    "from": "<string>",
    "maxFeePerGas": "<string>",
    "maxPriorityFeePerGas": "<string>"
  },
  "encodedTx": "<string>",
  "chainId": 123,
  "sellToken": "<string>",
  "buyToken": "<string>",
  "sellAmount": "<string>",
  "buyAmount": "<string>",
  "payer": "<string>",
  "recipient": "<string>",
  "issues": [
    {
      "message": "<string>",
      "actual": "<string>",
      "expected": "<string>",
      "token": "<string>",
      "spender": "<string>"
    }
  ],
  "validation": {
    "balance": {
      "actual": "<string>",
      "expected": "<string>",
      "reason": "<string>"
    },
    "allowance": {
      "actual": "<string>",
      "expected": "<string>",
      "reason": "<string>"
    },
    "gas": {
      "actual": "<string>",
      "expected": "<string>",
      "reason": "<string>"
    }
  },
  "simulation": {
    "gas": "<string>",
    "blockNumber": "<string>"
  },
  "validForSeconds": 123,
  "partnerId": "<string>",
  "srcToken": {
    "address": "<string>",
    "symbol": "<string>",
    "name": "<string>",
    "decimals": 123,
    "logoUri": {}
  },
  "dstToken": {
    "address": "<string>",
    "symbol": "<string>",
    "name": "<string>",
    "decimals": 123,
    "logoUri": {}
  },
  "gas": "231973",
  "quoteId": "<string>",
  "blockNumber": "<string>",
  "generatedAt": "<string>",
  "expiresAt": "<string>",
  "minAmountOut": "<string>",
  "allowanceTarget": {},
  "simulationIncomplete": true,
  "quotedAtBlock": "<string>"
}

This is the recommended endpoint for new wallet, router, and meta-aggregator integrations. It returns an exact-input executable quote and does not broadcast a transaction.

payer supplies the input and sends the returned transaction. recipient receives the output and defaults to payer. A successful response can contain balance, allowance, or native gas entries in issues. Resolve them before broadcasting. A validation status of UNKNOWN means AKKA could not complete that RPC check; validate it independently. Use simulation.status, not HTTP status alone, to decide whether your own simulation is required. Refresh after expiresAt, any approval transaction, user delay, failed simulation, or nonce replacement. Executable calldata is single-use and must not be cached or retried after broadcast. Inspect tx.type: send only gasPrice for legacy, or only maxFeePerGas and maxPriorityFeePerGas for eip1559. Preserve tx.to, tx.data, and tx.value exactly.

Keep the partner API key on a backend. Browser and mobile clients should call an authenticated proxy owned by the integrator.

Authorizations

apikey

string

header

default:basic-test-key

required

API key. basic-test-key is a shared, rate-limited evaluation credential; use a dedicated key in production.

Path Parameters

chainId

integer

required

Example:

999

Query Parameters

src

string

required

Exact-input source token address

dst

string

required

Destination token address

amount

string

required

Sell amount in the token smallest unit

payer

string

required

Transaction sender and token payer

recipient

string

Output recipient; defaults to payer

slippage

object

required

Slippage percentage

Response

200 - application/json

dstAmount

string

required

Expected output amount in wei (destination amount)

Example:

"12723902882990271"

object

required

Transaction data to execute the swap

Show child attributes

encodedTx

string

required

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

chainId

number

required

sellToken

string

required

buyToken

string

required

sellAmount

string

required

buyAmount

string

required

payer

string

required

recipient

string

required

issues

object[]

required

Show child attributes

validation

object

required

Show child attributes

simulation

object

required

Show child attributes

validForSeconds

number

required

validitySource

enum<string>

required

Available options:

ADVISORY,

ROUTE_DEADLINE

partnerId

string

required

srcToken

object

Source token information

Show child attributes

dstToken

object

Destination token information

Show child attributes

gas

string

Estimated gas amount for the swap (decimal-string uint256)

Example:

"231973"

quoteId

string

Unique identifier for this executable quote

blockNumber

string

Block used for quote metadata

generatedAt

string

ISO-8601 quote generation time

expiresAt

string

Advisory ISO-8601 refresh deadline

minAmountOut

string

Minimum output encoded in the transaction

allowanceTarget

object

ERC-20 approval target; null for native input

simulationIncomplete

boolean

True when RPC simulation/gas estimation did not complete

simulationStatus

enum<string>

Available options:

SUCCESS,

INCOMPLETE,

SKIPPED_METRIC_STATE

quotedAtBlock

string