Track Status

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

const status = await dzap.getTradeTxnStatus({
  txHash: '0xabc...',
  chainId: 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" },
      "allowUserTxOnDestChain": false
    }
  ]
}

GET

status

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

const status = await dzap.getTradeTxnStatus({
  txHash: '0xabc...',
  chainId: 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" },
      "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). To check several transactions in one call, see Batch Status.

Query

Either txHash or txId, always paired with chainId:

string

On-chain transaction hash from the executed trade.

string

The DZap transaction ID returned when building the trade.

integer

required

Chain ID where the transaction was executed.

Response

string

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

boolean

string

integer

Unix timestamp.

string

swap, bridge, or zap.

object[]

One entry per leg of the trade.

Show transaction leg

string

COMPLETED, FAILED, PENDING, PARTIAL, or REFUNDED.

object

Show source

object

Show asset

string

integer

string

integer

string

object[]

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

string

number

string

object

Same shape as source above, plus an optional timestamp.

object

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

object

{ id, name, icon }.

boolean

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

string

Human-readable detail, especially on failure.

string

Link to the provider’s own tracking page.

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

const status = await dzap.getTradeTxnStatus({
  txHash: '0xabc...',
  chainId: 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" },
      "allowUserTxOnDestChain": false
    }
  ]
}

Last modified on July 29, 2026

Getting started

Fuse API

Trade API

Track Status

Query

Response

​Query

​Response

Query

Response