概述
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
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,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。