Get transaction status

GET /status

Resolve swap progress from a source transaction hash. Status values are pending, src_confirmed, completed, and failed. A hash that does not match any known swap returns status pending with empty destination details rather than an error, so this endpoint is safe to poll immediately after broadcasting.

Authentication

Send your API key in the api-key header.

Parameters

Name	In	Type	Required	Description
txHash	query	string	yes	Source transaction hash to track.
fromChain	query	integer	yes	Chain id the transaction was sent on.
userAddress	query	string	no	Optional wallet address echoed back in the response.

Responses

Status	Description
200	Tracking state for the transaction.
401	Missing or invalid API key. Plausible catalog codes behind the numeric status are AUTH_001 (unauthorized access) and AUTH_002 (invalid API key).
500	Unexpected server-side failure. Plausible catalog codes behind the numeric status include SYSTEM_002 (internal server error) and SYSTEM_001 (database operation failed).

200 response

{
  "code": 0,
  "message": "success",
  "data": {
    "status": "completed",
    "kind": "sameChainSwap",
    "provider": {
      "key": "vector",
      "name": "Vector"
    },
    "srcTxDetails": {
      "txHash": "0x9c2f4e8a1b3d5c7e9f0a2b4c6d8e0f1a3b5c7d9e1f2a4b6c8d0e2f4a6b8c0d2e",
      "chainId": 8453,
      "chainLogo": null,
      "timestamp": null
    },
    "destTxDetails": {
      "txHash": "0x5e1a7c3b9d2f4e6a8c0b1d3f5a7c9e0b2d4f6a8c1e3b5d7f9a0c2e4b6d8f0a1c",
      "chainId": 8453,
      "chainLogo": null,
      "timestamp": null
    },
    "routeKind": "sameChainSwap",
    "updatedAtMs": 1785283260123,
    "userAddress": "0x1a2B3c4D5e6F7a8B9c0D1e2F3a4B5c6D7e8F9a0B"
  }
}

401 response

{
  "code": 401,
  "data": null,
  "message": "missing api-key header"
}

500 response

{
  "code": 500,
  "data": null,
  "message": "internal server error"
}