Skip to main content
POST
/
v1
/
buildTx
Build a zap transaction
curl --request POST \
  --url https://zap.dzap.io/v1/buildTx \
  --header 'Content-Type: application/json' \
  --data '{
  "srcToken": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
  "srcChainId": 8453,
  "destToken": "0xd0b53D9277642d899DF5C87A3966A349A798F224",
  "destChainId": 8453,
  "amount": "5000000",
  "recipient": "0x99BCEBf44433E901597D9fCb16E799a4847519f6",
  "slippage": 0.5,
  "account": "0x99BCEBf44433E901597D9fCb16E799a4847519f6",
  "estimateGas": false,
  "positionDetails": {},
  "poolDetails": {}
}'
{
  "status": "success",
  "data": {
    "amountOut": "918943376897193",
    "approvalData": {
      "callTo": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "approveTo": "0x1d46863e3592745008b5CbbAC12014F67329A9b8",
      "amount": "1680715"
    },
    "path": [
      {
        "action": "swap",
        "protocol": {
          "id": "dzap",
          "name": "Dzap Aggregator",
          "icon": "https://dzap.io/favicon.ico"
        },
        "input": [
          {
            "amount": "1680715",
            "amountUSD": "1.68072",
            "asset": {
              "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
              "chainId": 8453,
              "decimals": 6,
              "logo": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png",
              "price": "1",
              "symbol": "USDC",
              "name": "USD Coin",
              "type": "ERC20"
            }
          }
        ],
        "output": [
          {
            "amount": "918943376897193",
            "minReturn": "918024433520296",
            "amountUSD": "1.68295",
            "asset": {
              "address": "0x4200000000000000000000000000000000000006",
              "chainId": 8453,
              "decimals": 18,
              "logo": "https://static.debank.com/image/coin/logo_url/eth/d61441782d4a08a7479d54aea211679e.png",
              "price": "1831.4",
              "symbol": "WETH",
              "name": "Wrapped Ether",
              "type": "ERC20"
            }
          }
        ],
        "fee": [],
        "estimatedDuration": 10,
        "dust": []
      },
      {
        "action": "deposit",
        "protocol": {
          "id": "uniswap",
          "name": "Uniswap",
          "icon": "https://app.uniswap.org/favicon.png"
        },
        "input": [
          {
            "amount": "917721515538050",
            "amountUSD": "1.68072",
            "asset": {
              "address": "0x4200000000000000000000000000000000000006",
              "chainId": 8453,
              "decimals": 18,
              "logo": "https://static.debank.com/image/coin/logo_url/eth/d61441782d4a08a7479d54aea211679e.png",
              "price": "1831.4",
              "symbol": "WETH",
              "name": "Wrapped Ether",
              "type": "ERC20"
            }
          },
          {
            "amount": "3319285",
            "amountUSD": "3.31929",
            "asset": {
              "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
              "chainId": 8453,
              "decimals": 6,
              "logo": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png",
              "price": "1",
              "symbol": "USDC",
              "name": "USD Coin",
              "type": "ERC20"
            }
          }
        ],
        "output": [
          {
            "amount": "0",
            "minReturn": "0",
            "amountUSD": "0.00000",
            "asset": {
              "address": "0xd0b53D9277642d899DF5C87A3966A349A798F224",
              "chainId": 8453,
              "decimals": 18,
              "logo": "https://app.uniswap.org/favicon.png",
              "price": "0",
              "symbol": "Wrapped Ether/USD Coin",
              "name": "Wrapped Ether/USD Coin v3 0.05%",
              "type": "ERC721"
            }
          }
        ],
        "fee": [
          {
            "amount": "9177215155380",
            "amountUSD": "0.01681",
            "asset": {
              "address": "0x4200000000000000000000000000000000000006",
              "chainId": 8453,
              "decimals": 18,
              "logo": "https://static.debank.com/image/coin/logo_url/eth/d61441782d4a08a7479d54aea211679e.png",
              "price": "1831.4",
              "symbol": "WETH",
              "name": "Wrapped Ether",
              "type": "ERC20"
            }
          },
          {
            "amount": "33192",
            "amountUSD": "0.03319",
            "asset": {
              "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
              "chainId": 8453,
              "decimals": 6,
              "logo": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48/logo.png",
              "price": "1",
              "symbol": "USDC",
              "name": "USD Coin",
              "type": "ERC20"
            }
          }
        ],
        "estimatedDuration": 10,
        "dust": [
          {
            "amount": "302917982246",
            "minReturn": "302917982246",
            "amountUSD": "0.00055",
            "dust": true,
            "asset": {
              "address": "0x4200000000000000000000000000000000000006",
              "chainId": 8453,
              "decimals": 18,
              "logo": "https://static.debank.com/image/coin/logo_url/eth/d61441782d4a08a7479d54aea211679e.png",
              "price": "1831.4",
              "symbol": "WETH",
              "type": "ERC20",
              "name": "Wrapped Ether"
            }
          }
        ]
      }
    ],
    "steps": [
      {
        "action": "execute",
        "data": {
          "txnId": "0x393942432d313966362d31373436363231343536353330000000000000000000",
          "callTo": "0x1d46863e3592745008b5CbbAC12014F67329A9b8",
          "callData": "0xb71610c4393942432d313966362d3137343636323134353635333000000000000000000000000000000000000000000000000000000000000000000000000000000000e00000000000000000000000000000000000000000000000000000000000000de000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000e600000000000000000000000000000000000000000000000000000000000000f8000000000000000000000000099bcebf44433e901597d9fcb16e799a4847519f60000000000000000000000000000000000000000000000000000000000000ce00000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000034000000000000000000000000000000000000000000000000000000000000004400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000300000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000001000000000000000000000000833589fcd6edb6e08f4c7c32d4f71b54bda02913000000000000000000000000f708e11a7c94abde8f6217b13e6fe39c8b9cc0a6000000000000000000000000000000000000000000000000000000000019a54b0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000001000000000000000000000000420000000000000000000000000000000000000600000000000000000000000003a520b32c04bf3beef7beb72e919cf822ed34f1000000000000000000000000000000000000000000000000000342a9b0efb6820000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000271000000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000001000000000000000000000000833589fcd6edb6e08f4c7c32d4f71b54bda0291300000000000000000000000003a520b32c04bf3beef7beb72e919cf822ed34f1000000000000000000000000000000000000000000000000000000000032a5f50000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000271000000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000000000000000000000000000042000000000000000000000000000000000000060000000000000000000000001d46863e3592745008b5cbbac12014f67329a9b8000000000000000000000000000000000000000000000000000342f038414ea800000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000400000000000000000000000000000000000000000000000000000000000000620000000000000000000000000f708e11a7c94abde8f6217b13e6fe39c8b9cc0a600000000000000000000000000000000000000000000000000000000000000c0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000004e46022b00b3078316434362d3239413962382d3137343636323134353837393100000000000000000000000000000000001d46863e3592745008b5cbbac12014f67329a9b80000000000000000000000000000000000000000000000000000000000000060000000000000000000000000ef42f78d25f4c681dcad2597fa04877ff802ef4b000000000000000000000000ef42f78d25f4c681dcad2597fa04877ff802ef4b000000000000000000000000833589fcd6edb6e08f4c7c32d4f71b54bda029130000000000000000000000004200000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000019a54b000000000000000000000000000000000000000000000000000342f038414ea80000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000040000000000000000000000000000000000000000000000000000000000000002c473fc445700000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000277022400e01d46863e3592745008b5cbbac12014f67329a9b8833589fcd6edb6e08f4c7c32d4f71b54bda029134200000000000000000000000000000000000006e000d4c800d9f800e1e800e399ec4a8167630206d7ca0a5f9fdcd9a43a0c3db9985f26820685ec5b3e4dc7b710e4573205b861076a38861b0926a2eb292418ba80f00e8b5d4b8fa051308cff1c0000e0681b5540c8033f986314b6a3f800e819a54b060300e2128acb08000000000000000000000000fffd8963efd1fc6a506488495d951d5263988d2500000000000000000000000000000000000000000000000000000000000000a00000000000000000000000000000000000000000000000000000000000000014833589fcd6edb6e08f4c7c32d4f71b54bda029130000000000000000000000000100ea0603008a0300e20400ee0080a3c2fb43c7445d8ff8bd93dac53d98bde744402000070a000000000000000000000000000000000000000000000000000000000000030191050000020070000206070706000000000000000000000000000000000000000000000000000000c80343c62d8c74a90301bb0500600301dc00020a0b00000000000000000000000000000000000000000000000000000000000301ed0500800301dceda49bce2f38d284f839be1f4f2e23e6c7cc7dbd0200700202170500a00005060708070000000000000000000000000000000000000000000000000000000302340500800301dc0500600200700200480500c002000000e600ea0000000040016e017d017d07002001b201b8000006002001b801bb000008002001e401ed0000070020020e02170000030000022b023400000800200255026100000300000261026a00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000600000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000003a520b32c04bf3beef7beb72e919cf822ed34f100000000000000000000000000000000000000000000000000000000000000c000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000200000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000164883164560000000000000000000000004200000000000000000000000000000000000006000000000000000000000000833589fcd6edb6e08f4c7c32d4f71b54bda0291300000000000000000000000000000000000000000000000000000000000001f4fffffffffffffffffffffffffffffffffffffffffffffffffffffffffffcedfcfffffffffffffffffffffffffffffffffffffffffffffffffffffffffffcee1000000000000000000000000000000000000000000000000000033a50f44979ce000000000000000000000000000000000000000000000000000000000032244d0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000099bcebf44433e901597d9fcb16e799a4847519f600000000000000000000000000000000000000000000000000000000681b622400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004116942205a523e344e6acc7b3e7146565c1ab36411fa34b2f131c3ade52e376633457201cb43dcc9b9aea911904ff072922438a8fccb9916f2c9597b6679d6e9c1b0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000020000000000000000000000000833589fcd6edb6e08f4c7c32d4f71b54bda0291300000000000000000000000000000000000000000000000000000000004c4b40000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000000600000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002000000000000000000000000833589fcd6edb6e08f4c7c32d4f71b54bda029130000000000000000000000004200000000000000000000000000000000000006",
          "value": "0",
          "estimatedGas": "0"
        }
      }
    ]
  }
}

