跳转到主要内容
自动结算

​
简介

自动结算允许您根据配置的规则，将入金自动转换为任何区块链网络上的任何目标资产。这消除了手动交换或桥接资产的需要，确保您的资金可以自动转换为您在多条链上首选的资产。

规则管理

创建和管理自动结算规则以自动化资产转换。

资产转换

根据您的规则自动将任何稳定币转换为任何其他资产。

跨链

无缝地将资产结算到任何区块链网络。

风险管理

应用滑点容忍度和规则以防止不良执行。

​
自动结算工作原理

​
1. 规则创建

定义结算规则，指定何时以及如何自动转换充值。

​
2. 充值检测

当资金到达您的地址时，Blockradar 会自动检测符合规则的充值。

​
3. 资产转换

充值会自动交换为您选择链上的目标资产（通常是 USDC）。

​
4. 余额统一

所有转换的资产都会合并到您目标链上的单一统一余额中。

​
自动结算规则

​
规则组件

每条自动结算规则定义以下参数：
组件描述示例
规则名称结算规则的描述性名称”从 USDC 交换到 Optimism USDC”
顺序执行优先级偏好FASTEST、CHEAPEST、RECOMMENDED、NO_SLIPPAGE
滑点容忍度最大可接受的价格偏差 (%)5
源资产要自动结算的资产数组[“USDC”, “USDT”]
源最小/最大金额控制触发结算的充值金额最小: 1，最大:1，最大: 1,000
目标区块链目标区块链网络optimism、base、ethereum
目标资产转换的目标资产USDC、USDT、cNGN、DAI
目标地址接收转换资产的特定地址0x2455eC6700092991Ce0782365A89d5Cd89c8Fa22
是否 Gateway为规则启用 Gateway 功能false

​
规则配置选项

​
金额阈值

  • 最小金额：仅结算高于此阈值的充值
  • 最大金额：限制单次结算的金额上限
  • 批量处理：将多笔小额充值分组以提高效率

​
滑点保护

  • 保守：0.1% - 0.5%（最小价格影响）
  • 适中：0.5% - 1.0%（平衡方法）
  • 激进：1.0% - 2.0%（更快执行）

​
执行偏好

  • 最快：优先考虑速度而非成本
  • 最便宜：优化最低费用
  • 推荐：平衡速度、成本和可靠性
  • 无滑点：仅在无价格偏差时执行

​
规则层级和优先级

​
规则应用顺序

  1. 子地址规则：如果存在则首先应用
  2. 主钱包规则：如果没有子地址规则则作为后备应用
  3. 默认行为：如果未配置规则则不进行自动结算

​
覆盖行为

  • 子地址覆盖：地址特定规则完全覆盖主钱包规则
  • 无继承：当子地址有自己的规则时，不会继承主钱包规则
  • 独立配置：每个级别可以有完全不同的结算策略

​
各级别使用场景

​
主钱包规则

  • 一致策略：所有地址相同的结算行为
  • 简化管理：单一位置配置默认行为
  • 批量操作：一次性将规则应用于多个地址
  • 标准化：确保合规性和一致性

​
子地址规则

  • 测试：在特定地址上尝试不同的结算策略
  • 自定义要求：地址特定的结算需求
  • 覆盖默认：为特定用例修改行为
  • 精细控制：为特定地址微调结算

​
创建自动结算规则

​
通过控制面板

  1. 导航到钱包的自动结算部分
  2. 点击”创建新规则”
  3. 配置规则参数
  4. 设置金额阈值和滑点容忍度
  5. 选择源资产和目标资产/链
  6. 保存并激活规则

​
通过 API

