Authorizations
Path Parameters
Example:
"YOUR_WALLET_ID"
Body
application/json
Example:
Example:
"Luthfulah"
Example:
"Osen"
Example:
"+2348161846125"
API Documentation
Master Wallet
Address
Withdraw
Swap
Virtual Accounts
Custom Smart Contracts
Asset Management
Transactions
AML(Anti Money Laundering)
Auto Settlements
- GETMaster Wallet
- PATCHMaster Wallet Update
- GETMaster Wallet Get Rules
- GETMaster Wallet Get Rule
- POSTMaster Wallet Create Rule
- PATCHMaster Wallet Update Rule
- DELMaster Wallet Delete Rule
- GETChild Address
- PATCHChild Address Update
- GETChild Address Get Rules
- GETChild Address Get Rule
- POSTChild Address Create Rule
- PATCHChild Address Update Rule
- DELChild Address Delete Rule
Gateway
Beneficiaries
Payment Links
Asset Recovery
Miscellaneous
Master Wallet Create
Copy
curl --request POST \
--url https://api.blockradar.co/v1/wallets/{id}/virtual-accounts \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '{
"email": "[email protected]",
"firstname": "Luthfulah",
"lastname": "Osen",
"phone": "+2348161846125"
}'Copy
{
"data": {
"accountName": "luthfulah osen",
"accountNumber": "9018927611",
"address": null,
"bankCode": "076",
"bankName": "Polaris Bank",
"createdAt": "2025-11-06T18:30:34.286Z",
"currency": "NGN",
"customer": {
"createdAt": "2025-11-06T18:30:34.286Z",
"email": "[email protected]",
"id": "caa17eb8-4da8-45b4-a866-81dd0a1df613",
"name": "luthfulah osen",
"network": "mainnet",
"phone": "+2348161846125",
"status": "ACTIVE",
"updatedAt": "2025-11-06T18:30:34.286Z"
},
"id": "8180309e-1ead-4a72-a013-b5674600ce4c",
"isActive": true,
"reference": "20",
"status": "ACTIVE",
"type": "AUTO_FUNDING",
"updatedAt": "2025-11-06T18:30:34.286Z",
"wallet": {
"address": "0xD8582C57E56Ef45f9fe82870aDF63d9baB89e1F7",
"configurations": null,
"createdAt": "2024-05-27T19:33:42.377Z",
"derivationPath": "m/44'/60'/0'/0/11",
"description": "This is Base wallet",
"id": "35e964a6-436a-424f-bf3a-618cc060feea",
"isActive": true,
"name": "Base Wallet",
"network": "mainnet",
"status": "ACTIVE",
"updatedAt": "2024-05-27T19:33:42.377Z"
}
},
"message": "Virtual account created successfully",
"statusCode": 201
}Virtual Accounts
Master Wallet Create
This endpoint is used to create a new virtual account within a specific master wallet.
| Field | Type | Required | Description |
|---|---|---|---|
| firstname | string | Yes | Customer’s first name |
| lastname | string | Yes | Customer’s last name |
| string | Yes | Customer’s email address (must be unique per business) | |
| phone | string | Yes | Customer’s phone number in format: +234XXXXXXXXXX |
POST
/
v1
/
wallets
/
{id}
/
virtual-accounts
Master Wallet Create
Copy
curl --request POST \
--url https://api.blockradar.co/v1/wallets/{id}/virtual-accounts \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '{
"email": "[email protected]",
"firstname": "Luthfulah",
"lastname": "Osen",
"phone": "+2348161846125"
}'Copy
{
"data": {
"accountName": "luthfulah osen",
"accountNumber": "9018927611",
"address": null,
"bankCode": "076",
"bankName": "Polaris Bank",
"createdAt": "2025-11-06T18:30:34.286Z",
"currency": "NGN",
"customer": {
"createdAt": "2025-11-06T18:30:34.286Z",
"email": "[email protected]",
"id": "caa17eb8-4da8-45b4-a866-81dd0a1df613",
"name": "luthfulah osen",
"network": "mainnet",
"phone": "+2348161846125",
"status": "ACTIVE",
"updatedAt": "2025-11-06T18:30:34.286Z"
},
"id": "8180309e-1ead-4a72-a013-b5674600ce4c",
"isActive": true,
"reference": "20",
"status": "ACTIVE",
"type": "AUTO_FUNDING",
"updatedAt": "2025-11-06T18:30:34.286Z",
"wallet": {
"address": "0xD8582C57E56Ef45f9fe82870aDF63d9baB89e1F7",
"configurations": null,
"createdAt": "2024-05-27T19:33:42.377Z",
"derivationPath": "m/44'/60'/0'/0/11",
"description": "This is Base wallet",
"id": "35e964a6-436a-424f-bf3a-618cc060feea",
"isActive": true,
"name": "Base Wallet",
"network": "mainnet",
"status": "ACTIVE",
"updatedAt": "2024-05-27T19:33:42.377Z"
}
},
"message": "Virtual account created successfully",
"statusCode": 201
}⌘I