> ## 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 Message > Master Wallet Message ## OpenAPI ````yaml post /v1/wallets/{id}/signing/message 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/{id}/signing/message: parameters: - name: id in: path required: true schema: type: string example: YOUR_WALLET_ID post: tags: - Signing summary: Master Wallet Message description: Master Wallet Message operationId: masterWalletMessage requestBody: content: application/json: schema: type: object properties: message: type: string example: >- I am verifying ownership of the wallet address 0x... as customer cust_123. This message was signed on 2026-03-03 to confirm my control over this wallet. metadata: type: string example: OPTIONAL_METADATA note: type: string example: OPTIONAL_NOTE examples: Master Wallet Message: value: message: >- I am verifying ownership of the wallet address 0x... as customer cust_123. This message was signed on 2026-03-03 to confirm my control over this wallet. metadata: OPTIONAL_METADATA note: OPTIONAL_NOTE responses: '200': description: 200 - Solana / 200 - Tron content: application/json: schema: type: object properties: data: type: object properties: amlScreening: type: object properties: {} amount: nullable: true example: null amountPaid: nullable: true example: null amountUSD: type: string example: '0.00' asset: nullable: true example: null 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: '2024-10-22T10:57:33.465Z' derivationPath: type: string example: m/44'/501'/0' id: type: string example: 196badf5-380f-4480-ab4a-d0e4304e91f0 isActive: type: boolean example: true isEvmCompatible: type: boolean example: false isL2: type: boolean example: false name: type: string example: solana networkFeeModel: type: string example: native slug: type: string example: solana symbol: type: string example: sol tokenStandard: type: string nullable: true example: null updatedAt: type: string example: '2024-11-26T13:04:13.951Z' chainId: nullable: true example: null confirmations: nullable: true example: null confirmed: type: boolean example: true createdAt: type: string example: '2026-03-02T11:09:44.137Z' createdChannel: type: string example: dashboard currency: type: string example: USD fee: nullable: true example: null 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: type: string example: >- 5bfTmhezuvaceHBbQqfsZewsg9JLEwgFTws9r1XxcVougFKx3QG7jKU7sWJqaWXvvXCoFQkqkm5taUyvkFRwpaCj id: type: string example: b4d7b006-1156-4152-a50b-3d8583679456 isAutoSweep: type: boolean example: false metadata: nullable: true example: null network: type: string example: testnet note: nullable: true example: null processingProviderReference: nullable: true example: null processingReason: nullable: true example: null processingStatus: type: string example: PENDING rate: nullable: true example: null rateUSD: type: string example: '0.00' reason: type: string example: >- I am verifying ownership of the wallet address 0x... as customer cust_123. This message was signed on 2026-03-03 to confirm my control over this wallet. recipientAddress: type: string example: DiikCme9VyoW9W7DpbXzmKVfSQhynn3g6j6VXcnCr2gH reference: type: string example: 4TWtqR6V14sljfQA8Ncy senderAddress: type: string example: DiikCme9VyoW9W7DpbXzmKVfSQhynn3g6j6VXcnCr2gH signedTransaction: type: object properties: signature: type: string example: >- 5bfTmhezuvaceHBbQqfsZewsg9JLEwgFTws9r1XxcVougFKx3QG7jKU7sWJqaWXvvXCoFQkqkm5taUyvkFRwpaCj status: type: string example: SUCCESS toAmount: nullable: true example: null toCurrency: nullable: true example: null tokenAddress: nullable: true example: null type: type: string example: SIGNED updatedAt: type: string example: '2026-03-02T11:09:44.137Z' wallet: type: object properties: address: type: string example: DiikCme9VyoW9W7DpbXzmKVfSQhynn3g6j6VXcnCr2gH configurations: type: object properties: addresses: type: object properties: isActive: type: boolean example: true prefunding: type: object properties: assets: type: array items: type: object properties: alwaysMaintain: type: boolean example: true amount: type: string example: '4' blockchain: type: string example: solana createdAt: type: string example: '2025-09-02T11:50:53.807Z' currency: type: string example: USD id: type: string example: 17b48f89-ab7e-4962-a0cc-df5b7b5486b2 isActive: type: boolean example: true name: type: string example: Solana Network Fee Funding symbol: type: string example: SOL updatedAt: type: string example: '2025-09-02T11:50:53.807Z' example: - alwaysMaintain: true amount: '4' blockchain: solana createdAt: '2025-09-02T11:50:53.807Z' currency: USD id: 17b48f89-ab7e-4962-a0cc-df5b7b5486b2 isActive: true name: Solana Network Fee Funding symbol: SOL updatedAt: '2025-09-02T11:50:53.807Z' isActive: type: boolean example: true autoSettlement: type: object properties: isActive: type: boolean example: false name: type: string example: Base Master wallet swap auto ettlement rules: type: array items: type: object properties: destination: type: object properties: address: type: string example: >- 0x0077777d7EBA4688BDeF3E311b846F25870A19B9 asset: type: string example: USDC blockchain: type: string example: base isGateway: type: boolean example: true id: type: string example: 13d4d7e1-c95c-4a8a-a800-75894daf3673 isActive: type: boolean example: true name: type: string example: Swap from Base USDC to Gateway order: type: string example: FASTEST slippageTolerance: type: string example: '5' source: type: object properties: assets: type: array items: type: string example: USDC example: - USDC - USDT blockchain: type: string example: tron maxAmount: type: string example: '1000' minAmount: type: string example: '1' example: - destination: address: >- 0x0077777d7EBA4688BDeF3E311b846F25870A19B9 asset: USDC blockchain: base isGateway: true id: 13d4d7e1-c95c-4a8a-a800-75894daf3673 isActive: true name: Swap from Base USDC to Gateway order: FASTEST slippageTolerance: '5' source: assets: - USDC - USDT blockchain: tron maxAmount: '1000' minAmount: '1' createdAt: type: string example: '2024-11-05T07:47:40.388Z' derivationPath: type: string example: m/44'/501'/0'/0' description: type: string example: This is Solana Testnet Wallet id: type: string example: f8d8e16f-af6f-4707-9ea9-2075eefd95eb isActive: type: boolean example: true name: type: string example: Solana Wallet network: type: string example: testnet status: type: string example: ACTIVE updatedAt: type: string example: '2025-09-02T11:50:53.812Z' message: type: string example: Message signed successfully statusCode: type: number example: 200 examples: 200 - Solana: value: data: amlScreening: {} amount: null amountPaid: null amountUSD: '0.00' asset: null assetSwept: null assetSweptAmount: null assetSweptAt: null assetSweptGasFee: null assetSweptHash: null assetSweptRecipientAddress: null assetSweptSenderAddress: null blockHash: null blockNumber: null blockchain: configurations: null createdAt: '2024-10-22T10:57:33.465Z' derivationPath: m/44'/501'/0' id: 196badf5-380f-4480-ab4a-d0e4304e91f0 isActive: true isEvmCompatible: false isL2: false name: solana networkFeeModel: native slug: solana symbol: sol tokenStandard: null updatedAt: '2024-11-26T13:04:13.951Z' chainId: null confirmations: null confirmed: true createdAt: '2026-03-02T11:09:44.137Z' createdChannel: dashboard currency: USD fee: null feeHash: null feeUSD: null gasFee: null gasPrice: null gasUsed: null hash: >- 5bfTmhezuvaceHBbQqfsZewsg9JLEwgFTws9r1XxcVougFKx3QG7jKU7sWJqaWXvvXCoFQkqkm5taUyvkFRwpaCj id: b4d7b006-1156-4152-a50b-3d8583679456 isAutoSweep: false metadata: null network: testnet note: null processingProviderReference: null processingReason: null processingStatus: PENDING rate: null rateUSD: '0.00' reason: >- I am verifying ownership of the wallet address 0x... as customer cust_123. This message was signed on 2026-03-03 to confirm my control over this wallet. recipientAddress: DiikCme9VyoW9W7DpbXzmKVfSQhynn3g6j6VXcnCr2gH reference: 4TWtqR6V14sljfQA8Ncy senderAddress: DiikCme9VyoW9W7DpbXzmKVfSQhynn3g6j6VXcnCr2gH signedTransaction: signature: >- 5bfTmhezuvaceHBbQqfsZewsg9JLEwgFTws9r1XxcVougFKx3QG7jKU7sWJqaWXvvXCoFQkqkm5taUyvkFRwpaCj status: SUCCESS toAmount: null toCurrency: null tokenAddress: null type: SIGNED updatedAt: '2026-03-02T11:09:44.137Z' wallet: address: DiikCme9VyoW9W7DpbXzmKVfSQhynn3g6j6VXcnCr2gH configurations: addresses: isActive: true prefunding: assets: - alwaysMaintain: true amount: '4' blockchain: solana createdAt: '2025-09-02T11:50:53.807Z' currency: USD id: 17b48f89-ab7e-4962-a0cc-df5b7b5486b2 isActive: true name: Solana Network Fee Funding symbol: SOL updatedAt: '2025-09-02T11:50:53.807Z' isActive: true createdAt: '2024-11-05T07:47:40.388Z' derivationPath: m/44'/501'/0'/0' description: This is Solana Testnet Wallet id: f8d8e16f-af6f-4707-9ea9-2075eefd95eb isActive: true name: Solana Wallet network: testnet status: ACTIVE updatedAt: '2025-09-02T11:50:53.812Z' message: Message signed successfully statusCode: 200 200 - Tron: value: data: amlScreening: {} amount: null amountPaid: null amountUSD: '0.00' asset: null assetSwept: null assetSweptAmount: null assetSweptAt: null assetSweptGasFee: null assetSweptHash: null assetSweptRecipientAddress: null assetSweptSenderAddress: null blockHash: null blockNumber: null blockchain: configurations: null createdAt: '2024-05-14T11:53:33.110Z' derivationPath: m/44'/195'/0'/0 id: fa91a922-3838-45f6-8a88-a4c771e1443a isActive: true isEvmCompatible: false isL2: false name: tron networkFeeModel: native slug: tron symbol: trx tokenStandard: TRC20 updatedAt: '2024-11-26T13:04:13.943Z' chainId: null confirmations: null confirmed: true createdAt: '2026-03-02T11:11:35.399Z' createdChannel: dashboard currency: USD fee: null feeHash: null feeUSD: null gasFee: null gasPrice: null gasUsed: null hash: >- 0xb4a07203d5ba162c99e67cd91cb329eea1edd8ebd837ce458f7de55152a00c710b076ecc7015b1dec9c87693a4f456631858b03d2cc0af53cf92203bc33e9d421c id: df8811a7-7482-4f2c-ac7c-12298b6ab802 isAutoSweep: false metadata: null network: testnet note: null processingProviderReference: null processingReason: null processingStatus: PENDING rate: null rateUSD: '0.00' reason: >- I am verifying ownership of the wallet address 0x... as customer cust_123. This message was signed on 2026-03-03 to confirm my control over this wallet. recipientAddress: TF8LEkxpDVnS1u4aR48xSuekGGscvc6Uv7 reference: xZm6Xf7xWXlqCjp6eTd senderAddress: TF8LEkxpDVnS1u4aR48xSuekGGscvc6Uv7 signedTransaction: signature: >- 0xb4a07203d5ba162c99e67cd91cb329eea1edd8ebd837ce458f7de55152a00c710b076ecc7015b1dec9c87693a4f456631858b03d2cc0af53cf92203bc33e9d421c status: SUCCESS toAmount: null toCurrency: null tokenAddress: null type: SIGNED updatedAt: '2026-03-02T11:11:35.399Z' wallet: address: TF8LEkxpDVnS1u4aR48xSuekGGscvc6Uv7 configurations: addresses: isActive: true prefunding: assets: - alwaysMaintain: true amount: '3.5' blockchain: tron createdAt: '2025-09-02T11:58:15.807Z' currency: USD id: c4da3644-7980-484a-8477-5abe542d91a1 isActive: true name: Tron Network Fee Funding symbol: TRX updatedAt: '2025-09-02T11:58:15.807Z' isActive: true autoSettlement: isActive: false name: Base Master wallet swap auto ettlement rules: - destination: address: '0x0077777d7EBA4688BDeF3E311b846F25870A19B9' asset: USDC blockchain: base isGateway: true id: 13d4d7e1-c95c-4a8a-a800-75894daf3673 isActive: true name: Swap from Base USDC to Gateway order: FASTEST slippageTolerance: '5' source: assets: - USDC - USDT blockchain: tron maxAmount: '1000' minAmount: '1' createdAt: '2024-08-22T10:01:41.993Z' derivationPath: m/44'/195'/0'/0/0 description: This is Tron testnet master wallet id: eefe6470-3eec-4454-bc54-3eafe3bcbb87 isActive: true name: Tron Main Wallet network: testnet status: ACTIVE updatedAt: '2025-09-02T11:58:15.808Z' message: Message signed successfully statusCode: 200 components: securitySchemes: apiKey: type: apiKey name: x-api-key in: header ````