Build Transaction

curl -X POST https://zap.dzap.io/v1/buildTx \
  -H "Content-Type: application/json" \
  -d '{ "srcToken": "...", "srcChainId": 8453, ... }'

const tx = await dzap.buildZapTxn({
  srcToken: '0x...',
  srcChainId: 8453,
  destToken: '0x...',
  destChainId: 8453,
  amount: '5000000',
  recipient: '0x...',
  refundee: '0x...',
  slippage: 0.5,
  account: '0x...',
});

// Sign + send via your wallet client

{
  "status": "success",
  "data": {
    "approvalData": [
      {
        "callTo": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "approveTo": "0x1d46863e3592745008b5CbbAC12014F67329A9b8",
        "amount": "1680715"
      }
    ],
    "dust": [],
    "output": [
      {
        "amount": "918943376897193",
        "amountUSD": "1.68",
        "minAmount": "918024433520296",
        "asset": { "symbol": "WETH", "chainId": 8453 }
      }
    ],
    "path": [
      {
        "action": "swap",
        "protocol": { "id": "dzap", "name": "Dzap Aggregator" },
        "input": [{ "amount": "1680715", "amountUSD": "1.68", "asset": { "symbol": "USDC", "chainId": 8453 } }],
        "output": [{ "amount": "918943376897193", "amountUSD": "1.68", "minAmount": "918024433520296", "asset": { "symbol": "WETH", "chainId": 8453 } }],
        "fee": [],
        "estimatedDuration": 10
      }
    ],
    "steps": [
      {
        "action": "swap",
        "data": {
          "type": "evm",
          "txnId": "0xabc...",
          "callTo": "0x1d46863e3592745008b5CbbAC12014F67329A9b8",
          "callData": "0x...",
          "value": "0",
          "estimatedGas": "350000"
        }
      }
    ]
  }
}

POST

buildTx

curl -X POST https://zap.dzap.io/v1/buildTx \
  -H "Content-Type: application/json" \
  -d '{ "srcToken": "...", "srcChainId": 8453, ... }'

const tx = await dzap.buildZapTxn({
  srcToken: '0x...',
  srcChainId: 8453,
  destToken: '0x...',
  destChainId: 8453,
  amount: '5000000',
  recipient: '0x...',
  refundee: '0x...',
  slippage: 0.5,
  account: '0x...',
});

// Sign + send via your wallet client

{
  "status": "success",
  "data": {
    "approvalData": [
      {
        "callTo": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "approveTo": "0x1d46863e3592745008b5CbbAC12014F67329A9b8",
        "amount": "1680715"
      }
    ],
    "dust": [],
    "output": [
      {
        "amount": "918943376897193",
        "amountUSD": "1.68",
        "minAmount": "918024433520296",
        "asset": { "symbol": "WETH", "chainId": 8453 }
      }
    ],
    "path": [
      {
        "action": "swap",
        "protocol": { "id": "dzap", "name": "Dzap Aggregator" },
        "input": [{ "amount": "1680715", "amountUSD": "1.68", "asset": { "symbol": "USDC", "chainId": 8453 } }],
        "output": [{ "amount": "918943376897193", "amountUSD": "1.68", "minAmount": "918024433520296", "asset": { "symbol": "WETH", "chainId": 8453 } }],
        "fee": [],
        "estimatedDuration": 10
      }
    ],
    "steps": [
      {
        "action": "swap",
        "data": {
          "type": "evm",
          "txnId": "0xabc...",
          "callTo": "0x1d46863e3592745008b5CbbAC12014F67329A9b8",
          "callData": "0x...",
          "value": "0",
          "estimatedGas": "350000"
        }
      }
    ]
  }
}

Takes a quote (or the same params you passed to /v1/quote) and returns transaction data ready to sign and submit.

Body

string

required

integer

required

string

required

integer

required

string

required

string

required

Address to refund if cross-chain settlement fails.

number

required

string

required

string

Amount in wei. Not needed for NFT-only operations.

string

Permit2 / EIP-2612 signature payload, if you signed one.

boolean

Whether to include a gas estimate in the response.

object

NFT-related operation details (e.g. Uniswap V3 LP NFT).

Show positionDetails

string

NFT ID associated with the zap.

object

Pool-specific details for liquidity operations.

