Liquidity Pool

In a nutshell
Blockradar’s Liquidity Pool allows approved Liquidity Providers (LPs) to define and manage exchange rates for asset pairs. Rates power the internal swap engine — when a user initiates a swap, the system automatically selects the best available rate from active LPs, validates liquidity, and executes the transaction.

Prerequisites

Before using the Liquidity Pool API, ensure you have:

Become a Liquidity Provider

The Liquidity Pool is available to approved Liquidity Providers only. To get started, fill out the LP application form and the Blockradar team will review your application and onboard you.

API Key

Once onboarded, generate an API key from the Blockradar Dashboard. Navigate to Developers to create one.

Fund Your Wallets

Ensure your treasury wallets have sufficient balance of the assets you plan to provide liquidity for, plus native tokens to cover network fees.

How It Works

As a Liquidity Provider, you define exchange rates for asset pairs (e.g., BNB → USDC). When a user on the Blockradar platform initiates a swap, the system:

Finds matching rates from all active LPs for the requested asset pair.
Ranks candidates by best rate, LP priority, and creation time.
Validates liquidity by checking the selected LP’s treasury wallet has enough balance to fulfill the swap.
Executes the swap using the selected LP’s rate and treasury.

Rate Management

Create, update, deactivate, and reactivate exchange rates for any supported asset pair.

Amount Bands

Define minimum and maximum transaction amounts per rate to control exposure and segment pricing tiers.

Version History

Every rate change creates a new version. Full history is preserved for auditing and analytics.

Automatic Selection

The system automatically selects the best LP for each swap based on rate, priority, and available liquidity.

Rate Lifecycle

Rates follow a clear lifecycle with full version tracking:

1. Create a Rate

Define a new exchange rate for an asset pair. The rate starts as active at version 1.

curl --request POST \
  --url https://api.blockradar.co/v1/rates \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
    "fromAsset": "BNB",
    "toAsset": "USDC",
    "rate": "605.50",
    "minAmount": "0.01",
    "maxAmount": "100"
  }'

const response = await fetch('https://api.blockradar.co/v1/rates', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': apiKey
  },
  body: JSON.stringify({
    fromAsset: 'BNB',
    toAsset: 'USDC',
    rate: '605.50',
    minAmount: '0.01',
    maxAmount: '100'
  })
}).then(r => r.json());

console.log('Rate created:', response.data);

Request Parameters

Parameter	Type	Required	Description
`fromAsset`	string	Yes	The symbol of the asset to convert from (e.g., `BNB`)
`toAsset`	string	Yes	The symbol of the asset to convert to (e.g., `USDC`)
`rate`	string	Yes	The exchange rate. Provided as a string to avoid floating point precision issues
`minAmount`	string	Yes	Minimum transaction amount for this rate (inclusive)
`maxAmount`	string	No	Maximum transaction amount (exclusive). Omit for unlimited

Create Response

{
  "message": "Rate created successfully",
  "statusCode": 201,
  "data": {
    "id": "d69078ef-2467-40f4-bb00-63394efe32c0",
    "fromAsset": "BNB",
    "toAsset": "USDC",
    "rate": "605.50",
    "minAmount": "0.01",
    "maxAmount": "100",
    "isActive": true,
    "status": "active",
    "version": 1,
    "network": "testnet",
    "createdAt": "2026-02-19T07:50:17.042Z"
  }
}

2. Update a Rate

Modify the rate or amount constraints for an existing active rate. This creates a new version — the previous version is automatically marked as superseded.

curl --request PATCH \
  --url https://api.blockradar.co/v1/rates/{id} \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
    "rate": "610.00",
    "minAmount": "0.005"
  }'

const response = await fetch(`https://api.blockradar.co/v1/rates/${rateId}`, {
  method: 'PATCH',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': apiKey
  },
  body: JSON.stringify({
    rate: '610.00',
    minAmount: '0.005'
  })
}).then(r => r.json());

console.log('Rate updated:', response.data);

