Core Extension SDK

Search Core Assets

Last updated July 22, 2026

Summary

das.searchAssets returns Core assets matching search criteria and maps them to AssetResult (Core asset type plus DAS content).

  • Defaults to interface: "MplCoreAsset" and burnt: false
  • Derives collection plugins unless skipDerivePlugins: true
  • Supports agent filters (isAgent, agentToken, assetSigner) when using DAS ≥ 2.1.0

Code example

In this example two filters are applied:

  1. The Public Key of the Owner
  2. The Metadata URI jsonUri

Error: Could not load example "das-api/core-extension/search-assets"

Make sure the file exists at: src/examples/das-api/core-extension/search-assets/index.js

Cannot find module './das-api/core-extension/search-assets/index.js'

Discover registered agents

Error: Could not load example "das-api/core-extension/search-assets-agents"

Make sure the file exists at: src/examples/das-api/core-extension/search-assets-agents/index.js

Cannot find module './das-api/core-extension/search-assets-agents/index.js'

Example Response

[
{
publicKey: '8VrqN8b8Y7rqWsUXqUw7dxQw9J5UAoVyb6YDJs1mBCCz',
header: {
executable: false,
owner: 'CoREENxT6tW1HoK8ypY1SxRMZTcVPm7R94rH4PZNhX7d',
lamports: [Object],
rentEpoch: 18446744073709551616n,
exists: true
},
pluginHeader: { key: 3, pluginRegistryOffset: 179n },
royalties: {
authority: [Object],
offset: 138n,
basisPoints: 500,
creators: [Array],
ruleSet: [Object]
},
key: 1,
updateAuthority: {
type: 'Collection',
address: 'FgEKkVTSfLQ7a7BFuApypy4KaTLh65oeNRn2jZ6fiBav'
},
name: 'Number 1',
uri: 'https://arweave.net/TkklLLQKiO9t9_JPmt-eH_S-VBLMcRjFcgyvIrENBzA',
content: {
'$schema': 'https://schema.metaplex.com/nft1.0.json',
json_uri: 'https://arweave.net/TkklLLQKiO9t9_JPmt-eH_S-VBLMcRjFcgyvIrENBzA',
files: [Array],
metadata: [Object],
links: [Object]
},
owner: 'AUtnbwWJQfYZjJ5Mc6go9UancufcAuyqUZzR1jSe4esx',
seq: { __option: 'None' }
}
]

Parameters

NameRequiredDescription
negateIndicates whether the search criteria should be inverted or not.
conditionTypeIndicates whether to retrieve all ("all") or any ("any") asset that matches the search criteria.
interfaceDefaults to MplCoreAsset. Also accepts MplCoreCollection / MplCoreGroup via dedicated helpers.
ownerThe address of the owner.
ownerTypeType of ownership ["single", "token"].
creatorThe address of the creator.
creatorVerifiedIndicates whether the creator must be verified or not.
authorityThe address of the authority.
groupingThe grouping ["key", "value"] pair (e.g. ["collection", "<pubkey>"] or ["group", "<pubkey>"]).
delegateThe address of the delegate.
frozenIndicates whether the asset is frozen or not.
supplyThe supply of the asset.
supplyMintThe address of the supply mint.
compressedIndicates whether the asset is compressed or not.
compressibleIndicates whether the asset is compressible or not.
royaltyModelType of royalty ["creators", "fanout", "single"].
royaltyTargetThe target address for royalties.
royaltyAmountThe royalties amount.
burntForced to false by the Core helper.
sortBySorting criteria { sortBy, sortDirection }.
limitThe maximum number of assets to retrieve.
pageThe index of the "page" to retrieve.
beforeRetrieve assets before the specified ID.
afterRetrieve assets after the specified ID.
jsonUriThe value for the JSON URI.
nameAsset name filter when supported by the RPC.
isAgentFilter by registered agent status (MPL Core only).
agentTokenFilter by the agent's canonical token mint (MPL Core only).
assetSignerFilter by the Core Asset Signer PDA (MPL Core only).
skipDerivePluginsSkip automatic collection plugin derivation.
displayOptionsOnly showCollectionMetadata is supported for Core.

Notes

  • Technically the helper forwards standard DAS search parameters; some are rarely useful for Core (the package already constrains interface / burnt).
  • Agent filters and response fields require DAS ≥ 2.1.0 and an indexer that populates agent metadata.