Obtain the status of a specific bridge transaction by withdrawal hash

curl --request GET \
  --url https://api.rhino.fi/bridge/history/bridge/by-withdraw-hash/{withdrawTxHash} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.rhino.fi/bridge/history/bridge/by-withdraw-hash/{withdrawTxHash}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.rhino.fi/bridge/history/bridge/by-withdraw-hash/{withdrawTxHash}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.rhino.fi/bridge/history/bridge/by-withdraw-hash/{withdrawTxHash}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.rhino.fi/bridge/history/bridge/by-withdraw-hash/{withdrawTxHash}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.rhino.fi/bridge/history/bridge/by-withdraw-hash/{withdrawTxHash}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "_id": "<string>",
  "userId": "<string>",
  "chainIn": "<string>",
  "chainOut": "<string>",
  "amountIn": "<string>",
  "amountInUsd": 123,
  "amountOut": "<string>",
  "amountOutUsd": 123,
  "amountNative": "<string>",
  "amountNativeUsd": 123,
  "fee": "<string>",
  "feeUsd": 123,
  "gasFee": "<string>",
  "gasFeeUsd": 123,
  "platformFee": "<string>",
  "platformFeeUsd": 123,
  "percentageFee": "<string>",
  "percentageFeeUsd": 123,
  "sourceGasFee": "<string>",
  "sourceGasFeeUsd": 123,
  "sponsoredFees": {
    "fee": "<string>",
    "feeUsd": 123,
    "gasFee": "<string>",
    "gasFeeUsd": 123,
    "platformFee": "<string>",
    "platformFeeUsd": 123,
    "percentageFee": "<string>",
    "percentageFeeUsd": 123,
    "sourceGasFee": "<string>",
    "sourceGasFeeUsd": 123
  },
  "recipient": "<string>",
  "depositor": "<string>",
  "createdAt": "<string>",
  "commitmentDate": "<string>",
  "token": "<string>",
  "usdPrice": 123,
  "depositTxHash": "<string>",
  "depositCommittedAt": "<string>",
  "withdrawTxHash": "<string>",
  "withdrawCommittedAt": "<string>",
  "state": "EXECUTED",
  "estimatedDuration": 1,
  "postBridgeData": {
    "_tag": "extended",
    "vaultId": 1
  },
  "flowCredits": 123,
  "_tag": "bridge",
  "depositDiscoveredAt": "<string>",
  "depositConfirmedAt": "<string>",
  "expectedDepositConfirmedAt": "<string>",
  "expectedDepositConfirmedAtBlock": 123,
  "preSwapTxHash": "<string>",
  "preSwapCommittedAt": "<string>",
  "isConfirmed": true
}

{
  "issues": [
    {
      "path": [
        "<string>"
      ],
      "message": "<string>"
    }
  ],
  "message": "<string>",
  "_tag": "HttpApiDecodeError"
}

{
  "message": "<string>",
  "_tag": "Unauthorized"
}

{
  "message": "<string>",
  "_tag": "InvalidRequest"
}

GET

history

bridge

by-withdraw-hash

{withdrawTxHash}

Obtain the status of a specific bridge transaction by withdrawal hash

