Status - DZap

curl "https://api.dzap.io/v1/status?txHash=0xabc...&chainId=42161"

curl "https://api.dzap.io/v1/status/multi?txHashes=0x123...,0x456...&chainIds=1,42161"

const status = await dzap.getTradeTxnStatus({
  txHash: '0xabc...',
  chainId: 42161,
});

const multiStatus = await dzap.getTradeMultiTxnStatus({
  txHashes: '0x123...,0x456...',
  chainIds: '1,42161',
});

{
  "status": "COMPLETED",
  "gasless": false,
  "txHash": "0xabc...",
  "chainId": 42161,
  "timestamp": 1714117200,
  "type": "bridge",
  "transactions": [
    {
      "status": "COMPLETED",
      "source": { "asset": { "contract": "0xaf88...", "chainId": 42161, "symbol": "USDC" }, "amount": "1000000", "amountUSD": 1.0, "txHash": "0xabc...", "account": "0x99BC..." },
      "destination": { "asset": { "contract": "0x4200...", "chainId": 8453, "symbol": "WETH" }, "amount": "300000000000000", "amountUSD": 0.99, "txHash": "0xdef...", "account": "0x99BC...", "timestamp": 1714117290 },
      "provider": { "id": "across", "name": "Across", "icon": "https://..." },
      "allowUserTxOnDestChain": false
    }
  ]
}

GET

status

curl "https://api.dzap.io/v1/status?txHash=0xabc...&chainId=42161"

curl "https://api.dzap.io/v1/status/multi?txHashes=0x123...,0x456...&chainIds=1,42161"

const status = await dzap.getTradeTxnStatus({
  txHash: '0xabc...',
  chainId: 42161,
});

const multiStatus = await dzap.getTradeMultiTxnStatus({
  txHashes: '0x123...,0x456...',
  chainIds: '1,42161',
});

{
  "status": "COMPLETED",
  "gasless": false,
  "txHash": "0xabc...",
  "chainId": 42161,
  "timestamp": 1714117200,
  "type": "bridge",
  "transactions": [
    {
      "status": "COMPLETED",
      "source": { "asset": { "contract": "0xaf88...", "chainId": 42161, "symbol": "USDC" }, "amount": "1000000", "amountUSD": 1.0, "txHash": "0xabc...", "account": "0x99BC..." },
      "destination": { "asset": { "contract": "0x4200...", "chainId": 8453, "symbol": "WETH" }, "amount": "300000000000000", "amountUSD": 0.99, "txHash": "0xdef...", "account": "0x99BC...", "timestamp": 1714117290 },
      "provider": { "id": "across", "name": "Across", "icon": "https://..." },
      "allowUserTxOnDestChain": false
    }
  ]
}

Returns step-level status for a trade. Cross-chain trades are async; poll until the status reaches a terminal state (COMPLETED, FAILED, PARTIAL, or REFUNDED).

Query

Either txHash or txId, always paired with chainId:

txHash

string

On-chain transaction hash from the executed trade.

txId

string

The DZap transaction ID returned when building the trade.

chainId

integer

required

Chain ID where the transaction was executed.

Response

status

string

Overall status: COMPLETED, FAILED, PENDING, PARTIAL, or REFUNDED.

gasless

boolean

txHash

string

chainId

integer

timestamp

integer

Unix timestamp.

type

string

swap, bridge, or zap.

transactions

object[]

One entry per leg of the trade.

Show transaction leg

status

string

COMPLETED, FAILED, PENDING, PARTIAL, or REFUNDED.

source

object

Show source

asset

object

Show asset

contract

string

chainId

integer

name

string

symbol

string

decimals

integer

logo

string

underlyingTokens

object[]

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

amount

string

amountUSD

number

txHash

string

account

string

destination

object

Same shape as source above, plus an optional timestamp.

expected

object

Expected destination amount before execution (same shape as source above, minus txHash/status).

provider

object

{ id, name, icon }.

allowUserTxOnDestChain

boolean

Whether the user needs to take action on the destination chain.

message

string

Human-readable detail, especially on failure.

protocolExplorerLink

string

Link to the provider’s own tracking page.

Batch status

GET https://api.dzap.io/v1/status/multi

Check several transactions in one call. Accepts comma-separated txHashes/txIds aligned positionally to comma-separated chainIds, and returns an array of the same response shape as above.

txHashes

string

Comma-separated transaction hashes.

txIds

string

Comma-separated DZap transaction IDs.

chainIds

string

required

Comma-separated chain IDs, aligned to txHashes/txIds.

Examples

curl "https://api.dzap.io/v1/status?txHash=0xabc...&chainId=42161"

curl "https://api.dzap.io/v1/status/multi?txHashes=0x123...,0x456...&chainIds=1,42161"

const status = await dzap.getTradeTxnStatus({
  txHash: '0xabc...',
  chainId: 42161,
});

const multiStatus = await dzap.getTradeMultiTxnStatus({
  txHashes: '0x123...,0x456...',
  chainIds: '1,42161',
});

{
  "status": "COMPLETED",
  "gasless": false,
  "txHash": "0xabc...",
  "chainId": 42161,
  "timestamp": 1714117200,
  "type": "bridge",
  "transactions": [
    {
      "status": "COMPLETED",
      "source": { "asset": { "contract": "0xaf88...", "chainId": 42161, "symbol": "USDC" }, "amount": "1000000", "amountUSD": 1.0, "txHash": "0xabc...", "account": "0x99BC..." },
      "destination": { "asset": { "contract": "0x4200...", "chainId": 8453, "symbol": "WETH" }, "amount": "300000000000000", "amountUSD": 0.99, "txHash": "0xdef...", "account": "0x99BC...", "timestamp": 1714117290 },
      "provider": { "id": "across", "name": "Across", "icon": "https://..." },
      "allowUserTxOnDestChain": false
    }
  ]
}

Last modified on July 14, 2026

Execute Tokens

​Query

​Response

​Batch status

​Examples

Query

Response

Batch status

Examples