Skip to main content
GET
/
v1
/
wallets
/
{address}
/
virtual-account
Read deposit instructions
curl --request GET \
  --url https://api.calmtreasury.xyz/v1/wallets/{address}/virtual-account \
  --cookie calm_session=
{
  "bank_name": "Lead Bank",
  "bank_address": "1801 Main Street, Kansas City, MO 64108",
  "bank_routing_number": "021000021",
  "bank_account_number": "1234567890",
  "bank_beneficiary_name": "Ada Lovelace",
  "bank_beneficiary_address": "100 Main St, San Francisco, CA 94105",
  "payment_rail": "ach_push",
  "payment_rails": [
    "ach_push",
    "wire",
    "fednow"
  ]
}

Authorizations

​
calm_session
string
cookie
required

Session cookie issued by POST /v1/session/{address}. Sent automatically by the browser; the SDK uses credentials: 'include'.

Path Parameters

​
address
string
required

Ethereum address (0x-prefixed, 40 hex chars). Lowercased server-side before binding.

Pattern: ^0x[a-fA-F0-9]{40}$
Example:

"0xaabbccddeeff00112233445566778899aabbccdd"

Response

Deposit instructions

Currency-specific bank details the user wires money to. Shape is discriminated by the inner currency field — usd, gbp, and eur are documented below.

​
currency
enum<string>
required
Available options:
usd
​
bank_name
string
required
Example:

"Lead Bank"

​
bank_address
string
required
Example:

"1801 Main Street, Kansas City, MO 64108"

​
bank_routing_number
string
required
Example:

"021000021"

​
bank_account_number
string
required
Example:

"1234567890"

​
bank_beneficiary_name
string
required
Example:

"Ada Lovelace"

​
bank_beneficiary_address
string
required
Example:

"100 Main St, San Francisco, CA 94105"

​
payment_rail
string
required

Primary rail used for routing.

Example:

"ach_push"

​
payment_rails
enum<string>[]
required

All rails this account can receive.

Available options:
ach_push,
wire,
fednow
Example:
["ach_push", "wire", "fednow"]