Look Up a Relay Transaction

Endpoint

GET /transaction

Server: https://api.openfish.fun

Authentication: None required

---

Query Parameters

Parameter	Type	Required	Description
id	string (UUID)	Yes	Transaction ID

---

Responses

200 — Transaction found

Field	Type	Required	Description
transactionID	string	Yes	Transaction UUID
transactionHash	string	Yes	On-chain transaction hash (empty if not yet submitted)
state	string	Yes	"STATE_NEW", "STATE_EXECUTED", "STATE_CONFIRMED", "STATE_FAILED"
from	string	Yes	Sender address
to	string	Yes	Target contract address
proxy_address	string	Yes	Proxy wallet address (if applicable)
type	string	Yes	Relay type ("PROXY", "SAFE")
nonce	integer	Yes	Meta-transaction nonce
createdAt	string	Yes	ISO 8601 timestamp

Sample Response:

{
  "transactionID": "0190b317-a1d3-7bec-9b91-eeb6dcd3a620",
  "transactionHash": "0xabc123...",
  "state": "STATE_CONFIRMED",
  "from": "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266",
  "to": "0xA642f9165D192Ff13b1D43a0Ef56B3BD074614bB",
  "proxy_address": "",
  "type": "PROXY",
  "nonce": 61,
  "createdAt": "2026-04-09T12:00:00Z"
}

400 — Bad Request

{ "error": "invalid id" }

404 — Not Found

{ "error": "transaction not found" }