Skip to main content
POST
Create a virtual account

Authorizations

Authorization
string
header
required

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

Path Parameters

userId
string
required

ID of the user

Body

application/json

Create a virtual account and optionally configure its automatic USDT onramp conversion-fee threshold.

sourceCurrency
enum<string>
required
Available options:
usd
destinationCurrency
enum<string>
required
Available options:
usdc,
usdt,
usdg,
pyusd
destinationChain
enum<string>

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

Available options:
POLYGON,
ETHEREUM,
SOLANA,
BASE,
TRON
externalWalletId
string

Either externalWalletId or destinationChain must be provided.

maxBps

Maximum USDT conversion fee, supplied as an integer or decimal-integer string representing 0 through 10,000 basis points, allowed for automatic onramps through this virtual account. Omit or use null to leave the threshold disabled.

Required range: 0 <= x <= 10000
transferType
enum<string>
Available options:
ach,
wire

Response

Success

message
string
accountInfo
object