Earn

简而言之
Blockradar Earn 让您能够让闲置的稳定币产生效益，并随时间不断增长——类似于高收益储蓄账户，但属于非托管：资金从您自己的 wallet 转出，Blockradar 从不汇集或持有这些资金，您可以随时提取任意部分。

工作原理

闲置的稳定币通常只是静置在您的 wallet 中。Earn 会将您选定的金额转入收益策略，使其持续产生利息，并在您提取时返还到您的 wallet。您的原始存入金额始终完整保留——Earn 只会让它增长。

您始终掌控

资金从您自己的 wallet 转出。Blockradar 从不进行托管，也不会将您的资金与他人的混合。

自动产生收益

利息持续不断地全天候累积——无需任何管理。

随时提取

您可以随时提取部分或全部资金，没有锁定期。

三个步骤

存入

选择一种资产和一个金额。您的资金将转入该策略。存入是免费的。

赚取收益

随着利息的累积，您的余额会自行增长。实时价值会反映在您的持仓中。

提取

随时提取部分或全部资金。您将收到与您请求金额完全一致的款项——手续费从收益中扣除，绝不会动用您的本金。

您的资金在哪里产生收益

存入时，您的资金会被导向受信任的、可产生利息的渠道。可用性取决于您 wallet 所在的网络。

Aave

加密领域规模最大、最成熟、经受过实战检验的借贷协议之一。可用网络： Ethereum、Base、Arbitrum、Optimism、Polygon、BNB Smart Chain

Compound

Compound V3——开创性的、经过广泛审计的借贷协议，采用单一资产的隔离市场。可用网络： Ethereum、Base、Arbitrum

	Aave	Compound
特点	成熟的链上借贷协议	开创性借贷协议，隔离市场
收益	浮动（由市场决定）	浮动（由市场决定）
网络	Ethereum、Base、Arbitrum、Optimism、Polygon、BNB Smart Chain	Ethereum、Base、Arbitrum

每个「提供方 + 网络 + 资产」组合都是一个 earn 产品，拥有自己的实时 APY。当某个资产同时有两个提供方的产品（例如 Base 上的 USDC）时，您可以在每次存入时选择——并且可以同时持有两边的仓位。

收益功能是非托管的。Dashboard 只会显示您 wallet 可以产生收益的网络。

前置条件

API 密钥

从 Blockradar Dashboard 获取您的 API 密钥。前往 Developers 创建一个。

已创建 Master Wallet

通过 Create Wallet API 或 dashboard 创建一个 master wallet。Earn 持仓由您的 wallet 余额提供资金。

已启用 Earn 功能

请确保您的账户已启用 Earn 功能。如需开通，请联系 [email protected]。

充足的余额

为 wallet 充入您计划存入的稳定币，以及用于支付链上网络手续费的原生代币。

提取

提取时，您需要指定希望收到的金额，到账到您 wallet 的正是该金额。选择全部提取会关闭该持仓，并将剩余的一切（存入金额 + 全部累积利息）发送给您。

您可以追踪的内容

余额

您的持仓当前价值——存入金额加利息，已扣除手续费。

已赚取的利息

您已赚取的金额——今日、本周以及持仓存续期间的累计。

费率（APY）

您正在赚取的年化费率，以扣除手续费后的净费率显示。

安全性与可靠性

非托管

资金从您自己的 wallet 直接转入策略。Blockradar 从不进行托管。

成熟的协议

资金会进入领先的 DeFi 协议 Aave 和 Compound。

无锁定期

没有等待期。随时提取部分或全部资金。

后台运行着多项保障机制，以确保余额和手续费的准确性：

费率回退——如果某个费率来源短暂出现故障，系统会使用最近的已知费率，从而确保手续费和余额绝不会出错。
安全重试——被中断的交易会以幂等方式重试；资金绝不会丢失或被重复花费。
链上对账——您显示的余额会与真实的链上余额进行对账。

收益是浮动的——费率可能随时间上升或下降——并且 DeFi 带有任何链上协议都会有的常见智能合约风险。您的存入金额绝不会被收取手续费，但与任何投资一样，回报无法保证。

使用 API