curl --request GET \
  --url https://api.rhino.fi/bridge/history/bridge/by-withdraw-hash/{withdrawTxHash} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.rhino.fi/bridge/history/bridge/by-withdraw-hash/{withdrawTxHash}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.rhino.fi/bridge/history/bridge/by-withdraw-hash/{withdrawTxHash}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.rhino.fi/bridge/history/bridge/by-withdraw-hash/{withdrawTxHash}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.rhino.fi/bridge/history/bridge/by-withdraw-hash/{withdrawTxHash}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.rhino.fi/bridge/history/bridge/by-withdraw-hash/{withdrawTxHash}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "_id": "<string>",
  "userId": "<string>",
  "chainIn": "<string>",
  "chainOut": "<string>",
  "amountIn": "<string>",
  "amountInUsd": 123,
  "amountOut": "<string>",
  "amountOutUsd": 123,
  "amountNative": "<string>",
  "amountNativeUsd": 123,
  "fee": "<string>",
  "feeUsd": 123,
  "gasFee": "<string>",
  "gasFeeUsd": 123,
  "platformFee": "<string>",
  "platformFeeUsd": 123,
  "percentageFee": "<string>",
  "percentageFeeUsd": 123,
  "sourceGasFee": "<string>",
  "sourceGasFeeUsd": 123,
  "sponsoredFees": {
    "fee": "<string>",
    "feeUsd": 123,
    "gasFee": "<string>",
    "gasFeeUsd": 123,
    "platformFee": "<string>",
    "platformFeeUsd": 123,
    "percentageFee": "<string>",
    "percentageFeeUsd": 123,
    "sourceGasFee": "<string>",
    "sourceGasFeeUsd": 123
  },
  "recipient": "<string>",
  "depositor": "<string>",
  "createdAt": "<string>",
  "commitmentDate": "<string>",
  "token": "<string>",
  "usdPrice": 123,
  "depositTxHash": "<string>",
  "depositCommittedAt": "<string>",
  "withdrawTxHash": "<string>",
  "withdrawCommittedAt": "<string>",
  "state": "EXECUTED",
  "estimatedDuration": 1,
  "postBridgeData": {
    "_tag": "extended",
    "vaultId": 1
  },
  "flowCredits": 123,
  "_tag": "bridge",
  "depositDiscoveredAt": "<string>",
  "depositConfirmedAt": "<string>",
  "expectedDepositConfirmedAt": "<string>",
  "expectedDepositConfirmedAtBlock": 123,
  "preSwapTxHash": "<string>",
  "preSwapCommittedAt": "<string>",
  "isConfirmed": true
}

{
  "issues": [
    {
      "path": [
        "<string>"
      ],
      "message": "<string>"
    }
  ],
  "message": "<string>",
  "_tag": "HttpApiDecodeError"
}

{
  "message": "<string>",
  "_tag": "Unauthorized"
}

{
  "message": "<string>",
  "_tag": "InvalidRequest"
}

Authorizations

Authorization

string

header

required

JWT token for authentication

Path Parameters

withdrawTxHash

string

required

The transaction hash of a withdrawal for a bridge transaction, e.g. "0x5c504ed432cb51138bcf09aa5e8a410dd4a1e204ef84bfed1be16dfba1b22060".

Response

BridgeExecuted

Option 1
Option 2
Option 3

_id

string

required

userId

string

required

The projectID that the transaction is associated with.

chainIn

string

required

The blockchain that the tokens were bridged from.

chainOut

string

required

The blockchain that the tokens were bridged to.

amountIn

string

required

The native value of the tokens that were sent on the chainIn.

amountInUsd

number

required

The USD value of the tokens that were sent on the chainIn.

amountOut

string

required

The native value of the tokens that were sent on the chainOut.

amountOutUsd

number

required

The USD value of the tokens that were sent on the chainOut.

amountNative

string | null

required

The amount of native gas token (e.g. ETH, MATIC, BNB) that was delivered to the user's wallet on the destination chain as part of gas boost functionality, where Rhino.fi delivers a small amount of native gas token to the destination address, ensuring that further transactions from this address can be made immediately.

amountNativeUsd

number | null

required

The value, in USD, of amountNative.

fee

string

required

The total cost of the transaction as paid by the end customer, denominated in the token.

feeUsd

number

required

The total cost, in USD, of the transaction.

gasFee

string

required

Any chain specific costs charged to the end customer for the chainOut part of the overall transaction. Further information about which chains have these associated costs can be found here: https://learn.rhino.fi/articles/7749894324-tron-and-solana-onchain-gas-costs. If these costs are being paid by the client then this value will be zero and the gasFee and gasFeeUsd in the sponsored fee body will be non-zero.

gasFeeUsd

number

required

The gasFee value, in USD.

platformFee

string

required

The resulting fee charged from the $-based Client Surcharge. This is applicable to both legacy and PAYG/Subscription clients. For legacy clients this is deducted from the tokens sent on the chainOut and will be sent to the client at month end. For PAYG/Subscription clients this will be rebated at month end.

