토큰 데이터 읽기

Solana 블록체인에서 대체 가능 토큰 정보를 가져옵니다.

토큰 메타데이터 가져오기

민트 주소를 사용하여 토큰의 메타데이터를 가져옵니다. 이름, 심볼, 소수점 자릿수, 공급량을 포함한 온체인 토큰 정보를 조회합니다.

1// npm install @metaplex-foundation/mpl-token-metadata @metaplex-foundation/umi @metaplex-foundation/umi-bundle-defaults
2import { publicKey } from '@metaplex-foundation/umi'
3import { createUmi } from '@metaplex-foundation/umi-bundle-defaults'
4import {
5  fetchDigitalAsset,
6  mplTokenMetadata
7} from '@metaplex-foundation/mpl-token-metadata'
8
9// Initialize Umi with your RPC endpoint
10const umi = createUmi('https://api.devnet.solana.com').use(mplTokenMetadata())
11
12// The mint address of the token you want to fetch
13const mintAddress = publicKey('YOUR_TOKEN_MINT_ADDRESS')
14
15// Fetch the token's metadata from the blockchain
16const asset = await fetchDigitalAsset(umi, mintAddress)
17
18console.log('Token Name:', asset.metadata.name)
19console.log('Token Symbol:', asset.metadata.symbol)
20console.log('Token URI:', asset.metadata.uri)
21console.log('Decimals:', asset.mint.decimals)
22console.log('Supply:', asset.mint.supply)

1// npm install @metaplex-foundation/umi @metaplex-foundation/umi-bundle-defaults @metaplex-foundation/digital-asset-standard-api
2import { dasApi } from '@metaplex-foundation/digital-asset-standard-api';
3import { publicKey } from '@metaplex-foundation/umi';
4import { createUmi } from '@metaplex-foundation/umi-bundle-defaults';
5
6// Initialize Umi with a DAS-enabled RPC endpoint
7const umi = createUmi('https://api.devnet.solana.com').use(dasApi())
8
9// The mint address of the token you want to fetch
10const mintAddress = publicKey('YOUR_TOKEN_MINT_ADDRESS')
11
12// Fetch the asset using DAS API
13const asset = await umi.rpc.getAsset(mintAddress, {
14  displayOptions: {
15    showFungible: true
16  }
17})

1curl -X POST \
-H "Content-Type: application/json" \
-d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getAsset",
  "params": {
    "id": "<Mint Address>"
  }
}' \
https://api.devnet.solana.com

파라미터

파라미터	설명
`mintAddress`	가져올 토큰 민트 주소

토큰 잔액 가져오기

Associated Token Account 또는 DAS API를 사용하여 특정 지갑의 토큰 잔액을 가져옵니다.

1// npm install @metaplex-foundation/umi @metaplex-foundation/umi-bundle-defaults @metaplex-foundation/mpl-toolbox
2import { publicKey } from '@metaplex-foundation/umi'
3import { createUmi } from '@metaplex-foundation/umi-bundle-defaults'
4import {
5  findAssociatedTokenPda,
6  fetchToken
7} from '@metaplex-foundation/mpl-toolbox'
8
9const umi = createUmi('https://api.devnet.solana.com')
10
11const mintAddress = publicKey('YOUR_TOKEN_MINT_ADDRESS')
12const walletAddress = publicKey('WALLET_ADDRESS')
13
14// Find the Associated Token Account
15const tokenAccount = findAssociatedTokenPda(umi, {
16  mint: mintAddress,
17  owner: walletAddress,
18})
19
20// Fetch the token account data
21const tokenData = await fetchToken(umi, tokenAccount)
22
23console.log('Token Balance:', tokenData.amount)
24console.log('Mint:', tokenData.mint)
25console.log('Owner:', tokenData.owner)