该功能通过 rewards 资源对外提供。所有请求均通过 x-api-key 请求头使用您的 API 密钥进行身份验证。存入和提取通过 productId 进行路由——每个「提供方 + 网络 + 资产」组合（Base 上的 Aave USDC、Base 上的 Compound USDC 等）都是一个具有独立 id 的产品。当某个资产只有一个产品时，可以省略 productId；当有多个产品时，未携带该字段的请求会被拒绝并返回 422。旧的 type 字段（defi）仍被接受，但不再用于选择提供方。金额始终以字符串形式传入。存入和提取均为异步操作：每个操作都会返回一个 PENDING 交易，完成情况通过 webhook 推送。

大多数 endpoint 都接受一个可选的 addressId，用于将操作限定到某个 sub-address。省略它则对 master wallet 进行操作。

1. 查看可用项

在存入之前，请浏览产品目录，查看哪些链支持 earning，并列出 wallet 中哪些资产符合条件——每个条目都带有您存入时要使用的 productId。

curl --request GET \
  --url 'https://api.blockradar.co/v1/rewards/products?blockchain=base&asset=USDC' \
  --header 'x-api-key: <api-key>'

curl --request GET \
  --url https://api.blockradar.co/v1/rewards/supported-chains \
  --header 'x-api-key: <api-key>'

curl --request GET \
  --url 'https://api.blockradar.co/v1/wallets/{walletId}/rewards/assets' \
  --header 'x-api-key: <api-key>'

Product catalogue response

{
  "message": "Earn products retrieved successfully",
  "statusCode": 200,
  "data": [
    {
      "productId": "5d0cc05d-d792-4cfe-a189-4a552b2c917a",
      "productKey": "aave-base-usdc",
      "provider": "aave",
      "type": "defi",
      "name": "Aave V3 USDC",
      "blockchain": "base",
      "network": "mainnet",
      "apy": "2.41",
      "depositsEnabled": true,
      "providerPaused": { "deposits": false, "withdrawals": false },
      "isActive": true,
      "asset": { "symbol": "USDC", "decimals": 6 }
    },
    {
      "productId": "8f2f6a4d-90c1-4a52-b9be-52f10c8f6f21",
      "productKey": "compound-base-usdc",
      "provider": "compound",
      "type": "defi",
      "name": "Compound V3 USDC",
      "blockchain": "base",
      "network": "mainnet",
      "apy": "4.43",
      "depositsEnabled": true,
      "providerPaused": { "deposits": false, "withdrawals": false },
      "isActive": true,
      "asset": { "symbol": "USDC", "decimals": 6 }
    }
  ]
}

Supported chains response

{
  "message": "Supported reward chains retrieved successfully",
  "statusCode": 200,
  "data": {
    "all": ["ethereum", "base", "arbitrum", "optimism", "polygon", "bnb-smart-chain"],
    "byType": {
      "defi": ["ethereum", "base", "arbitrum", "optimism", "polygon", "bnb-smart-chain"]
    },
    "byProvider": {
      "aave": ["ethereum", "base", "arbitrum", "optimism", "polygon", "bnb-smart-chain"],
      "compound": ["ethereum", "base", "arbitrum"]
    }
  }
}

2. 预览网络手续费（可选）

在确认操作之前，估算链上网络手续费并检查 wallet 的原生代币余额。此操作不会转移资金。

curl --request POST \
  --url https://api.blockradar.co/v1/wallets/{walletId}/rewards/deposit/network-fee \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
    "assetId": "b1deda8d-7609-4895-b584-e8ef1f13e354",
    "amount": "1000",
    "productId": "8f2f6a4d-90c1-4a52-b9be-52f10c8f6f21"
  }'

Response

{
  "message": "Network fee fetched successfully",
  "statusCode": 200,
  "data": {
    "networkFee": "0.00006779052",
    "networkFeeInUSD": "0.14371725",
    "nativeBalance": "0.000929309612767174",
    "nativeBalanceInUSD": "1.97015496",
    "estimatedArrivalTime": 30,
    "transactionFee": "0"
  }
}

同样的预览也适用于提取，对应 POST /v1/wallets/{walletId}/rewards/withdraw/network-fee。

3. 存入

将一种资产转入收益策略。存入是免费的——手续费只会适用于已赚取的利息。

