Skip to main content
POST
/
v2
/
wallets
/
bridges
Create a bridging request
curl --request POST \
  --url https://production.hifibridge.com/v2/wallets/bridges \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "requestId": "<string>",
  "amount": 1,
  "source": {
    "userId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "chain": "POLYGON",
    "currency": "usdc"
  },
  "destination": {
    "chain": "POLYGON",
    "currency": "usdc",
    "userId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "walletAddress": "<string>"
  },
  "requireApproval": false
}
'
{
  "transferType": "WALLET.BRIDGE",
  "transferDetails": {
    "id": "9ccafd0f-e47f-43c2-8693-13741b67d638",
    "requestId": "1d860428-1d0b-47c5-9e65-98961ff59215",
    "createdAt": "2025-02-24T17:44:54.781519+00:00",
    "updatedAt": "2025-02-24T17:57:01.185+00:00",
    "amount": 0.01,
    "status": "COMPLETED",
    "source": {
      "userId": "a804f891-b63c-4b36-99ee-0aa83e6facde",
      "walletAddress": "0xE9cfBf1D690565579D823264170eE357f80e9A34",
      "chain": "POLYGON",
      "currency": "usdc"
    },
    "destination": {
      "userId": "a804f891-b63c-4b36-99ee-0aa83e6facde",
      "walletAddress": "0x17f043FB0a39334641beD627551AC095941157B0",
      "chain": "ETHEREUM",
      "currency": "usdc"
    },
    "receipt": {
      "transactionHash": "0x17f043FB0a39334641beD627551AC095941157B0",
      "operations": {
        "mint": {
          "transactionHash": "0x5784890f9efd0160e9401439a5cf2aa5350580ecf48f9ca2af617338ae089e53",
          "userOpHash": "0xef7bdb071b1fcfb5df629bd4d27ffa6dc32d0a5df676f26fb8c25311df1185ac",
          "chain": "ETHEREUM"
        },
        "burn": {
          "transactionHash": "0x5784890f9efd0160e9401439a5cf2aa5350580ecf48f9ca2af617338ae089e53",
          "userOpHash": "0xef7bdb071b1fcfb5df629bd4d27ffa6dc32d0a5df676f26fb8c25311df1185ac",
          "chain": "POLYGON"
        },
        "approve": {
          "transactionHash": "0x5784890f9efd0160e9401439a5cf2aa5350580ecf48f9ca2af617338ae089e53",
          "userOpHash": "0xef7bdb071b1fcfb5df629bd4d27ffa6dc32d0a5df676f26fb8c25311df1185ac",
          "chain": "POLYGON"
        }
      }
    },
    "failedReason": null,
    "fee": null,
    "quoteInformation": {
      "sendGross": {
        "amount": "0.01",
        "currency": "usdc"
      },
      "sendNet": {
        "amount": "0.01",
        "currency": "usdc"
      },
      "railFee": {
        "amount": "0",
        "currency": "usdc"
      },
      "receiveGross": {
        "amount": "0.01",
        "currency": "usdc"
      },
      "receiveNet": {
        "amount": "0.01",
        "currency": "usdc"
      },
      "rate": "1",
      "expiresAt": "2025-02-25T17:44:54.781Z"
    }
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
requestId
string
required

unique identifier for the request (recommend using uuid v4)

​
amount
number<float>
required

amount of crypto currency to bridge

Required range: x >= 0
​
source
object
required

bridging source

​
destination
object
required

bridging destination

​
requireApproval
boolean
default:false

Whether this bridging request requires approval before processing.

  • true: Request will enter approval workflow
  • false or omitted: Request proceeds immediately
Example:

false

Response

Success

​
transferType
string
​
transferDetails
object