Best Build

curl -X POST https://api.dzap.io/v1/best-build \
  -H "Content-Type: application/json" \
  -d '{
    "fromChain": 42161,
    "account": "0x99BCEBf44433E901597D9fCb16E799a4847519f6",
    "refundee": "0x99BCEBf44433E901597D9fCb16E799a4847519f6",
    "data": [
      {
        "amount": "1000000",
        "srcToken": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
        "destToken": "0x4200000000000000000000000000000000000006",
        "toChain": 8453,
        "slippage": 1,
        "recipient": "0x99BCEBf44433E901597D9fCb16E799a4847519f6"
      }
    ]
  }'

{
  "status": "success",
  "txId": "0xabc123...",
  "chainId": 42161,
  "transaction": {
    "from": "0x99BCEBf44433E901597D9fCb16E799a4847519f6",
    "data": "0x...",
    "to": "0x1d46863e3592745008b5CbbAC12014F67329A9b8",
    "value": "0",
    "gasLimit": "350000"
  },
  "broadcastViaProvider": false,
  "quotes": {
    "42161_0xaf88d065e77c8cC2239327C5EDb3A432268e5831_8453_0x4200000000000000000000000000000000000006": {
      "across": {
        "providerDetails": { "id": "across", "name": "Across", "icon": "https://..." },
        "destAmount": "300000000000000",
        "minDestAmount": "298500000000000",
        "priceImpact": "-0.12",
        "duration": "90"
      },
      "stargate": {
        "providerDetails": { "id": "stargate", "name": "Stargate", "icon": "https://..." },
        "destAmount": "299500000000000",
        "minDestAmount": "298000000000000",
        "priceImpact": "-0.15",
        "duration": "60"
      }
    }
  },
  "selectedProviders": {
    "42161_0xaf88d065e77c8cC2239327C5EDb3A432268e5831_8453_0x4200000000000000000000000000000000000006": "across"
  }
}

POST

best-build

curl -X POST https://api.dzap.io/v1/best-build \
  -H "Content-Type: application/json" \
  -d '{
    "fromChain": 42161,
    "account": "0x99BCEBf44433E901597D9fCb16E799a4847519f6",
    "refundee": "0x99BCEBf44433E901597D9fCb16E799a4847519f6",
    "data": [
      {
        "amount": "1000000",
        "srcToken": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
        "destToken": "0x4200000000000000000000000000000000000006",
        "toChain": 8453,
        "slippage": 1,
        "recipient": "0x99BCEBf44433E901597D9fCb16E799a4847519f6"
      }
    ]
  }'

{
  "status": "success",
  "txId": "0xabc123...",
  "chainId": 42161,
  "transaction": {
    "from": "0x99BCEBf44433E901597D9fCb16E799a4847519f6",
    "data": "0x...",
    "to": "0x1d46863e3592745008b5CbbAC12014F67329A9b8",
    "value": "0",
    "gasLimit": "350000"
  },
  "broadcastViaProvider": false,
  "quotes": {
    "42161_0xaf88d065e77c8cC2239327C5EDb3A432268e5831_8453_0x4200000000000000000000000000000000000006": {
      "across": {
        "providerDetails": { "id": "across", "name": "Across", "icon": "https://..." },
        "destAmount": "300000000000000",
        "minDestAmount": "298500000000000",
        "priceImpact": "-0.12",
        "duration": "90"
      },
      "stargate": {
        "providerDetails": { "id": "stargate", "name": "Stargate", "icon": "https://..." },
        "destAmount": "299500000000000",
        "minDestAmount": "298000000000000",
        "priceImpact": "-0.15",
        "duration": "60"
      }
    }
  },
  "selectedProviders": {
    "42161_0xaf88d065e77c8cC2239327C5EDb3A432268e5831_8453_0x4200000000000000000000000000000000000006": "across"
  }
}

Combines /v1/quotes and /v1/buildTx into one request: it collects quotes from every eligible provider for each pair in data, picks the best route per pair, and returns transaction calldata ready to sign - along with every provider’s quote so you can show alternatives without a second call. Whether a request is treated as a same-chain swap or a cross-chain bridge is inferred automatically: if fromChain equals data[0].toChain, it’s a swap; otherwise it’s a bridge. overrideMultiTx only applies to bridge requests; maximizeMinToAmount and nonceOffset only apply to swap requests.

Body

integer

required

Source chain ID for every item in data.

string

required

Wallet address sending the transaction.

string

required

Address to receive refunds.

object[]

required

Array of trade legs to quote and build.

Show data item

string

required

Amount to send, in the source token’s smallest unit.

string

required

Source token contract address.

integer

Source token decimals (skips a lookup if provided).

