Fetch status for swap or bridge transaction(s)

curl --request GET \
  --url https://api.dzap.io/v1/status

{
  "42161-0x4afecedbed3b35d8e3ab88aeca30166e20d09f0a5459512f0b10c4198225ab03": {
    "42161_0xaf88d065e77c8cC2239327C5EDb3A432268e5831-137_0x0000000000000000000000000000000000000000": {
      "srcChainId": 42161,
      "srcToken": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
      "srcAmount": "2000000",
      "srcAmountUSD": "1.99963",
      "srcTxHash": "0x4afecedbed3b35d8e3ab88aeca30166e20d09f0a5459512f0b10c4198225ab03",
      "destChainId": 137,
      "destToken": "0x0000000000000000000000000000000000000000",
      "destAmount": "3828561316214991485",
      "destAmountUSD": "1.99569",
      "destTxHash": "0xcb891ed63cf151cfdb51cd9c8efbbbe9bff0cb7e87be6e191e6125ef9c6ce8a1",
      "account": "0x545d9a8649A092ce25d469591B638057C4DF3385",
      "recipient": "0x545d9a8649A092ce25d469591B638057C4DF3385",
      "provider": "router",
      "allowUserTxOnDestChain": true,
      "status": "COMPLETED"
    }
  }
}

GET

status

curl --request GET \
  --url https://api.dzap.io/v1/status

{
  "42161-0x4afecedbed3b35d8e3ab88aeca30166e20d09f0a5459512f0b10c4198225ab03": {
    "42161_0xaf88d065e77c8cC2239327C5EDb3A432268e5831-137_0x0000000000000000000000000000000000000000": {
      "srcChainId": 42161,
      "srcToken": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
      "srcAmount": "2000000",
      "srcAmountUSD": "1.99963",
      "srcTxHash": "0x4afecedbed3b35d8e3ab88aeca30166e20d09f0a5459512f0b10c4198225ab03",
      "destChainId": 137,
      "destToken": "0x0000000000000000000000000000000000000000",
      "destAmount": "3828561316214991485",
      "destAmountUSD": "1.99569",
      "destTxHash": "0xcb891ed63cf151cfdb51cd9c8efbbbe9bff0cb7e87be6e191e6125ef9c6ce8a1",
      "account": "0x545d9a8649A092ce25d469591B638057C4DF3385",
      "recipient": "0x545d9a8649A092ce25d469591B638057C4DF3385",
      "provider": "router",
      "allowUserTxOnDestChain": true,
      "status": "COMPLETED"
    }
  }
}

Query Parameters

txHash

string

Transaction hash (used with chainId for single tx lookup)

chainId

integer

Source chain ID (used with txHash for single tx lookup)

txIds

string

Comma-separated list of srcChainId-txHash (e.g., 10-0xabc...,42161-0xdef...)

Response

Successfully fetched status

Option 1
Option 2

Response format when querying with txIds parameter - groups transactions by their ID

{key}

object

Transaction group keyed by 'chainId-txHash' format, containing status data for each bridge/swap pair

Show child attributes

{key}.{key}

object

Transaction status data keyed by 'srcChainId_srcTokenAddress-destChainId_destTokenAddress' format

Show child attributes

{key}.{key}.srcChainId

integer

required

Source blockchain network ID

Example:

42161

{key}.{key}.srcToken

string<address>

required

Source token contract address

Example:

"0xaf88d065e77c8cC2239327C5EDb3A432268e5831"

{key}.{key}.srcAmount

string

required

Source token amount in smallest unit (wei/atoms)

Example:

"2000000"

{key}.{key}.srcAmountUSD

string

required

Source amount value in USD

Example:

"1.99963"

{key}.{key}.srcTxHash

string

required

Source transaction hash

Example:

"0x4afecedbed3b35d8e3ab88aeca30166e20d09f0a5459512f0b10c4198225ab03"

{key}.{key}.destChainId

integer

required

Destination blockchain network ID

Example:

137

{key}.{key}.destToken

string<address>

required

Destination token contract address (0x0 for native token)

Example:

"0x0000000000000000000000000000000000000000"

{key}.{key}.destAmount

string

required

Destination token amount in smallest unit

Example:

"3828561316214991485"

{key}.{key}.destAmountUSD

string

required

Destination amount value in USD

Example:

"1.99569"

{key}.{key}.account

string<address>

required

Account that initiated the transaction

Example:

"0x545d9a8649A092ce25d469591B638057C4DF3385"

{key}.{key}.recipient

string<address>

required

Account that will receive the destination tokens

Example:

"0x545d9a8649A092ce25d469591B638057C4DF3385"

{key}.{key}.provider

string

required

Bridge/swap provider used for this transaction

Example:

"router"

{key}.{key}.allowUserTxOnDestChain

boolean

required

Whether user action is required on destination chain

Example:

true

{key}.{key}.status

enum<string>

required

Current status of the bridge/swap transaction

Available options:

PENDING,

IN_PROGRESS,

COMPLETED,

FAILED,

CANCELLED

Example:

"COMPLETED"

{key}.{key}.destTxHash

string | null

Destination transaction hash (null if transaction not yet executed)

Example:

"0xcb891ed63cf151cfdb51cd9c8efbbbe9bff0cb7e87be6e191e6125ef9c6ce8a1"

Build a transaction for swap or bridge Supported chains

⌘I

Trade API

Zap API

Fetch status for swap or bridge transaction(s)

Query Parameters

Response