Body

application/json
​
srcToken
string
required

Source token address

Example:

"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"

​
srcChainId
integer
required

Source chain ID

Example:

8453

​
destToken
string
required

Destination token address

Example:

"0x4C36388bE6F416A29C8d8Eee81C771cE6bE14B18"

​
destChainId
integer
required

Destination chain ID

Example:

8453

​
recipient
string
required

Recipient address for the swapped tokens

Example:

"0x99BCEBf44433E901597D9fCb16E799a4847519f6"

​
slippage
number
required

Slippage tolerance in percentage

Example:

0.5

​
account
string
required

Account address initiating the swap

Example:

"0x99BCEBf44433E901597D9fCb16E799a4847519f6"

​
amount
string

Amount to swap or liquidity to add/remove (optional)

Example:

"5000000"

​
estimateGas
boolean

Estimates gas and simulates the transaction, defaults to false (optional)

Example:

false

​
permit
string

Encoded permit2 data for ERC20 tokens (optional)

​
positionDetails
object

Optional position details for NFT-related operations

​
poolDetails
object

Optional pool details for liquidity operations

​
allowedBridges
string[]

Optional list of allowed bridges for the swap

List of allowed bridge protocols

​
allowedDexes
string[]

Optional list of allowed swap protocols for the swap

List of allowed swap protocols

Response

Successful response with Path information

​
status
string

Indicates whether the operation was successful

​
data
object

Path information or additional details

⌘I