Discovering Art Blocks Projects#

Choosing the Right Tool#

GoalToolWhat's minting right now?discover_live_mintsWhat's dropping soon?discover_upcoming_releasesBrowse/filter by vertical, artist, chain, tagdiscover_projectsFull details on a known projectget_projectAll projects by a specific artistget_artistHigh-level portfolio summary for a collectorget_wallet_summaryIndividual tokens a collector ownsget_wallet_tokensSee available tags for filteringlist_tags

Resource: artblocks://about#

Fetch this resource first if you need platform context — it covers vocabulary, verticals, chains, tags, user profiles, and a quick-start guide for which tool to use.

Tool: discover_projects#

Browses and filters Art Blocks collections with optional text search, chain, vertical, tag, floor price, and mintability filters. Returns project metadata with truncated descriptions, floor price, mint progress, featured token image, and a direct artblocks.io link. Test/dev projects (unassigned vertical) are excluded by default.

Filters#

ParamTypeNotessearchstringSearches project name and artist name (case-insensitive partial match)artistNamestringFilter by artist name (case-insensitive partial match)chainIdnumber1 (Ethereum), 42161 (Arbitrum), 8453 (Base)verticalNamestringSee verticals belowmintablebooleantrue = actively mintable projects onlytagstringFilter by tag (e.g. "ab500", "animated", "curated series 1"). Use list_tags to see all available tags.minFloorPricenumberMinimum floor price in ETHmaxFloorPricenumberMaximum floor price in ETH — only returns projects with a listing at or below this priceisArtblocksbooleantrue = Art Blocks flagship only, false = Engine only, omit for allincludeUnassignedbooleanInclude test/dev projects (default false)sortBystringnewest (default), oldest, name_asc, recently_updated, floor_asc, floor_desc, most_collected, edition_size_desc``limitnumberDefault 25, max 200offsetnumberFor pagination

Verticals#

ValueDescriptioncuratedArt Blocks Curated — highest-curation tierstudioArt Blocks Studio — artist-driven projectspresentsArt Blocks PresentsexplorationsArt Blocks ExplorationsplaygroundArt Blocks PlaygroundflexArt Blocks Flex — scripts with off-chain dependenciesfullyonchainFully on-chain — no external dependencies

Tool: get_project#

Returns full details for a single project. Use this when you need more than discover_projects provides — it returns the complete untruncated description, trait/feature distribution with per-value rarity percentages, artist profiles, tags, floor price, mint progress, minting config, featured token image, and artblocks.io link.

ParamTypeNotesprojectIdstringFull project ID (e.g. "0xa7d8...d270-78"). Provide this or slug.slugstringProject slug (e.g. "fidenza-by-tyler-hobbs"). Provide this or projectId.

Key fields unique to get_project (not in discover_projects):

• featureFields — trait distribution: each feature name with all values, counts, and rarity percentages
• Full description (not truncated — discover_projects truncates at ~800 chars)

Tool: get_artist#

Looks up an artist and returns all their projects with metadata, floor price, tags, and artblocks.io links. Search by name (partial), profile slug (exact), or wallet address.

ParamTypeNotesartistNamestringCase-insensitive partial matchartistSlugstringExact profile slug (e.g. "tyler-hobbs")artistAddressstringWallet address (exact match)chainIdnumberOptional chain filterlimitnumberMax projects to return (1–100, default 50)

At least one of artistName, artistSlug, or artistAddress is required.

Tool: discover_live_mints#

Returns projects currently active, unpaused, not complete, and past their start date. Ordered by most recently started. Includes minter type, pricing, supply, and artblocks.io links.

ParamTypeNotessearchstringFilter by project/artist namechainIdnumber1, 42161, 8453``limitnumberDefault 25, max 200

Tool: discover_upcoming_releases#

Returns projects with a future start_datetime, ordered by soonest first. Includes minter configuration and artblocks.io links.

ParamTypeNotessearchstringFilter by project/artist namechainIdnumber1, 42161, 8453``limitnumberDefault 25, max 100

Tool: list_tags#

Returns all distinct tag names that can be used with the discover_projects tag filter. No parameters. Common tags: "ab500", "animated", "interactive", "audio", "responsive", "curated series 1", "evolving".

Tool: get_wallet_summary#

High-level portfolio summary for an Art Blocks collector. Returns total token count, unique project count, chain distribution, and a per-project breakdown (project name, artist, token count, artblocks.io link) sorted by number held.

ParamTypeNoteswalletAddressstringWallet address or ENS name. Provide this or username (at least one required).usernamestringArt Blocks username — aggregates across all linked wallets.chainIdnumberOptional chain filterprojectIdstringFilter to a specific projectlimitnumberMax projects in breakdown (1–100, default 25)offsetnumberPagination offset

Tool: get_wallet_tokens#

Returns individual Art Blocks tokens owned by a collector with project context, media URLs, features/traits, mint date, and artblocks.io links.

ParamTypeNoteswalletAddressstringWallet address or ENS name. Provide this or username (at least one required).usernamestringArt Blocks username — aggregates across all linked wallets.chainIdnumberOptional chain filterprojectIdstringFilter to tokens from a specific projectsortBystringrecently_collected (default), first_collected, newest_mint, oldest_mint``limitnumberDefault 100, max 250offsetnumberFor pagination

User Profiles and Linked Wallets#

Art Blocks users can link multiple wallets to a single profile. get_wallet_summary, get_wallet_tokens, and check_allowlist_eligibility all accept either a walletAddress (including ENS) or an Art Blocks username. When a profile is found, tokens and eligibility are aggregated across all linked wallets, giving a complete view of a collector's holdings.

Project ID Format#

The id field in results is the full project ID used by all downstream tools:

<contract_address>-<project_index>

Example: 0xa7d8d9ef8d8ce8992df33d8b8cf4aebabd5bd270-0

Use this directly with get_project, get_project_minter_config, build_purchase_transaction, and check_allowlist_eligibility.

Following Up with GraphQL#

The domain-specific tools above handle most use cases. For deeper data (sales history, aggregations, custom joins), use the GraphQL tools ( graphql_query, build_query, explore_table) as an escape hatch.

Pagination#

text

# Page 1
discover_projects(tag: "ab500", sortBy: "floor_asc", limit: 25, offset: 0)

# Page 2
discover_projects(tag: "ab500", sortBy: "floor_asc", limit: 25, offset: 25)