Bundle

curl -X POST https://zap.dzap.io/v1/bundle/quote \
  -H "Content-Type: application/json" \
  -d '{
    "account": "0xUser",
    "recipient": "0xUser",
    "refundee": "0xUser",
    "slippage": 0.5,
    "actions": [
      {
        "action": "swap",
        "srcChainId": 42161,
        "srcToken": { "address": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "amount": "1000000" },
        "destToken": "0x724dc807b04555b71ed48a6896b6F41593b8C637"
      }
    ]
  }'

import type { ZapBundleRequest } from "@dzapio/sdk";

const bundleRequest: ZapBundleRequest = {
  account: "0xUser",
  recipient: "0xUser",
  refundee: "0xUser",
  slippage: 0.5,
  actions: [
    {
      action: "swap",
      srcChainId: 42161,
      srcToken: { address: "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", amount: "1000000" },
      destToken: "0x724dc807b04555b71ed48a6896b6F41593b8C637",
    },
  ],
};

// Quote only
const bundleQuote = await dzap.getZapBundleQuote(bundleRequest);

// Or get executable transaction steps directly
const bundleTx = await dzap.buildZapBundleTx(bundleRequest);

{
  "status": "success",
  "data": {
    "approvalData": [
      {
        "callTo": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
        "approveTo": "0x1d46863e3592745008b5CbbAC12014F67329A9b8",
        "amount": "1000000"
      }
    ],
    "dust": [],
    "output": [
      {
        "amount": "918943376897193",
        "amountUSD": "1.68",
        "minAmount": "918024433520296",
        "asset": { "symbol": "aUSDC", "chainId": 42161 }
      }
    ],
    "path": [
      {
        "action": "swap",
        "protocol": { "id": "dzap", "name": "Dzap Aggregator" },
        "input": [{ "amount": "1000000", "amountUSD": "1.00", "asset": { "symbol": "USDC", "chainId": 42161 } }],
        "output": [{ "amount": "918943376897193", "amountUSD": "1.68", "minAmount": "918024433520296", "asset": { "symbol": "aUSDC", "chainId": 42161 } }],
        "fee": [],
        "estimatedDuration": 10
      }
    ]
  }
}

POST

bundle

quote

curl -X POST https://zap.dzap.io/v1/bundle/quote \
  -H "Content-Type: application/json" \
  -d '{
    "account": "0xUser",
    "recipient": "0xUser",
    "refundee": "0xUser",
    "slippage": 0.5,
    "actions": [
      {
        "action": "swap",
        "srcChainId": 42161,
        "srcToken": { "address": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "amount": "1000000" },
        "destToken": "0x724dc807b04555b71ed48a6896b6F41593b8C637"
      }
    ]
  }'

import type { ZapBundleRequest } from "@dzapio/sdk";

const bundleRequest: ZapBundleRequest = {
  account: "0xUser",
  recipient: "0xUser",
  refundee: "0xUser",
  slippage: 0.5,
  actions: [
    {
      action: "swap",
      srcChainId: 42161,
      srcToken: { address: "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", amount: "1000000" },
      destToken: "0x724dc807b04555b71ed48a6896b6F41593b8C637",
    },
  ],
};

// Quote only
const bundleQuote = await dzap.getZapBundleQuote(bundleRequest);

// Or get executable transaction steps directly
const bundleTx = await dzap.buildZapBundleTx(bundleRequest);

{
  "status": "success",
  "data": {
    "approvalData": [
      {
        "callTo": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
        "approveTo": "0x1d46863e3592745008b5CbbAC12014F67329A9b8",
        "amount": "1000000"
      }
    ],
    "dust": [],
    "output": [
      {
        "amount": "918943376897193",
        "amountUSD": "1.68",
        "minAmount": "918024433520296",
        "asset": { "symbol": "aUSDC", "chainId": 42161 }
      }
    ],
    "path": [
      {
        "action": "swap",
        "protocol": { "id": "dzap", "name": "Dzap Aggregator" },
        "input": [{ "amount": "1000000", "amountUSD": "1.00", "asset": { "symbol": "USDC", "chainId": 42161 } }],
        "output": [{ "amount": "918943376897193", "amountUSD": "1.68", "minAmount": "918024433520296", "asset": { "symbol": "aUSDC", "chainId": 42161 } }],
        "fee": [],
        "estimatedDuration": 10
      }
    ]
  }
}

Bundle several zap actions (e.g. multiple deposits, or a swap plus a deposit) into a single request. There are two endpoints: /v1/bundle/quote to price the bundle, and /v1/bundle/buildTx to get executable transaction data for it. Both accept the same request body and return the same overall response shape as /v1/quote and /v1/buildTx respectively - the difference is the actions array replaces the single srcToken/destToken pair.

Body

actions

object[]

required

Ordered list of zap actions to bundle. See “Action shape” below.

account

string

required

User account initiating the bundle.

recipient

string

required

Address to receive the final tokens/positions.

refundee

string

required

Address to receive refunds if an action fails partway.

slippage

number

required