Show poolDetails

integer

Lower tick (concentrated liquidity).

integer

Upper tick.

string[]

Whitelist of bridges to consider.

string[]

Whitelist of swap protocols to consider.

object

Integrator fee configuration.

Show integrator

string

Unique integrator identifier.

integer

Fee in basis points (1 bps = 0.01%).

string

Wallet address to receive integrator fees.

Response

string

object[]

Array of approvals to grant before executing (one per token that needs approval; empty if none needed).

Show approvalData item

string

Token contract to call.

string

Spender address.

string

Amount to approve.

object[]

Final output amount(s) of the whole zap.

Show output item

object

Show asset

integer

string

integer

string

object

{ id, name, icon } - present for protocol-specific tokens (e.g. LP tokens).

object[]

Present for LP/vault tokens: { chainId, address, name?, symbol, decimals, logo? }.

string

Output amount in token units.

string

USD value of the output.

string

Minimum guaranteed return amount.

object[]

Any leftover/unswept amounts produced by the route. Same shape as data.output items above.

object[]

Ordered list of route steps (same shape as the /v1/quote response).

Show path item

string

Step type, e.g. swap, bridge, deposit, withdraw, stake, unstake, increase, harvest.

object

{ id, name, icon } - the protocol used for this step.

object[]

Same shape as data.output items above, minus minAmount.

object[]

Same shape as data.output items above.

object[]

{ asset, amount, amountUSD, included } - included indicates whether the fee is already netted into the shown amounts.

integer

Estimated seconds for this step.

object[]

Ordered list of executable transaction steps - sign and submit these in order.

Show step item

string

Step action type (e.g. swap, deposit, bridge).

object

Chain-specific transaction payload - shape depends on the chain type.

Show data (evm)

string

"evm"

string

Contract to call.

string

Hex-encoded calldata.

string

Native value to send, in wei.

string

Show data (bvm - Bitcoin-like)

string

"bvm"

string

Show data (svm - Solana)

string

"svm"

string

string[]

object

{ blockhash, lastValidBlockHeight }, when present.

string

boolean

Examples

curl -X POST https://zap.dzap.io/v1/buildTx \
  -H "Content-Type: application/json" \
  -d '{ "srcToken": "...", "srcChainId": 8453, ... }'

const tx = await dzap.buildZapTxn({
  srcToken: '0x...',
  srcChainId: 8453,
  destToken: '0x...',
  destChainId: 8453,
  amount: '5000000',
  recipient: '0x...',
  refundee: '0x...',
  slippage: 0.5,
  account: '0x...',
});

// Sign + send via your wallet client

{
  "status": "success",
  "data": {
    "approvalData": [
      {
        "callTo": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "approveTo": "0x1d46863e3592745008b5CbbAC12014F67329A9b8",
        "amount": "1680715"
      }
    ],
    "dust": [],
    "output": [
      {
        "amount": "918943376897193",
        "amountUSD": "1.68",
        "minAmount": "918024433520296",
        "asset": { "symbol": "WETH", "chainId": 8453 }
      }
    ],
    "path": [
      {
        "action": "swap",
        "protocol": { "id": "dzap", "name": "Dzap Aggregator" },
        "input": [{ "amount": "1680715", "amountUSD": "1.68", "asset": { "symbol": "USDC", "chainId": 8453 } }],
        "output": [{ "amount": "918943376897193", "amountUSD": "1.68", "minAmount": "918024433520296", "asset": { "symbol": "WETH", "chainId": 8453 } }],
        "fee": [],
        "estimatedDuration": 10
      }
    ],
    "steps": [
      {
        "action": "swap",
        "data": {
          "type": "evm",
          "txnId": "0xabc...",
          "callTo": "0x1d46863e3592745008b5CbbAC12014F67329A9b8",
          "callData": "0x...",
          "value": "0",
          "estimatedGas": "350000"
        }
      }
    ]
  }
}

Sign and submit each entry in data.steps in order via your wallet client. Once you have the resulting on-chain transaction hash, poll /v1/status (with chainId and txnHash) until the (possibly cross-chain) settlement completes.

Last modified on July 29, 2026

Getting started

Fuse API

Trade API

Build Transaction

Body

Response

Examples

​Body

​Response

​Examples

Body

Response

Examples