curl --request POST \
  --url https://api.blockradar.co/v1/wallets/{walletId}/rewards/deposit \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
    "assetId": "b1deda8d-7609-4895-b584-e8ef1f13e354",
    "amount": "1000",
    "productId": "8f2f6a4d-90c1-4a52-b9be-52f10c8f6f21",
    "reference": "order_12345",
    "metadata": {}
  }'

const response = await fetch(
  `https://api.blockradar.co/v1/wallets/${walletId}/rewards/deposit`,
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': apiKey
    },
    body: JSON.stringify({
      assetId: 'b1deda8d-7609-4895-b584-e8ef1f13e354',
      amount: '1000',
      productId: '8f2f6a4d-90c1-4a52-b9be-52f10c8f6f21',
      reference: 'order_12345'
    })
  }
).then(r => r.json());

console.log('Deposit initiated:', response.data);

请求体参数

参数	类型	是否必填	说明
`assetId`	string (UUID)	是	要存入的资产。必须支持奖励（参见步骤 1）。
`amount`	string	是	要存入的金额。必须大于 0。
`productId`	string (UUID)	否	要存入的 earn 产品（见步骤 1）。当资产有多个产品时必填——例如同一条链上的 Aave USDC 和 Compound USDC。
`type`	string	否	旧的策略类别（`defi`）。请优先使用 `productId`。
`reference`	string	否	客户端引用，会校验唯一性。
`metadata`	object	否	自定义元数据，会在交易中原样返回。
`addressId`	string (UUID)	否	限定到某个 sub-address。省略则使用 master wallet。

Response

{
  "message": "Rewards Deposit initiated successfully",
  "statusCode": 200,
  "data": {
    "id": "47ae3a92-4d36-4807-af9e-b83a4eb08d69",
    "reference": null,
    "amount": "1000",
    "amountPaid": "1000",
    "status": "PENDING",
    "type": "REWARD_DEPOSIT",
    "createdAt": "2026-06-03T13:58:33.222Z",
    "asset": {
      "symbol": "USDC",
      "decimals": 6,
      "blockchain": { "slug": "base", "name": "base" }
    }
  }
}

4. 追踪持仓与收益

持仓按产品进行聚合，包含实时余额、APY、已存入本金以及收益（今日 / 本周 / 累计）——所有数据均已扣除手续费。每个条目都带有其产品标识（productId、productKey、provider）。

curl --request GET \
  --url https://api.blockradar.co/v1/wallets/{walletId}/rewards \
  --header 'x-api-key: <api-key>'

curl --request GET \
  --url 'https://api.blockradar.co/v1/wallets/{walletId}/rewards?assetId={assetId}' \
  --header 'x-api-key: <api-key>'

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

curl --request GET \
  --url 'https://api.blockradar.co/v1/rewards/transactions?limit=10' \
  --header 'x-api-key: <api-key>'

Position response

{
  "message": "Wallet rewards retrieved successfully",
  "statusCode": 200,
  "data": [
    {
      "type": "defi",
      "productId": "5d0cc05d-d792-4cfe-a189-4a552b2c917a",
      "productKey": "aave-base-usdc",
      "provider": "aave",
      "apy": "2.41",
      "balance": "4.365017",
      "balanceInUSD": "4.365017",
      "totalDeposited": "4.360000",
      "totalDepositedInUSD": "4.360000",
      "earnings": "0.005017",
      "earningsInUSD": "0.005017",
      "todayEarnings": "0.000187",
      "weeklyEarnings": "0.001312",
      "lifetimeEarnings": "0.026492",
      "lifetimeEarningsInUSD": "0.026492",
      "asset": {
        "id": "2f6298ec-81ca-44f4-a8f2-cc045a46d28c",
        "isActive": true,
        "asset": {
          "id": "b1deda8d-7609-4895-b584-e8ef1f13e354",
          "name": "USD Coin",
          "symbol": "USDC",
          "decimals": 6,
          "currency": "USD",
          "network": "mainnet",
          "blockchain": { "name": "base", "slug": "base", "symbol": "eth" }
        }
      }
    }
  ]
}

持仓字段

