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)
