Discovering Art Blocks Projects

Choosing the Right Tool

Goal	Tool
What's minting right now?	discover_live_mints
What's dropping soon?	discover_upcoming_releases
Browse/filter by vertical, artist, chain, tag	discover_projects
Full details on a known project	get_project
All projects by a specific artist	get_artist
High-level portfolio summary for a collector	get_wallet_summary
Individual tokens a collector owns	get_wallet_tokens
See available tags for filtering	list_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

Param	Type	Notes
search	string	Searches project name and artist name (case-insensitive partial match)
artistName	string	Filter by artist name (case-insensitive partial match)
chainId	number	1 (Ethereum), 42161 (Arbitrum), 8453 (Base)
verticalName	string	See verticals below
mintable	boolean	true = actively mintable projects only
tag	string	Filter by tag (e.g. "ab500", "animated", "curated series 1"). Use list_tags to see all available tags.
minFloorPrice	number	Minimum floor price in ETH
maxFloorPrice	number	Maximum floor price in ETH — only returns projects with a listing at or below this price
isArtblocks	boolean	true = Art Blocks flagship only, false = Engine only, omit for all
includeUnassigned	boolean	Include test/dev projects (default false)
sortBy	string	newest (default), oldest, name_asc, recently_updated, floor_asc, floor_desc, most_collected, edition_size_desc
limit	number	Default 25, max 200
offset	number	For pagination

Verticals

Value	Description
curated	Art Blocks Curated — highest-curation tier
studio	Art Blocks Studio — artist-driven projects
presents	Art Blocks Presents
explorations	Art Blocks Explorations
playground	Art Blocks Playground
flex	Art Blocks Flex — scripts with off-chain dependencies
fullyonchain	Fully 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.

Param	Type	Notes
projectId	string	Full project ID (e.g. "0xa7d8...d270-78"). Provide this or slug.
slug	string	Project 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.

Param	Type	Notes
artistName	string	Case-insensitive partial match
artistSlug	string	Exact profile slug (e.g. "tyler-hobbs")
artistAddress	string	Wallet address (exact match)
chainId	number	Optional chain filter
limit	number	Max 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.

Param	Type	Notes
search	string	Filter by project/artist name
chainId	number	1, 42161, 8453
limit	number	Default 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.

Param	Type	Notes
search	string	Filter by project/artist name
chainId	number	1, 42161, 8453
limit	number	Default 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.

Param	Type	Notes
walletAddress	string	Wallet address or ENS name. Provide this or username (at least one required).
username	string	Art Blocks username — aggregates across all linked wallets.
chainId	number	Optional chain filter
projectId	string	Filter to a specific project
limit	number	Max projects in breakdown (1–100, default 25)
offset	number	Pagination 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.

Param	Type	Notes
walletAddress	string	Wallet address or ENS name. Provide this or username (at least one required).
username	string	Art Blocks username — aggregates across all linked wallets.
chainId	number	Optional chain filter
projectId	string	Filter to tokens from a specific project
sortBy	string	recently_collected (default), first_collected, newest_mint, oldest_mint
limit	number	Default 100, max 250
offset	number	For 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

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