跳转到主要内容

概述

searchAssets 在一次查询中组合多个筛选条件。当没有任何单个 getAssetsBy* 方法能满足需求时使用它,例如“这个钱包持有的、属于这个合集的压缩 NFT”或“这个钱包持有的同质化代币”。 默认情况下,所有筛选条件都必须匹配(conditionType: "all")。设置 conditionType: "any" 可匹配至少满足一个筛选条件的资产,设置 negate: true 可反转结果。

参数

筛选条件

string
所有者钱包(base-58)。
string
创作者地址(base-58)。
boolean
与 creatorAddress 一起使用时,仅匹配已验证的创作者。
string
权限地址(base-58)。
[string, string]
分组键和值,例如 ["collection", "J1S9H3QjnRtBbbuD4HjPV6RpRhwuk4zKbxsnCHuTgh9w"]。
string
委托人地址(base-58)。
string
资产接口,例如 V1_NFT、ProgrammableNFT、MplCoreAsset 或 FungibleToken。完整列表请参阅资产对象。
string
fungible、nonFungible、regularNFT、compressedNFT 或 all。
string
single(NFT)或 token(同质化代币)。
boolean
匹配已压缩或未压缩的资产。
boolean
匹配可以被压缩的资产。
boolean
匹配已冻结或未冻结的资产。
boolean
匹配已销毁或仍存在的资产。
number
匹配确切的供应量。
string
按供应 mint 匹配(base-58)。
string
creators、fanout 或 single。
string
版税接收者地址(base-58)。
number
以基点计的版税。
string
确切的元数据 JSON URI。
string
资产名称。需要同时提供 ownerAddress。

逻辑

string
all(默认)或 any。
boolean
返回不匹配的资产。

分页与输出

number
页码,从 1 开始。请参阅分页。
number
每页结果数。最大值和默认值均为 1,000。
string
来自上一次响应的游标。
string
返回 ID 在此 ID 之前的资产。
string
返回 ID 在此 ID 之后的资产。
object
{ "sortBy": "id" | "created" | "updated" | "recent_action" | "none", "sortDirection": "asc" | "desc" }
object
显示选项:showNativeBalance(需配合 ownerAddress)、showUnverifiedCollections、showCollectionMetadata、showInscription。也可以作为 displayOptions 传入。

响应

一个列表,包含 last_indexed_slot、total、limit、page 或 cursor、items(资产对象),以及使用 showNativeBalance 时的 nativeBalance。

代码示例

某个合集中仍存在的 NFT

某个钱包持有的同质化代币

某个钱包在一个合集中持有的压缩 NFT

常见错误