API & SDK

Swap tokens

post

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

Body

amountInnumberRequiredExample: 1

inputTokenstringRequiredExample: 0x8ede5b689d5ac487c3ee48ceabe28ae061be74071c86ffe523b7f42acda2fcb7::test_usdc::TestUSDC

outputTokenstringRequiredExample: 0x8ede5b689d5ac487c3ee48ceabe28ae061be74071c86ffe523b7f42acda2fcb7::test_usdt::TestUSDT

Responses

200

Successful swap response.

application/json

post

HTTPcURLJavaScriptPython

POST /api/swap HTTP/1.1
Host: swap-backend-prod-340342993997.asia-south2.run.app
Content-Type: application/json
Accept: */*
Content-Length: 221

{
  "amountIn": 1,
  "inputToken": "0x8ede5b689d5ac487c3ee48ceabe28ae061be74071c86ffe523b7f42acda2fcb7::test_usdc::TestUSDC",
  "outputToken": "0x8ede5b689d5ac487c3ee48ceabe28ae061be74071c86ffe523b7f42acda2fcb7::test_usdt::TestUSDT"
}

200

Successful swap response.

{
  "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"
      ]
    }
  }
}