# 如何在 Solana链上获取代币持有者

## 概述

让我们首先看看代币（尤其是非同质化代币）在 Solana 上是如何运作的。当开发人员创建代币时，他们使用代币程序创建一个铸币账户。这个铸币账户包含有关特定代币的信息，例如名称、代币地址和图像。一旦创建了铸币账户，就可以铸造代币并将其存储在代币账户中。代币账户是一个包含有关特定地址拥有的特定代币的信息的账户。这将包括铸币地址、所有者地址和账户中特定代币的数量等详细信息。例如，持有一些 USDC（SPL 代币）的地址将有一个 USDC 的代币账户。

我们了解了代币和代币账户的工作原理，我们可以看看如何获​​取给定代币的所有代币持有者。每个持有特定代币的钱包都会有一个该代币的代币账户。这意味着此代币将与持有该代币的所有钱包的代币账户相关联。这就是我们找出所有持有者的方法。如果我们能找到一种方法来获取与代币相关联的所有代币账户，然后获取这些账户的所有者，我们就会得到所有持有者的名单！

## getTokenAccounts 方法

幸运的是，Helius getTokenAccounts API 方法允许我们精确地做到这一点。我们能够在 API 调用参数中包含任何代币的铸币地址，我们将获得为该代币创建的所有代币帐户的列表。除此之外，API 还返回每个代币帐户的所有者；这个所有者就是我们通常所说的代币持有者。需要注意的一件小事是，一个帐户可以有多个针对同一代币的代币帐户。这不是什么大问题；我们只需要设置一些逻辑来处理共享所有者的代币帐户。

## 执行

现在让我们深入研究一些代码，看看我们实际上如何做到这一点。您需要一个 Helius API 密钥才能继续操作。您可以前往<https://dev.helius.xyz并注册一个帐户，免费获取一个。首先，我们必须创建一个名为getTokenHolders.js的> Javascript 文件。我们可以先添加我们的 Helius URL 并导入 fs 库，将结果保存到JSON文件中。

```

const url = `https://mainnet.helius-rpc.com/?api-key=`;
const fs = require("fs");

```

接下来，我们将创建一种方法来获取与特定代币相关联的所有代币帐户。我们可以首先创建一个名为 findHolders 的方法，该方法将使用 getTokenAccounts 方法获取所需的数据。您可以在此处阅读有关getTokenAccounts方法的更多信息。需要注意的一件重要事情是，每次调用 API 最多只能返回 1000 个代币帐户。Solana 上的大多数大型代币都有超过 100,000 个代币帐户。为了解决这个问题，我们将使用分页浏览所有代币帐户并继续进行 API 调用，直到我们获取与所有现有代币帐户相关的数据。在该方法中，我们将在getTokenAccounts调用的参数中包含代币铸币厂。当我们循环遍历所有代币帐户时，我们会将每个唯一的代币帐户所有者添加到列表中。方法运行完成后，我们会将此列表保存到包含所有代币持有者的JSON文件中。

```

const findHolders = async () => {
  // Pagination logic
  let page = 1;
 	// allOwners will store all the addresses that hold the token
  let allOwners = new Set();

  while (true) {
    const response = await fetch(url, {
      method: "POST",
      headers: {
        "Content-Type": "application/json",
      },
      body: JSON.stringify({
        jsonrpc: "2.0",
        method: "getTokenAccounts",
        id: "helius-test",
        params: {
          page: page,
          limit: 1000,
          displayOptions: {},
					//mint address for the token we are interested in
          mint: "CKfatsPMUf8SkiURsDXs7eK6GWb4Jsd6UDbs7twMCWxo",
        },
      }),
    });

		// Check if any error in the response
      if (!response.ok) {
        console.log(
          `Error: ${response.status}, ${response.statusText}`
        );
        break;
      }

    const data = await response.json();
  	// Pagination logic. 
    if (!data.result || data.result.token_accounts.length === 0) {
      console.log(`No more results. Total pages: ${page - 1}`);
      break;
    }
    console.log(`Processing results from page ${page}`);
 		// Adding unique owners to a list of token owners. 
    data.result.token_accounts.forEach((account) =>
      allOwners.add(account.owner)
    );
    page++;
  }

  fs.writeFileSync(
    "output.json",
    JSON.stringify(Array.from(allOwners), null, 2)
  );
};


```

在上面的示例中，在分页浏览所有代币账户时，多次调用getTokenAccounts方法。API 响应将为每个代币账户提供以下数据：

“地址”：“CVMR1nbxTcQ7Jpa1p137t5TyKFii3Y7Vazt9fFct3tk9”，

“薄荷”：“SHDWyBxihqiCj6YekG2GUr7wqKLeLAMK1gHZck9pL6y”，

“所有者”：“CckxW6C1CjsxYcXSiDbk7NYfPLhfqAm3kSB5LEZunnSE”，

“金额”：100000000，

“委托金额”：0，

“冻结”：错误

}，

我们从这些代币账户中提取了所有者，并将其添加到我们的列表中。如果我们愿意，我们还可以存储每个代币账户持有的代币数量，以找出最大的持有者。

一旦完成，我们需要做的就是调用该方法：

```
findHolders();
```

我们的getTokenHolders.js文件中的完整代码应如下所示：

```
const url = `https://mainnet.helius-rpc.com/?api-key=`;
const fs = require("fs");


const findHolders = async () => {
  let page = 1;
  let allOwners = new Set();

  while (true) {
    const response = await fetch(url, {
      method: "POST",
      headers: {
        "Content-Type": "application/json",
      },
      body: JSON.stringify({
        jsonrpc: "2.0",
        method: "getTokenAccounts",
        id: "helius-test",
        params: {
          page: page,
          limit: 1000,
          displayOptions: {},
          mint: "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
        },
      }),
    });

		// Check if any error in the response
      if (!response.ok) {
        console.log(
          `Error: ${response.status}, ${response.statusText}`
        );
        break;
      }

    const data = await response.json();

    if (!data.result || data.result.token_accounts.length === 0) {
      console.log(`No more results. Total pages: ${page - 1}`);

      break;
    }
    console.log(`Processing results from page ${page}`);
    data.result.token_accounts.forEach((account) =>
      allOwners.add(account.owner)
    );
    page++;
  }

  fs.writeFileSync(
    "output.json",
    JSON.stringify(Array.from(allOwners), null, 2)
  );
};

findHolders();

```

## 输出

我们的代码的输出将是所有持有者的列表，看起来类似于：

\[

“111An9SVxuPpgjnuXW9Ub7hcVmZpYNrYZF4edsGwJEW”，

“11Mmng3DoMsq2Roq8LBcqdz6d4kw9oSD8oka9Pwfbj”，

“112uNfcC8iwX9P2TkRdJKyPatg6a4GNcr9NC5mTc2z3”，

“113uswn5HNgEfBUKfK4gVBmd2GpZYbxd1N6h1uUWReg”，

“11CyvpdYTqFmCVWbJJeKFNX8F8RSjNSYW5VVUi8eX4P”，

“11MANeaiHEy9S9pRQNu3nqKa2gpajzX2wrRJqWrf8dQ”，

…

]

## 结论

在本指南的最后，我们成功介绍了通过 Helius getTokenAccounts API识别 Solana 代币持有者的过程。

如有不明白或者不清楚的地方，请加入官方电报群：[**https://t.me/gtokentool**](https://t.me/gtokentool)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.gtokentool.com/qu-kuai-lian/ru-he-zai-solana-lian-shang-huo-qu-dai-bi-chi-you-zhe.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.