Back to Details

discover-artblocks-projects

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Discovering Art Blocks Projects

探索Art Blocks项目

Choosing the Right Tool

选择合适的工具

GoalTool
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
目标工具
当前正在铸造的内容？
discover_live_mints
即将发布的内容？
discover_upcoming_releases
按垂直领域、艺术家、链、标签浏览/筛选
discover_projects
已知项目的完整详情
get_project
特定艺术家的所有项目
get_artist
收藏家的投资组合高阶摘要
get_wallet_summary
收藏家持有的单个代币
get_wallet_tokens
查看可用于筛选的标签
list_tags

Resource: 
artblocks://about

资源：
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

工具：
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.
浏览并筛选Art Blocks收藏品，支持可选文本搜索、链、垂直领域、标签、地板价和可铸造状态筛选。返回包含截断描述、地板价、铸造进度、特色代币图片以及Art Blocks.io直接链接的项目元数据。默认排除测试/开发项目（未分配垂直领域的项目）。

Filters

筛选条件

ParamTypeNotes
search
stringSearches project name and artist name (case-insensitive partial match)
artistName
stringFilter by artist name (case-insensitive partial match)
chainId
number
1
(Ethereum), 
42161
(Arbitrum), 
8453
(Base)
verticalName
stringSee verticals below
mintable
boolean
true
= actively mintable projects only
tag
stringFilter by tag (e.g. 
"ab500"
, 
"animated"
, 
"curated series 1"
). Use 
list_tags
to see all available tags.
minFloorPrice
numberMinimum floor price in ETH
maxFloorPrice
numberMaximum 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
booleanInclude test/dev projects (default false)
sortBy
string
newest
(default), 
oldest
, 
name_asc
, 
recently_updated
, 
floor_asc
, 
floor_desc
, 
most_collected
, 
edition_size_desc
limit
numberDefault 25, max 200
offset
numberFor pagination
参数类型说明
search
字符串搜索项目名称和艺术家名称（不区分大小写的部分匹配）
artistName
字符串按艺术家名称筛选（不区分大小写的部分匹配）
chainId
数字
1
（以太坊）, 
42161
（Arbitrum）, 
8453
（Base）
verticalName
字符串请查看下方的垂直领域列表
mintable
布尔值
true
= 仅返回当前可铸造的项目
tag
字符串按标签筛选（例如
"ab500"
、
"animated"
、
"curated series 1"
）。使用
list_tags
查看所有可用标签。
minFloorPrice
数字最低地板价（以ETH为单位）
maxFloorPrice
数字最高地板价（以ETH为单位）——仅返回有低于或等于该价格挂单的项目
isArtblocks
布尔值
true
= 仅返回Art Blocks旗舰项目, 
false
= 仅返回Engine项目, 留空则返回所有项目
includeUnassigned
布尔值包含测试/开发项目（默认值为false）
sortBy
字符串
newest
（默认）、
oldest
、
name_asc
、
recently_updated
、
floor_asc
、
floor_desc
、
most_collected
、
edition_size_desc
limit
数字默认25，最大值200
offset
数字用于分页

Verticals

垂直领域

ValueDescription
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
值描述
curated
Art Blocks Curated — 最高策展等级
studio
Art Blocks Studio — 艺术家主导的项目
presents
Art Blocks Presents
explorations
Art Blocks Explorations
playground
Art Blocks Playground
flex
Art Blocks Flex — 包含链下依赖的脚本
fullyonchain
Fully on-chain — 无外部依赖

Tool: 
get_project

工具：
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.
ParamTypeNotes
projectId
stringFull project ID (e.g. 
"0xa7d8...d270-78"
). Provide this or slug.
slug
stringProject 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)
返回单个项目的完整详情。当您需要
discover_projects
提供的内容之外的信息时使用本工具——它会返回完整未截断的描述、带各值稀有度百分比的特征/属性分布、艺术家资料、标签、地板价、铸造进度、铸造配置、特色代币图片以及Art Blocks.io链接。
参数类型说明
projectId
字符串完整项目ID（例如
"0xa7d8...d270-78"
）。需提供此参数或slug。
slug
字符串项目别名（例如
"fidenza-by-tyler-hobbs"
）。需提供此参数或projectId。
get_project
独有的关键字段（
discover_projects
中没有）：
  • featureFields
    — 特征分布：每个特征名称及其所有值、数量和稀有度百分比
  • 完整的
    description
    （未截断——
    discover_projects
    会截断至约800字符）

Tool: 
get_artist

工具：
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.
ParamTypeNotes
artistName
stringCase-insensitive partial match
artistSlug
stringExact profile slug (e.g. 
"tyler-hobbs"
)
artistAddress
stringWallet address (exact match)
chainId
numberOptional chain filter
limit
numberMax projects to return (1–100, default 50)
At least one of 
artistName
, 
artistSlug
, or 
artistAddress
is required.
查找艺术家并返回其所有项目的元数据、地板价、标签以及Art Blocks.io链接。可按名称（部分匹配）、资料别名（精确匹配）或钱包地址搜索。
参数类型说明
artistName
字符串不区分大小写的部分匹配
artistSlug
字符串精确匹配资料别名（例如
"tyler-hobbs"
）
artistAddress
字符串精确匹配钱包地址
chainId
数字可选的链筛选条件
limit
数字返回的最大项目数（1–100，默认50）
必须提供
artistName
、
artistSlug
或
artistAddress
中的至少一个参数。