string

required

Destination token contract address.

integer

Destination token decimals (skips a lookup if provided).

integer

required

Destination chain ID.

number

required

Slippage tolerance, in percent.

string

required

Address to receive the destination tokens for this leg.

string

Restrict/prefer quoting to a specific provider ID.

boolean

Request gasless-eligible quotes/build. Default false.

boolean

Request private/MEV-protected quotes/build. Default false.

boolean

Skip gas estimation for a faster build.

boolean

Skip USD pricing lookups for a faster response.

boolean

Simulate each candidate route on-chain before selecting the winner. Slower, but filters out routes that would revert.

boolean

Swap only. Runs extra on-chain checks to find the highest safe minToAmount for the selected route.

integer

Swap only. Offset applied to the sender’s nonce when building the transaction.

boolean

Bridge only. Overrides the default multi-transaction batching behavior.

object

Allow/deny list of bridge providers: { allow?: string[]; deny?: string[] }.

object

Allow/deny list of DEX providers: { allow?: string[]; deny?: string[] }.

object

Fine-tune quote collection timing.

Show timingStrategy

integer

Minimum wait time before returning results.`.

integer

Maximum wait time for quote optimization.`.

integer

Delay between subsequent provider batches..

integer

Target number of quotes to collect..

boolean

Return partial results once maxWaitTimeMs is hit.

boolean

Set true if Permit2 approval already exists for every token in data.

Response - success

string

"success" when the build succeeds.

string

Unique build/transaction ID - use for status polling and broadcasting.

integer

Chain where the transaction is to be executed.

object

Chain-specific payload, ready to sign. Same shape as transaction in the /v1/buildTx response - see that page for the per-chain-type field breakdown (evm, svm, btc, btcln, HyperLiquid).

boolean

Whether the built transaction must be broadcast via the winning provider rather than submitted directly.

object

Every provider that successfully quoted (and, if simulate was set, passed simulation) for each pair - not just the winner used to build transaction. Keyed by pair ID ({fromChain}_{srcToken}_{toChain}_{destToken}), then by provider ID. Within each pair, providers are ranked best-first by net return.

Show quotes[pairId][providerId]

object

Show providerDetails

string

May be null if a token’s USD price is unavailable.

string

Estimated seconds to completion.

object

Keyed by pair ID (same keys as quotes) - the provider ID whose quote was actually used to build transaction for that pair.

Response - error

string

"error".

string

Build ID, if one was generated before the failure. Empty string otherwise.

string

Failure reason.

Examples

curl -X POST https://api.dzap.io/v1/best-build \
  -H "Content-Type: application/json" \
  -d '{
    "fromChain": 42161,
    "account": "0x99BCEBf44433E901597D9fCb16E799a4847519f6",
    "refundee": "0x99BCEBf44433E901597D9fCb16E799a4847519f6",
    "data": [
      {
        "amount": "1000000",
        "srcToken": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
        "destToken": "0x4200000000000000000000000000000000000006",
        "toChain": 8453,
        "slippage": 1,
        "recipient": "0x99BCEBf44433E901597D9fCb16E799a4847519f6"
      }
    ]
  }'

{
  "status": "success",
  "txId": "0xabc123...",
  "chainId": 42161,
  "transaction": {
    "from": "0x99BCEBf44433E901597D9fCb16E799a4847519f6",
    "data": "0x...",
    "to": "0x1d46863e3592745008b5CbbAC12014F67329A9b8",
    "value": "0",
    "gasLimit": "350000"
  },
  "broadcastViaProvider": false,
  "quotes": {
    "42161_0xaf88d065e77c8cC2239327C5EDb3A432268e5831_8453_0x4200000000000000000000000000000000000006": {
      "across": {
        "providerDetails": { "id": "across", "name": "Across", "icon": "https://..." },
        "destAmount": "300000000000000",
        "minDestAmount": "298500000000000",
        "priceImpact": "-0.12",
        "duration": "90"
      },
      "stargate": {
        "providerDetails": { "id": "stargate", "name": "Stargate", "icon": "https://..." },
        "destAmount": "299500000000000",
        "minDestAmount": "298000000000000",
        "priceImpact": "-0.15",
        "duration": "60"
      }
    }
  },
  "selectedProviders": {
    "42161_0xaf88d065e77c8cC2239327C5EDb3A432268e5831_8453_0x4200000000000000000000000000000000000006": "across"
  }
}

Use the txId to poll /v1/status once the transaction has been signed and sent.

Last modified on August 11, 2026

Getting started

Fuse API

Trade API

Body

Response - success

Response - error

Examples

​Body

​Response - success

​Response - error

​Examples

Body

Response - success

Response - error

Examples