v1

latestOpenAPI 3.1.02026-07-26460218.4 KB

Create Sub Wallet

post/sub-wallets

Request body

namestring required

Wallet name. e.g. NGN Trading

sequenceIdstring required

Unique wallet identifier / idempotency key

currencystring required

YC Supported fiat currency. e.g. NGN, KES

createVirtualAccountboolean

When true, creates a virtual bank account linked to the sub-wallet

Response

Created

idstring

partnerIdstring

sequenceIdstring

namestring

metadataobject

currencystring

statusstring

createdAtinteger

updatedAtinteger

availableBalanceinteger

Example response

{
  "id": "6959f27c-9886-536b-a276-e1f4c2e632db",
  "partnerId": "d7fbe40a-6d50-4607-8648-9827a54947c3",
  "sequenceId": "6fb07a60-a2c2-5eb6-bb4b-6a91b04962b1",
  "name": "USD Secondary III",
  "currency": "USD",
  "status": "active",
  "createdAt": 1770719129967,
  "updatedAt": 1770719129967,
  "virtualAccount": {
    "id": "4e6b711b-8952-4f83-a2ac-cff122082cb2",
    "provider": "erebor",
    "currency": "USD",
    "accountNumber": "37212851507366",
    "routingNumber": "125109161",
    "accountName": "Demo Business Checking",
    "bankName": "Erebor Bank",
    "status": "ACTIVE",
    "depositInstructions": {
      "swift": {
        "memoTemplate": "FFC <account holder name> <account number>",
        "memo": "FFC Demo Business Checking 37212851507366",
        "bankName": "Erebor Bank. N.A",
        "accountNumber": "2908175093",
        "bic": "CHASUS33",
        "bankAddress": "500 Neil Ave, Ste 140 Columbus, OH 43215 US"
      }
    },
    "virtualAccountType": "third_party",
    "recordType": "viban",
    "createdAt": "2026-07-14T18:10:59.033Z",
    "updatedAt": "2026-07-14T18:10:59.033Z"
  }
}