字段	说明
`type`	该持仓所属的策略类别（`defi`）。
`productId`	该持仓所在的 earn 产品——提取时请传回该字段。
`productKey`	稳定且可读的产品键，例如 `compound-base-usdc`。
`provider`	底层协议（`aave` 或 `compound`）。
`apy`	当前的净年化收益率（扣除手续费后）。
`balance`	持仓的实时价值（本金 + 累积利息），已扣除手续费。
`totalDeposited`	已存入该持仓的本金。
`earnings`	该持仓迄今累积的利息。
`todayEarnings`	今日累积的利息。
`weeklyEarnings`	本周累积的利息。
`lifetimeEarnings`	持仓存续期间累积的利息（包括已提取的部分）。
`*InUSD`	对应字段换算为美元的价值。
`asset`	该持仓所持有的 wallet 资产，以及其区块链和网络。

/v1/rewards 返回的结构相同，但聚合了您业务中的所有 wallet，而 /v1/wallets/{walletId}/rewards 仅限定于单个 wallet。向 wallet endpoint 传入 assetId，即可返回单个持仓对象而非数组——如果该 wallet 同时在 Aave 和 Compound 两个产品中持有该资产的仓位，该对象会聚合总额，并携带一个 products 数组给出按产品的明细（此时其顶层的 productId/productKey/provider 为 null）。

5. 提取

amount 是您收到的净金额——Blockradar 会对赎回进行总额折算，使手续费仅从已实现的收益中扣除。传入 "max" 可完全退出并关闭持仓。当您为某个资产持有多个仓位时，请使用 productId 指明要从哪个仓位提取。

curl --request POST \
  --url https://api.blockradar.co/v1/wallets/{walletId}/rewards/withdraw \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
    "assetId": "b1deda8d-7609-4895-b584-e8ef1f13e354",
    "amount": "500",
    "productId": "8f2f6a4d-90c1-4a52-b9be-52f10c8f6f21"
  }'

curl --request POST \
  --url https://api.blockradar.co/v1/wallets/{walletId}/rewards/withdraw \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
    "assetId": "b1deda8d-7609-4895-b584-e8ef1f13e354",
    "amount": "max",
    "productId": "8f2f6a4d-90c1-4a52-b9be-52f10c8f6f21"
  }'

const response = await fetch(
  `https://api.blockradar.co/v1/wallets/${walletId}/rewards/withdraw`,
  {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': apiKey
    },
    body: JSON.stringify({
      assetId: 'b1deda8d-7609-4895-b584-e8ef1f13e354',
      amount: '500',
      productId: '8f2f6a4d-90c1-4a52-b9be-52f10c8f6f21'
    })
  }
).then(r => r.json());

console.log('Withdrawal initiated:', response.data);

请求体参数

参数	类型	是否必填	说明
`assetId`	string (UUID)	是	要提取的资产。
`amount`	string	是	要收到的净金额，或传入 `"max"` 以完全退出。
`productId`	string (UUID)	否	要从其仓位提取的 earn 产品。当 wallet 在多个产品中持有该资产的仓位时必填。
`type`	string	否	旧的策略类别（`defi`）。传入 `productId` 时会被忽略。
`address`	string	否	外部目标地址。省略则记入签名方（master wallet 或 sub-address）。
`reference`	string	否	客户端引用。
`metadata`	object	否	自定义元数据。
`addressId`	string (UUID)	否	限定到某个 sub-address。省略则使用 master wallet。

提取永远不会被目录标志阻止——即使某个产品已下架或暂停新存入，现有持仓始终可以提取。

交易生命周期

存入和提取均为异步操作。发起调用会返回一个处于 PENDING 状态的交易——链上结算随后进行，最终结果通过 webhook 推送。

字段	取值	说明
`type`	`REWARD_DEPOSIT`、`REWARD_WITHDRAW`	Earn 交易的类型。
`status`	`PENDING` → 已结算	初始为 `PENDING`；在交易于链上确认后转变。

使用 Business Reward Transactions（GET /v1/rewards/transactions）可列出您业务中近期的存入和提取，按时间从新到旧排序。

Transaction shape

{
  "id": "47ae3a92-4d36-4807-af9e-b83a4eb08d69",
  "reference": null,
  "amount": "0.2",
  "amountPaid": "0.2",
  "status": "PENDING",
  "type": "REWARD_WITHDRAW",
  "createdAt": "2026-06-03T13:58:33.222Z",
  "asset": {
    "symbol": "USDC",
    "decimals": 6,
    "blockchain": { "slug": "base", "name": "base" }
  }
}