Slippage tolerance, in percent. 0.5 = 0.5%.

quotesOnly

boolean

If true, skip building executable transaction steps (only meaningful on /v1/bundle/buildTx).

estimateGas

boolean

Whether to include a gas estimate in the response.

allowedDexes

string[]

Whitelist of swap protocols to consider.

allowedBridges

string[]

Whitelist of bridges to consider.

integrator

object

Integrator fee configuration.

Show integrator

string

Unique integrator identifier.

feeBps

integer

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

wallet

string

Wallet address to receive integrator fees.

Action shape

Each entry in actions[]:

action

string

required

Action type: swap, bridge, deposit, withdraw, stake, unstake, increase, or harvest.

srcChainId

integer

required

srcToken

object | object[]

required

A single { address: string; amount?: string } or an array of them (for multi-token deposits).

destToken

string

Destination token (or LP/NFT) address. Optional depending on the action.

destChainId

integer

Required for cross-chain actions.

positionDetails

object

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

Show positionDetails

nftId

string

NFT ID associated with the action.

poolDetails

object

Pool-specific details for liquidity operations.

Show poolDetails

lowerTick

integer

Lower tick (concentrated liquidity).

upperTick

integer

Upper tick.

protocol

string

Force a specific protocol for this action instead of auto-selecting the best one.

Response

Both endpoints return the same top-level status field. The data shape depends on which endpoint you call:

status

string

data.approvalData

object[]

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

Show approvalData item

callTo

string

Token contract to call.

approveTo

string

Spender address.

amount

string

Amount to approve.

data.output

object[]

Final output amount(s) of the whole bundle.

Show output item

asset

object

Show asset

chainId

integer

address

string

symbol

string

name

string

logo

string

decimals

integer

price

string

type

string

provider

object

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

underlyingTokens

object[]

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

amount

string

Output amount in token units.

amountUSD

string

USD value of the output.

minAmount

string

Minimum guaranteed return amount.

data.dust

object[]

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

data.path

object[]

Ordered list of route steps.

Show path item

action

string

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

protocol

object

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

input

object[]

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

output

object[]

Same shape as data.output items above.

fee

object[]

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

estimatedDuration

integer

Estimated seconds for this step.

data.steps

object[]

Only present from /v1/bundle/buildTx. Ordered list of executable transaction steps - sign and submit these in order.

Show step item

action

string

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

data

object

Chain-specific transaction payload - EVM: { type: "evm", txnId, callTo, callData, value, estimatedGas }; similar shapes exist for Bitcoin-like (bvm) and Solana (svm) chains - see Build Transaction for the full breakdown.

Examples

curl -X POST https://zap.dzap.io/v1/bundle/quote \
  -H "Content-Type: application/json" \
  -d '{
    "account": "0xUser",
    "recipient": "0xUser",
    "refundee": "0xUser",
    "slippage": 0.5,
    "actions": [
      {
        "action": "swap",
        "srcChainId": 42161,
        "srcToken": { "address": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", "amount": "1000000" },
        "destToken": "0x724dc807b04555b71ed48a6896b6F41593b8C637"
      }
    ]
  }'

import type { ZapBundleRequest } from "@dzapio/sdk";

const bundleRequest: ZapBundleRequest = {
  account: "0xUser",
  recipient: "0xUser",
  refundee: "0xUser",
  slippage: 0.5,
  actions: [
    {
      action: "swap",
      srcChainId: 42161,
      srcToken: { address: "0xaf88d065e77c8cC2239327C5EDb3A432268e5831", amount: "1000000" },
      destToken: "0x724dc807b04555b71ed48a6896b6F41593b8C637",
    },
  ],
};

// Quote only
const bundleQuote = await dzap.getZapBundleQuote(bundleRequest);

// Or get executable transaction steps directly
const bundleTx = await dzap.buildZapBundleTx(bundleRequest);

{
  "status": "success",
  "data": {
    "approvalData": [
      {
        "callTo": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
        "approveTo": "0x1d46863e3592745008b5CbbAC12014F67329A9b8",
        "amount": "1000000"
      }
    ],
    "dust": [],
    "output": [
      {
        "amount": "918943376897193",
        "amountUSD": "1.68",
        "minAmount": "918024433520296",
        "asset": { "symbol": "aUSDC", "chainId": 42161 }
      }
    ],
    "path": [
      {
        "action": "swap",
        "protocol": { "id": "dzap", "name": "Dzap Aggregator" },
        "input": [{ "amount": "1000000", "amountUSD": "1.00", "asset": { "symbol": "USDC", "chainId": 42161 } }],
        "output": [{ "amount": "918943376897193", "amountUSD": "1.68", "minAmount": "918024433520296", "asset": { "symbol": "aUSDC", "chainId": 42161 } }],
        "fee": [],
        "estimatedDuration": 10
      }
    ]
  }
}

Last modified on July 14, 2026

Status Execute

Getting started

Fuse API

Trade API

Body

Action shape

Response

Examples

​Body

​Action shape

​Response

​Examples

Body

Action shape

Response

Examples