【Web3探索】如何获得某 NFT 收藏品的持有者清单？实战全程手把手教学

Chainbase
更新于 2023-08-18 16:11
阅读 2502

在快速增长的 NFT 市场中，了解特定 NFT 集合的持有者对于做出明智的决策和评估市场动态至关重要。通过 Chainbase API ，您可以轻松获取特定 NFT 的持有者信息，这篇文章会教你如何做。

**The Author: [ Oksana Kovalenko](https://chainbase.com/blog/article/how-to-get-the-owners-of-an-nft-collection)**

# 1. 引言：

非同质化代币（NFT）市场迎来了显著的飙升，吸引了创作者和投资者的关注。作为 NFT 爱好者，收集有关 NFT 集合的全面信息，包括其持有者的身份，变得非常重要。通过了解持有者，您可以深入了解市场动态，识别有影响力的持有者，从而做出更明智的投资决策。在本文中，我们将逐步探索如何获取 NFT 集合的持有者。

# 2. 理解 NFT 及其持有者：

在深入了解细节之前，让我们简要了解一下什么是 NFT 以及在 NFT 环境中为什么持有者很重要。NFT 是表示数字物品所有权或真实性证明的独特数字资产。与比特币或以太坊等可替代货币不同，可被一对一交换的同质化货币不同，NFT 具有独特的属性，并可以代表各种类型的数字内容，包括艺术品、音乐、收藏品和虚拟房地产等。

在 NFT 市场中，拥有 NFT 的所有者至关重要，因为它代表着控制和价值。NFT 的所有者有权转让、出售或展示其资产。此外，持有者信息提供了有关资产分布、持仓集中度和整体市场动态的见解。了解谁拥有特定的 NFT 集合可以帮助投资者评估对其的兴趣和活动水平。

# 3. 辨认区块链平台：

要开始发现 NFT 集合的持有者，您需要辨认与该集合关联的区块链平台。有几个区块链平台支持 NFT 的创建和交易，包括以太坊、Polygon、币安智能链等。每个平台都有自己的生态系统和与 NFT 交互的工具。

一旦确定了与您感兴趣的 NFT 集合相关的区块链平台，您就可以继续下一步来获取持有者信息。

# 4. 使用区块链浏览器：

区块链浏览器是一个强大的工具，允许您探索区块链上的交易历史和其他数据。它提供了对 on-chain 活动的可见性，包括 NFT 的创建、所有权转让和交互等。为了找到 NFT 集合的持有者，您需要使用区块链浏览器来搜索与该集合相关联的 NFT 合约地址。

# 5. 查找 NFT 合约地址：

NFT 合约地址是代表区块链上特定 NFT 集合的唯一标识符。通过找到合约地址，您可以访问与该集合相关的所有信息，包括持有者信息。要查找 NFT 合约地址，您可以使用区块链浏览器，并搜索集合名称或相关的元数据。一旦找到合约地址，请记录下来，因为您在后续步骤中会用到它。

# 6.在 Chainbase 建立免费账户：

在使用 Chainbase 及其 API 之前，您需要设置一个免费账户。访问 Chainbase [网站](https://chainbase.com/) 并通过[注册过程](https://chainbase.com/blog/article/how-to-register-a-chainbase-account)创建账户。成功注册后，请登录您的账户并导航到仪表板。从那里，创建一个新项目，并获取一个 API 密钥，用于发起 API 请求。

# 7. 使用 Chainbase API 编写脚本：

要获取 NFT 集合的持有者，您需要编写一个与 Chainbase API 交互的脚本。该 API 允许您基于链 ID 和集合的合约地址获取 NFT 持有者的数据。

在 JavaScript 中，您可以使用 `fetch` 函数来向 Chainbase 发起 API 调用。以下是使用 Chainbase API 编写脚本的示例：

```jsx
network_id = '1'; // 替换为适用于区块链平台的正确网络 ID
contract_addr = '0xed5af388653567af2f388e6224dc7c4b3241c544'; // 替换为 NFT 集合的合约地址

fetch(`https://api.chainbase.online/v1/nft/owners?chain_id=${network_id}&contract_address=${contract_addr}`, {
    method: 'GET',
    headers: {
        'x-api-key': CHAINBASE_API_KEY, // 替换为您的 Chainbase API 密钥
        'accept': 'application/json'
    }
}).then(response => response.json())
    .then(data => console.log(data.data))
    .catch(error => console.error(error));

