Discovering Art Blocks Projects

Choosing the Right Tool

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

Verticals

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.

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.

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.

Tool: discover_upcoming_releases

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

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.

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.

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:

\x3Ccontract_address>-\x3Cproject_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

# 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)