get_artist#Finds an artist and returns all their Art Blocks projects with full metadata, floor prices, tags, and direct artblocks.io links. Results are ordered by most recently launched.
Provide at least one — they can be combined:
ParamTypeNotesartistNamestringCase-insensitive partial match (e.g. "hobbs" finds Tyler Hobbs)artistSlugstringExact artist profile slug (e.g. "tyler-hobbs")artistAddressstringArtist's wallet address (exact match)chainIdnumberOptional — filter projects to a specific chainlimitnumberMax projects to return (1–100, default 50)
text
artistNames — deduplicated list of artist display names matched
artistProfiles — unique artist profile objects: { slug, displayName }
totalProjects — total project count matching the query
projects[] — array of project objects, each containing:
id — full project ID (contract_address-project_index)
name, artistName, description, slug
artBlocksUrl — direct link to project on artblocks.io
chainId, contractAddress, projectIndex
verticalName, verticalDisplay, curationStatus
active, paused, complete, invocations, maxInvocations, remaining
startDatetime, completedAt
aspectRatio, scriptTypeAndVersion, renderComplete
website, license
lowestListing — floor price in ETH (null if no listings)
featuredTokenImageUrl — hero image URL (null if none)
tags[] — tag name strings (e.g. "ab500", "animated")
artistProfiles[] — { slug, displayName }
Use get_artist when...Use something else when...You want all projects by a specific artistYou want to browse projects broadly → discover_projectsYou know the artist's name, slug, or wallet addressYou have a specific project ID → get_projectYou want to compare an artist's body of workYou need token-level data → get_token_metadata
artBlocksUrl for each project — use these when presenting projects to usersartistSlug field in results (under artistProfiles) can be used for subsequent lookupsartistNames array will show all matched namesprojectIndex is the project number on the contract (e.g. 78); id is the full project ID (e.g. 0xa7d8...d270-78)