如何使用加密市场数据API市场附加组件构建加密投资组合跟踪器

概述

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

你将会做什么

• 从我们的GitHub仓库克隆并运行一个现成的React应用，该应用利用Crypto Market Data API Marketplace附加组件计算并显示投资组合的历史和当前市场价值。

• 了解Crypto Market Data API附加组件中可用的不同方法。

你将需要什么

• 一个启用Crypto Market Data API Marketplace附加组件的QuickNode账户
• 已安装Node.js（版本18.16或更高）。
• Typescript和ts-node - 安装说明请见指南
• 熟悉JavaScript或TypeScript

Crypto Market Data API附加组件概述

Crypto Market Data API提供了一套API端点以访问各种类型的加密货币市场数据。以下是此附加组件中的一些方法：

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

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

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

设置开发环境

首先，你需要设置开发环境以构建加密投资组合追踪器应用，通过安装必要的依赖并配置QuickNode访问。

安装必要的工具和依赖

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

接下来，如果还没有，请全局安装TypeScript和ts-node：

npm install -g typescript ts-node

设置端点

在你开始之前，请注意Crypto Market Data API是一个付费附加组件。请根据你的需求检查详细信息并比较计划。

使用Crypto Market Data API设置端点非常简单。如果你还没有注册，可以在这里创建一个账户。

登录后，导航到Endpoints页面并点击创建端点。此附加组件支持多个链上的端点。你可以选择这些网络中的任何一个，并点击下一步。激活Crypto Market Data API附加组件，最后点击创建端点。

如果你已有一个没有附加组件的端点，前往你端点内的Add-ons页面，选择Crypto Market Data API并激活它。

一旦你的端点准备好，复制HTTP提供者链接并保管好，因为在下一部分你需要用到它。

克隆和运行示例应用

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

1. 首先克隆QuickNode's Guide Examples repository到你的本地环境。

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，并用你的QuickNode端点更新YOUR_QUICKNODE_ENDPOINT占位符，该端点已启用Crypto Market Data API：

VITE_QUICKNODE_ENDPOINT="YOUR_QUICKNODE_ENDPOINT"

注意：尽管我们使用dotenv来管理环境变量，但请注意，敏感数据如端点仍可能在前端暴露。这个设置在没有额外安全措施的生产环境中并不合适。

5. 启动开发服务器。

npm run dev

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

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

应用工作流程

该应用旨在使用Crypto Market Data API跟踪和可视化你的加密货币投资组合。以下是该应用的工作流程和逻辑的详细概述：

1. 获取和过滤资产：

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

• 随后，对资产进行过滤，将加密货币与法定货币分开。加密货币通过特定属性 ( type_is_crypto) 被识别，从而允许应用区分它们与普通货币。

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

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

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

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

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

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

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

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

• 对于历史值，应用使用历史汇率执行类似的计算。这使用户能够看到他们的投资组合价值如何随着时间的推移而变化。

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

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

使用Crypto Market Data API的其他想法

除了我们在本指南中开发的加密投资组合追踪器，探索使用Crypto Market Data API可以构建的其他项目。以下是一些创新和有价值的项目想法：

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

2. 加密交易机器人：一个与自动交易策略集成的应用，使用v1/getCurrentQuotes、v1/getCurrentOrderBooks和v1/getHistoricalTrades执行交易。

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

结论

在本指南中，你已经了解了Crypto Market Data API的方法和Crypto Portfolio Tracker应用的工作流程。该应用展示了如何集成市场价格数据以跟踪投资组合表现并获取有价值的见解。

在这里构建的应用只是一个起点。你可以自定义和扩展该应用以满足你的特定需求，无论是用于个人使用、财务分析还是开发与加密相关的项目。同时，你可以开发其他利用Crypto Market Data API方法的项目。

请订阅我们的新闻通讯，以获取有关Web3和区块链的更多文章和指南。如果你有任何问题或需要进一步的帮助，欢迎加入我们的Discord服务器，或通过下面的表单提供反馈。通过关注我们的Twitter（@QuickNode）和我们的Telegram公告频道，保持最新动态。

我们 ❤️ 反馈！

告诉我们如果你有任何反馈或对新主题的请求。我们很想听到你的意见。

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