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

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.

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