> ## Documentation Index > Fetch the complete documentation index at: https://docs.blockradar.co/llms.txt > Use this file to discover all available pages before exploring further. # Master Wallet Account Create ## OpenAPI ````yaml post /v2/wallets/{id}/virtual-accounts openapi: 3.0.3 info: title: Blockradar Documentation description: >- The OpenAPI specification of the Blockradar API that enables fintechs and developers to seamlessly integrate stablecoin deposits and payments into their products. version: 1.0.0 contact: {} servers: - url: https://api.blockradar.co security: - apiKey: [] tags: - name: Rewards description: >- Non-custodial yield (Earn) on stablecoins via regulated (Fija) and DeFi (Aave) strategies. Deposit, withdraw, preview fees, and read positions and earnings at the business, wallet, and sub-address level. Amounts are returned net of the platform fee, which applies only to interest earned. - name: Wallet description: >- Wallet Management System Comprehensive wallet management API for multi-blockchain operations. This system handles wallet creation, configuration, balance monitoring, and integration with various blockchain networks. Core Functionality: - Multi-blockchain wallet creation and management - Balance monitoring and asset tracking - Auto-settlement rule configuration - Gateway wallet integration - Address generation and management - Transaction monitoring and processing - name: Addresses description: >- Address Management System Comprehensive blockchain address management API for operations. This system handles address creation, validation, monitoring, and management across multiple blockchain networks. Core Functionality: - Multi-blockchain address generation - Address validation and verification - Balance monitoring and tracking - Transaction history management - Address labeling and organization - Integration with wallet systems - Real-time address monitoring - name: Asset - name: Transactions - name: Withdraw description: >- The Withdraw feature allows you to programmatically withdraw stablecoins from your master wallet with ease - name: Withdraw Fiat - name: Signing description: >- Typed data signing service for secure transaction authorization. Supports all EIP-712 standards including EIP-3009 (TransferWithAuthorization) and EIP-2612 (Permit). - name: Swap description: >- The Swap feature enables users to exchange one stabelcoin asset for another across different blockchains. This feature provides a seamless way to convert between different stablecoins while maintaining security and compliance standards. - name: Liquidity Pool - name: Virtual Accounts description: >- Virtual Accounts API provides endpoints for managing virtual bank accounts linked to master wallets or child addresses. This API enables businesses to: - Create virtual accounts for customers to receive payments - Retrieve virtual account details - Activate/deactivate virtual accounts **Virtual Account Types:** Virtual accounts support different types with varying behaviors: 1. **AUTO_FUNDING** (Default): - Automatically mints stablecoin when fiat payments are received - Transfers the stablecoin to the linked wallet/address immediately - Best for real-time payment processing **How It Works - Auto-Funding Flow (AUTO_FUNDING type only):** When a customer sends fiat currency to a virtual account with type AUTO_FUNDING: 1. **Payment Receipt**: The payment is received in the virtual account 2. **Automatic Minting**: The system automatically mints the stablecoin equivalent 3. **Blockchain Transfer**: The minted stablecoin is transferred to the virtual account's linked wallet or address **Note**: The auto-funding flow only applies to virtual accounts with type `AUTO_FUNDING`. Other types have different processing behaviors. ## Prerequisites Before creating virtual accounts, ensure: - **Compliance requirements must be completed** (see [Compliance Requirements](http://localhost:3000/essentials/virtual-accounts#compliance-requirements) section below) - **Virtual accounts feature must be enabled** for your business (reach out to [support@blockradar.co](https://mailto:support@blockradar.co) or use live chat on the dashboard to enable the feature after compliance approval) - **Only available on MAINNET environment** (not available on testnet) - **Master Wallet must support stablecoin asset** - Your account plan must include stablecoin access (upgrade from Dashboard → Settings → Subscription if needed) **Supported Currency:** - Fiat: NGN (Nigerian Naira) - Stablecoin: cNGN - minted automatically on blockchain (for AUTO_FUNDING type) - name: Auto Settlements description: >- Creates a new auto settlement rule for a wallet. Auto settlement automatically transfers/swap assets based on configured rules when certain conditions are met. Rules can be configured for: - Source blockchain and assets - Destination blockchain and asset - Amount ranges (min/max) - Slippage tolerance - Gateway vs non-gateway wallets Gateway rules are required for testnet wallets and must have matching source/destination assets. - name: Smart Contract description: >- This API provides endpoints for interacting with smart contracts on the blockchain. It allows for reading contract data, executing contract functions, and estimating network fees. - name: Gateway description: >- The Gateway feature enables you to programmatically deposit USDC into a unified, chain-abstracted balance and instantly mint USDC on any supported blockchain, streamlining crosschain transfers and eliminating manual bridging steps and rebalancing complexities. - name: Payment Links description: >- The Payment Pages API provides a quick and secure way to collect payment for servcies. - name: Beneficiaries description: >- This API allows you to create beneficiaries with automatic settlements to your external wallets on a periodic basis. Example frequencies: INSTANT, DAILY, WEEKLY, MONTHLY, YEARLY - name: AML description: >- The AML (Anti Money Laundering) API provides a quick way for you to check if an address is blacklisted or sanctioned - name: Asset Recovery description: >- Enables the recovery (salvage) of both native blockchain assets and tokens from a specified sender address to a recipient address. This feature supports emergency fund recovery and asset consolidation operations. - name: Miscellaneous description: >- The Miscellaneous API are supporting APIs that can be used to provide more details to other APIs. - name: Asset1 - name: Blockchain - name: Webhooks description: >- Webhooks allow you to set up a notification system that can be used to receive updates on certain requests made to the Blockradar API. To see full list and instructions [https://docs.blockradar.co/essentials/webhooks](https://docs.blockradar.co/essentials/webhooks) ## - name: Deposit - name: Withdraw1 - name: Swap1 - name: Gateway1 paths: /v2/wallets/{id}/virtual-accounts: post: tags: - Virtual Accounts V2 summary: Master Wallet Account Create operationId: VirtualAccountV2Controller_create parameters: - name: id required: true in: path schema: type: string format: uuid description: Wallet identifier. example: 4465468a-3c36-4536-918a-91d689e18a74 requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreateVirtualAccountV2Dto' responses: '201': description: Created successfully. content: application/json: schema: $ref: '#/components/schemas/VirtualAccountCreateResponse' example: statusCode: 201 message: Virtual account created successfully data: created: true virtualAccount: id: 3e8fcd73-4067-4386-8c1e-9929e6a768d7 reference: va_01J2X8JQ4V9N0P7K2M6C3F5R8T accountNumber: '0123456789' accountName: Acme Ltd / Ada Okafor bankName: Example Bank bankCode: '999' currency: NGN institutionAddress: null assetId: ae455f23-3824-4125-baab-d158315cbcbd providerId: 1128dd40-2c94-4c16-a6bf-fbbc6afee52c isActive: true status: active type: AUTO_FUNDING label: Ada collection account createdAt: '2026-07-19T12:30:00.000Z' updatedAt: '2026-07-19T12:30:00.000Z' components: schemas: CreateVirtualAccountV2Dto: type: object properties: currency: type: string description: ISO 4217 virtual-account currency. example: NGN minLength: 3 maxLength: 3 assetId: type: string description: Stablecoin asset that receives settlements. example: ae455f23-3824-4125-baab-d158315cbcbd format: uuid customerId: type: string description: Existing customer identifier, when the provider requires one. example: 18d2f159-e0cd-4a45-b735-e9dfe0f7520a format: uuid additionalData: type: object description: Values collected and validated against additionalDataSchema. example: bvn: '12345678901' dateOfBirth: '1992-04-18' code: type: string passkeyResponse: type: object label: type: string maxLength: 100 description: Your display label for the virtual account. example: Ada collection account provider: type: string description: Provider slug resolved from the requirements flow. example: example-provider required: - provider - currency VirtualAccountCreateResponse: type: object properties: statusCode: type: integer example: 201 message: type: string description: Human-readable result. example: Virtual account created successfully data: $ref: '#/components/schemas/VirtualAccountCreateResult' required: - statusCode - message - data VirtualAccountCreateResult: type: object properties: created: type: boolean example: true virtualAccount: $ref: '#/components/schemas/VirtualAccount' required: - created - virtualAccount VirtualAccount: type: object additionalProperties: true properties: id: type: string description: Virtual account identifier. example: 3e8fcd73-4067-4386-8c1e-9929e6a768d7 format: uuid reference: type: string description: Blockradar virtual-account reference. example: va_01J2X8JQ4V9N0P7K2M6C3F5R8T accountNumber: type: string description: Bank account number. example: '0123456789' accountName: type: string description: Bank account holder name. example: Acme Ltd / Ada Okafor bankName: type: string description: Bank name. example: Example Bank bankCode: type: string description: Bank or institution code. example: '999' currency: type: string description: ISO 4217 account currency. example: NGN institutionAddress: type: string description: Institution address. example: null nullable: true assetId: type: string description: Stablecoin asset settled to the wallet. example: ae455f23-3824-4125-baab-d158315cbcbd format: uuid providerId: type: string description: Provider identifier. example: 1128dd40-2c94-4c16-a6bf-fbbc6afee52c format: uuid isActive: type: boolean example: true status: type: string description: Provider-normalized account status. example: active type: type: string description: Virtual account behavior. example: AUTO_FUNDING label: type: string description: Customer-defined label. example: Ada collection account nullable: true createdAt: type: string description: Creation timestamp. example: '2026-07-19T12:30:00.000Z' format: date-time updatedAt: type: string description: Last update timestamp. example: '2026-07-19T12:30:00.000Z' format: date-time required: - id - reference - accountNumber - accountName - bankName - bankCode - currency - assetId - providerId - isActive - status - type - createdAt - updatedAt securitySchemes: apiKey: type: apiKey name: x-api-key in: header ````