Get Market Benchmark

curl --request GET \
  --url https://api.blockradar.co/v1/rates/market-benchmark \
  --header 'x-api-key: <api-key>'

import requests

url = "https://api.blockradar.co/v1/rates/market-benchmark"

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/v1/rates/market-benchmark', 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/rates/market-benchmark",
  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/v1/rates/market-benchmark"

	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/v1/rates/market-benchmark")
  .header("x-api-key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.blockradar.co/v1/rates/market-benchmark")

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

{
  "data": {
    "fromAsset": "USDT",
    "toAsset": "cNGN",
    "bestRate": "1547.50"
  },
  "message": "Market benchmark retrieved",
  "statusCode": 200
}

Liquidity Pool

Get Market Benchmark

Returns the best competing rate for one or more asset pairs across other Liquidity Providers in the same business segment, excluding your own rates.

Use this endpoint to benchmark your pricing against the rest of the market before creating or updating a rate. Pass a single fromAsset / toAsset pair, or batch up to 20 pairs via the comma-separated pairs query parameter (e.g. USDT:cNGN,cNGN:USDT).

Results are cached for 60 seconds per pair.

Endpoint

GET https://api.blockradar.co/v1/rates/market-benchmark

Query Parameters

Key	Required	Type	Description
fromAsset	conditional	string	Source asset symbol. Required when `pairs` is not provided.
toAsset	conditional	string	Destination asset symbol. Required when `pairs` is not provided.
amount	false	string	Amount to benchmark — only rates whose `minAmount`/`maxAmount` band covers this amount are considered.
pairs	false	string	Comma-separated list of `from:to` pairs for batch lookup (max 20). When provided, the response is an array.

GET

rates

market-benchmark

Get Market Benchmark

curl --request GET \
  --url https://api.blockradar.co/v1/rates/market-benchmark \
  --header 'x-api-key: <api-key>'

import requests

url = "https://api.blockradar.co/v1/rates/market-benchmark"

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/v1/rates/market-benchmark', 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/rates/market-benchmark",
  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/v1/rates/market-benchmark"

	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/v1/rates/market-benchmark")
  .header("x-api-key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.blockradar.co/v1/rates/market-benchmark")

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

{
  "data": {
    "fromAsset": "USDT",
    "toAsset": "cNGN",
    "bestRate": "1547.50"
  },
  "message": "Market benchmark retrieved",
  "statusCode": 200
}

Autorisations

x-api-key

string

header

requis

Paramètres de requête

fromAsset

string

Source asset symbol. Required when pairs is not provided.

Exemple:

"USDT"

toAsset

string

Destination asset symbol. Required when pairs is not provided.

Exemple:

"cNGN"

amount

string

Amount to benchmark — only rates whose band covers this amount are considered.

Exemple:

"500"

pairs

string

Comma-separated from:to pairs for batch lookup (max 20).

Exemple:

"USDT:cNGN,cNGN:USDT"

Réponse

200 - application/json

200

data

object

object
object[]

Show child attributes

message

string

Exemple:

"Market benchmark retrieved"

statusCode

number

Exemple:

200

Check Pair Get Treasury Balances