RathRath Finance
API Reference

Status

Returns bridge transaction status and execution progress for a tracked route.

GET
/status

Query Parameters

providerKey*string

Bridge or routing provider key returned by the quote response. Required. Use the exact provider identifier you want to check.

txRef*string

Transaction reference returned by the provider or quote/build response. Required. This is the primary lookup key for status tracking.

fromChainId?|

Optional source chain ID hint to help the status resolver disambiguate provider state.

Formatint64
Range0 <= value
toChainId?|

Optional destination chain ID hint to help the status resolver disambiguate provider state.

Formatint64
Range0 <= value

Header Parameters

api-key*string

Required API key used for authenticated access and account-based rate limits. Missing or invalid keys return 401.

Response Body

application/json

curl -X GET "https://api.xpath.rath.fi/status?providerKey=string&txRef=string" \  -H "api-key: string"
{
  "code": 0,
  "data": {
    "destinationTxHash": "string",
    "details": null,
    "providerKey": "string",
    "sourceTxHash": "string",
    "state": "string",
    "txRef": "string",
    "updatedAtMs": 0
  },
  "message": "string"
}
Empty
Empty