v1

latestOpenAPI 3.0.32026-07-26184851.6 MB

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

Query parameters

fromAssetstring

Example:USDT

Source asset symbol. Required when pairs is not provided.

toAssetstring

Example:cNGN

Destination asset symbol. Required when pairs is not provided.

amountstring

Example:500

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

pairsstring

Example:USDT:cNGN,cNGN:USDT

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

Response

200

messagestring

statusCodenumber

Example response

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