Get Exchange Rates
curl --request GET \
--url https://api.blockradar.co/v2/wallets/{id}/withdraw/fiat/rates \
--header 'x-api-key: <api-key>'import requests
url = "https://api.blockradar.co/v2/wallets/{id}/withdraw/fiat/rates"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.blockradar.co/v2/wallets/{id}/withdraw/fiat/rates', 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/{id}/withdraw/fiat/rates",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"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"
"net/http"
"io"
)
func main() {
url := "https://api.blockradar.co/v2/wallets/{id}/withdraw/fiat/rates"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.blockradar.co/v2/wallets/{id}/withdraw/fiat/rates")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.blockradar.co/v2/wallets/{id}/withdraw/fiat/rates")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"message": "Exchange rates fetched successfully",
"data": {
"rate": "0.995845122",
"amount": "3.983380488",
"unlocked": true,
"sessionId": "13a36c1c-f4a6-4e49-a582-2ecded2559bc",
"sessionExpiresAt": "2026-09-15T15:20:00.000Z",
"debitAmount": "4",
"provider": "noah",
"limits": {
"minAmount": "3.5",
"maxAmount": null,
"currency": "USDC",
"amountSide": "source"
}
},
"status": true
}{
"statusCode": 400,
"message": "Customer must complete onboarding with Noah before withdrawing fiat",
"details": {
"code": "CUSTOMER_ONBOARDING_REQUIRED",
"customerId": "18d2f159-e0cd-4a45-b735-e9dfe0f7520a",
"provider": {
"id": "1128dd40-2c94-4c16-a6bf-fbbc6afee52c",
"slug": "noah",
"name": "Noah"
},
"onboarding": {
"caseId": null,
"status": null,
"providerStatus": null,
"action": {
"type": "create_case",
"method": "POST",
"path": "/v1/customers/18d2f159-e0cd-4a45-b735-e9dfe0f7520a/onboarding-requests",
"body": {
"provider": "noah",
"type": "offramp"
}
}
}
}
}{
"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
Get Exchange Rates
Get a rate and start a withdrawal session. Include customerId to withdraw on behalf of a customer; omit it for a business withdrawal. Keep sessionId for payment-method discovery, resolution, quote, and execution. Returns indicative pricing and a session. Optional limits apply to the entered amountSide and currency at route level. A selected payment method can have a higher source minimum; inspect its limits before resolving it. Source budgets include fees; target requests fix the fiat payout and fund fees on top in crypto.
GET
/
v2
/
wallets
/
{id}
/
withdraw
/
fiat
/
rates
Get Exchange Rates
curl --request GET \
--url https://api.blockradar.co/v2/wallets/{id}/withdraw/fiat/rates \
--header 'x-api-key: <api-key>'import requests
url = "https://api.blockradar.co/v2/wallets/{id}/withdraw/fiat/rates"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.blockradar.co/v2/wallets/{id}/withdraw/fiat/rates', 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/{id}/withdraw/fiat/rates",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"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"
"net/http"
"io"
)
func main() {
url := "https://api.blockradar.co/v2/wallets/{id}/withdraw/fiat/rates"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.blockradar.co/v2/wallets/{id}/withdraw/fiat/rates")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.blockradar.co/v2/wallets/{id}/withdraw/fiat/rates")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"message": "Exchange rates fetched successfully",
"data": {
"rate": "0.995845122",
"amount": "3.983380488",
"unlocked": true,
"sessionId": "13a36c1c-f4a6-4e49-a582-2ecded2559bc",
"sessionExpiresAt": "2026-09-15T15:20:00.000Z",
"debitAmount": "4",
"provider": "noah",
"limits": {
"minAmount": "3.5",
"maxAmount": null,
"currency": "USDC",
"amountSide": "source"
}
},
"status": true
}{
"statusCode": 400,
"message": "Customer must complete onboarding with Noah before withdrawing fiat",
"details": {
"code": "CUSTOMER_ONBOARDING_REQUIRED",
"customerId": "18d2f159-e0cd-4a45-b735-e9dfe0f7520a",
"provider": {
"id": "1128dd40-2c94-4c16-a6bf-fbbc6afee52c",
"slug": "noah",
"name": "Noah"
},
"onboarding": {
"caseId": null,
"status": null,
"providerStatus": null,
"action": {
"type": "create_case",
"method": "POST",
"path": "/v1/customers/18d2f159-e0cd-4a45-b735-e9dfe0f7520a/onboarding-requests",
"body": {
"provider": "noah",
"type": "offramp"
}
}
}
}
}{
"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>"
}Start a withdrawal session by selecting the asset, fiat currency, amount, and amount side. Keep the returned
sessionId and use it for the remaining steps.
Include customerId here to withdraw on behalf of a customer. Omit it to withdraw on behalf of the business. The customer is saved in the session; changing customers requires a new rates request.
Next, use the session to discover payment methods and get the requirements for the selected method. Reuse the same authentication profile, business, and wallet throughout the session.
Amount limits
When returned,data.limits describes the route before selecting a payment method. It contains only minAmount, maxAmount, currency, and amountSide. Decimal boundaries are inclusive; a null boundary means no configured restriction.
For source, compare the total entered crypto budget, including fees. For target, compare the entered fiat payout; required crypto funding includes fees on top. Limits match the request amount side and currency. Do not convert source minimums into fiat minimums. Individual payment methods can have higher minimums than the route.
data.amount is the indicative fiat output for a source request, or source conversion principal for a target request. data.debitAmount is estimated source funding. The final quote is authoritative.
