Skip to main content
POST
/
v2
/
wallets
/
transfers
Create a crypto transfer
curl --request POST \
  --url https://production.hifibridge.com/v2/wallets/transfers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "requestId": "<string>",
  "source": {
    "userId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  },
  "destination": {
    "userId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "walletAddress": "<string>"
  },
  "amount": 1,
  "requireApproval": false
}
'
{
  "transferType": "WALLET.TRANSFER",
  "transferDetails": {
    "id": "006737ca-42d5-4780-b3c2-aeb63279c591",
    "requestId": "d0d62bec-2623-4f61-afda-148d6a8e1009",
    "createdAt": "2025-02-03T16:11:36.654998+00:00",
    "updatedAt": "2025-02-03T16:12:41.503+00:00",
    "chain": "POLYGON_MAINNET",
    "currency": "usdc",
    "contractAddress": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
    "status": "CREATED",
    "failedReason": "",
    "source": {
      "userId": "aec66b02-4f3f-471c-839a-94820b36abb2",
      "walletAddress": "0xA25641cB6056C371CB65F28aC02450c9206e0fAA",
      "walletType": "INDIVIDUAL",
      "user": {
        "email": "samuelyoon0@gmail.com",
        "lastName": "Yoon",
        "firstName": "Samuel",
        "businessName": null
      }
    },
    "destination": {
      "userId": "aec66b02-4f3f-471c-839a-94820b36abb2",
      "walletType": "INDIVIDUAL",
      "walletAddress": "0xA25641cB6056C371CB65F28aC02450c9206e0fAA",
      "user": {
        "email": "samuelyoon0@gmail.com",
        "lastName": "Yoon",
        "firstName": "Samuel",
        "businessName": null
      }
    },
    "amount": 0.01,
    "amountIncludeDeveloperFee": 0.01,
    "receipt": {
      "transactionHash": "0x5784890f9efd0160e9401439a5cf2aa5350580ecf48f9ca2af617338ae089e53",
      "userOpHash": "0xef7bdb071b1fcfb5df629bd4d27ffa6dc32d0a5df676f26fb8c25311df1185ac"
    },
    "developerFee": {
      "feeId": "9b354c37-d20d-4d94-bcd8-c852353ca406",
      "feeType": "FIX",
      "feeAmount": 0.5,
      "feePercent": 0,
      "status": "CREATED",
      "transactionHash": null,
      "failedReason": null
    }
  }
}

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 transfer request (recommend using uuid v4)

​
source
object
required

crypto transfer source

​
destination
object
required

crypto transfer destination

​
currency
enum<string>

crypto currency (note: usdHifi is only available in sandbox to simulate token movement)

Available options:
usdc,
usdt,
usdg,
pyusd
​
amount
number<float>

amount of crypto currency to send

Required range: x >= 0
​
chain
enum<string>
Available options:
POLYGON,
ETHEREUM,
BASE,
SOLANA,
BSC,
FLOW_EVM,
CANTON,
TRON
​
fee
object

crypto transfer fee

​
requireApproval
boolean
default:false

Whether this transfer requires approval before processing.

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

false

Response

Success

​
transferType
string
Example:

"WALLET.TRANSFER"

​
transferDetails
object