探索获取钱包 DeFi 仓位的最简单方法_加密百科

概述

钱包持有者通常将其投资组合的很大一部分锁定在 DeFi 协议中，例如赚取收益。然而，跟踪这些头寸可能具有挑战性，使投资组合跟踪器、钱包和税务平台等工具的开发变得复杂。这就是我们推出 DeFi 头寸功能的原因。

使用 Moralis 的 DeFi Positions，您只需几行代码即可查询 DeFi 协议数据。您是否好奇它的工作原理？如果是这样，请加入我们的指南，我们将向您展示。让我们开始吧！

什么是 DeFi 协议数据？

DeFi 协议数据包含有关钱包在各种 DeFi 平台（例如 Uniswap 和 Aave）上的头寸的详细信息。这些数据包括流动性头寸、收益耕作活动和 DeFi 生态系统内的其他互动。鉴于许多钱包持有者将资产锁定在 DeFi 协议中，这些数据对于构建投资组合追踪器、加密税务平台和其他 Web3 项目以及确保整体准确的财务报告至关重要。

传统上，检索 DeFi 协议数据非常复杂且耗时。但是，Moralis 的 DeFi API 简化了此过程，提供了一种访问全面 DeFi 协议数据的精简方法。

那么，Moralis 的 DeFi API 到底是什么，它是如何工作的？让我们探索它的功能和优点！

Moralis 的 DeFi API – 获取 DeFi 协议数据的最简单方法

Moralis 的DeFi API是访问 DeFi 协议数据的最简单、最强大的方式。此领先的 API 提供统一的界面，可在一个地方查询流动性对、ERC-20 配额、流动性提供者代币、DeFi 头寸等。

凭借强大的跨链支持，Moralis 的 DeFi API 使您能够跨主要区块链网络和协议检索数据，包括以太坊、Polygon、BNB 智能链 (BSC) 等。

因此，无论您正在开发借贷平台、投资组合追踪器还是类似的应用程序，Moralis 的 DeFi API 都能为您提供必要的工具。

那么，如何使用 Moralis 的 DeFi API 获取协议数据？这就是我们的 DeFi Positions 功能发挥作用的地方！

Moralis 的 DeFi 头寸介绍

DeFi API 最突出的功能之一是 DeFi 仓位，它可以全面洞察任何钱包的 DeFi 活动。但这实际上意味着什么？我们的 DeFi 仓位功能包含三个关键端点：

按钱包分类的 DeFi 协议摘要

检索与特定钱包地址关联的所有 DeFi 协议的综合摘要。以下是端点运行的示例：

从‘node-fetch’导入fetch ；
const选项 = {
方法：'GET' ，
标题：{
   接受：'application/json' ，
   'X-API 密钥' ：'YOUR_API_KEY'
 } ，
} ；
获取（'https://deep-index.moralis.io/api/v2.2/wallets/0xcB1C1FdE09f811B294172696404e88E658659905/defi/summary?chain=eth' ，选项）
.then （响应= >响应.json （））
.then （响应= >控制台.log （响应）） 
.catch ( err = > console . error ( err ) ) ; 

调用此终端节点时，您将收到钱包与之交互的 DeFi 协议的详细摘要，包括所有仓位的美元总价值、未领取的奖励、协议名称和其他相关数据。以下是响应示例：

{
  活动协议：8 ， 
  总持仓数：12 ， 
  总美元值：871.6550972487607 ， 
  总未认领美元值：26.31655680118138 ， 
  协议：[ 
    {
      协议名称：'Uniswap v3' ，
      protocol_id ：'uniswap-v3' ，
      protocol_url : ' https://app.uniswap.org ' ,
      协议徽标：'https ：//cdn.moralis.io/defi/uniswap.png' ，
      总美元值：433.6700616074799 ， 
      总未认领美元值：26.31655680118138 ， 
      职位：3 
    } ，
    //...
  ]
}

钱包 DeFi 持仓汇总

获取与钱包关联的所有 DeFi 头寸的摘要，包括每个头寸的未领取奖励。下面是调用此端点时的示例：