Only provide the fields you want to change — partial updates are supported.

3. Deactivate a Rate

Temporarily take a rate offline. The rate becomes deactivated and will no longer be selected for swaps.

curl --request PATCH \
  --url https://api.blockradar.co/v1/rates/{id}/deactivate \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
    "reason": "Pausing for maintenance"
  }'

const response = await fetch(
  `https://api.blockradar.co/v1/rates/${rateId}/deactivate`,
  {
    method: 'PATCH',
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': apiKey
    },
    body: JSON.stringify({
      reason: 'Pausing for maintenance'
    })
  }
).then(r => r.json());

console.log('Rate deactivated:', response.data);

4. Reactivate a Rate

Bring a deactivated rate back online. This creates a new version with active status.

curl --request PATCH \
  --url https://api.blockradar.co/v1/rates/{id}/reactivate \
  --header 'x-api-key: <api-key>'

const response = await fetch(
  `https://api.blockradar.co/v1/rates/${rateId}/reactivate`,
  {
    method: 'PATCH',
    headers: { 'x-api-key': apiKey }
  }
).then(r => r.json());

console.log('Rate reactivated:', response.data);

Pricing Tools

Before quoting a new tier or repricing an existing one, use the pricing tools to inspect your own coverage and benchmark against other Liquidity Providers in the same business segment.

Check Active Rates for a Pair

GET /rates/check-pair returns every active rate you have configured for an asset pair on the current environment, including the amount band of each. Use it to confirm whether you are already quoting a pair before opening a new tier.

curl --request GET \
  --url 'https://api.blockradar.co/v1/rates/check-pair?fromAsset=USDT&toAsset=cNGN' \
  --header 'x-api-key: <api-key>'

const response = await fetch(
  'https://api.blockradar.co/v1/rates/check-pair?fromAsset=USDT&toAsset=cNGN',
  { headers: { 'x-api-key': apiKey } }
).then(r => r.json());

console.log('Active rates:', response.data.rates);

Response

{
  "message": "Pair check completed",
  "statusCode": 200,
  "data": {
    "fromAsset": "USDT",
    "toAsset": "cNGN",
    "hasActiveRates": true,
    "activeRateCount": 2,
    "rates": [
      {
        "id": "d69078ef-2467-40f4-bb00-63394efe32c0",
        "rate": "1545.00",
        "minAmount": "10",
        "maxAmount": "1000",
        "version": 1,
        "createdAt": "2026-04-12T09:14:22.501Z"
      },
      {
        "id": "5b6683f0-6e92-4eaf-ae8d-5f2ddd76b376",
        "rate": "1547.50",
        "minAmount": "1000",
        "maxAmount": null,
        "version": 3,
        "createdAt": "2026-04-12T09:18:41.022Z"
      }
    ]
  }
}

Benchmark Against Other LPs

GET /rates/market-benchmark returns the best competing rate for an asset pair across other Liquidity Providers in your business segment. Your own rates are excluded so you can see what you are pricing against. Results are cached for 60 seconds per pair. Pass amount to restrict the benchmark to rates whose band covers that transaction size, or pass pairs (comma-separated from:to entries, max 20) to get an array of benchmarks in a single call.

curl --request GET \
  --url 'https://api.blockradar.co/v1/rates/market-benchmark?fromAsset=USDT&toAsset=cNGN' \
  --header 'x-api-key: <api-key>'

curl --request GET \
  --url 'https://api.blockradar.co/v1/rates/market-benchmark?pairs=USDT:cNGN,cNGN:USDT' \
  --header 'x-api-key: <api-key>'

const single = await fetch(
  'https://api.blockradar.co/v1/rates/market-benchmark?fromAsset=USDT&toAsset=cNGN',
  { headers: { 'x-api-key': apiKey } }
).then(r => r.json());

const batch = await fetch(
  'https://api.blockradar.co/v1/rates/market-benchmark?pairs=USDT:cNGN,cNGN:USDT',
  { headers: { 'x-api-key': apiKey } }
).then(r => r.json());