```

该脚本向 Chainbase API 端点发出 HTTP GET 请求，以获取 NFT 集合的持有者。它通过 URL 中的网络 ID 和合约地址传递参数。此外，它还包括 `x-api-key` 请求头，用于进行身份验证，其中包含您的 Chainbase API 密钥。

API 调用的响应将包含有关 NFT 集合持有者的数据，包括他们的地址和所持有的 NFT 总数。您可以根据需要访问和处理此数据。

使用 Axios：

如果您喜欢在 JavaScript 中使用 Axios 库来发起 HTTP 请求，以下是另一个脚本：

```jsx
network_id = '1'; // 替换为区块链平台的正确网络 ID
contract_addr = '0xed5af388653567af2f388e6224dc7c4b3241c544'; // 替换为 NFT 集合的合约地址

```

该脚本实现了与前一个脚本相同的结果，但使用 Axios 发起 API 请求。在运行此脚本之前，请确保通过终端运行 `npm install axios --save` 安装了 Axios。

# 8. 打印持有者信息：

要打印数据，可以在终端中运行命令 `node <filename>.js`。在这种情况下，返回数据的 `data` 列如下所示。

执行脚本后，您将收到响应，其中包含 NFT 集合持有者的地址以及每个地址所持有的 NFT 总数。然后，您可以根据需要处理和显示此信息。

```jsx
{
"address": "0xd46c8648f2ac4ce1a1aace620460fbd24f640853",
"total": 374
},
{
"address": "0xff3879b8a363aed92a6eaba8f61f1a96a9ec3c1e",
"total": 290
},
{
"address": "0x29469395eaf6f95920e59f858042f0e28d98a20b",
"total": 224
},
{
"address": "0x8e0788650afeedfb26f26bee874aed02688b2108",
"total": 117
},
{
"address": "0x54be3a794282c030b15e43ae2bb182e14c409c5e",
"total": 113
},

```

通过按照这些步骤，您可以获取 NFT 集合的持有者信息，并深入了解该集合内资产的分布。这些信息可以对多种目的产生价值，例如评估 NFT 集合的受欢迎程度，识别有影响力的持有者，或者评估市场趋势。

# 9. 结论：

在快速增长的 NFT 市场中，了解特定 NFT 集合的持有者对于做出明智的决策和评估市场动态至关重要。遵循本文中概述的步骤，您可以轻松通过 Chainbase API 获取特定 NFT 的持有者信息。掌握了这些知识，您可以探索持有者的情况，识别关键参与者，并对市场获得有价值的见解。

# 10. 常见问题解答：

**Q1. 了解 NFT 集合的持有者为什么很重要？**

了解 NFT 集合的持有者提供了关于资产分布、持仓集中度和整体市场动态的见解。它帮助投资者评估特定集合的兴趣和活动水平，使他们能够做出更明智的投资决策。

- Q2. 如何识别 NFT 集合的区块链平

台？

要识别 NFT 集合的区块链平台，您可以参考 NFT 集合所属平台提供的信息，即该集合在哪个平台上创建或交易。此外，您可以探索流行的区块链平台，例如以太坊、Polygon 或币安智能链，并查看该集合是否存在于其中任何一个上。

**Q3. 除了 Chainbase，还有其他检索持有者信息的工具吗？**

虽然我们的 API 是检索持有者信息的强大工具，但其他区块链浏览器和分析平台也提供类似的功能。一些流行的选择包括 Etherscan、Polygonscan 和 BscScan，它们为各自的区块链平台提供有关 NFT 交易和所有权的见解。

**Q4. 我能通过 Chainbase 获取 NFT 集合的历史所有权数据吗？**

我们提供实时数据访问，包括 NFT 集合当前的持有者。但它可能不提供历史所有权数据。如果您需要历史数据，可以尝试探索其他专门从事 NFT 分析和数据聚合的平台或服务。

**Q5. 使用 Chainbase 及其 API 是否需要支付费用？**

我们提供免费层，允许用户访问其基本功能，包括 API。然而，如果您想请求更多 NFT 地址数据，可能会有[开发者计划](https://chainbase.com/pricing)或其他收费服务。

# 关于 Chainbase

- Chainbase 是面向 Web3 的一体化数据基础设施，可让您在链上数据上建立索引、转换和使用，实现规模化。通过利用丰富的链上数据和流式计算技术，Chainbase 自动化索引和查询区块链数据，使开发者能够用更少的工作完成更多的任务。

### 想了解更多关于 Chainbase 的信息？

访问我们的网站 [chainbase.com](https://chainbase.com/) 注册一个 [免费账户](https://chainbase.com/register)，并查阅我们的 [文档](https://docs.chainbase.com/docs)。

[网站](https://chainbase.com/)｜[博客](https://chainbase.com/blog)｜[推特](https://twitter.com/ChainbaseHQ)｜[Discord](https://discord.gg/kYrpZuwv6e)｜[Link3](https://link3.to/chainbase)

**The Original Link: [How to Get the Owners of an NFT Collection](https://chainbase.com/blog/article/how-to-get-the-owners-of-an-nft-collection)**

The Author: Oksana Kovalenko

1. 引言：

2. 理解 NFT 及其持有者：

3. 辨认区块链平台：

一旦确定了与您感兴趣的 NFT 集合相关的区块链平台，您就可以继续下一步来获取持有者信息。

4. 使用区块链浏览器：

5. 查找 NFT 合约地址：

6.在 Chainbase 建立免费账户：

在使用 Chainbase 及其 API 之前，您需要设置一个免费账户。访问 Chainbase 网站并通过注册过程创建账户。成功注册后，请登录您的账户并导航到仪表板。从那里，创建一个新项目，并获取一个 API 密钥，用于发起 API 请求。

7. 使用 Chainbase API 编写脚本：

要获取 NFT 集合的持有者，您需要编写一个与 Chainbase API 交互的脚本。该 API 允许您基于链 ID 和集合的合约地址获取 NFT 持有者的数据。

在 JavaScript 中，您可以使用 fetch 函数来向 Chainbase 发起 API 调用。以下是使用 Chainbase API 编写脚本的示例：

network_id = '1'; // 替换为适用于区块链平台的正确网络 ID
contract_addr = '0xed5af388653567af2f388e6224dc7c4b3241c544'; // 替换为 NFT 集合的合约地址

fetch(`https://api.chainbase.online/v1/nft/owners?chain_id=${network_id}&contract_address=${contract_addr}`, {
    method: 'GET',
    headers: {
        'x-api-key': CHAINBASE_API_KEY, // 替换为您的 Chainbase API 密钥
        'accept': 'application/json'
    }
}).then(response => response.json())
    .then(data => console.log(data.data))
    .catch(error => console.error(error));

