流动性池 - Blockradar

概述
Blockradar 的流动性池允许经过审批的流动性提供者（LP）定义和管理资产交易对的汇率。汇率驱动内部兑换引擎——当用户发起兑换时，系统会自动从活跃的 LP 中选择最优汇率，验证流动性，并执行交易。

前提条件

在使用流动性池 API 之前，请确保您已完成以下准备：

成为流动性提供者

流动性池仅对经过审批的流动性提供者开放。如需开始使用，请填写 LP 申请表，Blockradar 团队将审核您的申请并为您完成入驻流程。

API 密钥

入驻完成后，从 Blockradar 控制面板生成 API 密钥。导航至 Developers 创建密钥。

为钱包充值

确保您的资金钱包中有足够的资产余额用于提供流动性，以及足够的原生代币来支付网络手续费。

工作原理

作为流动性提供者，您可以为资产交易对定义汇率（例如 BNB → USDC）。当 Blockradar 平台上的用户发起兑换时，系统会：

查找匹配汇率：从所有活跃 LP 中查找与请求的资产交易对匹配的汇率。
排序候选方案：按最优汇率、LP 优先级和创建时间进行排序。
验证流动性：检查所选 LP 的资金钱包是否有足够余额来完成兑换。
执行兑换：使用所选 LP 的汇率和资金钱包完成交易。

汇率管理

为任何支持的资产交易对创建、更新、停用和重新激活汇率。

金额区间

为每个汇率定义最小和最大交易金额，以控制风险敞口并实现分层定价。

版本历史

每次汇率变更都会创建新版本。完整历史记录可用于审计和分析。

自动选择

系统会根据汇率、优先级和可用流动性，自动为每笔兑换选择最优 LP。

汇率生命周期

汇率遵循清晰的生命周期，并提供完整的版本追踪：

1. 创建汇率

为资产交易对定义新的汇率。汇率创建后默认为 active（活跃）状态，版本号为 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"
  }'

请求参数

参数	类型	必填	描述
`fromAsset`	string	是	要兑换的源资产符号（例如 `BNB`）
`toAsset`	string	是	要兑换为的目标资产符号（例如 `USDC`）
`rate`	string	是	汇率。以字符串形式提供，以避免浮点精度问题
`minAmount`	string	是	此汇率的最小交易金额（包含）
`maxAmount`	string	否	最大交易金额（不包含）。省略则表示不限

创建响应

{
  "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. 更新汇率

修改现有活跃汇率的汇率值或金额限制。此操作会创建一个新版本——旧版本将自动标记为 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"
  }'

只需提供您要更改的字段——支持部分更新。

3. 停用汇率

暂时将汇率下线。汇率状态变为 deactivated（已停用），将不再被用于兑换选择。

curl --request POST \
  --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"
  }'

4. 重新激活汇率

将已停用的汇率重新上线。此操作会创建一个新版本，状态为 active。

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

汇率版本管理

每次更新或重新激活汇率时，都会创建一个新版本。旧版本将被标记为 superseded（已替代）。这提供了完整的审计追踪。

字段	描述
`version`	从 1 开始的递增版本号
`rootRateId`	指向原始汇率——同一链中的所有版本共享此 ID
`previousRateId`	指向前一个版本

版本链示例

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

查看汇率历史

检索汇率的完整版本历史：

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

历史响应

{
  "message": "Rate history retrieved successfully",
  "statusCode": 200,
  "data": {
    "currentVersion": 2,
    "rootRateId": "d69078ef-2467-40f4-bb00-63394efe32c0",
    "history": [
      {
        "id": "d69078ef-2467-40f4-bb00-63394efe32c0",
        "fromAsset": "BNB",
        "toAsset": "USDC",
        "rate": "605.50",
        "minAmount": "0.01",
        "status": "superseded",
        "version": 1,
        "createdAt": "2026-02-19T07:50:17.042Z"
      },
      {
        "id": "cad01df3-4041-4e81-a368-534fb4de5d12",
        "fromAsset": "BNB",
        "toAsset": "USDC",
        "rate": "610.00",
        "minAmount": "0.005",
        "status": "active",
        "version": 2,
        "createdAt": "2026-02-19T07:59:35.481Z"
      }
    ]
  },
  "meta": {
    "currentPage": 1,
    "itemCount": 2,
    "itemsPerPage": 10,
    "totalItems": 2,
    "totalPages": 1
  }
}

