Skip to main content
POST
Request a virtual account for a smart account
Virtual accounts provide a way to receive funds from traditional banking systems. They are automatically linked to your smart account and enable fiat-to-crypto conversion.

Virtual Account Flow

Supported Features

  • Fiat Deposits: Receive traditional currency deposits
  • Auto-Conversion: Automatically convert to stablecoins
  • Multi-Currency: Support for USD, EUR, and other currencies
  • Real-Time Updates: Instant balance notifications

Important Notes

  • KYC verification is required before creating virtual accounts
  • Each currency requires a separate virtual account
  • Account details include routing and account numbers
  • Deposits typically process within 1-3 business days
  • Virtual accounts remain active until explicitly deactivated

Authorizations

Authorization
string
header
required

Your Grid API key from the Grid Dashboard

Path Parameters

address
string
required

Smart account address

Body

application/json
currency
string
required
grid_user_id
string<uuid> | null
deprecated

(Deprecated) User ID is derived automatically from the smart account address. This field is optional and only validated if provided.

Response

Virtual account created successfully