Skip to main content
POST
/
accounts
/
{address}
/
virtual-account
Request a virtual account for a smart account
curl --request POST \
  --url https://grid.squads.xyz/api/grid/v1/accounts/{address}/virtual-account \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "currency": "<string>",
  "grid_user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}'
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>
required

Response

Virtual account created successfully