LIlifi

GET /v1/relayer/status/{taskId}

Cross chain relay transfers might take a while to complete. Waiting on the transaction on the sending chain doesn't help here. For this reason we build a simple endpoint that let's you check the status of your transfer. Important: The endpoint returns a 200 successful response even if the transaction can not be found. This behavior accounts for the case that the transaction hash is valid but the transaction has not been mined yet. While non of the parameters fromChain, toChain and bridge are required, passing the fromChain parameter will speed up the request and is therefore encouraged. If you want to learn more about how to use this endpoint please have a look at our guide.

Request

Response

statusstring

Example response

{
  "status": "ok",
  "data": {
    "status": "DONE",
    "message": "All done",
    "metadata": {
      "chainId": 137,
      "txHash": "0x1425098ed5ecc5192070ac32a69dd924268b9df5e7a69764142473e9d022321a"
    },
    "transactionStatus": {
      "transactionId": "0xaddfdf22eeacd02f006e04bbb58f683394807664f62e150b078db0598ab64daa",
      "sending": {
        "txHash": "0x1425098ed5ecc5192070ac32a69dd924268b9df5e7a69764142473e9d022321a",
        "txLink": "https://polygonscan.com/tx/0x1425098ed5ecc5192070ac32a69dd924268b9df5e7a69764142473e9d022321a",
        "amount": "1000000",
        "token": {
          "address": "0xc2132D05D31c914a87C6611C10748AEb04B58e8F",
          "chainId": 137,
          "symbol": "USDT",
          "decimals": 6,
          "name": "USDT",
          "coinKey": "USDT",
          "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0xdAC17F958D2ee523a2206206994597C13D831ec7/logo.png",
          "priceUSD": "0.99989"
        },
        "chainId": 137,
        "gasPrice": "85184881231",
        "gasUsed": "361568",
        "gasToken": {
          "address": "0x0000000000000000000000000000000000000000",
          "chainId": 137,
          "symbol": "POL",
          "decimals": 18,
          "name": "Polygon Ecosystem Token",
          "coinKey": "POL",
          "logoURI": "https://static.debank.com/image/matic_token/logo_url/matic/6f5a6b6f0732a7a235131bd7804d357c.png",
          "priceUSD": "0.4506"
        },
        "gasAmount": "30800127136930208",
        "gasAmountUSD": "0.0139",
        "amountUSD": "0.9999",
        "timestamp": 1736518025
      },
      "receiving": {
        "txHash": "0x1425098ed5ecc5192070ac32a69dd924268b9df5e7a69764142473e9d022321a",
        "txLink": "https://polygonscan.com/tx/0x1425098ed5ecc5192070ac32a69dd924268b9df5e7a69764142473e9d022321a",
        "amount": "820847",
        "token": {
          "address": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
          "chainId": 137,
          "symbol": "USDC",
          "decimals": 6,
          "name": "USD Coin",
          "coinKey": "USDC",
          "logoURI": "https://static.debank.com/image/coin/logo_url/usdc/e87790bfe0b3f2ea855dc29069b38818.png",
          "priceUSD": "1.000100010001"
        },
        "chainId": 137,
        "gasPrice": "85184881231",
        "gasUsed": "361568",
        "gasToken": {
          "address": "0x0000000000000000000000000000000000000000",
          "chainId": 137,
          "symbol": "POL",
          "decimals": 18,
          "name": "Polygon Ecosystem Token",
          "coinKey": "POL",
          "logoURI": "https://static.debank.com/image/matic_token/logo_url/matic/6f5a6b6f0732a7a235131bd7804d357c.png",
          "priceUSD": "0.4506"
        },
        "gasAmount": "30800127136930208",
        "gasAmountUSD": "0.0139",
        "amountUSD": "0.8209",
        "timestamp": 1736518025
      }
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.