Default

Get swap routing plan

get

Returns a graph-based routing plan for swap request. The plan includes detailed routes through various liquidity sources and can optionally include encoded calldata for immediate execution.

Query parameters

chainIdintegerRequired

Integer ID of the blockchain

Example: 1

sellTokenstringRequired

Address of sell token. For native tokens, use either 0x0000000000000000000000000000000000000000 or 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee

Example: 0x853d955acef822db058eb8505911ed77f175b99e

buyTokenstringRequired

Address of buy token. For native tokens, use either 0x0000000000000000000000000000000000000000 or 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee

Example: 0x1f9840a85d5af5bf1d1762f925bdaddc4201f984

sellAmountstringOptional

Amount of sellToken to sell (in base units). Exactly one of sellAmount or buyAmount must be provided.

Example: 10000000000000000000000

buyAmountstringOptional

Amount of buyToken to buy (in base units). Exactly one of sellAmount or buyAmount must be provided.

Example: 1000000000000000000

useRfqbooleanOptional

Whether to use market maker RFQ liquidity

Default: falseExample: false

routerstring · enumOptional

Router contract unique name

Default: default-routerExample: swapnet-routerPossible values:

includeCalldatabooleanOptional

Whether to include calldata in the response

Default: falseExample: false

userAddressstringOptional

User's wallet address. Required when includeCalldata=true

Example: 0x11b86991c6218b36c1d19d4a2e9eb0ce3606eb49

slippageTolerancenumber · max: 1Optional

Slippage tolerance (0.01 = 1%). Required when includeCalldata=true

Example: 0.01

apiKeystringRequired

Your API key

Example: your-api-key-here

Responses

200

Successful swap routing response

application/json

400

Bad request - Invalid parameters

application/json

500

Internal server error

application/json

get

/swap

HTTPcURLJavaScriptPython

GET /api/v1.0/swap?chainId=1&sellToken=text&buyToken=text&apiKey=text HTTP/1.1
Host: app.swap-net.xyz
Accept: */*

{
  "aggregator": "swapnet",
  "router": "default-router",
  "sell": {
    "referenceId": 7,
    "amount": "10000000000000000000000"
  },
  "buy": {
    "referenceId": 6,
    "amount": "1034955025987043448356"
  },
  "nativeTokenUsdPrice": 4622.638914277432,
  "tokens": [
    {
      "referenceId": 7,
      "address": "0x853d955acef822db058eb8505911ed77f175b99e",
      "name": "Frax",
      "symbol": "FRAX",
      "decimals": 18,
      "usdPrice": 0.9985832349359104
    },
    {
      "referenceId": 6,
      "address": "0x1f9840a85d5af5bf1d1762f925bdaddc4201f984",
      "name": "Uniswap",
      "symbol": "UNI",
      "decimals": 18,
      "usdPrice": 9.632281172169868
    }
  ],
  "routes": [
    {
      "address": "0xc63b0708e2f7e69cb8a1df0e1389a98c35a76d52",
      "name": "UniswapV3",
      "details": {
        "fee": 500
      },
      "fromTokens": [
        {
          "referenceId": 7,
          "amount": "10000000000000000000000"
        }
      ],
      "toTokens": [
        {
          "referenceId": 6,
          "amount": "1034955025987043448356"
        }
      ]
    }
  ]
}

Get example tokens

get

Returns a list of example tokens for trading on the specified chain. Notice that this is not a full list of tradable tokens.

Query parameters

chainIdintegerRequired

Integer ID of the blockchain

Example: 1

apiKeystringRequired

Your API key

Example: your-api-key-here

Responses

200

Successful tokens response

application/json

400

Bad request - Invalid parameters

application/json

500

Internal server error

application/json

get

/tokens

HTTPcURLJavaScriptPython

GET /api/v1.0/tokens?chainId=1&apiKey=text HTTP/1.1
Host: app.swap-net.xyz
Accept: */*

[
  {
    "address": "0x853d955acef822db058eb8505911ed77f175b99e",
    "name": "Frax",
    "symbol": "FRAX",
    "decimals": 18,
    "metadata": {
      "logoURI": "https://example.com/frax.png"
    }
  },
  {
    "address": "0x1f9840a85d5af5bf1d1762f925bdaddc4201f984",
    "name": "Uniswap",
    "symbol": "UNI",
    "decimals": 18,
    "metadata": {
      "logoURI": "https://example.com/uni.png"
    }
  }
]

Get available chains

get

Returns a list of blockchain networks supported by the SwapNet aggregator.

Query parameters

apiKeystringRequired

Your API key

Example: your-api-key-here

Responses

200

Successful chains response

application/json

400

Bad request - Invalid parameters

application/json

500

Internal server error

application/json

get

/chains

HTTPcURLJavaScriptPython

GET /api/v1.0/chains?apiKey=text HTTP/1.1
Host: app.swap-net.xyz
Accept: */*

[
  {
    "chainId": 1,
    "name": "Ethereum"
  },
  {
    "chainId": 137,
    "name": "Polygon"
  },
  {
    "chainId": 42161,
    "name": "Arbitrum One"
  }
]

Get detailed chain information

get

Returns detailed information about a specific blockchain network, including supported routers, liquidity sources, and key token addresses.

Query parameters

chainIdintegerRequired

Integer ID of the blockchain

Example: 1

apiKeystringRequired

Your API key

Example: your-api-key-here

Responses

200

Successful chain info response

application/json

400

Bad request - Invalid parameters

application/json

500

Internal server error

application/json

get

/chainInfo

HTTPcURLJavaScriptPython

GET /api/v1.0/chainInfo?chainId=1&apiKey=text HTTP/1.1
Host: app.swap-net.xyz
Accept: */*

{
  "chainId": 1,
  "name": "Ethereum",
  "usdTokenAddress": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
  "wrappedNativeTokenAddress": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
  "routers": [
    {
      "name": "default-router",
      "liquiditySources": [
        "UniswapV2",
        "UniswapV3",
        "SushiswapV2"
      ],
      "deployedAddress": "0x616000e384Ef1C2B52f5f3A88D57a3B64F23757e",
      "hasEncoder": true
    }
  ]
}