platformFeeUsd

number

required

The platformFee value, in USD.

percentageFee

string

required

The resulting fee charged from the %-based Client Surcharge. This is applicable to both legacy and PAYG/Subscription clients. For legacy clients this is deducted from the tokens sent on the chainOut and will be sent to the client at month end. For PAYG/Subscription clients this will be rebated at month end.

percentageFeeUsd

number

required

The percentageFee value, in USD.

sourceGasFee

string

required

The cost on the chainIn to sweep the received tokens into Rhino.fi's control. For legacy clients this is deducted from the tokens sent on the chainOut. For PAYG/Subscription tier clients this is paid by Rhino.fi as part of the PAYG/Subscription monthly cost so no direct cost is passed onto the end customer, unless configured this way. This is only relevant for transactions involving a Rhino.fi Smart Deposit Address; for bridging/swapping-only activity the sourceGasFee will be paid directly by the customer within their depositing transaction.

sourceGasFeeUsd

number

required

The sourceGasFee value, in USD.

sponsoredFees

object

required

For both legacy and PAYG/Subscription clients, represents the fees that are paid by the client on behalf of the end customer.

Show child attributes

recipient

string

required

The address on the chainOut that received the bridged tokens.

depositor

string

required

The address on the chainIn that sent the tokens for bridging.

createdAt

string

required

The datetime that the bridging / bridging+swapping quote was created.

commitmentDate

string

required

The datetime that the bridging / bridging+swapping quote was committed with Rhino.fi.

token

string

required

The asset being bridged, sent on the chainIn and received on the chainOut.

usdPrice

number

required

The USD price of the token at the time the quote was created.

depositTxHash

string

required

The transaction hash of the deposit made on the chainIn.

depositCommittedAt

string

required

The datetime that the deposit transaction was committed on the chainIn.

withdrawTxHash

string

required

The transaction hash of the withdrawal of the tokens to the recipient on the chainOut.

withdrawCommittedAt

string

required

The datetime that the withdrawal transaction was committed on the chainOut.

state

enum<string>

required

Available options:

EXECUTED

speed

enum<string>

Provides information about whether the transaction is expected to be completed "fast" (typically under 30 seconds), "standard" (typically under a minute) or "slow" (can be up to 20 minutes). For more information on our bridge processing speeds please read this article on the Rhino.fi Knowledge Base: https://learn.rhino.fi/articles/8257872655-bridge-speed.

Available options:

fast,

standard,

slow

estimatedDuration

number

The estimated time for the transaction to complete in milliseconds.

Required range: x >= 0

postBridgeData

object

Custom Routing Rules as configured by Rhino.fi for a specific client, e.g. to move funds after the initial bridge into a yield bearing vault. To understand more about how Routing Rules can help automate onchain actions and ensure that your funds land in an active state, please contact your Rhino.fi Customer Success Manager or speak to a member of the Rhino.fi sales team.

Show child attributes

flowCredits

number

The number of Flow Credits that this transaction will use from the client's agreed Rhino.fi PAYG/Subscription tier.

_tag

enum<string>

Available options:

bridge

depositDiscoveredAt

string

The datetime that Rhino.fi first discovered the deposit transaction on the chainIn.

depositConfirmedAt

string

The datetime that the deposit transaction reached the required number of confirmations on the chainIn.

expectedDepositConfirmedAt

string

The datetime that the deposit transaction is expected to reach the required number of confirmations on the chainIn.

expectedDepositConfirmedAtBlock

integer

The block on the chainIn at which the deposit transaction is expected to reach the required number of confirmations.

preSwapTxHash

string

The transaction hash of the swap performed on the chainIn before bridging.

preSwapCommittedAt

string

The datetime that the pre-bridge swap was committed on the chainIn.

isConfirmed

boolean

Whether the deposit transaction has reached the required number of confirmations on the chainIn.

⌘I

API Documentation

Bridge & swap endpoints

SDA endpoints

Webhook endpoints

Obtain the status of a specific bridge transaction by withdrawal hash

Authorizations

Path Parameters

Response