Single pair response

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

Batch response

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

bestRate is null when no other LP has an active rate for the pair (or for the supplied amount band).

Inspect Treasury Balances

GET /rates/treasury-balances returns aggregated treasury balances for every asset that appears in your active rates, broken down by blockchain. Use it to monitor liquidity coverage across the pairs you are quoting. The response excludes assets with a zero on-chain balance and de-duplicates entries when the same asset/wallet pair is referenced by multiple rates.

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

const response = await fetch(
  'https://api.blockradar.co/v1/rates/treasury-balances',
  { headers: { 'x-api-key': apiKey } }
).then(r => r.json());

console.log('Treasury balances:', response.data);

Response

{
  "message": "Treasury balances retrieved successfully",
  "statusCode": 200,
  "data": [
    {
      "asset": "USDT",
      "totalBalance": "5000.00",
      "totalConvertedBalance": "5000.00",
      "chains": [
        {
          "blockchain": "ethereum",
          "balance": "3000.00",
          "convertedBalance": "3000.00",
          "walletAddress": "0xA1b2C3d4E5f6789012345678901234567890aBcD"
        },
        {
          "blockchain": "polygon",
          "balance": "2000.00",
          "convertedBalance": "2000.00",
          "walletAddress": "0xA1b2C3d4E5f6789012345678901234567890aBcD"
        }
      ]
    }
  ]
}

Rate Versioning

Every time a rate is updated or reactivated, a new version is created. The previous version is marked as superseded. This provides a complete audit trail.

Field	Description
`version`	Sequential version number starting at 1
`rootRateId`	Points to the original rate — all versions in a chain share this ID
`previousRateId`	Points to the immediately preceding version

Version Chain Example

v1 (active)  →  v2 (active, v1 superseded)  →  v3 (deactivated)  →  v4 (active, v3 superseded)

View Rate History

Retrieve the full version history for a rate:

curl --request GET \
  --url https://api.blockradar.co/v1/rates/{id}/history \
  --header 'x-api-key: <api-key>'

const response = await fetch(
  `https://api.blockradar.co/v1/rates/${rateId}/history`,
  {
    headers: { 'x-api-key': apiKey }
  }
).then(r => r.json());

console.log('History:', response.data);
console.log('Page:', response.meta.currentPage);

History Response

{
  "message": "Rate history retrieved successfully",
  "statusCode": 200,
  "data": [
    {
      "id": "d69078ef-2467-40f4-bb00-63394efe32c0",
      "fromAsset": "BNB",
      "toAsset": "USDC",
      "network": "testnet",
      "rate": "605.50",
      "minAmount": "0.01",
      "maxAmount": null,
      "isActive": false,
      "status": "deactivated",
      "version": 1,
      "previousRateId": null,
      "rootRateId": null,
      "createdBy": "86964e42-79dc-4267-a2ca-3612c4b095a8",
      "deactivatedBy": "86964e42-79dc-4267-a2ca-3612c4b095a8",
      "deactivatedAt": "2026-02-25T18:13:48.113Z",
      "deactivationReason": "re",
      "createdAt": "2026-02-19T07:50:17.042Z",
      "updatedAt": "2026-02-25T18:13:48.101Z"
    }
  ],
  "meta": {
    "totalItems": 1,
    "itemCount": 1,
    "itemsPerPage": 10,
    "totalPages": 1,
    "currentPage": 1
  }
}

Rate Statuses

Status	Description
`active`	Currently live and eligible for swap selection
`superseded`	Replaced by a newer version (via update or reactivate)
`deactivated`	Manually taken offline — can be reactivated

superseded is a terminal state — these records are historical and cannot be modified.

Amount Bands

Each rate covers a transaction amount range defined by minAmount and maxAmount:

minAmount — The inclusive lower bound. Transactions below this amount will not use this rate.
maxAmount — The exclusive upper bound. Set to null (omit) for unlimited.

Multiple Rates for the Same Pair

