Child Address Execute
curl --request POST \
--url https://api.blockradar.co/v2/wallets/{walletId}/addresses/{addressId}/withdraw/fiat/execute \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"sessionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"paymentMethod": "<string>",
"customerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"assetId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"amount": "<string>",
"amountSide": "source",
"currency": "<string>",
"paymentMethodData": {},
"isGaslessWithdraw": true,
"reference": "wd_20260719_001",
"metadata": {
"payoutId": "payout_123"
},
"note": "Vendor payout",
"provider": "<string>",
"code": "<string>",
"passkeyResponse": {}
}
'import requests
url = "https://api.blockradar.co/v2/wallets/{walletId}/addresses/{addressId}/withdraw/fiat/execute"
payload = {
"sessionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"paymentMethod": "<string>",
"customerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"assetId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"amount": "<string>",
"amountSide": "source",
"currency": "<string>",
"paymentMethodData": {},
"isGaslessWithdraw": True,
"reference": "wd_20260719_001",
"metadata": { "payoutId": "payout_123" },
"note": "Vendor payout",
"provider": "<string>",
"code": "<string>",
"passkeyResponse": {}
}
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({
sessionId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
paymentMethod: '<string>',
customerId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
assetId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
amount: '<string>',
amountSide: 'source',
currency: '<string>',
paymentMethodData: {},
isGaslessWithdraw: true,
reference: 'wd_20260719_001',
metadata: {payoutId: 'payout_123'},
note: 'Vendor payout',
provider: '<string>',
code: '<string>',
passkeyResponse: {}
})
};
fetch('https://api.blockradar.co/v2/wallets/{walletId}/addresses/{addressId}/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/v2/wallets/{walletId}/addresses/{addressId}/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([
'sessionId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'paymentMethod' => '<string>',
'customerId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'assetId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'amount' => '<string>',
'amountSide' => 'source',
'currency' => '<string>',
'paymentMethodData' => [
],
'isGaslessWithdraw' => true,
'reference' => 'wd_20260719_001',
'metadata' => [
'payoutId' => 'payout_123'
],
'note' => 'Vendor payout',
'provider' => '<string>',
'code' => '<string>',
'passkeyResponse' => [
]
]),
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/v2/wallets/{walletId}/addresses/{addressId}/withdraw/fiat/execute"
payload := strings.NewReader("{\n \"sessionId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"paymentMethod\": \"<string>\",\n \"customerId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"assetId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"amount\": \"<string>\",\n \"amountSide\": \"source\",\n \"currency\": \"<string>\",\n \"paymentMethodData\": {},\n \"isGaslessWithdraw\": true,\n \"reference\": \"wd_20260719_001\",\n \"metadata\": {\n \"payoutId\": \"payout_123\"\n },\n \"note\": \"Vendor payout\",\n \"provider\": \"<string>\",\n \"code\": \"<string>\",\n \"passkeyResponse\": {}\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/v2/wallets/{walletId}/addresses/{addressId}/withdraw/fiat/execute")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"sessionId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"paymentMethod\": \"<string>\",\n \"customerId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"assetId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"amount\": \"<string>\",\n \"amountSide\": \"source\",\n \"currency\": \"<string>\",\n \"paymentMethodData\": {},\n \"isGaslessWithdraw\": true,\n \"reference\": \"wd_20260719_001\",\n \"metadata\": {\n \"payoutId\": \"payout_123\"\n },\n \"note\": \"Vendor payout\",\n \"provider\": \"<string>\",\n \"code\": \"<string>\",\n \"passkeyResponse\": {}\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.blockradar.co/v2/wallets/{walletId}/addresses/{addressId}/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 \"sessionId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"paymentMethod\": \"<string>\",\n \"customerId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"assetId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"amount\": \"<string>\",\n \"amountSide\": \"source\",\n \"currency\": \"<string>\",\n \"paymentMethodData\": {},\n \"isGaslessWithdraw\": true,\n \"reference\": \"wd_20260719_001\",\n \"metadata\": {\n \"payoutId\": \"payout_123\"\n },\n \"note\": \"Vendor payout\",\n \"provider\": \"<string>\",\n \"code\": \"<string>\",\n \"passkeyResponse\": {}\n}"
response = http.request(request)
puts response.read_body{
"message": "Successful",
"data": {
"id": "5b26b640-7a15-48aa-a465-82a4cb6e927b",
"reference": "wd_20260719_001",
"senderAddress": "0x947514e4B803e312C312da0F1B41fEDdbe15ae7a",
"recipientAddress": "0123456789",
"tokenAddress": "0xA0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"amount": "100.00",
"amountPaid": "100.00",
"amountUSD": "100.00",
"rateUSD": "1.00",
"fee": "1.50",
"feeUSD": "1.50",
"currency": "NGN",
"toCurrency": "NGN",
"hash": null,
"confirmed": false,
"status": "pending",
"processingStatus": "pending",
"processingProviderReference": null,
"type": "offramp",
"note": "Vendor payout",
"createdAt": "2026-07-19T12:30:00.000Z",
"updatedAt": "2026-07-19T12:30:00.000Z"
},
"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>"
}v2
Child Address 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
/
v2
/
wallets
/
{walletId}
/
addresses
/
{addressId}
/
withdraw
/
fiat
/
execute
Child Address Execute
curl --request POST \
--url https://api.blockradar.co/v2/wallets/{walletId}/addresses/{addressId}/withdraw/fiat/execute \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"sessionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"paymentMethod": "<string>",
"customerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"assetId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"amount": "<string>",
"amountSide": "source",
"currency": "<string>",
"paymentMethodData": {},
"isGaslessWithdraw": true,
"reference": "wd_20260719_001",
"metadata": {
"payoutId": "payout_123"
},
"note": "Vendor payout",
"provider": "<string>",
"code": "<string>",
"passkeyResponse": {}
}
'import requests
url = "https://api.blockradar.co/v2/wallets/{walletId}/addresses/{addressId}/withdraw/fiat/execute"
payload = {
"sessionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"paymentMethod": "<string>",
"customerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"assetId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"amount": "<string>",
"amountSide": "source",
"currency": "<string>",
"paymentMethodData": {},
"isGaslessWithdraw": True,
"reference": "wd_20260719_001",
"metadata": { "payoutId": "payout_123" },
"note": "Vendor payout",
"provider": "<string>",
"code": "<string>",
"passkeyResponse": {}
}
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({
sessionId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
paymentMethod: '<string>',
customerId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
assetId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
amount: '<string>',
amountSide: 'source',
currency: '<string>',
paymentMethodData: {},
isGaslessWithdraw: true,
reference: 'wd_20260719_001',
metadata: {payoutId: 'payout_123'},
note: 'Vendor payout',
provider: '<string>',
code: '<string>',
passkeyResponse: {}
})
};
fetch('https://api.blockradar.co/v2/wallets/{walletId}/addresses/{addressId}/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/v2/wallets/{walletId}/addresses/{addressId}/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([
'sessionId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'paymentMethod' => '<string>',
'customerId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'assetId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'amount' => '<string>',
'amountSide' => 'source',
'currency' => '<string>',
'paymentMethodData' => [
],
'isGaslessWithdraw' => true,
'reference' => 'wd_20260719_001',
'metadata' => [
'payoutId' => 'payout_123'
],
'note' => 'Vendor payout',
'provider' => '<string>',
'code' => '<string>',
'passkeyResponse' => [
]
]),
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/v2/wallets/{walletId}/addresses/{addressId}/withdraw/fiat/execute"
payload := strings.NewReader("{\n \"sessionId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"paymentMethod\": \"<string>\",\n \"customerId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"assetId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"amount\": \"<string>\",\n \"amountSide\": \"source\",\n \"currency\": \"<string>\",\n \"paymentMethodData\": {},\n \"isGaslessWithdraw\": true,\n \"reference\": \"wd_20260719_001\",\n \"metadata\": {\n \"payoutId\": \"payout_123\"\n },\n \"note\": \"Vendor payout\",\n \"provider\": \"<string>\",\n \"code\": \"<string>\",\n \"passkeyResponse\": {}\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/v2/wallets/{walletId}/addresses/{addressId}/withdraw/fiat/execute")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"sessionId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"paymentMethod\": \"<string>\",\n \"customerId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"assetId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"amount\": \"<string>\",\n \"amountSide\": \"source\",\n \"currency\": \"<string>\",\n \"paymentMethodData\": {},\n \"isGaslessWithdraw\": true,\n \"reference\": \"wd_20260719_001\",\n \"metadata\": {\n \"payoutId\": \"payout_123\"\n },\n \"note\": \"Vendor payout\",\n \"provider\": \"<string>\",\n \"code\": \"<string>\",\n \"passkeyResponse\": {}\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.blockradar.co/v2/wallets/{walletId}/addresses/{addressId}/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 \"sessionId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"paymentMethod\": \"<string>\",\n \"customerId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"assetId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"amount\": \"<string>\",\n \"amountSide\": \"source\",\n \"currency\": \"<string>\",\n \"paymentMethodData\": {},\n \"isGaslessWithdraw\": true,\n \"reference\": \"wd_20260719_001\",\n \"metadata\": {\n \"payoutId\": \"payout_123\"\n },\n \"note\": \"Vendor payout\",\n \"provider\": \"<string>\",\n \"code\": \"<string>\",\n \"passkeyResponse\": {}\n}"
response = http.request(request)
puts response.read_body{
"message": "Successful",
"data": {
"id": "5b26b640-7a15-48aa-a465-82a4cb6e927b",
"reference": "wd_20260719_001",
"senderAddress": "0x947514e4B803e312C312da0F1B41fEDdbe15ae7a",
"recipientAddress": "0123456789",
"tokenAddress": "0xA0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"amount": "100.00",
"amountPaid": "100.00",
"amountUSD": "100.00",
"rateUSD": "1.00",
"fee": "1.50",
"feeUSD": "1.50",
"currency": "NGN",
"toCurrency": "NGN",
"hash": null,
"confirmed": false,
"status": "pending",
"processingStatus": "pending",
"processingProviderReference": null,
"type": "offramp",
"note": "Vendor payout",
"createdAt": "2026-07-19T12:30:00.000Z",
"updatedAt": "2026-07-19T12:30:00.000Z"
},
"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>"
}For customer identity, session binding, onboarding recovery and fee semantics, see Customer fiat flows.
Authorizations
Path Parameters
Wallet identifier.
Child address identifier.
Body
application/json
- Option 1
- Option 2
Supply sessionId, or all original routing fields. Repeated fields must match the session. Customer identity is inherited from the session.
Session ID returned by the v2 rates endpoint.
ID of an existing active customer owned by the authenticated business.
Pattern:
^\d+(\.\d+)?$source fixes the total source-asset budget, with fees allocated inside it; target fixes the fiat payout before beneficiary deductions and derives the required source debit.
Available options:
source, target Required string length:
3Unique client reference used for reconciliation and safe retries.
Example:
"wd_20260719_001"
Your application metadata.
Example:
{ "payoutId": "payout_123" }
Human-readable transaction note.
Example:
"Vendor payout"
Completed payment-method resolution, including the provider resolutionId. Required when the provider returned a resolution session. Complete every nextStep before quoting or executing.
Show child attributes
Show child attributes
2FA code, when required.
WebAuthn assertion, when required.