Swap API (kX)

Overview

This API allows fetching quotes for token swaps and provides transaction data (calldata) for execution if the parameters slippageTolerance, deadline, and recipient are specified. This enables direct interaction with smart contracts.

This API is an aggregator of various providers and selects the best ones.

Currently, the following external providers are supported:

  1. OpenOcean

  2. Fly (prev MagPie)

  3. OogaBooga

  4. Enso

  5. Kyberswap

  6. Kodiak

Endpoint

URL: https://backend.kodiak.finance/quote

Method: GET

Content Type: application/json

Query Parameters

Parameter
Required
Description

tokenInAddress

✅

Address of the input token for the swap. For native use token = BERA , ETH, or address(0) 0x000000000000000000000000000000000000000000

tokenInChainId

✅

Chain ID of the input token.

tokenOutAddress

✅

Address of the output token for the swap. For native use token = BERA , ETH, or address(0) 0x000000000000000000000000000000000000000000

tokenOutChainId

✅

Chain ID of the output token.

amount

✅

Amount of tokens to swap in human terms

type

✅

Type of swap: exactIn (fixed input amount) or exactOut (fixed output amount). exactOut is not supported by most providers, so this is not a recommended method and may show you poor quotes

refCode

❌

Your referral code (received from the Kodiak team)

referrerFeeBps

❌

Your share of fees. Each referral code has a maximum threshold. Example: 100 = 1%

recipient

❌

The address of the recipient of the swapped tokens. Required for generating calldata

slippageTolerance

❌

Allowed slippage percentage as an integer (e.g., 1 for 1%).

providers

❌

Case insensitive list of providers separated by commas.

Available options: Kodiak , OpenOcean,Magpie,OogaBooga,Enso,Kyberswap

For example: kodiak,openocean,oogabooga

debug

❌

Receive additional information on all underlying providers quoted by setting to true

Example Request

Example response

Please note the address in methodParameters.to, which may change depending on the quote (mainly to use legacy Kodiak router for tokens unsupported by kX). You must approve it yourself.

PreviousDEXNextSwap API (Kodiak Router)

Last updated