Skip to main content
Track transaction confirmation events by hash or by sender address.

Choose A Topic

NeedTopic
Track one known transactiontx-status/{hash}
Track transactions from one senderaddress/{bech32}
Both topics deliver txStatus events. Address topics can also deliver accountDelta events.

Request

{
  "action": "subscribe",
  "requestId": "tx-001",
  "topic": "tx-status/<hash>"
}

Acknowledgment

{
  "action": "subscribe",
  "requestId": "tx-001",
  "status": "ok",
  "topic": "tx-status/<hash>"
}

Pushed Event

{
  "type": "txStatus",
  "data": {
    "hash": "a1b2c3...",
    "status": "success",
    "reason": null,
    "sender": "erd1..."
  }
}

Status Values

StatusMeaning
pendingSeen but not finalized.
successFinalized successfully.
failFinalized with failure; inspect reason.
invalidRejected as invalid.
droppedDropped before finalization.

Limits

LimitValue
Active topics64 per WebSocket connection
DeliveryAfter transaction status ingestion
Hash trackingOne topic per hash

Unsubscribe

{
  "action": "unsubscribe",
  "requestId": "tx-stop",
  "topic": "tx-status/<hash>"
}

Reconnect Handling

After reconnect, resubscribe to still-pending hashes. For completed hashes, prefer a Gateway status lookup instead of keeping long-lived topics.