Transaction Status

GET /api/v1/relayer/tx/status

Query status of a submitted transaction by hash. No auth required.

Only returns transactions relayed by this service (sender_type = TransactionRelayer).

Query	Required	Description
tx_hash	yes	Transaction hash (64 hex chars, optional 0x)

{
  "hash": "0xabc...",
  "status": "TxStatusPending",
  "status_code": 1,
  "replaced_by_hash": ""
}

Field	Type	Description
hash	string	Transaction hash
status	string	Status name (see Transaction status)
status_code	int	Status code
replaced_by_hash	string	Replacement tx hash if replaced; omitted or empty otherwise

Common errors (status: "40001")

Message	Cause
tx_hash is required	No query parameter provided
invalid tx_hash	Invalid hash format
transaction not found	No matching relayer record

Status values

status_code	status	Meaning
0	Unknown TxStatus (0)	Unknown
1	TxStatusPending	Submitted, awaiting confirmation
2	TxStatusReplaced	Replaced by a higher-gas transaction
3	TxStatusConfirmed	Confirmed successfully
4	TxStatusConfirmedFailed	Confirmed but execution failed

Request example

Set TX_HASH to the hash returned by transaction submission.

curl -sS --get https://mainnet-gw.sodex.dev/api/v1/relayer/tx/status \
  --data-urlencode "tx_hash=$TX_HASH"