Solana NFTを取得する方法: 資産、コレクション、証明書

概要

このガイドでは、Helius Digital Asset Standard (DAS) APIを使用してNFTとデジタルコレクティブルを読み取る方法を説明します。単一の資産の取得、ウォレットのNFT一覧、コレクションまたはクリエイターによるクエリ、圧縮NFTとマークリ証明書の操作、エディションの一覧、トランザクション履歴の読み取りについて解説します。代替トークン — 残高、供給量、保有者、価格 — についてはGet SPL Tokens ガイドを参照してください。同じgetAssetおよびgetAssetsByOwnerメソッドはNFTとトークンの両方に対応しており、このページはNFTとコレクティブルのワークフローに焦点を当てています。

使用時期

このページのメソッドを使用する場合:

単一のNFTのメタデータ、画像、属性を表示する場合
ポートフォリオやギャラリーのためにウォレットが所有するすべてのNFTを一覧する場合
コレクションおよびクリエイターのクエリでマーケットプレイスやエクスプローラーを動かす場合
圧縮NFTの検証や転送（マークリ証明が必要）
NFTのオンチェーントランザクション履歴を表示する場合
マスターNFTから印刷されたエディションを一覧表示する場合

NFTメソッド

単一のNFTにはgetAsset、ウォレットのコレクションにはgetAssetsByOwnerから始めます。各カードはその完全なAPIリファレンスにリンクしています。

getAsset

IDで指定した1つのNFTの完全なデータ。

getAssetsByOwner

ウォレットが保有するすべてのNFT。

searchAssets

コレクション、クリエイター、属性などでフィルタリング。詳細はSearch Assetsガイドを参照。

getAssetsByCreator

クリエイターによって作成されたすべての資産。

getAssetsByGroup

コレクション内のすべての資産。

getSignaturesForAsset

資産のトランザクション履歴。

getNftEditions

マスターNFTからのエディション。

getAssetProof

圧縮NFTのためのマークリ証明。

単一のNFTを取得する

1つのNFTのIDによって完全なメタデータ、所有権、およびコレクションデータを取得します。

const response = await fetch('https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: '1',
    method: 'getAsset',
    params: { id: 'F9Lw3ki3hJ7PF9HQXsBzoY8GyE6sPoEZZdXJBsTTD2rk' },
  }),
});

const { result } = await response.json();
console.log(result.content.metadata.name, result.ownership.owner);

他のNFTクエリ

ウォレットのNFTを一覧表示 — getAssetsByOwner

const getNFTsByOwner = async (ownerAddress) => {
  const response = await fetch('https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      jsonrpc: '2.0',
      id: '1',
      method: 'getAssetsByOwner',
      params: { ownerAddress, page: 1, limit: 10 },
    }),
  });

  const { result } = await response.json();
  return result;
};

getNFTsByOwner('86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY');

クリエイター別 — getAssetsByCreator

const getAssetsByCreator = async (creatorAddress) => {
  const response = await fetch('https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      jsonrpc: '2.0',
      id: '1',
      method: 'getAssetsByCreator',
      params: { creatorAddress, page: 1, limit: 100 },
    }),
  });

  const { result } = await response.json();
  return result;
};

getAssetsByCreator('9uBX3ASjxWvNBAD1xjbVaKA74mWGZys3RGSF7DdeDD3F');

コレクション別 — getAssetsByGroup

const getAssetsByCollection = async (collectionAddress) => {
  const response = await fetch('https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      jsonrpc: '2.0',
      id: '1',
      method: 'getAssetsByGroup',
      params: { groupKey: 'collection', groupValue: collectionAddress, page: 1, limit: 100 },
    }),
  });

  const { result } = await response.json();
  return result;
};

getAssetsByCollection('J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w');

トランザクション履歴 — getSignaturesForAsset

const getNFTTransactionHistory = async (mintAddress) => {
  const response = await fetch('https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      jsonrpc: '2.0',
      id: '1',
      method: 'getSignaturesForAsset',
      params: { id: mintAddress, page: 1, limit: 100 },
    }),
  });

  const { result } = await response.json();
  return result;
};

getNFTTransactionHistory('FNt6A9Mfnqbwc1tY7uwAguKQ1JcpBrxmhczDgbdJy5AC');

圧縮NFT

ステート圧縮NFT（cNFT）は、通常のNFTと同じメソッドで読み取ります — getAsset、getAssetsByOwner、searchAssetsのすべてがそれを返します。圧縮に特有な点は2つあります。

マークリ証明 — 転送や焼却などのオンチェーン操作にはgetAssetProofからの証明が必要です。
履歴 — cNFTのトランザクション履歴はgetSignaturesForAsset（上記参照）を使用します。

マークリ証明を取得 — getAssetProof

const getProof = async (id) => {
  const response = await fetch('https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      jsonrpc: '2.0',
      id: '1',
      method: 'getAssetProof',
      params: { id },
    }),
  });

  const { result } = await response.json();
  return result; // { root, proof, node_index, leaf, tree_id }
};

getProof('Bu1DEKeawy7txbnCEJE4BU3BKLXaNAKCYcHR4XhndGss');

ベストプラクティス

大量の結果セットを返すメソッドにはページネーションを使用します。
try/catchでエラーを処理し、指数バックオフで一時的な失敗を再試行します。
API呼び出しを減らすために適切な場合にはレスポンスをキャッシュします。
複数のIDがある場合には、多数の単一のgetAsset呼び出しの代わりにgetAssetBatchを使用します。

次のステップ

SPLトークンの取得

代替トークンのバランス、供給量、保有者、価格。

資産の検索

NFTをコレクション、クリエイター、属性でフィルタリング。

DAS API FAQ

資産、価格データ、使用法に関する一般的な質問。

はじめに

データストリーミングとイベントリスニング

データ API & RPC

トレーディング

トランザクションの送信

ウォレット・アズ・ア・サービス

ガイド

リソース

Solana NFTを取得する方法: 資産、コレクション、証明書

概要

使用時期

NFTメソッド

getAsset

getAssetsByOwner

searchAssets

getAssetsByCreator

getAssetsByGroup

getSignaturesForAsset

getNftEditions

getAssetProof

単一のNFTを取得する

他のNFTクエリ

圧縮NFT

ベストプラクティス

次のステップ

SPLトークンの取得

資産の検索

DAS API FAQ

​概要

​使用時期

​NFTメソッド

getAsset

getAssetsByOwner

searchAssets

getAssetsByCreator

getAssetsByGroup

getSignaturesForAsset

getNftEditions

getAssetProof

​単一のNFTを取得する

​他のNFTクエリ

​圧縮NFT

​ベストプラクティス

​次のステップ

SPLトークンの取得

資産の検索

DAS API FAQ

概要

使用時期

NFTメソッド

単一のNFTを取得する

他のNFTクエリ

圧縮NFT

ベストプラクティス

次のステップ