POST
/
accounts
/
{address}
/
virtual-account
Request virtual 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' \
  --header 'x-grid-environment: <api-key>' \
  --data '{
  "grid_user_id": "123e4567-e89b-12d3-a456-426614174030",
  "currency": "USD"
}'
{
  "data": {
    "id": "<string>",
    "customer_id": "<string>",
    "source_deposit_instructions": {
      "currency": "USD",
      "bank_beneficiary_name": "<string>",
      "bank_name": "<string>",
      "bank_address": "<string>",
      "bank_routing_number": "<string>",
      "bank_account_number": "<string>",
      "payment_rails": [
        "ach"
      ]
    },
    "destination": {
      "currency": "usdc",
      "payment_rail": "solana",
      "address": "11111111111111111111111111111112"
    },
    "status": "activated",
    "developer_fee_percent": 123
  },
  "metadata": {
    "request_id": "123e4567-e89b-12d3-a456-426614174000",
    "timestamp": "2023-07-15T14:30:00.000Z"
  }
}
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

API key authentication with Bearer token. Include the API key in the Authorization header as 'Bearer YOUR_API_KEY'

​
x-grid-environment
string
header
required

Environment identifier for the Grid API. Use 'sandbox' for testing on devnet or 'production' for production on mainnet.

Path Parameters

​
address
string
required

Smart account address

Example:

"11111111111111111111111111111112"

Body

application/json

Response

200
application/json

Virtual account created successfully

The response is of type object.