Skip to main content
GET
/
accounts
/
{address}
/
virtual-accounts
List virtual accounts
curl --request GET \
  --url https://grid.squads.xyz/api/grid/v1/accounts/{address}/virtual-accounts \
  --header 'Authorization: Bearer <token>' \
  --header 'x-grid-environment: <api-key>'
{
  "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"
  }
}
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

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"

Query Parameters

​
source_currency
enum<string>

Filter by source fiat currency

Available options:
USD,
EUR
​
destination_currency
enum<string>

Filter by destination crypto currency

Available options:
usdc,
usdt,
pyusd,
eurc

Response

Virtual accounts retrieved successfully

​
data
object[]
required

The actual response payload

​
metadata
object
required
⌘I