Virtual Account

Create a virtual account

Changed on Nov 3, 2026

Generate a virtual bank account to onramp from sourceCurrency to destinationCurrency on chain destinationChain. (note: virtual accounts are billable)

post/v2/users/{userId}/virtual-accounts

Request

Base URL
https://production.hifibridge.com
URL
https://production.hifibridge.com/v2/users/{userId}/virtual-accounts
Auth
HTTP bearer

Path parameters

userIdstring required

ID of the user

Request body

sourceCurrency'usd' required

destinationCurrency'usdc' | 'usdt' | 'usdg' | 'pyusd' required

destinationChain'POLYGON' | 'ETHEREUM' | 'SOLANA' | 'BASE' | 'TRON'

Either externalWalletId or destinationChain must be provided. If provided, the token will be delivered to user's HIFI wallet on the destination chain.

externalWalletIdstring

Either externalWalletId or destinationChain must be provided.

transferType'ach' | 'wire'

Response

Success

messagestring

Example response

{
  "accountInfo": {
    "microDeposits": {
      "data": [
        {
          "amount": "0.71"
        }
      ]
    }
  }
}

Changes

Nov 3, 2026319fa6bd5bc6 Revision changes
- breaking
  the response property ///// became nullable for the status
- breaking
  the response property ///// became nullable for the status
- breaking
  the response property ///// became nullable for the status
- breaking
  the response property ///// became nullable for the status
- breaking
  the response property ///// became nullable for the status
- breaking
  the response property ///// became nullable for the status
- breaking
  the response property ///// became nullable for the status
- breaking
  the response property ///// became nullable for the status
- breaking
  the response property ///// became nullable for the status
- breaking
  the response property ///// became nullable for the status
- breaking
  the response property ///// became nullable for the status
- breaking
  the response property ///// became nullable for the status
- breaking
  the //// response's property type changed from integer to string for status
- info
  added the new optional request property
- info
  added the optional property / to the response with the status
- info
  added the optional property ///// to the response with the status

Operation history