> ## 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.
# searchAssets
> 所有者、作成者、コレクション、およびカスタム属性を含む柔軟な基準を使用して、Solana NFT、圧縮NFT、およびトークンを検索およびフィルタリングします
## リクエストパラメーター
検索結果をフィルタリングするための所有デジタル資産を取得するSolanaウォレットアドレス。
特定のSolanaトークンタイプ（圧縮NFT（cNFT）、通常のNFT、
プログラマブルNFT（pNFT）、またはファンジブルSPLトークン）をフィルタリングして、対象の資産を発見します。
* `fungible`
* `nonFungible`
* `regularNft`
* `compressedNft`
* `all`
返す結果のページ。
プログラム権限に基づくSolanaデジタル資産をフィルタリングするための権限アドレス基準。
特定のプロトコルまたは更新権限によって制御されている資産を見つけるのに役立ちます。
返される最大資産数。
レスポンスのソートオプション。
資産をソートする基準。
* `created`
* `recent_action`
* `updated`
* `none`
ソート方向。
* `asc`
* `desc`
圧縮Solana NFT（cNFT）をフィルタリングし、
ストレージコストの削減とスケーラビリティの向上を図ります。
圧縮可能であるが、まだ圧縮フォーマットに変換されていない
Solana資産をフィルタリングします。
資産検索の委譲基準。
アーティスト、プロジェクト、またはクリエイターによって作成されたSolana NFTを
特定し、帰属とロイヤリティの追跡を行うためのクリエイターウォレットアドレス基準。
クリエイターが検証されているかどうか。
コレクションメンバーシップによってSolana NFTをフィルタリングするためのコレクショングループ化配列
（例: \["collection", "\"]）で関連する資産を見つけます。
コレクションツリーで圧縮NFT（cNFT）をフィルタリングするためのマークルツリーアドレス。
このパラメータはHelius固有であり、公式DAS仕様には含まれていません。
資産検索の供給基準。
資産検索の供給通貨基準。
資産が凍結されているかどうか。
資産が焼却されているかどうか。
エージェントアイデンティティ（MPLコアエージェントアイデンティティ外部プラグイン）を持つ資産をフィルタリングします。
エージェントレジストリプログラムからのbase58エージェントトークンミントアドレスでフィルタリングします。
Base58資産署名者PDA（MPLコア）でフィルタリングします。
特定のNFT実装をフィルタリングするためのSolanaトークン標準インターフェイスタイプ
プログラマブルNFT、レガシーNFT、ファンジブルトークン、MPLコア資産、コレクション、またはグループ（MIP-11）を含みます。
* `V1_NFT`
* `V1_PRINT`
* `LEGACY_NFT`
* `V2_NFT`
* `FungibleAsset`
* `FungibleToken`
* `Custom`
* `Identity`
* `Executable`
* `ProgrammableNFT`
* `MplCoreAsset`
* `MplBubblegumV2`
* `MplCoreCollection`
* `MplCoreGroup`
ロイヤリティターゲットタイプ基準。
ロイヤリティターゲット基準。
ロイヤリティ額基準。
所有モデル基準。
後方ページネーションのためのカーソル。
前方ページネーションのためのカーソル。
Solana資産検索レスポンスをカスタマイズするための高度な表示オプション。
検証されていないコレクションを表示し、それをスキップする代わりに。
コレクションのメタデータを表示。
一致する資産の総数を表示（リクエストが遅くなります）。
所有者のネイティブ（SOL）バランスを表示。
ゼロバランスの資産を表示。
## OpenAPI
````yaml ja/openapi/das-api/searchAssets.yaml POST /
openapi: 3.1.0
info:
title: Solana NFT Discovery & Search API
version: 1.0.0
description: >-
強力なフィルター機能を備えたSolanaエコシステム全体でNFT、トークン、その他のデジタル資産を検索および発見するための高度なSolanaデジタルアセット標準（DAS）API。この包括的な検索APIは、NFTマーケットプレイス、ポートフォリオアプリケーション、分析プラットフォームの基盤を提供し、コレクション、クリエーター、圧縮ステータス、所有権など、複数の基準に基づいてデジタル資産を検索およびフィルターすることができます。Solanaエコシステム全体で、従来のNFTおよび圧縮されたNFTの両方をサポートします。
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
- url: https://mainnet.helius-rpc.com
description: メインネットRPCエンドポイント
- url: https://devnet.helius-rpc.com
description: Devnet RPCエンドポイント
security: []
paths:
/:
post:
tags:
- RPC
summary: searchAssets
description: >
包括的なフィルターオプションを使用してSolanaデジタル資産を検索および発見します。アプリケーションが所有権、クリエーター、コレクション、圧縮ステータス、メタデータ属性を含む複数の基準を使用してNFT、圧縮されたNFT、ファンジブルトークン、その他のデジタル資産を見つけることを可能にする強力な発見APIです。Solanaエコシステム全体での高度な資産発見機能を必要とするマーケットプレイス、ポートフォリオトラッカー、分析プラットフォームに最適です。
主な機能:
- すべてのSolana NFT標準（従来、圧縮、プログラム可能）にわたる多基準検索
- NFTプロジェクトとコミュニティのためのコレクションベースのフィルタリング
- 属性およびポートフォリオ分析のためのクリエーターおよび所有権に基づくクエリ
- コスト効率の良い資産を識別するための圧縮ステータスフィルタリング
- 特性に基づく発見のためのメタデータ属性検索
- 大量の結果セットに対する完全なページネーションサポート
operationId: rpc
requestBody:
content:
application/json:
schema:
type: object
required:
- jsonrpc
- id
- method
- params
properties:
jsonrpc:
type: string
enum:
- '2.0'
description: JSON-RPCプロトコルのバージョン。
default: '2.0'
id:
type: string
description: リクエストを識別するためのID。
default: '1'
method:
type: string
enum:
- searchAssets
description: 呼び出すJSON-RPCメソッドの名前。
default: searchAssets
params:
type: object
description: '`searchAssets` メソッドのパラメータ。'
default:
ownerAddress: 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
page: 1
limit: 10
tokenType: all
required:
- ownerAddress
- tokenType
properties:
ownerAddress:
type: string
description: 所有するデジタル資産をフィルタリング結果として取得するためのSolanaウォレットアドレス。
example: 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
tokenType:
type: string
enum:
- fungible
- nonFungible
- regularNft
- compressedNft
- all
description: >
圧縮NFT（cNFT）、通常のNFT、プログラム可能なNFT、または特定のSolanaトークンタイプのフィルタリング。
example: all
page:
type: integer
description: 返す結果のページ。
example: 1
authorityAddress:
type: string
description: >
プログラムのアクセス権に基づいてSolanaデジタル資産をフィルタリングするための権限アドレス基準。特定のプロトコルや更新権限によって制御されている資産を見つけるのに便利です。
example: string
limit:
type: integer
description: 返す資産の最大数。
example: 100
sortBy:
type: object
description: 応答のソートオプション。
properties:
sortBy:
type: string
description: 資産をソートする基準。
enum:
- created
- recent_action
- updated
- none
sortDirection:
type: string
description: ソート方向。
enum:
- asc
- desc
compressed:
type: boolean
description: >
圧縮されたSolana
NFT（cNFT）をフィルタリングし、保存コストの削減と拡張性の向上を図るための状態圧縮テクノロジーを使用。
example: true
compressible:
type: boolean
description: |
圧縮が可能だがまだ圧縮されていないSolana資産のフィルタリング。
example: false
delegate:
type: integer
description: 資産検索のためのデリゲート基準。
creatorAddress:
type: string
description: >
属性およびロイヤリティ追跡のために、特定のアーティスト、プロジェクト、クリエーターによって作成されたSolana
NFTを見つけるためのクリエーターウォレットアドレス基準。
example: string
creatorVerified:
type: boolean
description: クリエーターが検証されているかどうか。
example: true
grouping:
type: array
items:
type: string
description: >
関連する資産を見つけるためのコレクションメンバーシップによるSolana
NFTのフィルタリングのためのコレクショングループ化配列
（例： ["collection", ""]）。
example:
- collection
- DRiP2Pn2K6fuMLKQmt5rZWyHiUZ6WK3GChEySUpHSS4x
tree:
type: string
description: >
Helius固有のパラメータであり、公式DAS仕様の一部ではない、コレクションツリーごとに圧縮NFT（cNFT）をフィルタリングするためのマークルツリーアドレス。
example: mwfDfWTYkyPYcZWPHCQyYMZKwg7SxDxWRAhGkBcNqqL
supply:
type: integer
description: 資産検索のための供給基準。
example: 0
supplyMint:
type: string
description: 資産検索のための供給ミント基準。
frozen:
type: boolean
description: 資産が凍結されているかどうか。
example: false
burnt:
type: boolean
description: 資産が焼却されたかどうか。
example: false
isAgent:
type: boolean
description: エージェントIDを持つ資産のフィルタリング（MPL Core AgentIdentity外部プラグイン）。
agentToken:
type: string
description: Agent Registryプログラムからのbase58エージェントトークンミントアドレスでフィルタリング。
assetSigner:
type: string
description: base58資産署名者PDA（MPL Core）でフィルタリング。
interface:
type: string
description: >
プログラム可能なNFT、レガシーNFT、ファンジブルトークン、MPL
Core資産、コレクション、またはグループ（MIP-11）を含む特定のNFT実装をフィルタリングするためのSolanaトークン標準インターフェースタイプ。
enum:
- V1_NFT
- V1_PRINT
- LEGACY_NFT
- V2_NFT
- FungibleAsset
- FungibleToken
- Custom
- Identity
- Executable
- ProgrammableNFT
- MplCoreAsset
- MplBubblegumV2
- MplCoreCollection
- MplCoreGroup
example: Custom
royaltyTargetType:
type: string
description: ロイヤルティターゲットタイプ基準。
example: creators
royaltyTarget:
type: integer
description: ロイヤルティターゲット基準。
example: 0
royaltyAmount:
type: integer
description: ロイヤルティ金額基準。
example: 0
ownerType:
type: integer
description: 所有モデル基準。
example: 1
before:
type: string
description: 前に戻るためのページネーションクロック。
example: string
after:
type: string
description: 前に進むためのページネーションクロック。
example: string
options:
type: object
description: Solana資産検索応答をカスタマイズするための高度な表示オプション。
properties:
showUnverifiedCollections:
type: boolean
default: false
description: 検証されていないコレクションをスキップする代わりに表示します。
showCollectionMetadata:
type: boolean
default: false
description: コレクションのメタデータを表示します。
showGrandTotal:
type: boolean
default: false
description: 一致する資産の合計数を表示します（リクエストが遅くなります）。
showNativeBalance:
type: boolean
default: false
description: 所有者のネイティブ（SOL）バランスを表示します。
showZeroBalance:
type: boolean
default: false
description: 残高ゼロの資産を表示します。
example:
jsonrpc: '2.0'
id: my-id
method: searchAssets
params:
ownerAddress: 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
tokenType: all
limit: 50
responses:
'200':
description: 成功した応答
content:
application/json:
schema:
type: object
properties:
assets:
type: object
properties:
last_indexed_slot:
type: integer
description: このスロットまでのすべてのデータがインデックスされていることが保証されます。
example: 365750752
total:
type: integer
description: 検索基準に一致するSolana NFTおよびデジタル資産の合計数。
example: 80
limit:
type: integer
description: 要求された資産の最大数。
example: 50
page:
type: integer
description: 現在の結果ページ。
example: 1
items:
type: array
description: 資産の配列。
items:
type: object
properties:
interface:
type: string
description: デジタル資産のSolanaトークン標準実装タイプ。
enum:
- V1_NFT
- V1_PRINT
- LEGACY_NFT
- V2_NFT
- FungibleAsset
- FungibleToken
- Custom
- Identity
- Executable
- ProgrammableNFT
- MplCoreAsset
- MplCoreCollection
- MplCoreGroup
is_agent:
type: boolean
description: >-
この資産がエージェントIDを持っているかどうか（MPL Core
AgentIdentity外部プラグイン）。偽の場合は省略されます。
agent_token:
type: string
description: >-
Agent
RegistryプログラムからのBase58エンコードされたエージェントトークンミント。登録されていない場合は省略されます。
asset_signer:
type: string
description: MPL Core用のBase58エンコードされた資産署名者PDA。該当しない場合は省略されます。
plugins:
type: object
description: オプションのMIP-11 `groups` メンバーシップを含むMPL Coreプラグイン。
additionalProperties: true
id:
type: string
description: Solanaデジタル資産の一意のミントアドレス識別子。
ownership:
type: object
description: 現在の所有者およびモデルを含むSolanaデジタル資産の所有詳細。
content:
type: object
description: URI、属性、メディアを含むSolanaデジタル資産のコンテンツおよびメタデータ。
example:
total: 80
limit: 50
page: 1
items:
- interface: V1_NFT
id: SomeNftMintKey12345
ownership:
owner: 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
ownership_model: single
content:
json_uri: https://example.com/metadata/12345.json
nativeBalance:
type: object
description: lamportsおよびUSD値でのSolanaウォレットアカウントのネイティブSOLバランス。
properties:
lamports:
type: integer
description: アカウントにあるlamportsの数。
price_per_sol:
type: number
description: SOLの現在の価格。
total_price:
type: number
description: このアカウントのSOLの総価値。
'400':
description: 不正なリクエスト。サーバーは無効な構文のためリクエストを理解できませんでした。
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
example: '2.0'
error:
type: object
properties:
code:
type: integer
example: -32602
message:
type: string
example: 無効なリクエストパラメータ。
id:
type: string
example: '1'
'401':
description: 認証されていない。クライアントは要求された応答を得るために認証する必要があります。
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
example: '2.0'
error:
type: object
properties:
code:
type: integer
example: -32001
message:
type: string
example: 認証に失敗しました。APIキーがないか無効です。
id:
type: string
example: '1'
'403':
description: 禁止された。クライアントはコンテンツへのアクセス権を持っていません。
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
example: '2.0'
error:
type: object
properties:
code:
type: integer
example: -32003
message:
type: string
example: このリソースにアクセスする権限がありません。
id:
type: string
example: '1'
'404':
description: 見つかりません。サーバーは要求されたリソースを見つけることができません。
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
example: '2.0'
error:
type: object
properties:
code:
type: integer
example: -32004
message:
type: string
example: 検索基準に一致する資産が見つかりません。
id:
type: string
example: '1'
'429':
description: リクエストが多すぎます。指定された時間内にユーザーがあまりにも多くのリクエストを送信しました。
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
example: '2.0'
error:
type: object
properties:
code:
type: integer
example: -32029
message:
type: string
example: レートがリミットを超えました。しばらくしてからもう一度試してください。
id:
type: string
example: '1'
'500':
description: 内部サーバーエラー。サーバーが対処方法がわからない状況に直面しました。
content:
application/json:
schema:
type: object
properties:
jsonrpc:
type: string
example: '2.0'
error:
type: object
properties:
code:
type: integer
example: -32000
message:
type: string
example: サーバーで予期しないエラーが発生しました。
id:
type: string
example: '1'
security:
- ApiKeyQuery: []
components:
securitySchemes:
ApiKeyQuery:
type: apiKey
in: query
name: api-key
description: >-
あなたのHelius
APIキー。無料で[ダッシュボード](https://dashboard.helius.dev/api-keys)から取得できます。
````