1// npm install @metaplex-foundation/umi @metaplex-foundation/umi-bundle-defaults @metaplex-foundation/digital-asset-standard-api
2import { publicKey } from '@metaplex-foundation/umi'
3import { createUmi } from '@metaplex-foundation/umi-bundle-defaults'
4import { dasApi } from '@metaplex-foundation/digital-asset-standard-api'
5
6const umi = createUmi('https://api.devnet.solana.com').use(dasApi())
7
8const mintAddress = publicKey('YOUR_TOKEN_MINT_ADDRESS')
9const walletAddress = publicKey('WALLET_ADDRESS')
10
11// Use searchAssets to find the token with balance for a specific wallet
12const result = await umi.rpc.searchAssets({
13  owner: walletAddress,
14  interface: 'FungibleToken',
15  limit: 1000,
16  displayOptions: {
17    showFungible: true
18  }
19})
20
21// Find the specific token by mint address
22const token = result.items.find(
23  (asset) => asset.id === mintAddress
24)
25
26if (token) {
27  console.log('Token:', token.content.metadata?.name)
28  console.log('Balance (raw):', token.token_info?.balance)
29  console.log('Decimals:', token.token_info?.decimals)
30
31  // Calculate human-readable balance
32  const decimals = token.token_info?.decimals || 0
33  const balance = Number(token.token_info?.balance) / Math.pow(10, decimals)
34  console.log('Balance:', balance)
35} else {
36  console.log('Token not found in wallet')
37}

1# Get token balance for a wallet using DAS searchAssets
2# Returns all fungible tokens - filter by mint address in response
3curl -X POST \
-H "Content-Type: application/json" \
-d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "searchAssets",
  "params": {
    "ownerAddress": "<Wallet Address>",
    "interface": "FungibleToken",
    "options": {
      "showFungible": true
    }
  }
}' \
https://api.devnet.solana.com

소유자별 모든 토큰 가져오기

DAS API를 사용하여 지갑 주소가 소유한 모든 대체 가능 토큰을 조회합니다.

1// npm install @metaplex-foundation/umi @metaplex-foundation/umi-bundle-defaults @metaplex-foundation/digital-asset-standard-api
2import { dasApi } from '@metaplex-foundation/digital-asset-standard-api';
3import { publicKey } from '@metaplex-foundation/umi';
4import { createUmi } from '@metaplex-foundation/umi-bundle-defaults';
5
6const umi = createUmi('https://api.devnet.solana.com').use(dasApi())
7
8const walletAddress = publicKey('WALLET_ADDRESS')
9
10// Get all fungible assets owned by the wallet using searchAssets
11// Using interface: 'FungibleToken' filters server-side (more efficient)
12const result = await umi.rpc.searchAssets({
13  owner: walletAddress,
14  interface: 'FungibleToken',
15  limit: 1000,
16  displayOptions: {
17    showFungible: true
18  }
19})
20
21const fungibleTokens = result.items
22
23console.log(`Found ${fungibleTokens.length} fungible tokens\n`)
24
25fungibleTokens.forEach(token => {
26  const decimals = token.token_info?.decimals || 0
27  const rawBalance = token.token_info?.balance || 0
28  const balance = Number(rawBalance) / Math.pow(10, decimals)
29
30  console.log(`${token.content.metadata?.name} (${token.content.metadata?.symbol})`)
31  console.log(`  Mint: ${token.id}`)
32  console.log(`  Balance: ${balance.toLocaleString()}`)
33})

1# Get all fungible tokens owned by a wallet using searchAssets
2# Using interface: "FungibleToken" filters server-side (more efficient)
3curl -X POST \
-H "Content-Type: application/json" \
-d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "searchAssets",
  "params": {
    "ownerAddress": "GfK2Xz6pzQp1sC1FvxePKnikZA7iyaCSVXZykixLjem5",
    "interface": "FungibleToken",
    "options": {
      "showFungible": true
    }
  }
}' \
https://api.devnet.solana.com

접근 방식 비교

기능	직접 RPC	DAS API
속도	대량 쿼리에서 느림	대량 쿼리에 최적화
데이터 신선도	실시간	거의 실시간 (인덱싱됨)
검색 기능	제한적	고급 필터링
사용 사례	단일 토큰 조회	포트폴리오 보기, 검색

팁

포트폴리오 보기에 DAS 사용 - 사용자가 소유한 모든 토큰을 표시할 때, DAS API는 여러 RPC 호출보다 훨씬 빠릅니다
DAS에서 showFungible 설정 - showFungible: true를 설정하세요. 그렇지 않으면 일부 RPC는 NFT 데이터만 반환합니다

토큰 메타데이터 가져오기

파라미터

토큰 잔액 가져오기

소유자별 모든 토큰 가져오기

접근 방식 비교

팁

관련 가이드