v1

latestOpenAPI 3.0.02026-07-243678114.1 KB

Partners

Create Virtual Account

Create a virtual account with crypto wallets across supported networks. Supports both managed (DFNS) wallets and external (self-custody) wallets via the wallet_address field on chain configurations. Optionally configure deposit splits to automatically route portions of incoming deposits to other virtual accounts.

post/partners/accounts/create-virtual-account

Request body

namestring required

A descriptive name to identify the account.

referencestring required

Your own account reference identifier. Must be URL-safe, containing only alphanumeric characters, hyphens, and underscores (no spaces or special characters).

Example request

{
  "chains": [
    {
      "chain_id": 1,
      "currencies": [
        "USDT",
        "USDC"
      ],
      "wallet_address": "0x4bbeEB066eD09B7AEd07bF39EEe0460DFa261520"
    }
  ],
  "deposit_splits": [
    {
      "account_ref": "my-fee-account",
      "account_id": 12345,
      "pct": "2.5"
    }
  ]
}

Response

errorboolean

messagestring

Example response

{
  "data": {
    "account_number": "123456789",
    "address": "0x4bbeEB066eD09B7AEd07bF39EEe0460DFa261520",
    "chain_id": 1,
    "created_at": "2023-01-01T12:00:00Z",
    "created_by": "user123",
    "currencies": [
      "BTC",
      "ETH",
      "USD"
    ],
    "deleted_at": "2023-01-02T08:30:00Z",
    "enabled": true,
    "id": 123456,
    "name": "Primary Account",
    "org_id": "org123",
    "sort_code": "123456",
    "updated_at": "2023-01-03T10:45:00Z"
  }
}