该脚本向 Chainbase API 端点发出 HTTP GET 请求，以获取 NFT 集合的持有者。它通过 URL 中的网络 ID 和合约地址传递参数。此外，它还包括 x-api-key 请求头，用于进行身份验证，其中包含您的 Chainbase API 密钥。

API 调用的响应将包含有关 NFT 集合持有者的数据，包括他们的地址和所持有的 NFT 总数。您可以根据需要访问和处理此数据。

使用 Axios：

如果您喜欢在 JavaScript 中使用 Axios 库来发起 HTTP 请求，以下是另一个脚本：

network_id = '1'; // 替换为区块链平台的正确网络 ID
contract_addr = '0xed5af388653567af2f388e6224dc7c4b3241c544'; // 替换为 NFT 集合的合约地址

const axios = require('axios');
const options = {
    url: `https://api.chainbase.online/v1/nft/owners?chain_id=${network_id}&contract_address=${contract_addr}`,
    method: 'GET',
    headers: {
        'x-api-key': CHAINBASE_API_KEY, // 替换为您的 Chainbase API 密钥
        'accept': 'application/json'
    }
};
axios(options)
    .then(response => console.log(response.data.data))
    .catch(error => console.log(error));

该脚本实现了与前一个脚本相同的结果，但使用 Axios 发起 API 请求。在运行此脚本之前，请确保通过终端运行 npm install axios --save 安装了 Axios。

8. 打印持有者信息：

要打印数据，可以在终端中运行命令 node <filename>.js。在这种情况下，返回数据的 data 列如下所示。

执行脚本后，您将收到响应，其中包含 NFT 集合持有者的地址以及每个地址所持有的 NFT 总数。然后，您可以根据需要处理和显示此信息。

{
"address": "0xd46c8648f2ac4ce1a1aace620460fbd24f640853",
"total": 374
},
{
"address": "0xff3879b8a363aed92a6eaba8f61f1a96a9ec3c1e",
"total": 290
},
{
"address": "0x29469395eaf6f95920e59f858042f0e28d98a20b",
"total": 224
},
{
"address": "0x8e0788650afeedfb26f26bee874aed02688b2108",
"total": 117
},
{
"address": "0x54be3a794282c030b15e43ae2bb182e14c409c5e",
"total": 113
},