Obtain a list of previously generated swapping and/or bridging quotes

This endpoint provides a full history of a user’s bridging and swapping activity. This includes commits for quotes generated through the POST /quote/bridge-swap/user endpoint and submitted through POST /quote/commit/{quoteId}, as well as bridges initiated via a Smart Deposit Address.

GET /history-cursor/user

Obtain a list of previously generated swapping and/or bridging quotes

cURL

curl --request GET \
  --url https://api.rhino.fi/bridge/history-cursor/user \
  --header 'Authorization: Bearer <token>'

200

{
  "items": [
    {
      "_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,
      "state": "PENDING",
      "speed": "fast",
      "estimatedDuration": 1,
      "postBridgeData": {
        "_tag": "extended",
        "vaultId": 1
      },
      "flowCredits": 123,
      "_tag": "bridge"
    }
  ],
  "nextPageToken": "<string>"
}

Authorizations

bearerlegacyApiKey

Authorization · string · header · required

JWT token for authentication

Query Parameters

sortBy · enum<string> · required

The field that results will be sorted by. Either "createdAt" (sorting by the datetime that the quote was created) or "updatedAt" (sorting by the datetime that the quote was last updated). Must be used in conjunction with sortDirection.

Available options: createdAt, updatedAt

Example:

"createdAt"

sortDirection · enum<string> · required

The order that results will be returned in. Either "asc" or "desc". Must be used in conjunction with sortBy.

Available options: asc, desc

Example:

"desc"

pageToken · string

a non empty string

Minimum string length: 1

pageSize · string · required

a string to be decoded into a number

state · enum<string>

Optional filter by the status of the bridge/bridge+swap transaction. One of: "PENDING" (the quote has been committed but the deposit has not yet been received and accepted for processing), "ACCEPTED" (the deposit has been accepted and the transaction is being processed onchain), or "EXECUTED" (fully processed onchain).

Available options: PENDING, ACCEPTED, EXECUTED

Example:

"PENDING"

Response

200

application/json

Success

items · object[] · required

Bridge transaction details.

Option 1

Option 2

Option 3

Option 4

Option 5

Option 6

Option 7

Option 8

Option 9

Option 10

Option 11

Option 12

Option 13

Option 14

Option 15

Option 16

Option 17

Option 18

Option 19

Option 20

Option 21

Option 22

Option 23

Show child attributes

nextPageToken · string | null · required

An opaque token identifying the next page of results, to be passed in the pageToken query param to fetch it. Null when there are no further pages.

Minimum string length: 1