从‘node-fetch’导入fetch ；
const选项 = {
  方法：'GET' ，
  标题：{
    接受：'application/json' ，
    'X-API 密钥' ：'YOUR_API_KEY'
  } ，
} ；
获取（'https://deep-index.moralis.io/api/v2.2/wallets/0xcB1C1FdE09f811B294172696404e88E658659905/defi/positions?chain=eth' ，选项）
  .then （响应= >响应.json （））
  .then （响应= >控制台.log （响应）） 
  .catch ( err = > console . error ( err ) ) ; 

运行上述代码将返回钱包所有 DeFi 仓位的详细摘要。其中包括仓位标签、相关代币、每个仓位的美元价值以及其他相关详细信息。以下是示例输出：

[
  {
    “协议名称”：“Uniswap v2” ， 
    “协议ID”：“uniswap-v2” ， 
    “protocol_url”：“https://app.uniswap.org/pools/v2” ， 
    “protocol_logo”：“https://cdn.moralis.io/defi/uniswap.png” ， 
    “位置”：{ 
      “标签”：“流动性” ， 
      “代币”：[ 
        {
          “token_type”：“提供” ， 
          “名称”：“USD 硬币” ， 
          “符号”：“USDC” ， 
          “合约地址”：“0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48” ， 
          “小数”：“6” ， 
          “徽标”：“https://logo.moralis.io/0x1_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48_ac01a87aaf98ddb0f349ee4ebe97f0d8” ， 
          “缩略图”：“https://logo.moralis.io/0x1_0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48_ac01a87aaf98ddb0f349ee4ebe97f0d8” ， 
          “余额”：“9762775.56142477145245169357” ， 
          “余额格式”：“9.76277556142477145245169357” ， 
          “美元价格”：0.9999274263552301 ， 
          “美元价值”：9.76206704121921 
        } ，
        //...
      ] ，
      “地址”：“0xb4e16d0168e52d35cacd2c6185b44281ec28c9dc” ， 
      “余额_美元”：19.509109037404016 ， 
      “未认领美元总值”：5.127740503730312 ， 
      “位置详细信息”：{ 
        “reserve0”：“9.76277556142477145245169357” ， 
        “保留1”：“0.00356975548622332765688138345279600856” ， 
        “工厂”：“0x5c69bee701ef814a2b6a3edd4b1652cb9cc5aa6f” ， 
        “对”：“0xb4e16d0168e52d35cacd2c6185b44281ec28c9dc” ， 
        “池份额”：0.000021077221080781 
      }
    }
  } ，
  //...
]

按钱包和协议划分的 DeFi 持仓明细

查询特定钱包和协议的详细持仓数据。以下是示例：

从‘node-fetch’导入fetch ；
const选项 = {
方法：'GET' ，
标题：{
   接受：'application/json' ，
   'X-API 密钥' ：'YOUR_API_KEY'
 } ，
} ；
获取（'https://deep-index.moralis.io/api/v2.2/wallets/0xcB1C1FdE09f811B294172696404e88E658659905/defi/uniswap-v3/positions?chain=eth' ，选项）
.then （响应= >响应.json （））
.then （响应= >控制台.log （响应）） 
.catch ( err = > console . error ( err ) ) ; 

运行代码将返回指定钱包和协议的综合 DeFi 头寸，包括头寸标签、代币、每个头寸的美元价值、未领取的奖励等。请参阅下面的示例响应：