Tool: 
discover_live_mints

工具：
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.
ParamTypeNotes
search
stringFilter by project/artist name
chainId
number
1
, 
42161
, 
8453
limit
numberDefault 25, max 200
返回当前活跃、未暂停、未完成且已过开始日期的项目。按最近启动时间排序。包含铸造者类型、定价、供应量以及Art Blocks.io链接。
参数类型说明
search
字符串按项目/艺术家名称筛选
chainId
数字
1
、
42161
、
8453
limit
数字默认25，最大值200

Tool: 
discover_upcoming_releases

工具：
discover_upcoming_releases

Returns projects with a future 
start_datetime
, ordered by soonest first. Includes minter configuration and artblocks.io links.
ParamTypeNotes
search
stringFilter by project/artist name
chainId
number
1
, 
42161
, 
8453
limit
numberDefault 25, max 100
返回带有未来
start_datetime
的项目，按发布时间从近到远排序。包含铸造配置以及Art Blocks.io链接。
参数类型说明
search
字符串按项目/艺术家名称筛选
chainId
数字
1
、
42161
、
8453
limit
数字默认25，最大值100

Tool: 
list_tags

工具：
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"
.
返回可用于
discover_projects
的
tag
筛选条件的所有独特标签名称。无参数。常见标签：
"ab500"
、
"animated"
、
"interactive"
、
"audio"
、
"responsive"
、
"curated series 1"
、
"evolving"
。

Tool: 
get_wallet_summary

工具：
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.
ParamTypeNotes
walletAddress
stringWallet address or ENS name. Provide this or 
username
(at least one required).
username
stringArt Blocks username — aggregates across all linked wallets.
chainId
numberOptional chain filter
projectId
stringFilter to a specific project
limit
numberMax projects in breakdown (1–100, default 25)
offset
numberPagination offset
返回Art Blocks收藏家的投资组合高阶摘要。返回总代币数、独特项目数、链分布以及按持有数量排序的项目明细（项目名称、艺术家、代币数量、Art Blocks.io链接）。
参数类型说明
walletAddress
字符串钱包地址或ENS名称。需提供此参数或
username
（至少提供其中一个）。
username
字符串Art Blocks用户名——汇总所有关联钱包的信息。
chainId
数字可选的链筛选条件
projectId
字符串筛选特定项目
limit
数字明细中返回的最大项目数（1–100，默认25）
offset
数字分页偏移量

Tool: 
get_wallet_tokens

工具：
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.
ParamTypeNotes
walletAddress
stringWallet address or ENS name. Provide this or 
username
(at least one required).
username
stringArt Blocks username — aggregates across all linked wallets.
chainId
numberOptional chain filter
projectId
stringFilter to tokens from a specific project
sortBy
string
recently_collected
(default), 
first_collected
, 
newest_mint
, 
oldest_mint
limit
numberDefault 100, max 250
offset
numberFor pagination
返回收藏家持有的单个Art Blocks代币，包含项目上下文、媒体URL、特征/属性、铸造日期以及Art Blocks.io链接。
参数类型说明
walletAddress
字符串钱包地址或ENS名称。需提供此参数或
username
（至少提供其中一个）。
username
字符串Art Blocks用户名——汇总所有关联钱包的信息。
chainId
数字可选的链筛选条件
projectId
字符串筛选特定项目的代币
sortBy
字符串
recently_collected
（默认）、
first_collected
、
newest_mint
、
oldest_mint
limit
数字默认100，最大值250
offset
数字用于分页

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.
Art Blocks用户可将多个钱包关联到单个资料。
get_wallet_summary
、
get_wallet_tokens
和
check_allowlist_eligibility
均接受
walletAddress
（包括ENS）或Art Blocks
username
作为参数。当找到对应资料时，会汇总所有关联钱包的代币和资格信息，完整展示收藏家的持有情况。

Project ID Format

项目ID格式

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
.
结果中的
id
字段是所有下游工具使用的完整项目ID：
<contract_address>-<project_index>
示例：
0xa7d8d9ef8d8ce8992df33d8b8cf4aebabd5bd270-0
可直接将其用于
get_project
、
get_project_minter_config
、
build_purchase_transaction
和
check_allowlist_eligibility
。

Following Up with GraphQL

使用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.
上述领域特定工具可处理大多数使用场景。如需更深入的数据（销售历史、聚合数据、自定义关联），可使用GraphQL工具（
graphql_query
、
build_query
、
explore_table
）作为备选方案。

Pagination

分页

undefined
undefined

Page 1

第1页

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

Page 2

第2页

discover_projects(tag: "ab500", sortBy: "floor_asc", limit: 25, offset: 25)
undefined
discover_projects(tag: "ab500", sortBy: "floor_asc", limit: 25, offset: 25)
undefined