如何使用 Crypto Market Data API Marketplace 插件构建加密货币投资组合追踪器

概述

加密货币市场数据 API 由 CoinAPI 开发，允许开发者访问来自超过 350 家交易所的实时和历史市场数据。本指南将引导你使用此 API 构建一个加密货币投资组合跟踪器，使你能够有效地分析加密货币投资组合。该应用程序将允许用户输入他们的持有量，获取当前和历史汇率，并显示总投资组合价值以及历史投资组合价值图表。

你将做什么

• 从 我们的 GitHub 存储库 克隆并运行一个即用型 React 应用程序，该应用程序利用加密货币市场数据 API Marketplace 插件来计算和显示投资组合的历史和当前市场价值。

• 了解有关 加密货币市场数据 API 插件上可用的不同方法的更多信息

你需要的

• 一个启用了加密货币市场数据 API Marketplace 插件的 QuickNode 账户
• 安装在你系统上的 Node.js (18.16 或更高版本)。
• Typescript 和 ts-node - 安装说明在指南中说明
• 熟悉 JavaScript 或 TypeScript

加密货币市场数据 API 插件概述

加密货币市场数据 API 提供了一套端点来访问各种类型的加密货币市场数据。以下是此插件中可用的一些方法：

• v1/getExchanges：检索受支持的交易所列表。
• v1/getSymbols：获取有关可用交易对的详细信息。
• v1/getAssets：访问有关各种加密货币和法定货币的数据。
• v1/getCurrentQuotes：获取指定交易对的最新报价。
• v1/getHistoricalQuotes：获取历史报价。
• v1/getCurrentOrderBooks：获取当前订单簿快照。
• v1/getHistoricalTrades：检索历史交易数据。
• v1/getHistoricalExchangeRates：访问指定资产的历史汇率。
• v1/getHistoricalOHLCV：获取历史开盘价、最高价、最低价、收盘价和成交量数据。
• v1/getCurrentExchangeRates：获取指定资产的最新汇率。

这些方法允许开发者为加密货币钱包、分析、指数提供商、经纪商、投资组合管理、投资、税务/会计、研究、机器人交易等构建强大的应用程序。通过利用加密货币市场数据 API，你可以将实时和历史市场数据无缝集成到你的项目中。

在本指南的范围内，我们将使用 v1/getAssets、v1/getCurrentExchangeRates 和 v1/getHistoricalExchangeRates 方法创建一个加密货币投资组合跟踪器应用程序。

设置你的开发环境

首先，你需要通过安装必要的依赖项并配置你的 QuickNode 访问权限来设置你的开发环境，以构建你的加密货币投资组合跟踪器应用程序。

安装必要的工具和依赖项

在开始之前，请确保你的系统上安装了 Node.js。如果尚未安装，请从官方网站下载并安装。Node.js 附带 npm（Node 包管理器），你将使用它来安装其他依赖项。

接下来，全局安装 TypeScript 和 ts-node（如果尚未安装）：

npm install -g typescript ts-node

设置端点

在开始之前，请注意 加密货币市场数据 API 是一项付费插件。请根据你的需求查看详细信息并比较计划。

使用加密货币市场数据 API 设置你的端点非常简单。如果你尚未注册，可以在 此处 创建一个帐户。

登录后，导航到 端点 页面，然后点击 创建端点。此插件支持多个链上的端点。你可以选择其中任何一个网络，然后点击 下一步。激活 加密货币市场数据 API 插件，最后，点击 创建端点。

如果你已经有一个没有插件的端点，请转到你的端点内的 插件 页面，选择 加密货币市场数据 API，然后激活它。

准备好你的端点后，复制 HTTP 提供商链接 并将其放在手边，因为你将在下一节中需要它。

克隆并运行示例应用程序

为了简化流程，我们准备了一个示例应用程序，你可以克隆并在本地运行。按照以下步骤开始：

1. 首先，将 QuickNode 的指南示例存储库 克隆到你的本地环境。

git clone https://github.com/quiknode-labs/qn-guide-examples.git

2. 导航到项目目录：

cd sample-dapps/crypto-portfolio-tracker-with-the-crypto-market-data-api

3. 安装所有必需的依赖项。

npm install

4. 将 .env.example 文件重命名为 .env，并使用启用了 加密货币市场数据 API 的 QuickNode 端点更新 YOUR_QUICKNODE_ENDPOINT 占位符：

