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
}
]
}
Status
Track Status
Track the status of a single trade (swap or bridge) transaction by hash or ID.
GET
/
v1
/
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
EithertxHash 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
integer
Unix timestamp.
string
swap, bridge, or zap.object[]
One entry per leg of the trade.
Show transaction leg
Show transaction leg
string
COMPLETED, FAILED, PENDING, PARTIAL, or REFUNDED.object
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