Sign in

v1

latestOpenAPI 3.0.02026-07-224537337.5 KB

Create a Virtual Account

Create a new virtual account that converts incoming fiat deposits to crypto.

post/v2/virtual-account

Request body

destinationCurrency'usdc' | 'usdt' | 'eurc' required

The crypto currency deposited funds are converted into. See Supported Rails & Currencies.

network'arbitrum' | 'avalanche' | 'base' | 'ethereum' | 'polygon' | 'sol' | 'tron' required

The blockchain network the destination wallet is on. See Supported Rails & Currencies.

walletAddressstring required

The on-chain wallet address where converted crypto is sent. Must be valid for the selected network.

integratorFeeBpsstring

Integrator fee in basis points (1 bps = 0.01%). Defaults to 0 if not provided.

customerIdstring required

The customer who will own the virtual account.

sourceCurrency'usd' | 'eur' required

The fiat currency the virtual account accepts for deposits.

Example request

{
  "destinationCurrency": "usdc",
  "network": "ethereum",
  "walletAddress": "0x4838B106FCe9647Bdf1E7877BF73cE8B0BAD5f97",
  "integratorFeeBps": "100",
  "customerId": "customer_b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7",
  "sourceCurrency": "usd"
}

Response

idstring required

Unique identifier for the virtual account.

customerstring

The customer ID who owns the virtual account.

activeboolean required

Whether the virtual account is currently active and accepting deposits.

createdstring required

Timestamp when the virtual account was created (ISO 8601).

updatedstring required

Timestamp when the virtual account was last updated (ISO 8601).

Example response

{
  "id": "virtualAccount_a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6",
  "customer": "customer_b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7",
  "active": true,
  "depositInstructions": {
    "currency": "usd",
    "bankName": "Lead Bank",
    "bankAddress": "1801 Main St, Kansas City, MO 64108",
    "bankAccountNumber": "9876543210",
    "bankRoutingNumber": "021000089",
    "bankBeneficiaryName": "Bridge Financial Inc.",
    "bankBeneficiaryAddress": "123 Finance St, San Francisco, CA 94105",
    "iban": "DE89370400440532013000",
    "bic": "COBADEFFXXX"
  },
  "destination": {
    "currency": "usdc",
    "walletAddress": "0x4838B106FCe9647Bdf1E7877BF73cE8B0BAD5f97",
    "network": "ethereum"
  },
  "fee": {
    "totalBpsRate": "130",
    "integratorFee": {
      "bpsRate": "100"
    },
    "platformFee": {
      "bpsRate": "30"
    }
  },
  "created": "2025-01-15T10:30:00.000Z",
  "updated": "2025-01-15T12:00:00.000Z"
}