You can create multiple rates for the same asset pair with different amount bands to offer tiered pricing:

Rate	Band	Use Case
605.00	0.01 – 10 BNB	Small transactions
606.50	10 – 100 BNB	Medium transactions
608.00	100+ BNB	Large transactions

Amount bands for the same asset pair must not overlap. The system will reject a rate if its band overlaps with another active rate for the same pair.

Liquidity Validation

Before executing a swap using your rate, the system validates that your treasury wallet has:

Sufficient token balance of the destination asset to cover the swap output (amount x rate).
Sufficient native token balance (ETH, BNB, etc.) to cover network fees for the transfer.

If your wallet balance is insufficient, the system skips your rate and moves to the next available LP. You will receive an alert via email when your liquidity is low.

Keep your treasury wallets well-funded to avoid missed swap opportunities. The system will notify you when balances drop below thresholds.

Best Practices

Rate Management

Monitor market conditions and update rates regularly to stay competitive
Use amount bands to offer tiered pricing for different transaction sizes
Deactivate rates during maintenance or high volatility instead of deleting them
Review version history to track rate changes over time

Liquidity

Maintain sufficient balance in your treasury wallets for both the destination asset and native tokens
Set up monitoring for low balance alerts
Fund wallets proactively to avoid gaps in service

API Reference

Endpoint	Description
Create Rate	Create a new exchange rate for an asset pair
Get Rate	Retrieve a single rate by ID
Update Rate	Update an existing rate (creates a new version)
Deactivate Rate	Take a rate offline
Reactivate Rate	Bring a deactivated rate back online
Get Rate History	View full version history for a rate
Check Pair	List your active rates for a specific asset pair
Get Market Benchmark	Best competing rate for a pair (or a batch of pairs), excluding your own
Get Treasury Balances	Aggregated treasury balances grouped by asset and blockchain

Support

Email: [email protected]
Become an LP: Apply here to express your interest in becoming a Liquidity Provider

The Liquidity Pool is designed for institutional and professional liquidity providers. Apply to become an LP, then test your rate configurations on testnet before going live.

Get Started

Wallets

Receive Payments

Send Payments

Convert & Manage

Compliance & Recovery

Integrations

Prerequisites

How It Works

Rate Management

Amount Bands

Version History

Automatic Selection

Rate Lifecycle

1. Create a Rate

Request Parameters

Create Response

2. Update a Rate

3. Deactivate a Rate

4. Reactivate a Rate

Pricing Tools

Check Active Rates for a Pair

Benchmark Against Other LPs

Inspect Treasury Balances

Rate Versioning

Version Chain Example

View Rate History

History Response

Rate Statuses

Amount Bands

Multiple Rates for the Same Pair

Liquidity Validation

Best Practices

Rate Management

Liquidity

API Reference

Support

​Prerequisites

​How It Works

Rate Management

Amount Bands

Version History

Automatic Selection

​Rate Lifecycle

​1. Create a Rate

​Request Parameters

​Create Response

​2. Update a Rate

​3. Deactivate a Rate

​4. Reactivate a Rate

​Pricing Tools

​Check Active Rates for a Pair

​Benchmark Against Other LPs

​Inspect Treasury Balances

​Rate Versioning

​Version Chain Example

​View Rate History

​History Response

​Rate Statuses

​Amount Bands

​Multiple Rates for the Same Pair

​Liquidity Validation

​Best Practices

​Rate Management

​Liquidity

​API Reference

​Support

Prerequisites

How It Works

Rate Lifecycle

1. Create a Rate

Request Parameters

Create Response

2. Update a Rate

3. Deactivate a Rate

4. Reactivate a Rate

Pricing Tools

Check Active Rates for a Pair

Benchmark Against Other LPs

Inspect Treasury Balances

Rate Versioning

Version Chain Example

View Rate History

History Response

Rate Statuses

Amount Bands

Multiple Rates for the Same Pair

Liquidity Validation

Best Practices

Rate Management

Liquidity

API Reference

Support