Skip to main content
GET
/
accounts
/
{address}
/
virtual-accounts
Get all virtual accounts for a smart account
curl --request GET \
  --url https://grid.squads.xyz/api/grid/v1/accounts/{address}/virtual-accounts \
  --header 'Authorization: Bearer <token>'
Retrieve all virtual accounts associated with your smart account. Use optional filters to narrow results by currency or payment rail.

​
Filtering Options

You can filter virtual accounts by:
  • Source Currency: USD, EUR, GBP
  • Destination Currency: USDC, USDT, PYUSD, EURC
  • Status: activated, deactivated

​
Account Information

Each virtual account includes:
  • Bank deposit instructions (routing number, account number)
  • Supported payment rails (ACH, SEPA, Wire)
  • Destination currency configuration
  • Current activation status
  • Developer fee percentage (if applicable)

​
Important Notes

  • Only activated virtual accounts can receive deposits
  • Each currency combination requires a separate virtual account
  • Virtual account details should be shared securely with depositors
  • Monitor account status regularly for compliance updates

Authorizations

​
Authorization
string
header
required

Your Grid API key from the Grid Dashboard

Path Parameters

​
address
string
required

Smart account address

Query Parameters

​
source_currency
string

Filter by source currency

​
destination_currency
string

Filter by destination currency

Response

Virtual accounts retrieved successfully