Create Virtual Account

Create new Virtual Account

post

Creates Virtual Account and returns deposit information

Path parameters

customer_idstringrequired

The unique identifier of the customer

Header parameters

Authorizationstringrequired

Token for authentication

Body

source_currencystring · enumrequired

The currency for the source

Options: usd, eur

destination_tokenstring · enumoptional

The currency to be deposited

Options: usdc, usdt

destination_networkstring · enumrequired

The blockchain network for the destination

Options: polygon, ethereum, tron, solana

destination_addressstringoptional

The blockchain address where the funds will be sent

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.alignlabs.dev/v0/customers/{customer_id}/virtual-account' \
  --header 'Authorization: text' \
  --header 'Content-Type: application/json' \
  --data '{
    "source_currency": "usd",
    "destination_token": "usdc",
    "destination_network": "polygon",
    "destination_address": "text"
  }'

application/json

201

201

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "status": "active",
  "destination_token": "usdc",
  "destination_network": "polygon",
  "destination_address": "text",
  "deposit_instructions": {
    "payment_rails": [
      "swift"
    ],
    "currency": "eur",
    "bank_name": "text",
    "bank_address": "text",
    "bank_account_beneficiary_name": "text",
    "iban": {
      "bic": "text",
      "iban_number": "text"
    }
  }
}

Successful offramp transfer initiation response