API & SDK

Swap tokens

Perform a token swap using the specified input and output tokens.

POSThttps://swap-backend-prod-340342993997.asia-south2.run.app/api/swap

Body

application/json

amountIn*number

Example: 1

inputToken*string

Example: "0x8ede5b689d5ac487c3ee48ceabe28ae061be74071c86ffe523b7f42acda2fcb7::test_usdc::TestUSDC"

outputToken*string

Example: "0x8ede5b689d5ac487c3ee48ceabe28ae061be74071c86ffe523b7f42acda2fcb7::test_usdt::TestUSDT"

Response

200

Successful swap response.

Body

application/json

statusstring

Example: "success"

dataobject

Request

JavaScriptCurlPython

const response = await fetch('https://swap-backend-prod-340342993997.asia-south2.run.app/api/swap', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "amountIn": 1,
      "inputToken": "0x8ede5b689d5ac487c3ee48ceabe28ae061be74071c86ffe523b7f42acda2fcb7::test_usdc::TestUSDC",
      "outputToken": "0x8ede5b689d5ac487c3ee48ceabe28ae061be74071c86ffe523b7f42acda2fcb7::test_usdt::TestUSDT"
    }),
});
const data = await response.json();

Response

200

{
  "status": "success",
  "data": {
    "inputToken": {
      "token": "0x8ede5b689d5ac487c3ee48ceabe28ae061be74071c86ffe523b7f42acda2fcb7::test_usdc::TestUSDC",
      "decimals": 6,
      "price": 1
    },
    "outputToken": {
      "token": "0x8ede5b689d5ac487c3ee48ceabe28ae061be74071c86ffe523b7f42acda2fcb7::test_usdt::TestUSDT",
      "decimals": 6,
      "price": 1
    },
    "inputAmount": 1,
    "inputAmountUSD": 1,
    "outputAmount": 0.97,
    "outputAmountUSD": 0.97,
    "route": [
      {
        "fromToken": "0x8ede5b689d5ac487c3ee48ceabe28ae061be74071c86ffe523b7f42acda2fcb7::test_usdc::TestUSDC",
        "toToken": "0x8ede5b689d5ac487c3ee48ceabe28ae061be74071c86ffe523b7f42acda2fcb7::test_eth::TestETH",
        "poolType": "0x8ede5b689d5ac487c3ee48ceabe28ae061be74071c86ffe523b7f42acda2fcb7::weighted_pool::WeightedPool<...>"
      }
    ],
    "txnData": {
      "function": "0x8ede5b689d5ac487c3ee48ceabe28ae061be74071c86ffe523b7f42acda2fcb7::entry::swap_exact_in_multihop",
      "typeArguments": [
        "text"
      ],
      "arguments": [
        "text"
      ]
    }
  }
}