> ## Documentation Index
> Fetch the complete documentation index at: https://www.helius.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Solana 可替代代币 API：完整的代币数据访问

> 使用DAS API查询所有Solana代币：SPL代币、Token-2022扩展、USD价格数据，以及通过getAsset、getAssetsByOwner和searchAssets获取余额。

## 概述

最初，DAS API仅支持针对Metaplex NFT和cNFT的所有权查询。Helius已扩展DAS API以支持**所有代币**，包括普通SPL代币（无元数据）和Token-2022（及其扩展）。

您可以查询**任何**账户的所有代币（SPL、Token-2022、NFT和压缩NFT）的代币余额，并包含以USD计算的代币价格。Solana代币是通过其mint账户定义的。例如，USDC的mint账户是[EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v](https://explorer.solana.com/address/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v)。当您购买40美元的USDC时，会创建一个持有40个USDC代币的代币账户。一个钱包可以持有数百个不同代币的代币账户。

要了解有关Token-2022的更多信息，请参阅Helius的[博客文章](https://www.helius.dev/blog/what-is-token-2022)。

## 何时使用

当您想要在一个DAS调用中获得账户资产的**统一视图**——可替代代币、NFT和压缩NFT——包括元数据和USD价格时，请使用可替代代币扩展。这是投资组合追踪器、钱包和代币面板的正确选择。

当您只需要链上原始数据——单个账户余额、总供应量或最大持有者——而不需要元数据或价格时，请使用标准RPC代币方法（`getTokenAccountBalance`, `getTokenAccountsByOwner`, `getTokenSupply`, `getTokenLargestAccounts`）。有关这些方法，请参阅[获取SPL代币指南](/docs/zh/das/get-tokens)。

## 工作原理

Helius针对可替代代币的扩展围绕所有权索引。以下方法提供账户资产的统一视图：[getAsset](/docs/zh/api-reference/das/getasset)、[getAssetsByOwner](/docs/zh/api-reference/das/getassetsbyowner)和[searchAssets](/docs/zh/api-reference/das/searchassets)。

该扩展添加了一个名为 `tokenType` 的额外字段，允许您查询账户拥有的所有资产，包括可替代的和 Token-2022 代币。`tokenType` 的选项有：

* `fungible`：返回所有可替代代币。
* `nonFungible`：返回所有 NFT（压缩和常规 NFT）。
* `regularNft`：仅返回常规 NFT。
* `compressedNft`：仅返回压缩 NFT。
* `all`：返回所有代币。

示例请求：

```json theme={"system"}
{
    "jsonrpc": "2.0",
    "id": "helius-test",
    "method": "searchAssets",
    "params": {
        "ownerAddress": "5aZZ4duJUKiMsJN9vRsoAn4SDX7agvKu7Q3QdFWRfWze",
        "tokenType": "all"
    }
}
```

响应现在包括 JitoSOL 等可替代代币。每个项目包含总账户余额、代币的程序地址、关联的代币地址、流通中的总供应量和价格信息。以下是修整过的项目，显示了相关字段：

```jsonc theme={"system"}
{
    "id": "J1toso1uCk3RLmjorhTtrVwY9HJ7X8V9yYac6Y7kGCPn",
    "content": {
        "$schema": "",
        "json_uri": "",
        "metadata": {
            "description": "MEV-Powered Liquid Staking Derivative",
            "name": "Jito Staked SOL",
            "symbol": "JitoSOL",
            "token_standard": "Fungible"
        }
        // ...
    },
    "token_info": {
        "symbol": "JitoSOL",
        "balance": 35688813508,
        "supply": 5949594702758293,
        "decimals": 9,
        "token_program": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
        "associated_token_address": "H7iLu4DPFpzEx1AGN8BCN7Qg966YFndt781p6ukhgki9",
        "price_info": {
            "price_per_token": 56.47943,
            "total_price": 2015.6838854339217,
            "currency": "USDC"
        }
    }
    // ...
}
```

## Token-2022 支持

Helius 支持 Token-2022 代币并解析其扩展。如果代币使用 Token-2022 程序，响应将包括 `mint_extensions` 字段。以下是 BERN 的 `mint_extensions` 字段的修整项：

```jsonc theme={"system"}
{
    "mint_extensions": {
        "transfer_fee_config": {
            "withheld_amount": 0,
            "newer_transfer_fee": {
                "epoch": 457,
                "maximum_fee": 3906250000000000000,
                "transfer_fee_basis_points": 690
            },
            "older_transfer_fee": {
                "epoch": 455,
                "maximum_fee": 3906250000000000000,
                "transfer_fee_basis_points": 0
            },
            "withdraw_withheld_authority": "7MyTjmRygJoCuDBUtAuSugiYZFULD2SWaoUTmtjtRDzD",
            "transfer_fee_config_authority": "7MyTjmRygJoCuDBUtAuSugiYZFULD2SWaoUTmtjtRDzD"
        }
    }
    // ...
}
```

## 向后兼容性

为了向后兼容，当省略 `tokenType` 时，行为与原始 DAS 相同：仅返回 NFT 和压缩 NFT。

```json theme={"system"}
{
    "jsonrpc": "2.0",
    "id": "helius-test",
    "method": "searchAssets",
    "params": {
        "ownerAddress": "5aZZ4duJUKiMsJN9vRsoAn4SDX7agvKu7Q3QdFWRfWze"
    }
}
```

## 下一步

<CardGroup cols={3}>
  <Card title="获取 SPL 代币" icon="coins" href="/docs/zh/das/get-tokens">
    余额、供应量、持有者和代币账户。
  </Card>

  <Card title="搜索资产" icon="magnifying-glass" href="/docs/zh/das/search">
    按 tokenType、所有者和集合进行筛选。
  </Card>

  <Card title="searchAssets 参考" icon="code" href="/docs/zh/api-reference/das/searchassets">
    完整请求和响应架构。
  </Card>
</CardGroup>