Skip to main content
POST
/
api
/
grid
/
v1
/
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"
}
'

Documentation Index

Fetch the complete documentation index at: https://developers.squads.so/llms.txt

Use this file to discover all available pages before exploring further.

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