helius_search_assets
Search for Solana blockchain assets using filters such as owner address, creator, burnt status, frozen status, compressed, or supply mint. Retrieve paginated results.
Instructions
Search for assets using various filters
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | ||
| limit | No | ||
| cursor | No | ||
| before | No | ||
| after | No | ||
| creatorAddress | No | ||
| ownerAddress | No | ||
| jsonUri | No | ||
| grouping | No | ||
| burnt | No | ||
| frozen | No | ||
| supplyMint | No | ||
| supply | No | ||
| delegate | No | ||
| compressed | No |
Implementation Reference
- src/handlers/helius.ts:417-427 (handler)The actual handler function that executes the search_assets tool logic. Calls helius.rpc.searchAssets(input) and returns the results.
export const searchAssetsHandler = async (input: SearchAssetsInput): Promise<ToolResultSchema> => { try { const assets = await (helius as any as Helius).rpc.searchAssets(input); if (!assets || assets.items.length === 0) { return createErrorResponse(`No assets found for search: ${JSON.stringify(input, null, 2)}`); } return createSuccessResponse(`Search results: ${JSON.stringify(assets, null, 2)}`); } catch (error) { return createErrorResponse(`Error searching assets: ${error instanceof Error ? error.message : String(error)}`); } } - src/handlers/helius.types.ts:208-224 (schema)Type definition for SearchAssetsInput, defining all supported search filter parameters.
export type SearchAssetsInput = { page?: number; limit?: number; cursor?: string; before?: string; after?: string; creatorAddress?: string; ownerAddress?: string; jsonUri?: string; grouping?: string[]; burnt?: boolean; frozen?: boolean; supplyMint?: string; supply?: number; delegate?: string; compressed?: boolean; } - src/tools.ts:580-580 (registration)Registration of the 'helius_search_assets' tool mapping to helius.searchAssetsHandler in the tool registry.
"helius_search_assets": helius.searchAssetsHandler, - src/tools.ts:372-408 (schema)Input schema definition for the 'helius_search_assets' tool, specifying all properties and validation constraints.
{ name: 'helius_search_assets', description: 'Search for assets using various filters', inputSchema: { type: 'object', properties: { page: { type: 'number' }, limit: { type: 'number' }, cursor: { type: 'string' }, before: { type: 'string' }, after: { type: 'string' }, creatorAddress: { type: 'string' }, ownerAddress: { type: 'string' }, jsonUri: { type: 'string' }, grouping: { type: 'array', items: { type: 'string' } }, burnt: { type: 'boolean' }, frozen: { type: 'boolean' }, supplyMint: { type: 'string' }, supply: { type: 'number' }, delegate: { type: 'string' }, compressed: { type: 'boolean' } }, // At least one filter parameter should be provided anyOf: [ { required: ['ownerAddress'] }, { required: ['creatorAddress'] }, { required: ['jsonUri'] }, { required: ['supplyMint'] }, { required: ['delegate'] }, { required: ['burnt'] }, { required: ['frozen'] }, { required: ['compressed'] } ] }