汇率状态

状态	描述
`active`	当前处于活跃状态，可被兑换选择
`superseded`	已被更新版本替代（通过更新或重新激活）
`deactivated`	已手动下线——可以重新激活

superseded 是终态——这些记录属于历史数据，无法修改。

金额区间

每个汇率覆盖由 minAmount 和 maxAmount 定义的交易金额范围：

minAmount——包含的下限。低于此金额的交易将不会使用此汇率。
maxAmount——不包含的上限。设置为 null（省略）表示不限。

同一交易对的多个汇率

您可以为同一资产交易对创建具有不同金额区间的多个汇率，以实现分层定价：

汇率	区间	适用场景
605.00	0.01 – 10 BNB	小额交易
606.50	10 – 100 BNB	中等交易
608.00	100+ BNB	大额交易

同一资产交易对的金额区间不得重叠。如果新汇率的区间与同一交易对的其他活跃汇率区间重叠，系统将拒绝创建。

流动性验证

在使用您的汇率执行兑换之前，系统会验证您的资金钱包是否具有：

足够的代币余额：目标资产余额足以覆盖兑换输出金额（amount x rate）。
足够的原生代币余额：（ETH、BNB 等）足以支付转账的网络手续费。

如果您的钱包余额不足，系统将跳过您的汇率并选择下一个可用的 LP。当您的流动性不足时，您将收到邮件通知。

请保持资金钱包有充足的余额，以避免错失兑换机会。当余额低于阈值时，系统会通知您。

最佳实践

汇率管理

关注市场动态，定期更新汇率以保持竞争力
使用金额区间，为不同交易规模提供分层定价
在维护或高波动期间停用汇率，而不是删除汇率
查看版本历史，追踪汇率随时间的变化

流动性管理

保持充足余额：确保资金钱包中有足够的目标资产和原生代币
设置监控：配置低余额告警
主动充值：提前为钱包充值，避免服务中断

API 参考

接口	描述
创建汇率	为资产交易对创建新的汇率
获取汇率	通过 ID 检索单个汇率
更新汇率	更新现有汇率（创建新版本）
停用汇率	将汇率下线
重新激活汇率	将已停用的汇率重新上线
获取汇率历史	查看汇率的完整版本历史

支持

邮箱：[email protected]
成为 LP：点此申请表达您成为流动性提供者的意向

流动性池专为机构和专业流动性提供者设计。申请成为 LP，然后在测试网上测试您的汇率配置，确认无误后再上线正式环境。

开始使用

核心功能

​前提条件

​工作原理

汇率管理

金额区间

版本历史

自动选择

​汇率生命周期

​1. 创建汇率

​请求参数

​创建响应

​2. 更新汇率

​3. 停用汇率

​4. 重新激活汇率

​汇率版本管理

​版本链示例

​查看汇率历史

​历史响应

​汇率状态

​金额区间

​同一交易对的多个汇率

​流动性验证

​最佳实践

​汇率管理

​流动性管理

​API 参考

​支持

前提条件

工作原理

汇率生命周期

1. 创建汇率

请求参数

创建响应

2. 更新汇率

3. 停用汇率

4. 重新激活汇率

汇率版本管理

版本链示例

查看汇率历史

历史响应

汇率状态

金额区间

同一交易对的多个汇率

流动性验证

最佳实践

汇率管理

流动性管理

API 参考

支持