Check transaction status

After submitting a wallet-signed artifact, you can verify on-chain status using the transaction status endpoint. Supports EVM, Solana, and Bitcoin.

When to use

• After POST /swap/{swapId}/signing leads to a broadcast transaction hash in your flow.
• To poll until the transaction is confirmed or failed.
• To show users real-time status (e.g. pending → confirmed).

Request

Endpoint: GET /status/transaction/{txHash} Required query: chainRef — chain where the transaction was submitted.

curl -X GET 'https://api.gateway.zert.com/api/v1/status/transaction/0x123...abc?chainRef=eth-mainnet' \
  -H 'Authorization: Bearer YOUR_API_KEY'

Use the correct chainRef for the chain of the tx (e.g. eth-mainnet, polygon-mainnet, solana-mainnet, bitcoin).

Response

{
  "data": {
    "txHash": "0x123...abc",
    "chain": "eth-mainnet",
    "status": "confirmed",
    "confirmedAtMs": 1745400000000
  },
  "meta": { "requestId": "...", "timestamp": "..." }
}

Status values

Status	Description
pending	Submitted, not yet confirmed
confirmed	Confirmed on chain
failed	Transaction failed

Polling example

Poll every few seconds until status is confirmed or failed, or until a timeout:

1. Call GET /status/transaction/{txHash}?chainRef=....
2. If data.status is confirmed or failed, stop.
3. If pending, wait (e.g. 3–5 seconds) and repeat.
4. Treat 404 as not indexed or not found yet, and retry only if that matches your expected flow.

See Get Transaction Status for full parameters, response fields, and error codes.