Child Address Get Quote
curl --request POST \
--url https://api.blockradar.co/v1/wallets/{walletId}/addresses/{addressId}/deposit/fiat/quote \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"assetId": "ae455f23-3824-4125-baab-d158315cbcbd",
"currency": "NGN",
"amount": "100.00",
"rail": "one_time_virtual_account",
"sessionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"customerId": "18d2f159-e0cd-4a45-b735-e9dfe0f7520a",
"provider": "example-provider"
}
'import requests
url = "https://api.blockradar.co/v1/wallets/{walletId}/addresses/{addressId}/deposit/fiat/quote"
payload = {
"assetId": "ae455f23-3824-4125-baab-d158315cbcbd",
"currency": "NGN",
"amount": "100.00",
"rail": "one_time_virtual_account",
"sessionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"customerId": "18d2f159-e0cd-4a45-b735-e9dfe0f7520a",
"provider": "example-provider"
}
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({
assetId: 'ae455f23-3824-4125-baab-d158315cbcbd',
currency: 'NGN',
amount: '100.00',
rail: 'one_time_virtual_account',
sessionId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
customerId: '18d2f159-e0cd-4a45-b735-e9dfe0f7520a',
provider: 'example-provider'
})
};
fetch('https://api.blockradar.co/v1/wallets/{walletId}/addresses/{addressId}/deposit/fiat/quote', 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}/addresses/{addressId}/deposit/fiat/quote",
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([
'assetId' => 'ae455f23-3824-4125-baab-d158315cbcbd',
'currency' => 'NGN',
'amount' => '100.00',
'rail' => 'one_time_virtual_account',
'sessionId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'customerId' => '18d2f159-e0cd-4a45-b735-e9dfe0f7520a',
'provider' => 'example-provider'
]),
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}/addresses/{addressId}/deposit/fiat/quote"
payload := strings.NewReader("{\n \"assetId\": \"ae455f23-3824-4125-baab-d158315cbcbd\",\n \"currency\": \"NGN\",\n \"amount\": \"100.00\",\n \"rail\": \"one_time_virtual_account\",\n \"sessionId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"customerId\": \"18d2f159-e0cd-4a45-b735-e9dfe0f7520a\",\n \"provider\": \"example-provider\"\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}/addresses/{addressId}/deposit/fiat/quote")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"assetId\": \"ae455f23-3824-4125-baab-d158315cbcbd\",\n \"currency\": \"NGN\",\n \"amount\": \"100.00\",\n \"rail\": \"one_time_virtual_account\",\n \"sessionId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"customerId\": \"18d2f159-e0cd-4a45-b735-e9dfe0f7520a\",\n \"provider\": \"example-provider\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.blockradar.co/v1/wallets/{walletId}/addresses/{addressId}/deposit/fiat/quote")
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 \"assetId\": \"ae455f23-3824-4125-baab-d158315cbcbd\",\n \"currency\": \"NGN\",\n \"amount\": \"100.00\",\n \"rail\": \"one_time_virtual_account\",\n \"sessionId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"customerId\": \"18d2f159-e0cd-4a45-b735-e9dfe0f7520a\",\n \"provider\": \"example-provider\"\n}"
response = http.request(request)
puts response.read_body{
"statusCode": 200,
"message": "Fiat deposit quote retrieved",
"data": {
"amount": "100.00",
"amountFiat": "155000.00",
"feeFiat": "1500.00",
"amountFiatPayable": "156500.00",
"rate": "1550.00",
"unlocked": true,
"additionalDataRequirements": {
"schema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"title": "Bank account details",
"properties": {
"institutionIdentifier": {
"type": "string",
"title": "Institution"
},
"accountIdentifier": {
"type": "string",
"title": "Account identifier"
},
"accountName": {
"type": "string",
"title": "Account name",
"readOnly": true,
"x-field-kind": "resolved",
"x-resolution": {
"method": "POST",
"url": "/v1/wallets/4465468a-3c36-4536-918a-91d689e18a74/deposit/fiat/payment-order-requirements/resolve",
"body": {
"provider": "example-provider",
"assetId": "ae455f23-3824-4125-baab-d158315cbcbd",
"currency": "NGN",
"amount": "100.00",
"rail": "one_time_virtual_account"
},
"inputPath": "additionalData",
"dependsOn": [
"institutionIdentifier",
"accountIdentifier"
],
"responsePath": "data.accountName"
}
}
},
"required": [
"institutionIdentifier",
"accountIdentifier"
],
"additionalProperties": false
},
"data": null
}
}
}Deposit Fiat
Get Child Address Quote
POST
/
v1
/
wallets
/
{walletId}
/
addresses
/
{addressId}
/
deposit
/
fiat
/
quote
Child Address Get Quote
curl --request POST \
--url https://api.blockradar.co/v1/wallets/{walletId}/addresses/{addressId}/deposit/fiat/quote \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"assetId": "ae455f23-3824-4125-baab-d158315cbcbd",
"currency": "NGN",
"amount": "100.00",
"rail": "one_time_virtual_account",
"sessionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"customerId": "18d2f159-e0cd-4a45-b735-e9dfe0f7520a",
"provider": "example-provider"
}
'import requests
url = "https://api.blockradar.co/v1/wallets/{walletId}/addresses/{addressId}/deposit/fiat/quote"
payload = {
"assetId": "ae455f23-3824-4125-baab-d158315cbcbd",
"currency": "NGN",
"amount": "100.00",
"rail": "one_time_virtual_account",
"sessionId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"customerId": "18d2f159-e0cd-4a45-b735-e9dfe0f7520a",
"provider": "example-provider"
}
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({
assetId: 'ae455f23-3824-4125-baab-d158315cbcbd',
currency: 'NGN',
amount: '100.00',
rail: 'one_time_virtual_account',
sessionId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
customerId: '18d2f159-e0cd-4a45-b735-e9dfe0f7520a',
provider: 'example-provider'
})
};
fetch('https://api.blockradar.co/v1/wallets/{walletId}/addresses/{addressId}/deposit/fiat/quote', 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}/addresses/{addressId}/deposit/fiat/quote",
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([
'assetId' => 'ae455f23-3824-4125-baab-d158315cbcbd',
'currency' => 'NGN',
'amount' => '100.00',
'rail' => 'one_time_virtual_account',
'sessionId' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'customerId' => '18d2f159-e0cd-4a45-b735-e9dfe0f7520a',
'provider' => 'example-provider'
]),
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}/addresses/{addressId}/deposit/fiat/quote"
payload := strings.NewReader("{\n \"assetId\": \"ae455f23-3824-4125-baab-d158315cbcbd\",\n \"currency\": \"NGN\",\n \"amount\": \"100.00\",\n \"rail\": \"one_time_virtual_account\",\n \"sessionId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"customerId\": \"18d2f159-e0cd-4a45-b735-e9dfe0f7520a\",\n \"provider\": \"example-provider\"\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}/addresses/{addressId}/deposit/fiat/quote")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"assetId\": \"ae455f23-3824-4125-baab-d158315cbcbd\",\n \"currency\": \"NGN\",\n \"amount\": \"100.00\",\n \"rail\": \"one_time_virtual_account\",\n \"sessionId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"customerId\": \"18d2f159-e0cd-4a45-b735-e9dfe0f7520a\",\n \"provider\": \"example-provider\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.blockradar.co/v1/wallets/{walletId}/addresses/{addressId}/deposit/fiat/quote")
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 \"assetId\": \"ae455f23-3824-4125-baab-d158315cbcbd\",\n \"currency\": \"NGN\",\n \"amount\": \"100.00\",\n \"rail\": \"one_time_virtual_account\",\n \"sessionId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"customerId\": \"18d2f159-e0cd-4a45-b735-e9dfe0f7520a\",\n \"provider\": \"example-provider\"\n}"
response = http.request(request)
puts response.read_body{
"statusCode": 200,
"message": "Fiat deposit quote retrieved",
"data": {
"amount": "100.00",
"amountFiat": "155000.00",
"feeFiat": "1500.00",
"amountFiatPayable": "156500.00",
"rate": "1550.00",
"unlocked": true,
"additionalDataRequirements": {
"schema": {
"$schema": "http://json-schema.org/draft-07/schema#",
"type": "object",
"title": "Bank account details",
"properties": {
"institutionIdentifier": {
"type": "string",
"title": "Institution"
},
"accountIdentifier": {
"type": "string",
"title": "Account identifier"
},
"accountName": {
"type": "string",
"title": "Account name",
"readOnly": true,
"x-field-kind": "resolved",
"x-resolution": {
"method": "POST",
"url": "/v1/wallets/4465468a-3c36-4536-918a-91d689e18a74/deposit/fiat/payment-order-requirements/resolve",
"body": {
"provider": "example-provider",
"assetId": "ae455f23-3824-4125-baab-d158315cbcbd",
"currency": "NGN",
"amount": "100.00",
"rail": "one_time_virtual_account"
},
"inputPath": "additionalData",
"dependsOn": [
"institutionIdentifier",
"accountIdentifier"
],
"responsePath": "data.accountName"
}
}
},
"required": [
"institutionIdentifier",
"accountIdentifier"
],
"additionalProperties": false
},
"data": null
}
}
}Incluez
customerId lorsque le dépôt appartient à un client existant et
exige un KYC propre au corridor. L’adaptateur du fournisseur déduit le corridor de
la devise fiat sélectionnée. La réponse peut inclure un
schéma fournisseur dans data.additionalDataRequirements.schema et des valeurs
enregistrées réutilisables dans data.additionalDataRequirements.data.
Consultez Dynamic Forms pour le flux de traitement du schéma.Autorisations
Paramètres de chemin
Wallet identifier.
Child address identifier.
Corps
application/json
Stablecoin asset identifier returned by the supported-assets endpoint.
Exemple:
"ae455f23-3824-4125-baab-d158315cbcbd"
ISO 4217 fiat currency code.
Required string length:
3Exemple:
"NGN"
Decimal amount encoded as a string to preserve precision.
Pattern:
^\d+(\.\d+)?$Exemple:
"100.00"
Payment collection rail.
Options disponibles:
one_time_virtual_account, payment_link, qr_code Exemple:
"one_time_virtual_account"
Existing deposit session. When supplied, the original route values are authoritative.
Existing Blockradar customer identifier. Include it when requesting a new quote so saved provider KYC can be returned and reused.
Exemple:
"18d2f159-e0cd-4a45-b735-e9dfe0f7520a"
Optional provider slug. Omit it to let Blockradar select an eligible provider.
Exemple:
"example-provider"

