Master Wallet Execute
curl --request POST \
--url https://api.blockradar.co/v1/wallets/{walletId}/withdraw/fiat/execute \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"reference": "client-reference-value",
"accountIdentifier": "8034007516",
"amount": 1000,
"assetId": "a79270bf-5a79-4bdc-8fef-586bfcff6e9f",
"code": "445223",
"currency": "NGN",
"institutionIdentifier": "OPAYNGPC"
}
'import requests
url = "https://api.blockradar.co/v1/wallets/{walletId}/withdraw/fiat/execute"
payload = {
"reference": "client-reference-value",
"accountIdentifier": "8034007516",
"amount": 1000,
"assetId": "a79270bf-5a79-4bdc-8fef-586bfcff6e9f",
"code": "445223",
"currency": "NGN",
"institutionIdentifier": "OPAYNGPC"
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
reference: 'client-reference-value',
accountIdentifier: '8034007516',
amount: 1000,
assetId: 'a79270bf-5a79-4bdc-8fef-586bfcff6e9f',
code: '445223',
currency: 'NGN',
institutionIdentifier: 'OPAYNGPC'
})
};
fetch('https://api.blockradar.co/v1/wallets/{walletId}/withdraw/fiat/execute', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.blockradar.co/v1/wallets/{walletId}/withdraw/fiat/execute",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'reference' => 'client-reference-value',
'accountIdentifier' => '8034007516',
'amount' => 1000,
'assetId' => 'a79270bf-5a79-4bdc-8fef-586bfcff6e9f',
'code' => '445223',
'currency' => 'NGN',
'institutionIdentifier' => 'OPAYNGPC'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.blockradar.co/v1/wallets/{walletId}/withdraw/fiat/execute"
payload := strings.NewReader("{\n \"reference\": \"client-reference-value\",\n \"accountIdentifier\": \"8034007516\",\n \"amount\": 1000,\n \"assetId\": \"a79270bf-5a79-4bdc-8fef-586bfcff6e9f\",\n \"code\": \"445223\",\n \"currency\": \"NGN\",\n \"institutionIdentifier\": \"OPAYNGPC\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.blockradar.co/v1/wallets/{walletId}/withdraw/fiat/execute")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"reference\": \"client-reference-value\",\n \"accountIdentifier\": \"8034007516\",\n \"amount\": 1000,\n \"assetId\": \"a79270bf-5a79-4bdc-8fef-586bfcff6e9f\",\n \"code\": \"445223\",\n \"currency\": \"NGN\",\n \"institutionIdentifier\": \"OPAYNGPC\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.blockradar.co/v1/wallets/{walletId}/withdraw/fiat/execute")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"reference\": \"client-reference-value\",\n \"accountIdentifier\": \"8034007516\",\n \"amount\": 1000,\n \"assetId\": \"a79270bf-5a79-4bdc-8fef-586bfcff6e9f\",\n \"code\": \"445223\",\n \"currency\": \"NGN\",\n \"institutionIdentifier\": \"OPAYNGPC\"\n}"
response = http.request(request)
puts response.read_body{
"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
}{
"statusCode": 123,
"message": "<string>",
"details": {
"code": "CUSTOMER_ONBOARDING_REQUIRED",
"customerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"provider": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"slug": "<string>",
"name": "<string>"
},
"onboarding": {
"caseId": "<string>",
"status": "<string>",
"providerStatus": "<string>",
"action": {
"type": "create_case",
"method": "POST",
"path": "/v1/customers/18d2f159-e0cd-4a45-b735-e9dfe0f7520a/onboarding-requests",
"body": {
"provider": "<string>",
"type": "onramp"
}
}
}
},
"requestId": "<string>"
}{
"statusCode": 123,
"message": "<string>",
"details": {
"code": "CUSTOMER_ONBOARDING_REQUIRED",
"customerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"provider": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"slug": "<string>",
"name": "<string>"
},
"onboarding": {
"caseId": "<string>",
"status": "<string>",
"providerStatus": "<string>",
"action": {
"type": "create_case",
"method": "POST",
"path": "/v1/customers/18d2f159-e0cd-4a45-b735-e9dfe0f7520a/onboarding-requests",
"body": {
"provider": "<string>",
"type": "onramp"
}
}
}
},
"requestId": "<string>"
}{
"statusCode": 123,
"message": "<string>",
"details": {
"code": "CUSTOMER_ONBOARDING_REQUIRED",
"customerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"provider": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"slug": "<string>",
"name": "<string>"
},
"onboarding": {
"caseId": "<string>",
"status": "<string>",
"providerStatus": "<string>",
"action": {
"type": "create_case",
"method": "POST",
"path": "/v1/customers/18d2f159-e0cd-4a45-b735-e9dfe0f7520a/onboarding-requests",
"body": {
"provider": "<string>",
"type": "onramp"
}
}
}
},
"requestId": "<string>"
}v1
Master Wallet Execute
Master Wallet Execute For customer-owned withdrawals, provide customerId when starting the flow; subsequent requests inherit it from sessionId. Changing identity requires a new rates request. Customer eligibility failures use the HTTP error details contract. See Customer fiat flows.
POST
/
v1
/
wallets
/
{walletId}
/
withdraw
/
fiat
/
execute
Master Wallet Execute
curl --request POST \
--url https://api.blockradar.co/v1/wallets/{walletId}/withdraw/fiat/execute \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"reference": "client-reference-value",
"accountIdentifier": "8034007516",
"amount": 1000,
"assetId": "a79270bf-5a79-4bdc-8fef-586bfcff6e9f",
"code": "445223",
"currency": "NGN",
"institutionIdentifier": "OPAYNGPC"
}
'import requests
url = "https://api.blockradar.co/v1/wallets/{walletId}/withdraw/fiat/execute"
payload = {
"reference": "client-reference-value",
"accountIdentifier": "8034007516",
"amount": 1000,
"assetId": "a79270bf-5a79-4bdc-8fef-586bfcff6e9f",
"code": "445223",
"currency": "NGN",
"institutionIdentifier": "OPAYNGPC"
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
reference: 'client-reference-value',
accountIdentifier: '8034007516',
amount: 1000,
assetId: 'a79270bf-5a79-4bdc-8fef-586bfcff6e9f',
code: '445223',
currency: 'NGN',
institutionIdentifier: 'OPAYNGPC'
})
};
fetch('https://api.blockradar.co/v1/wallets/{walletId}/withdraw/fiat/execute', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.blockradar.co/v1/wallets/{walletId}/withdraw/fiat/execute",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'reference' => 'client-reference-value',
'accountIdentifier' => '8034007516',
'amount' => 1000,
'assetId' => 'a79270bf-5a79-4bdc-8fef-586bfcff6e9f',
'code' => '445223',
'currency' => 'NGN',
'institutionIdentifier' => 'OPAYNGPC'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.blockradar.co/v1/wallets/{walletId}/withdraw/fiat/execute"
payload := strings.NewReader("{\n \"reference\": \"client-reference-value\",\n \"accountIdentifier\": \"8034007516\",\n \"amount\": 1000,\n \"assetId\": \"a79270bf-5a79-4bdc-8fef-586bfcff6e9f\",\n \"code\": \"445223\",\n \"currency\": \"NGN\",\n \"institutionIdentifier\": \"OPAYNGPC\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.blockradar.co/v1/wallets/{walletId}/withdraw/fiat/execute")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"reference\": \"client-reference-value\",\n \"accountIdentifier\": \"8034007516\",\n \"amount\": 1000,\n \"assetId\": \"a79270bf-5a79-4bdc-8fef-586bfcff6e9f\",\n \"code\": \"445223\",\n \"currency\": \"NGN\",\n \"institutionIdentifier\": \"OPAYNGPC\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.blockradar.co/v1/wallets/{walletId}/withdraw/fiat/execute")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"reference\": \"client-reference-value\",\n \"accountIdentifier\": \"8034007516\",\n \"amount\": 1000,\n \"assetId\": \"a79270bf-5a79-4bdc-8fef-586bfcff6e9f\",\n \"code\": \"445223\",\n \"currency\": \"NGN\",\n \"institutionIdentifier\": \"OPAYNGPC\"\n}"
response = http.request(request)
puts response.read_body{
"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
}{
"statusCode": 123,
"message": "<string>",
"details": {
"code": "CUSTOMER_ONBOARDING_REQUIRED",
"customerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"provider": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"slug": "<string>",
"name": "<string>"
},
"onboarding": {
"caseId": "<string>",
"status": "<string>",
"providerStatus": "<string>",
"action": {
"type": "create_case",
"method": "POST",
"path": "/v1/customers/18d2f159-e0cd-4a45-b735-e9dfe0f7520a/onboarding-requests",
"body": {
"provider": "<string>",
"type": "onramp"
}
}
}
},
"requestId": "<string>"
}{
"statusCode": 123,
"message": "<string>",
"details": {
"code": "CUSTOMER_ONBOARDING_REQUIRED",
"customerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"provider": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"slug": "<string>",
"name": "<string>"
},
"onboarding": {
"caseId": "<string>",
"status": "<string>",
"providerStatus": "<string>",
"action": {
"type": "create_case",
"method": "POST",
"path": "/v1/customers/18d2f159-e0cd-4a45-b735-e9dfe0f7520a/onboarding-requests",
"body": {
"provider": "<string>",
"type": "onramp"
}
}
}
},
"requestId": "<string>"
}{
"statusCode": 123,
"message": "<string>",
"details": {
"code": "CUSTOMER_ONBOARDING_REQUIRED",
"customerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"provider": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"slug": "<string>",
"name": "<string>"
},
"onboarding": {
"caseId": "<string>",
"status": "<string>",
"providerStatus": "<string>",
"action": {
"type": "create_case",
"method": "POST",
"path": "/v1/customers/18d2f159-e0cd-4a45-b735-e9dfe0f7520a/onboarding-requests",
"body": {
"provider": "<string>",
"type": "onramp"
}
}
}
},
"requestId": "<string>"
}Para identidad, sesiones, recuperación y comisiones, consulte Flujos fiat para clientes.
Autorizaciones
Parámetros de ruta
Ejemplo:
"YOUR_WALLET_ID"
Cuerpo
application/json
destination bank account identifier
Ejemplo:
"8034007516"
amount to withdraw in asset units
Ejemplo:
1000
asset ID of the stablecoin to withdraw
Ejemplo:
"a79270bf-5a79-4bdc-8fef-586bfcff6e9f"
destination fiat currency code
Ejemplo:
"NGN"
bank or institution identifier code
Ejemplo:
"OPAYNGPC"
Optional existing active customer owned by the authenticated business. Omit for the business-owned flow. Start a new session to change customer identity.
client reference for tracking transaction
Ejemplo:
"client-reference-value"
Ejemplo:
"445223"