API 参考

Method	Endpoint	说明
`GET`	`/v1/rewards`	跨所有 wallet 聚合、按产品分组的业务级持仓
`GET`	`/v1/rewards/products`	earn 产品目录，含每个产品的 APY 和可用性
`GET`	`/v1/rewards/supported-chains`	受支持的链，以扁平并集形式呈现，并按策略类型和提供方分组
`GET`	`/v1/rewards/transactions`	最近的奖励存入和提取（从新到旧）
`GET`	`/v1/wallets/{walletId}/rewards`	某个 wallet 的持仓；传入 `assetId` 可获取单一资产
`GET`	`/v1/wallets/{walletId}/rewards/assets`	某个 wallet 中符合奖励条件的资产及各策略的 APY
`POST`	`/v1/wallets/{walletId}/rewards/deposit`	将一种资产存入 earn 策略
`POST`	`/v1/wallets/{walletId}/rewards/deposit/network-fee`	预览存入的网络手续费
`POST`	`/v1/wallets/{walletId}/rewards/withdraw`	从持仓中提取一笔净金额（或 `"max"`）
`POST`	`/v1/wallets/{walletId}/rewards/withdraw/network-fee`	预览提取的网络手续费

FAQ

Aave 和 Compound 有什么区别？

两者都是领先且经受过实战检验的链上借贷协议。各市场的利率不同且独立变动——请查看产品目录了解每个产品的实时 APY，并在每次存入时进行选择。您可以同时持有两边的仓位。

存入需要付费吗？

不需要。存入是免费的。唯一的手续费是您所赚取利息的一小部分——绝不会动用您的存入金额。

我什么时候开始赚取收益？

一旦您的存入在链上结算，它就会开始全天候持续产生收益。

提取有多快？

它会立即开始，并在不久后于链上结算。完成时您会立即收到通知。

我拿回的会比投入的少吗？

您的存入金额绝不会被收取手续费，您可保留利息减去 Blockradar 一小部分份额后的金额。费率是浮动的，且链上协议存在风险，因此回报无法保证——但平台手续费绝不会触及您的本金。

“全部提取”会做什么？

它会取出该持仓中的全部资金——您的存入金额加全部已赚取的利息——并将其关闭。您可以随时重新开始一笔新的存入。

为什么一笔新的 $0.20 存入有时会显示为 $0.199999？

这是底层协议一个微小的舍入小问题（不到一美分的零头），并非手续费。它会自行抹平，并且随着利息开始累积，您的余额会很快超过您的存入金额。

支持

电子邮件：[email protected]

开始使用

钱包

收款

付款

转换与管理

合规与工具

工作原理

您始终掌控

自动产生收益

随时提取

三个步骤

您的资金在哪里产生收益

Aave

Compound

前置条件

提取

您可以追踪的内容

余额

已赚取的利息

费率（APY）

安全性与可靠性

非托管

成熟的协议

无锁定期

使用 API

1. 查看可用项

2. 预览网络手续费（可选）

3. 存入

请求体参数

4. 追踪持仓与收益

持仓字段

5. 提取

请求体参数

交易生命周期

API 参考

FAQ

支持

​工作原理

您始终掌控

自动产生收益

随时提取

​三个步骤

​您的资金在哪里产生收益

Aave

Compound

​前置条件

​提取

​您可以追踪的内容

余额

已赚取的利息

费率（APY）

​安全性与可靠性

非托管

成熟的协议

无锁定期

​使用 API

​1. 查看可用项

​2. 预览网络手续费（可选）

​3. 存入

​请求体参数

​4. 追踪持仓与收益

​持仓字段

​5. 提取

​请求体参数

​交易生命周期

​API 参考

​FAQ

​支持

工作原理

三个步骤

您的资金在哪里产生收益

前置条件

提取

您可以追踪的内容

安全性与可靠性

使用 API

1. 查看可用项

2. 预览网络手续费（可选）

3. 存入

请求体参数

4. 追踪持仓与收益

持仓字段

5. 提取

请求体参数

交易生命周期

API 参考

FAQ

支持