使用自动结算规则 API 以编程方式创建结算规则： 
curl --request POST \
  --url https://api.blockradar.co/v1/wallets/{walletId}/auto-settlements/rules \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
    "name": "Swap from USDC to Optimism USDC",
    "order": "FASTEST",
    "slippageTolerance": "5",
    "source": {
        "assets": [
            "USDC",
            "USDT"
        ],
        "minAmount": "1",
        "maxAmount": "1000"
    },
    "destination": {
        "blockchain": "optimism",
        "asset": "USDC",
        "address": "0x2455eC6700092991Ce0782365A89d5Cd89c8Fa22"
    }
}'

​
使用场景

​
资金管理

  • 灵活资产转换：转换为任何首选资产（USDC、ETH、USDT 等）
  • 跨链操作：在多个网络上维护余额
  • 自动整合：无需手动干预
  • 多资产策略：支持各种资产偏好和策略

​
业务运营

  • 支付处理：自动将入金结算为首选资产
  • 收入管理：将各种稳定币转换为您选择的目标资产
  • 风险缓解：自动应用滑点保护
  • 资产多元化：自动维护目标资产配置

​
DeFi 集成

  • 收益农场：自动将奖励结算为首选资产
  • 流动性管理：整合 LP 奖励和费用
  • 投资组合再平衡：维护目标资产配置

​
最佳实践

​
规则配置

  • 保守开始：从低滑点容忍度开始
  • 监控性能：跟踪结算成功率
  • 逐步调整：根据市场状况微调规则
  • 测试网测试：主网部署前在测试网验证规则

​
风险管理

  • 滑点限制：设置适当的容忍度水平
  • 金额上限：限制最大结算金额
  • 网络选择：选择可靠的目标链
  • 后备规则：创建备用结算选项

​
运营效率

  • 批量处理：将小额充值分组以提高效率
  • 时机优化：考虑网络拥堵模式
  • 成本分析：平衡速度与成本偏好
  • 监控：设置结算失败警报

​
监控和警报

​
控制面板监控

  • 规则状态：活跃/非活跃规则指示器
  • 结算历史：跟踪成功和失败的结算
  • 性能指标：成功率和执行时间
  • 资产余额：监控统一余额增长

​
Webhook 通知

自动结算在执行时触发 Webhook 事件：
事件描述
swap.success自动结算交换成功执行
swap.failed自动结算交换执行失败

​
Webhook 载荷示例

{
  "event": "swap.success",
  "data": {
    "id": "99a2b490-0798-460b-9265-4d99f182fe52",
    "reference": "ZMxcorDGtf",
    "senderAddress": "0xAA2d5fd5e7bE97E214f8565DCf3a4862719960b5",
    "recipientAddress": "0xb55c054D8eE75224E1033e6eC775B4F62D942b43",
    "amount": "5",
    "status": "SUCCESS",
    "type": "SWAP",
    "network": "mainnet",
    "toAmount": "4.965398",
    "rate": "0.9930796000000001",
    "asset": {
      "name": "USD Coin",
      "symbol": "USDC",
      "network": "mainnet"
    },
    "toAsset": {
      "name": "Tether USD",
      "symbol": "USDT",
      "network": "mainnet"
    },
    "toBlockchain": {
      "name": "optimism",
      "slug": "optimism"
    },
    "toWallet": {
      "name": "Optimism Mainnet Wallet",
      "address": "0xb55c054D8eE75224E1033e6eC775B4F62D942b43"
    },
    "metadata": {
      "swapAutoSettlement": {
        "rule": {
          "id": "rule-id-123",
          "name": "USDT to USDC on Base",
          "order": "RECOMMENDED",
          "slippageTolerance": 5,
          "source": {
            "assets": ["USDC", "USDT"],
            "minAmount": "1",
            "maxAmount": "1000"
          },
          "destination": {
            "blockchain": "optimism",
            "asset": "USDC",
            "address": "0x2455eC6700092991Ce0782365A89d5Cd89c8Fa22"
          }
        },
        "settleAmount": "5"
      },
      "transactionId": "transaction-id"
    }
  }
}

​
区分自动结算与常规交换

