> ## 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. # Child Address Sign-Only > This endpoint allows you to initiate a withdrawal from a specific address without broadcasting ### Body Parameters | Key | Required | Type | Description | | --- | --- | --- | --- | | assetId | true\* | string (UUID) | The ID of the asset to withdraw. Required if `assets` array is **not** provided. | | address | true\* | string | The destination wallet address for the withdrawal. Required if `assets` array is **not** provided. | | amount | true\* | string | The withdrawal amount. Must be greater than 0. Required if `assets` array is **not** provided. | | reference | false | string | An optional reference note for the withdrawal. | | **note** | false | string | A short message or internal remark to associate with this withdrawal. Not visible on-chain. | | metadata | false | object | Optional metadata (key-value pairs) for additional transaction details. | | assets | false | array of `Asset` | Used for **batch withdrawals**. Required if `assetId`, `amount`, and `address` are **not** provided. | --- ### Asset (for Batch Withdrawals) | Key | Required | Type | Description | | --- | --- | --- | --- | | id | true | string (UUID) | The ID of the asset to withdraw. | | amount | true | string | The withdrawal amount. Must be greater than 0. | | address | true | string | The destination wallet address for the withdrawal. | | reference | false | string | Optional reference note for this asset withdrawal. | | **note** | false | string | A short message or internal remark for this asset withdrawal. Not visible on-chain. | | metadata | false | object | Optional metadata (key-value pairs) for this asset withdrawal. | --- ### Notes - **Single withdrawal**: Provide `assetId`, `amount`, and `address` at the top level. - **Batch withdrawal**: Omit top-level `assetId`, `amount`, and `address`, and instead provide an array of `assets` (each following `Asset`). ## OpenAPI ````yaml post /v1/wallets/{walletId}/addresses/{addressId}/withdraw/sign 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}/addresses/{addressId}/withdraw/sign: parameters: - name: walletId in: path required: true schema: type: string example: YOUR_WALLET_ID - name: addressId in: path required: true schema: type: string example: ADDRESS_ID post: tags: - Withdraw summary: Child Address Sign-Only description: > This endpoint allows you to initiate a withdrawal from a specific address without broadcasting ### Body Parameters | Key | Required | Type | Description | | --- | --- | --- | --- | | assetId | true\* | string (UUID) | The ID of the asset to withdraw. Required if `assets` array is **not** provided. | | address | true\* | string | The destination wallet address for the withdrawal. Required if `assets` array is **not** provided. | | amount | true\* | string | The withdrawal amount. Must be greater than 0. Required if `assets` array is **not** provided. | | reference | false | string | An optional reference note for the withdrawal. | | **note** | false | string | A short message or internal remark to associate with this withdrawal. Not visible on-chain. | | metadata | false | object | Optional metadata (key-value pairs) for additional transaction details. | | assets | false | array of `Asset` | Used for **batch withdrawals**. Required if `assetId`, `amount`, and `address` are **not** provided. | --- ### Asset (for Batch Withdrawals) | Key | Required | Type | Description | | --- | --- | --- | --- | | id | true | string (UUID) | The ID of the asset to withdraw. | | amount | true | string | The withdrawal amount. Must be greater than 0. | | address | true | string | The destination wallet address for the withdrawal. | | reference | false | string | Optional reference note for this asset withdrawal. | | **note** | false | string | A short message or internal remark for this asset withdrawal. Not visible on-chain. | | metadata | false | object | Optional metadata (key-value pairs) for this asset withdrawal. | --- ### Notes - **Single withdrawal**: Provide `assetId`, `amount`, and `address` at the top level. - **Batch withdrawal**: Omit top-level `assetId`, `amount`, and `address`, and instead provide an array of `assets` (each following `Asset`). operationId: childAddressSignOnly requestBody: content: application/json: schema: type: object properties: assets: type: array items: type: object properties: address: type: string example: 0xRecipient1Address amount: type: string example: '10.5' id: type: string example: '{{assetId1}}' reference: type: string example: sign-001 example: - address: 0xRecipient1Address amount: '10.5' id: '{{assetId1}}' reference: sign-001 - address: 0xRecipient2Address amount: '25.0' id: '{{assetId2}}' reference: sign-002 examples: Child Address Sign-Only: value: assets: - address: 0xRecipient1Address amount: '10.5' id: '{{assetId1}}' reference: sign-001 - address: 0xRecipient2Address amount: '25.0' id: '{{assetId2}}' reference: sign-002 responses: '200': description: Withdraw / Withdraw (Batch) content: application/json: schema: type: object properties: data: type: object properties: amlScreening: type: object properties: message: type: string example: Address is not sanctioned provider: type: string example: ofac, fbi, tether, circle status: type: string example: success amount: type: string example: '0.005' amountPaid: type: string example: '0.005' amountUSD: type: string example: '0.005' asset: type: object properties: address: type: string example: '0x337610d27c682E347C9cD60BD4b3b107C9d34dDd' createdAt: type: string example: '2025-08-01T12:36:47.206Z' currency: type: string example: USD decimals: type: number example: 18 id: type: string example: 80f8ba40-d2c3-487c-bb37-e4c041492e0b isActive: type: boolean example: true isNative: type: boolean example: false name: type: string example: Tether USD network: type: string example: testnet standard: type: string example: BEP20 symbol: type: string example: USDT updatedAt: type: string example: '2025-08-01T12:36:47.206Z' 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: createdAt: type: string example: '2025-08-01T12:36:47.166Z' derivationPath: type: string example: m/44'/60'/0'/0 id: type: string example: 3953d0bc-4d9c-4dab-9814-bc204ea86028 isActive: type: boolean example: true isEvmCompatible: type: boolean example: true isL2: type: boolean example: false name: type: string example: BNB smart chain slug: type: string example: bnb-smart-chain symbol: type: string example: bnb tokenStandard: type: string example: BEP20 updatedAt: type: string example: '2025-08-01T12:36:47.166Z' chainId: nullable: true example: null confirmations: nullable: true example: null confirmed: type: boolean example: true createdAt: type: string example: '2025-08-06T11:20:15.385Z' currency: type: string example: USD errors: type: array items: {} example: [] fee: nullable: true example: null feeHash: nullable: true example: null gasFee: nullable: true example: null gasPrice: nullable: true example: null gasUsed: nullable: true example: null hash: type: string example: >- 0x9df88df3ef381c449b7d87343885be552f51d58a1e36e8721f8290171c41324a id: type: string example: 110a10b2-6fea-4e70-aecb-49c7306f5d41 metadata: nullable: true example: null network: type: string example: testnet note: nullable: true example: null rate: nullable: true example: null rateUSD: type: string example: '1' reason: nullable: true example: null recipientAddress: type: string example: '0xDBAcA914f11A8882D5917e2cDD9Dbcbd6f974406' reference: type: string example: egfq3zz8S5 senderAddress: type: string example: '0x1345c2f58e22Eb85d5B85000F7FD8c8c8a301a01' signedTransaction: type: string example: >- 0xf8a9038407270e0082882e94337610d27c682e347c9cd60bd4b3b107c9d34ddd80b844a9059cbb000000000000000000000000dbaca914f11a8882d5917e2cdd9dbcbd6f9744060000000000000000000000000000000000000000000000000011c37937e0800081e6a0e29c45e1de02e6fb4336afc82b8537e035ccafd2669a75992d42ef185ae08216a07febc9ff3883c560ae5d5b3cda3aa570673ad8010efc66a847c994b6f65230ea status: type: string example: SUCCESS success: type: array items: type: object properties: hash: type: string example: 0xsignedhash1... id: type: string example: tx-uuid-1 signedTransaction: type: string example: 0xf86c... example: - hash: 0xsignedhash1... id: tx-uuid-1 signedTransaction: 0xf86c... - hash: 0xsignedhash2... id: tx-uuid-2 signedTransaction: 0xf86d... toAmount: nullable: true example: null toCurrency: nullable: true example: null tokenAddress: type: string example: '0x337610d27c682E347C9cD60BD4b3b107C9d34dDd' type: type: string example: SIGNED updatedAt: type: string example: '2025-08-06T11:20:15.385Z' wallet: type: object properties: address: type: string example: '0x48197e643FfE94C045E96268c3d749eFd5Cf62d6' configurations: type: object properties: autoSweeping: type: object properties: isActive: type: boolean example: false 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: '2025-08-01T17:25:56.817Z' derivationPath: type: string example: m/44'/60'/0'/0/0 description: type: string example: bnb id: type: string example: acff0ed8-0592-4942-848a-6d0a3559c279 isActive: type: boolean example: true name: type: string example: BNB Wallet network: type: string example: testnet status: type: string example: ACTIVE updatedAt: type: string example: '2025-08-04T15:24:38.130Z' message: type: string example: Withdrawal request signed statusCode: type: number example: 200 examples: Withdraw: value: data: amlScreening: message: Address is not sanctioned provider: ofac, fbi, tether, circle status: success amount: '0.005' amountPaid: '0.005' amountUSD: '0.005' asset: address: '0x337610d27c682E347C9cD60BD4b3b107C9d34dDd' createdAt: '2025-08-01T12:36:47.206Z' currency: USD decimals: 18 id: 80f8ba40-d2c3-487c-bb37-e4c041492e0b isActive: true isNative: false name: Tether USD network: testnet standard: BEP20 symbol: USDT updatedAt: '2025-08-01T12:36:47.206Z' assetSwept: null assetSweptAmount: null assetSweptAt: null assetSweptGasFee: null assetSweptHash: null assetSweptRecipientAddress: null assetSweptSenderAddress: null blockHash: null blockNumber: null blockchain: createdAt: '2025-08-01T12:36:47.166Z' derivationPath: m/44'/60'/0'/0 id: 3953d0bc-4d9c-4dab-9814-bc204ea86028 isActive: true isEvmCompatible: true isL2: false name: BNB smart chain slug: bnb-smart-chain symbol: bnb tokenStandard: BEP20 updatedAt: '2025-08-01T12:36:47.166Z' chainId: null confirmations: null confirmed: true createdAt: '2025-08-06T11:20:15.385Z' currency: USD fee: null feeHash: null gasFee: null gasPrice: null gasUsed: null hash: >- 0x9df88df3ef381c449b7d87343885be552f51d58a1e36e8721f8290171c41324a id: 110a10b2-6fea-4e70-aecb-49c7306f5d41 metadata: null network: testnet note: null rate: null rateUSD: '1' reason: null recipientAddress: '0xDBAcA914f11A8882D5917e2cDD9Dbcbd6f974406' reference: egfq3zz8S5 senderAddress: '0x1345c2f58e22Eb85d5B85000F7FD8c8c8a301a01' signedTransaction: >- 0xf8a9038407270e0082882e94337610d27c682e347c9cd60bd4b3b107c9d34ddd80b844a9059cbb000000000000000000000000dbaca914f11a8882d5917e2cdd9dbcbd6f9744060000000000000000000000000000000000000000000000000011c37937e0800081e6a0e29c45e1de02e6fb4336afc82b8537e035ccafd2669a75992d42ef185ae08216a07febc9ff3883c560ae5d5b3cda3aa570673ad8010efc66a847c994b6f65230ea status: SUCCESS toAmount: null toCurrency: null tokenAddress: '0x337610d27c682E347C9cD60BD4b3b107C9d34dDd' type: SIGNED updatedAt: '2025-08-06T11:20:15.385Z' wallet: address: '0x48197e643FfE94C045E96268c3d749eFd5Cf62d6' configurations: autoSweeping: isActive: false threshold: 0 withdrawal: gasless: isActive: false operator: gt threshold: 0 createdAt: '2025-08-01T17:25:56.817Z' derivationPath: m/44'/60'/0'/0/0 description: bnb id: acff0ed8-0592-4942-848a-6d0a3559c279 isActive: true name: BNB Wallet network: testnet status: ACTIVE updatedAt: '2025-08-04T15:24:38.130Z' message: Withdrawal request signed statusCode: 200 Withdraw (Batch): value: data: errors: [] success: - hash: 0xsignedhash1... id: tx-uuid-1 signedTransaction: 0xf86c... - hash: 0xsignedhash2... id: tx-uuid-2 signedTransaction: 0xf86d... message: Batch withdrawal signed (2/2 successful) statusCode: 200 components: securitySchemes: apiKey: type: apiKey name: x-api-key in: header ````