API Reference

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

aggregatorstringRequired

Name of the aggregator service

Example: swapnet

routerstringRequired

Router contract unique name used

Example: default-router

nativeTokenUsdPricenumberRequired

Current price of the native token on this chain

Example: 4622.638914277432

routerAddressstringOptional

Address of router contract (only when includeCalldata=true)

Example: 0x616000e384Ef1C2B52f5f3A88D57a3B64F23757e

calldatastringOptional

Calldata to settle the trade (only when includeCalldata=true)

Example: 0x87395540000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000001c0

gasLimitstringOptional

Estimated upper bound of gas consumption (only when includeCalldata=true)

Example: 1200000

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

addressstringRequired

Token contract address

Example: 0x853d955acef822db058eb8505911ed77f175b99e

namestringRequired

Token name

Example: Frax

symbolstringRequired

Token symbol

Example: FRAX

decimalsinteger · max: 18Required

Number of decimal places for the token

Example: 18

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

chainIdintegerRequired

Unique identifier for the blockchain network

Example: 1

namestringRequired

Human-readable name of the blockchain network

Example: Ethereum

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

chainIdintegerRequired

Unique identifier for the blockchain network

Example: 1

namestringRequired

Human-readable name of the blockchain network

Example: Ethereum

usdTokenAddressstringRequired

Address of the primary USD-pegged token on this chain

Example: 0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48

wrappedNativeTokenAddressstringRequired

Address of the wrapped native token (e.g., WETH, WMATIC)

Example: 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2

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