{
  "protocol_name": "Uniswap v3" , 
  “协议ID”：“uniswap-v3” ， 
  “协议网址”：“https://app.uniswap.org” ， 
  “protocol_logo”：“https://cdn.moralis.io/defi/uniswap.png” ， 
  “总美元值”：433.28689509249983 ， 
  “未认领美元总值”：26.291817301924766 ， 
  “职位”：[ 
    {
      “标签”：“流动性” ， 
      “代币”：[ 
        {
          “token_type”：“提供” ， 
          “名称”：“Coinbase 包装的质押 ETH” ， 
          “符号”：“cbETH” ， 
          “合约地址”：“0xbe9895146f7af43049ca1c1ae358b0541ea49704” ， 
          “小数”：“18” ， 
          “徽标”：“https://logo.moralis.io/0x1_0xbe9895146f7af43049ca1c1ae358b0541ea49704_22de8d667f6e46b09b33c805e7973049” ， 
          “缩略图”：“https://logo.moralis.io/0x1_0xbe9895146f7af43049ca1c1ae358b0541ea49704_22de8d667f6e46b09b33c805e7973049” ， 
          “余额”：“0” ， 
          “balance_formatted”：“0” ， 
          “美元价格”：2937.5037898342443 ， 
          “美元价值”：0 
        } ，
        //...
        {
          "token_type": "奖励" , 
          “名称”：“Coinbase 包装的质押 ETH” ， 
          “符号”：“cbETH” ， 
          “合约地址”：“0xbe9895146f7af43049ca1c1ae358b0541ea49704” ， 
          “小数”：“18” ， 
          “徽标”：“https://logo.moralis.io/0x1_0xbe9895146f7af43049ca1c1ae358b0541ea49704_22de8d667f6e46b09b33c805e7973049” ， 
          “缩略图”：“https://logo.moralis.io/0x1_0xbe9895146f7af43049ca1c1ae358b0541ea49704_22de8d667f6e46b09b33c805e7973049” ， 
          “余额”：“880092663147703” ， 
          “余额格式”：“0.000880092663147703” ， 
          “美元价格”：2937.5037898342443 ， 
          “美元价值”：2.5852755334016906 
        } ，
        //...
      ] ，
      “地址”：“0x840deeef2f115cf50da625f7368c24af6fe74410” ， 
      “余额_美元”：78.95335940631567 ， 
      “未认领美元总值”：5.121540153915798 ， 
      “位置详细信息”：{ 
        “nft_metadata”：{ 
          "name": "Uniswap - 0.05% - cbETH/WETH - 0.95028<>0.95218" , 
          “description”：“此 NFT 代表 Uniswap V3 cbETH-WETH 池中的流动性头寸。//...” ， 
          “图像”：”//...” 
        } ，
        //...
    } ，
  ]
  //...
}

通过这三个端点，您可以获得对任何钱包的 DeFi 位置的无与伦比的洞察力——只需一个 API 调用即可！

支持的协议

DeFi Positions 功能目前支持 13 种主要协议，包括：

Uniswap-v3
Uniswap-v2
Pancakeswap-v3
Pancakeswap-v2
Quickswap-v2
Sushiswap-v2
Aave-v3
Aave-v2
Fraxswap-v2
Fraxswap-v1
丽都
马克道
特征层

这仅仅是个开始——Moralis 的团队正在通过频繁添加新协议来不断扩大支持！

教程：如何通过 3 个步骤获取 DeFi 协议数据

在本教程中，我们将指导您完成使用我们的 DeFi API 检索 DeFi 协议数据的过程。借助我们用户友好的界面，您只需三个简单的步骤即可实现此目的：

获取 Moralis API 密钥
getDefiSummary()编写调用端点的脚本
运行代码

但在开始之前，您需要处理一些先决条件！

先决条件

如果尚未准备好，请确保在继续之前已准备好以下内容：

节点 v14+
npm/yarn

步骤 1：获取 Moralis API 密钥

要获取密钥，请首先通过单击右上角的“免费开始”按钮注册 Moralis：

接下来，登录，您将在“主页”选项卡下直接找到您的密钥：

复制并暂时保留密钥，因为在第二步中您将需要它。

`getDefiSummary()`步骤 2：编写调用端点的脚本

打开您喜欢的集成开发环境 (IDE)，设置一个文件夹，并使用以下终端命令初始化一个新项目：

npm init

接下来，运行以下命令来安装所需的依赖项：

npm 安装 node-fetch--save
npm 安装 moralis@moralisweb3/common-evm-utils

然后，打开您的“package.json”文件并添加"type": "module"到列表中：

创建新的”index.js”文件并添加以下脚本：

从‘node-fetch’导入fetch ；
const选项 = {
方法：'GET' ，
标题：{
   接受：'application/json' ，
   'X-API 密钥' ：'YOUR_API_KEY'
 } ，
} ；
获取（'https://deep-index.moralis.io/api/v2.2/wallets/0xcB1C1FdE09f811B294172696404e88E658659905/defi/summary?chain=eth' ，选项）
.then （响应= >响应.json （））
.then （响应= >控制台.log （响应）） 
.catch ( err = > console . error ( err ) ) ; 

现在，您需要配置代码。首先将其替换YOUR_API_KEY为您在第一步中复制的密钥。然后，配置address参数以适合您的查询：

就这样！剩下的就是执行脚本。

步骤 3：运行代码

要执行脚本，请打开一个新终端，导航到项目的根文件夹，然后运行以下命令：

节点索引.js

作为回报，您将收到钱包 DeFi 头寸的摘要。响应将包括所有头寸的总美元价值、未领取的奖励、协议名称等。以下是它可能的样子：

{
  活动协议：8 ， 
  总持仓数：12 ， 
  总美元值：871.6550972487607 ， 
  总未认领美元值：26.31655680118138 ， 
  协议：[ 
    {
      协议名称：'Uniswap v3' ，
      protocol_id ：'uniswap-v3' ，
      protocol_url : ' https://app.uniswap.org ' ,
      协议徽标：'https ：//cdn.moralis.io/defi/uniswap.png' ，
      总美元值：433.6700616074799 ， 
      总未认领美元值：26.31655680118138 ， 
      职位：3 
    } ，
    //...
  ]
}

恭喜！您现在知道如何使用 Moralis DeFi API 无缝检索协议数据。您可以按照相同的步骤调用我们的任何其他端点！

DeFi 协议数据的优势和用例

Moralis 的 DeFi Positions 功能为各个领域提供了多种应用。以下是四个主要示例：

增强投资组合管理：开发人员可以通过整合详细的 DeFi 活动洞察来提升投资组合管理，从而提高用户参与度和保留率。

全面的钱包洞察：投资组合追踪器可以更深入地了解用户的 DeFi 活动，提供更完整的财务概览。

精准的税务报告：加密税务公司可以利用全面的 DeFi 协议数据来提高报告准确性。

明智的投资决策：以 DeFi 为中心的投资者和分析师可以利用细粒度的 DeFi 协议和头寸数据做出更明智的交易选择。

总而言之，我们的顶级 DeFi Positions 功能在跨多个行业构建广泛的 dapp 时非常有用！

超越 DeFi 头寸——进一步探索 Moralis

Moralis 是业界领先的 Web3 数据提供商，将所有加密数据整合到一处。借助我们强大的 Web3 API 和高级 RPC 节点，只需几行代码即可访问所需的数据。因此，无论您是构建投资组合跟踪器、加密税务工具还是任何其他平台，Moralis 都能满足您的需求。

我们的开发工具有何独特之处？

全面：Moralis 的工具专为效率而设计，可让您以更少的努力获得更多的数据，从而让您更快、更有效地构建 Web3 项目。

跨链兼容性：我们的 Web3 API 在 30 多个区块链网络中提供完整的功能，因此您可以依靠单一提供商满足您的所有数据需求。

企业级安全性：由于符合 SOC 2 Type 2 标准，Moralis 确保我们所有产品的企业级数据安全。

现在您已经对 Moralis 有了大致的了解，让我们深入了解下面我们的开发工具的具体内容！

Web3 API

Moralis Web3 API 套件提供了一套全面的工具，旨在通过无缝访问区块链数据来简化您的开发人员体验。以下是五个关键 API：

钱包 API：使用钱包 API 简化钱包数据集成。只需几行代码即可检索钱包的历史记录、代币余额、净值、盈利能力等。

代币 API：使用 Moralis 代币 API 轻松获取 ERC-20 代币数据。此接口提供对代币余额、元数据、价格、交易等的无缝访问，非常适合将 ERC-20 数据集成到钱包、投资组合跟踪器和类似平台中。

NFT API：NFT API 是您处理所有 NFT 事务的首选解决方案。无论您需要 NFT 余额、价格还是最新元数据，此 API 都能满足您的需求。它非常适合构建 NFT 市场、Web3 游戏和其他以 NFT 为中心的应用程序。

价格 API：使用 Moralis 的价格 API 获取实时和历史价格数据。这个强大的工具支持 ERC-20 代币和 NFT，可轻松将准确的价格数据集成到您的 dapp 中。
Streams API：借助 Streams API 保持领先地位，它是业界领先的实时区块链数据解决方案。我们直观的点击界面让您可以轻松设置 Web3 数据管道，这样您就可以在链上事件发生时将其直接传输到您的 dapp 中。