VITE_QUICKNODE_ENDPOINT="YOUR_QUICKNODE_ENDPOINT"

注意：即使我们使用 dotenv 来管理环境变量，也要注意，诸如端点之类的敏感数据仍可能在前端暴露。如果没有额外的安全措施，此设置不适用于生产环境。

5. 启动开发服务器。

npm run dev

然后，在你的浏览器中打开 http://localhost:5173/ 以查看该应用程序。

6. 添加你的持有量并计算你的投资组合价值。

应用程序的工作流程

该应用程序旨在通过使用 加密货币市场数据 API 跟踪和可视化你的加密货币投资组合。以下是应用程序的工作流程和逻辑的详细概述：

1. 获取和过滤资产：

• 最初，该应用程序使用 v1/getAssets 方法获取资产列表。此列表包括加密货币和法定货币。

• 然后，过滤资产以将加密货币与法定货币分开。加密货币通过一个特定的属性（type_is_crypto）来识别，允许该应用程序将它们与常规货币区分开来。

• 过滤后的加密货币列表用于填充“添加持有量”功能中的选项，使用户能够选择他们想要添加到其投资组合中的加密货币。

• 同时，过滤后的法定货币列表（例如，美元、欧元）用作显示投资组合价值的基础货币的选项。

2. 用户交互和数据获取：

• 用户可以通过选择所需的资产并指定他们持有的数量来输入他们的加密货币持有量。此输入创建他们的个性化投资组合。

• 然后，该应用程序使用 v1/getCurrentExchangeRates 方法获取投资组合中每种加密货币的当前汇率。

• 除了获取当前汇率外，该应用程序还使用 v1/getHistoricalExchangeRates 检索资产的历史数据，以生成趋势和可视化效果，显示投资组合价值随时间的变化。

3. 计算和显示投资组合价值：

• 该应用程序通过将每种加密货币的数量乘以其在所选法定货币中的当前汇率来计算投资组合的当前价值。

• 对于历史价值，该应用程序使用历史汇率执行类似的计算。这允许用户查看其投资组合的价值随时间的变化。

• 然后，计算出的值显示为：

  • 饼图：显示投资组合的分布，说明每种加密货币相对于总投资组合价值的比例。
  • 折线图：显示投资组合的历史价值，使用户能够可视化其投资组合在指定期间内的趋势和变化。

使用加密货币市场数据 API 的其他想法

除了我们在本指南中开发的加密货币投资组合跟踪器之外，还可以发现使用加密货币市场数据 API 构建的内容。以下是一些创新且有价值的项目创意：

1. 历史市场数据分析器：一个使用 v1/getHistoricalQuotes、v1/getHistoricalOrderBooks 和 v1/getHistoricalOHLCV 提供详细的历史市场数据分析的应用程序。

2. 加密货币交易机器人：一个集成了自动化交易策略以使用 v1/getCurrentQuotes、v1/getCurrentOrderBooks 和 v1/getHistoricalTrades 执行交易的应用程序。

3. 加密货币套利查找器：一个通过使用 v1/getCurrentQuotes 和 v1/getCurrentOrderBooks 比较价格来识别不同交易所之间的套利机会的应用程序。

结论

在本指南中，你了解了 加密货币市场数据 API 的方法和 加密货币投资组合跟踪器 应用程序的工作流程。此应用程序演示了如何集成市场价格数据以跟踪投资组合表现并获得有价值的见解。

此处构建的应用程序只是一个起点。你可以自定义和扩展该应用程序以满足你的特定需求，无论是用于个人用途、财务分析还是开发与加密货币相关的项目。此外，你可以开发其他利用 加密货币市场数据 API 方法的项目。

订阅我们的 新闻通讯，以获取更多关于 Web3 和区块链的文章和指南。如果你有任何问题或需要更多帮助，请随时加入我们的 Discord 服务器或使用下面的表格提供反馈。请在 Twitter (@QuickNode) 和我们的 Telegram 公告频道 上关注我们，以获取最新信息。

我们 ❤️ 反馈！

如果你有任何反馈或对新主题的要求，请 告诉我们。我们很乐意听到你的声音。

• 原文链接： quicknode.com/guides/mar...
• 登链社区 AI 助手，为大家转译优秀英文文章，如有翻译不通的地方，还请包涵～