Subaccounts

Notbank's subaccount service redefines financial management by allowing total segmentation of resources within the same platform. This tool facilitates precise balance control, enabling purchases, sales and conversions to be operated in independent and secure environments. By isolating each capital flow, users can optimize their trading strategies and maintain impeccable accounting organization. It is the ideal solution for those seeking operational agility without compromising clarity or structure of their financial movements.

1.1 Create a subaccount

Node

// ...
await restClient.getSubAccountService().createSubAccount({
    alias: "subaccount1"
});

1.2 Get subaccounts

Node

const subAccounts = await restClient.getSubAccountService().getSubAccounts({
    page: 1,
    page_size: 10
});

console.log(subAccounts);
// [
//    {
//        "id": 1556,
//        "alias": "subaccount1",
//        "created_at": "2026-02-17T13:27:28"
//    }
// ]

1.3 Get list of supported banks

Node

const banks = await restClient.getWalletService().getBanks({
  country: "PE"
});

console.log(banks);
// [
//    {
//        "id": "6e83d105-83ff-4a1e-ba62-cd23b21e9d37",
//        "name": "BANK OF CHINA",
//        "country": "PE"
//    },
//    {
//        "id": "925099d0-4b2c-403e-9b8b-f64e18ce5f47",
//        "name": "BANCO AZTECA",
//        "country": "PE"
//    }, ...
// ]

1.4 Get provinces

Node

const provinces = await restClient.getWalletService().getProvinces({
  "country": "PE"
});

console.log(provinces);
// {
//   "status": "success",
//   "data": [
//     [
//       "101",
//       "Chachapoyas"
//     ],
//     [
//       "102",
//       "Bagua"
//     ],
//     [
//       "103",
//       "Bongara"
//     ], ...
//   ]
// }

1.5 Add bank account

Node

// ...
const userBankAccount =  restClient.getWalletService().AddClientBankAccount({
  country: "PEN",
  bank: "6e83d105-83ff-4a1e-ba62-cd23b21e9d37",
  number: "111111111111111111111", // CCI number
  kind: "ahorro",
  province: "212", // Huaylas
  document_number: "111111111",
  document_type: "DNI",
  name_1: "Juan",
  name_2: "Perez"
});

console.log(userBankAccount.id);
// 29cd83cf-3678-4207-80c7-7caaa1d24c27

1.6 Get available networks

Given the large number of coins and networks that Notbank supports, it is first necessary to obtain the available networks for a cryptocurrency.

Node

// ...
const networks = await restClient.getWalletService().getNetworksTemplates({
  currency: "USDT"
});

console.log(networks);
// [
//   {
//     "currency": "USDT",
//     "network": "USDT_ERC20",
//     "network_name": "Ethereum",
//     "network_protocol": "ERC-20",
//     template: [
//       [Object],
//       [Object]
//     ]
//   }
// ]

1.7 Get a USDT ERC20 wallet

Using the network code ( network ) obtained in the previous step plus the currency code (currency) you can request your wallet address.

Node

// ...
const addresses = await restClient.getWalletService().getDepositAddresses({
  account_id: clientAccountId,
  currency: "USDT",
  network: "USDT_ERC20",
});

console.log(addresses)
// ["2N3r9roRrHy7p6C5pGE8NQP9ZNT81H7ZKyU"]

1.8 Convert cryptocurrencies

In this example, we will request the amount of Ethereum (ETH) we would receive if we used 1000 Soles (PEN). Then we will check the promised amount, which is valid for 20 seconds and finally, we will execute the purchase.

The conversion is not limited to transactions between cryptocurrencies, but to any possible combination: cryptocurrency to cryptocurrency, fiat currency to cryptocurrency, cryptocurrency to fiat currency and fiat currency to fiat currency.

The amounts attached in the examples are for educational purposes and do not represent the current state of the market.

1.8.1 Request quote

Node

const quoteId = await restClient.getQuoteService().createDirectQuote({
  from_currency: "PEN",
  from_amount: 1000,
  to_currency: "ETH",
  operation: 3, // CONVERSION
  account_id: clientAccountId,
});

console.log(quoteId)
// fc4ffe0e-b87a-4e1f-a727-f6ddae7dc1e0

1.8.2 Check quote

Node

// ...
const quote = await restClient.getQuoteService().getQuote({
  quote_id: "fc4ffe0e-b87a-4e1f-a727-f6ddae7dc1e0",
  account_id: clientAccountId,
});

console.log(quote.status)
// 0 // pending
console.log(quote.amount_out)
// 1.5 // ETH

1.8.3 Execute quote

Node

// ...
const quote = await restClient.getQuoteService().executeQuote({
  quote_id: "fc4ffe0e-b87a-4e1f-a727-f6ddae7dc1e0",
  account_id: clientAccountId,
});

console.log(quote.status)
// 0 // pending
console.log(quote.amount_out)
// 1.5 // ETH

// After a few moments, check the request status again
const quote = await restClient.getQuoteService().getQuote({
  quote_id: "fc4ffe0e-b87a-4e1f-a727-f6ddae7dc1e0",
  account_id: clientAccountId,
});

console.log(quote.status)
// 1 // executed
console.log(quote.amount_out)
// 1.5 // ETH

1.9 Bank withdrawal notification

Node

await restClient.getWalletService().createFiatWithdraw({
  account_id: clientAccountId, 
  payment_method: 1,  // bank transfer
  currency: "PEN",
  amount: 1000,
  bank_account_id: "29cd83cf-3678-4207-80c7-7caaa1d24c27"
});

1.10 Move USDT balance to the main account

Node

await restClient.getWalletService().transferFunds({
  "sender_account_id": subAccountId,
  "receiver_account_id": primaryAccountId,
  "currency_name": "USDT",
  "amount": 100,
  "notes": "transfer detail",
  "otp": "123456" // two-step authentication
});