> ## 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 Execute > Master Wallet Execute ## OpenAPI ````yaml post /v1/wallets/{walletId}/withdraw/fiat/execute 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: /v1/wallets/{walletId}/withdraw/fiat/execute: parameters: - name: walletId in: path required: true schema: type: string example: YOUR_WALLET_ID post: tags: - Withdraw Fiat summary: Master Wallet Execute description: Master Wallet Execute operationId: masterWalletExecute requestBody: content: application/json: schema: required: - assetId - institutionIdentifier - accountIdentifier - currency - amount type: object properties: reference: type: string description: client reference for tracking transaction example: client-reference-value accountIdentifier: description: destination bank account identifier type: string example: '8034007516' amount: description: amount to withdraw in asset units type: number example: 1000 assetId: description: asset ID of the stablecoin to withdraw type: string example: a79270bf-5a79-4bdc-8fef-586bfcff6e9f code: type: string example: '445223' currency: description: destination fiat currency code type: string example: NGN institutionIdentifier: description: bank or institution identifier code type: string example: OPAYNGPC examples: Master Wallet Execute: value: accountIdentifier: '8034007516' amount: 1000 assetId: a79270bf-5a79-4bdc-8fef-586bfcff6e9f code: '445223' currency: NGN institutionIdentifier: OPAYNGPC responses: '200': description: '200' headers: Access-Control-Allow-Origin: schema: type: string example: '*' Connection: schema: type: string example: keep-alive Content-Encoding: schema: type: string example: gzip Content-Security-Policy: schema: type: string example: >- default-src 'self';base-uri 'self';font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';img-src 'self' data:;object-src 'none';script-src 'self';script-src-attr 'none';style-src 'self' https: 'unsafe-inline';upgrade-insecure-requests Cross-Origin-Embedder-Policy: schema: type: string example: require-corp Cross-Origin-Opener-Policy: schema: type: string example: same-origin Cross-Origin-Resource-Policy: schema: type: string example: same-origin Date: schema: type: string example: Thu, 29 Jan 2026 06:07:10 GMT ETag: schema: type: string example: W/"979-B0fPyYM7Q9d7oYEN+VTPNt780Uk" Keep-Alive: schema: type: string example: timeout=5 Origin-Agent-Cluster: schema: type: string example: '?1' Referrer-Policy: schema: type: string example: no-referrer Strict-Transport-Security: schema: type: string example: max-age=15552000; includeSubDomains Transfer-Encoding: schema: type: string example: chunked Vary: schema: type: string example: Accept-Encoding X-Content-Type-Options: schema: type: string example: nosniff X-DNS-Prefetch-Control: schema: type: string example: 'off' X-Download-Options: schema: type: string example: noopen X-Frame-Options: schema: type: string example: SAMEORIGIN X-Permitted-Cross-Domain-Policies: schema: type: string example: none X-RateLimit-Limit: schema: type: string example: '60' X-RateLimit-Remaining: schema: type: string example: '59' X-RateLimit-Reset: schema: type: string example: '0' X-XSS-Protection: schema: type: string example: '0' content: application/json: schema: type: object properties: data: type: object properties: amlScreening: type: object properties: {} amount: type: string example: '1000' amountPaid: type: string example: '1000' amountUSD: type: string example: '0.68' asset: type: object properties: address: type: string example: '0x46C85152bFe9f96829aA94755D9f915F9B10EF5F' configurations: nullable: true example: null createdAt: type: string example: '2026-01-20T08:10:37.843Z' currency: type: string example: NGN decimals: type: number example: 6 id: type: string example: 4a54eddc-b2bc-42a2-8197-4f2cb250866e isActive: type: boolean example: true isNative: type: boolean example: false name: type: string example: cNGN network: type: string example: mainnet standard: nullable: true example: null symbol: type: string example: cNGN updatedAt: type: string example: '2026-01-20T08:10:37.843Z' assetSwept: nullable: true example: null assetSweptAmount: nullable: true example: null assetSweptAt: nullable: true example: null assetSweptGasFee: nullable: true example: null assetSweptHash: nullable: true example: null assetSweptRecipientAddress: nullable: true example: null assetSweptSenderAddress: nullable: true example: null blockHash: nullable: true example: null blockNumber: nullable: true example: null blockchain: type: object properties: configurations: nullable: true example: null createdAt: type: string example: '2026-01-20T08:10:37.776Z' derivationPath: type: string example: m/44'/60'/0'/0 id: type: string example: 384ba700-5831-49a1-8cba-7d89385d5a25 isActive: type: boolean example: true isEvmCompatible: type: boolean example: true isL2: type: boolean example: true name: type: string example: base networkFeeModel: type: string example: native slug: type: string example: base symbol: type: string example: eth tokenStandard: nullable: true example: null updatedAt: type: string example: '2026-01-20T08:10:37.776Z' chainId: nullable: true example: null confirmations: nullable: true example: null confirmed: type: boolean example: false createdAt: type: string example: '2026-01-29T06:07:10.726Z' createdChannel: type: string example: dashboard currency: type: string example: NGN fee: type: string example: '2' feeHash: nullable: true example: null feeUSD: nullable: true example: null gasFee: nullable: true example: null gasPrice: nullable: true example: null gasUsed: nullable: true example: null hash: nullable: true example: null id: type: string example: db53c3ef-5643-4f98-92cf-d02aef300f45 isAutoSweep: type: boolean example: false metadata: nullable: true example: null network: type: string example: mainnet note: nullable: true example: null processingProviderReference: nullable: true example: null processingReason: nullable: true example: null processingStatus: type: string example: PENDING rate: type: string example: '1' rateUSD: type: string example: '0.00068' reason: nullable: true example: null recipientAddress: type: string example: '0x30F6A8457F8E42371E204a9c103f2Bd42341dD0F' reference: type: string example: v7OlAUdQzvrEabyMJJ3 senderAddress: type: string example: '0x969838345E5cd5F755DfcADB57e72F5d23271e48' signedTransaction: nullable: true example: null status: type: string example: PENDING toAmount: type: string example: '1000' toCurrency: type: string example: NGN tokenAddress: type: string example: '0x46C85152bFe9f96829aA94755D9f915F9B10EF5F' type: type: string example: OFFRAMP updatedAt: type: string example: '2026-01-29T06:07:10.726Z' wallet: type: object properties: address: type: string example: '0x969838345E5cd5F755DfcADB57e72F5d23271e48' configurations: type: object properties: addresses: type: object properties: prefunding: type: object properties: isActive: type: boolean example: false rules: type: array items: {} example: [] autoSettlement: type: object properties: isActive: type: boolean example: false rules: type: array items: {} example: [] autoSweeping: type: object properties: isActive: type: boolean example: true threshold: type: number example: 0 withdrawal: type: object properties: gasless: type: object properties: isActive: type: boolean example: false operator: type: string example: gt threshold: type: number example: 0 createdAt: type: string example: '2026-01-20T08:44:44.305Z' derivationPath: type: string example: m/44'/60'/0'/0/0 description: type: string example: This is Base master Wallet id: type: string example: 7aa5120b-2106-43c6-92c7-6458b7d2de8b isActive: type: boolean example: true name: type: string example: Base Mainnet network: type: string example: mainnet status: type: string example: ACTIVE updatedAt: type: string example: '2026-01-20T08:44:44.305Z' message: type: string example: Successful status: type: boolean example: true examples: '200': value: reference: client-reference-value data: amlScreening: {} amount: '1000' amountPaid: '1000' amountUSD: '0.68' asset: address: '0x46C85152bFe9f96829aA94755D9f915F9B10EF5F' configurations: null createdAt: '2026-01-20T08:10:37.843Z' currency: NGN decimals: 6 id: 4a54eddc-b2bc-42a2-8197-4f2cb250866e isActive: true isNative: false name: cNGN network: mainnet standard: null symbol: cNGN updatedAt: '2026-01-20T08:10:37.843Z' assetSwept: null assetSweptAmount: null assetSweptAt: null assetSweptGasFee: null assetSweptHash: null assetSweptRecipientAddress: null assetSweptSenderAddress: null blockHash: null blockNumber: null blockchain: configurations: null createdAt: '2026-01-20T08:10:37.776Z' derivationPath: m/44'/60'/0'/0 id: 384ba700-5831-49a1-8cba-7d89385d5a25 isActive: true isEvmCompatible: true isL2: true name: base networkFeeModel: native slug: base symbol: eth tokenStandard: null updatedAt: '2026-01-20T08:10:37.776Z' chainId: null confirmations: null confirmed: false createdAt: '2026-01-29T06:07:10.726Z' createdChannel: dashboard currency: NGN fee: '2' feeHash: null feeUSD: null gasFee: null gasPrice: null gasUsed: null hash: null id: db53c3ef-5643-4f98-92cf-d02aef300f45 isAutoSweep: false metadata: null network: mainnet note: null processingProviderReference: null processingReason: null processingStatus: PENDING rate: '1' rateUSD: '0.00068' reason: null recipientAddress: '0x30F6A8457F8E42371E204a9c103f2Bd42341dD0F' reference: v7OlAUdQzvrEabyMJJ3 senderAddress: '0x969838345E5cd5F755DfcADB57e72F5d23271e48' signedTransaction: null status: PENDING toAmount: '1000' toCurrency: NGN tokenAddress: '0x46C85152bFe9f96829aA94755D9f915F9B10EF5F' type: OFFRAMP updatedAt: '2026-01-29T06:07:10.726Z' wallet: address: '0x969838345E5cd5F755DfcADB57e72F5d23271e48' configurations: addresses: prefunding: isActive: false rules: [] autoSettlement: isActive: false rules: [] autoSweeping: isActive: true threshold: 0 withdrawal: gasless: isActive: false operator: gt threshold: 0 createdAt: '2026-01-20T08:44:44.305Z' derivationPath: m/44'/60'/0'/0/0 description: This is Base master Wallet id: 7aa5120b-2106-43c6-92c7-6458b7d2de8b isActive: true name: Base Mainnet network: mainnet status: ACTIVE updatedAt: '2026-01-20T08:44:44.305Z' message: Successful status: true components: securitySchemes: apiKey: type: apiKey name: x-api-key in: header ````