Webhook 载荷包含帮助识别自动结算交易的元数据：
字段描述
metadata.swapAutoSettlement.rule触发此交换的完整自动结算规则载荷
metadata.swapAutoSettlement.settleAmount根据规则结算的金额
metadata.transactionId用于跟踪的内部交易 ID
当 metadata.swapAutoSettlement 存在时，表示交换是由自动结算规则触发的。rule 字段包含完整的规则配置，而不仅仅是 ID。

​
关键 Webhook 数据字段

字段描述
toAmount交换后收到的最终金额（扣除费用和滑点后）
rate交换使用的汇率
toAsset目标资产详情（此示例中为 USDT）
toBlockchain目标区块链网络（此示例中为 Optimism）
toWallet接收转换资产的目标钱包
assetSwept转换后原始资产是否被归集

​
API 参考

​
端点

​
主钱包自动结算

端点方法描述API 参考
/v1/wallets/{walletId}/auto-settlements/rulesGET列出主钱包的所有结算规则获取所有规则
/v1/wallets/{walletId}/auto-settlements/rulesPOST为主钱包创建新结算规则创建规则
/v1/wallets/{walletId}/auto-settlements/rules/{id}GET获取特定主钱包规则详情获取规则
/v1/wallets/{walletId}/auto-settlements/rules/{id}PATCH更新现有主钱包规则更新规则
/v1/wallets/{walletId}/auto-settlements/rules/{id}DELETE删除主钱包结算规则删除规则
/v1/wallets/{walletId}/auto-settlementsGET获取主钱包结算历史获取结算
/v1/wallets/{walletId}/auto-settlementsPATCH更新主钱包结算设置更新结算

​
子地址自动结算

端点方法描述API 参考
/v1/wallets/{walletId}/addresses/{addressId}/auto-settlements/rulesGET列出特定地址的所有结算规则获取所有规则
/v1/wallets/{walletId}/addresses/{addressId}/auto-settlements/rulesPOST为特定地址创建新结算规则创建规则
/v1/wallets/{walletId}/addresses/{addressId}/auto-settlements/rules/{id}GET获取特定地址规则详情获取规则
/v1/wallets/{walletId}/addresses/{addressId}/auto-settlements/rules/{id}PATCH更新现有地址规则更新规则
/v1/wallets/{walletId}/addresses/{addressId}/auto-settlements/rules/{id}DELETE删除地址结算规则删除规则
/v1/wallets/{walletId}/addresses/{addressId}/auto-settlementsGET获取地址结算历史获取结算
/v1/wallets/{walletId}/addresses/{addressId}/auto-settlementsPATCH更新地址结算设置更新结算

​
规则参数

参数类型必需描述
namestring是用于识别的规则名称
orderstring是执行优先级（FASTEST/CHEAPEST/RECOMMENDED/NO_SLIPPAGE）
slippageTolerancenumber是最大可接受滑点 (%)
isGatewayboolean否为规则启用 Gateway 功能
source.assetsarray是要自动结算的源资产数组
source.minAmountstring否触发结算的最小金额
source.maxAmountstring否每次结算的最大金额
destination.blockchainstring是目标区块链网络
destination.assetstring是转换的目标资产
destination.addressstring是接收转换资产的目标地址

​
入门指南

​
1. 启用自动结算

  • 导航到钱包设置
  • 启用自动结算功能
  • 配置默认偏好

​
2. 创建第一条规则

  • 从简单的 USDT 到 ETH 规则开始（或您首选的任何资产）
  • 设置保守的滑点容忍度
  • 选择您首选的目标链和资产

​
3. 测试和监控

  • 首先在测试网部署
  • 监控结算成功率
  • 根据需要调整参数

​
4. 逐步扩展

  • 为其他资产添加规则
  • 实施批量处理
  • 针对您的用例优化

​
支持和资源

​
获取帮助

自动结算是自动化资金管理的强大方式。从简单的规则开始，随着您对系统越来越熟悉，逐渐增加复杂性。