Back to Details

get-artist

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Looking Up Art Blocks Artists

查找Art Blocks艺术家

Tool: 
get_artist

工具：
get_artist

Finds an artist and returns all their Art Blocks projects with full metadata, floor prices, tags, and direct artblocks.io links. Results are ordered by most recently launched.
查找艺术家并返回其所有Art Blocks项目的完整元数据、地板价、标签以及指向artblocks.io的直接链接。结果按最新发布顺序排列。

Search Options

搜索选项

Provide at least one — they can be combined:
ParamTypeNotes
artistName
stringCase-insensitive partial match (e.g. 
"hobbs"
finds Tyler Hobbs)
artistSlug
stringExact artist profile slug (e.g. 
"tyler-hobbs"
)
artistAddress
stringArtist's wallet address (exact match)
chainId
numberOptional — filter projects to a specific chain
limit
numberMax projects to return (1–100, default 50)
至少提供以下参数之一——也可组合使用：
参数类型说明
artistName
字符串不区分大小写的部分匹配（例如：
"hobbs"
会匹配到Tyler Hobbs）
artistSlug
字符串精确匹配艺术家个人主页的slug（例如：
"tyler-hobbs"
）
artistAddress
字符串艺术家的钱包地址（精确匹配）
chainId
数字可选参数——按特定链过滤项目
limit
数字返回的最大项目数（1–100，默认值为50）

Response Shape

响应结构

artistNames        — deduplicated list of artist display names matched
artistProfiles     — unique artist profile objects: { slug, displayName }
totalProjects      — total project count matching the query
projects[]         — array of project objects, each containing:
  id                 — full project ID (contract_address-project_index)
  name, artistName, description, slug
  artBlocksUrl       — direct link to project on artblocks.io
  chainId, contractAddress, projectIndex
  verticalName, verticalDisplay, curationStatus
  active, paused, complete, invocations, maxInvocations, remaining
  startDatetime, completedAt
  aspectRatio, scriptTypeAndVersion, renderComplete
  website, license
  lowestListing      — floor price in ETH (null if no listings)
  featuredTokenImageUrl — hero image URL (null if none)
  tags[]             — tag name strings (e.g. "ab500", "animated")
  artistProfiles[]   — { slug, displayName }
artistNames        — deduplicated list of artist display names matched
artistProfiles     — unique artist profile objects: { slug, displayName }
totalProjects      — total project count matching the query
projects[]         — array of project objects, each containing:
  id                 — full project ID (contract_address-project_index)
  name, artistName, description, slug
  artBlocksUrl       — direct link to project on artblocks.io
  chainId, contractAddress, projectIndex
  verticalName, verticalDisplay, curationStatus
  active, paused, complete, invocations, maxInvocations, remaining
  startDatetime, completedAt
  aspectRatio, scriptTypeAndVersion, renderComplete
  website, license
  lowestListing      — floor price in ETH (null if no listings)
  featuredTokenImageUrl — hero image URL (null if none)
  tags[]             — tag name strings (e.g. "ab500", "animated")
  artistProfiles[]   — { slug, displayName }

When to Use vs Other Tools

与其他工具的使用场景对比

Use 
get_artist
when...		Use something else when...
You want all projects by a specific artistYou want to browse projects broadly → 
discover_projects
You know the artist's name, slug, or wallet addressYou have a specific project ID → 
get_project
You want to compare an artist's body of workYou need token-level data → 
get_token_metadata
适合使用
get_artist
的场景...		适合使用其他工具的场景...
你想要获取特定艺术家的所有项目你想要广泛浏览项目 → 使用
discover_projects
你知道艺术家的姓名、slug或钱包地址你有特定的项目ID → 使用
get_project
你想要对比艺术家的全部作品你需要代币级别的数据 → 使用
get_token_metadata

Notes

注意事项

  • Results include 
    artBlocksUrl
    for each project — use these when presenting projects to users
  • The 
    artistSlug
    field in results (under 
    artistProfiles
    ) can be used for subsequent lookups
  • The tool excludes unassigned/test projects automatically
  • If the artist name is ambiguous (partial match returns multiple artists), the 
    artistNames
    array will show all matched names
  • projectIndex
    is the project number on the contract (e.g. 
    78
    ); 
    id
    is the full project ID (e.g. 
    0xa7d8...d270-78
    )
  • 结果中包含每个项目的
    artBlocksUrl
    ——向用户展示项目时可使用这些链接
  • 结果中（
    artistProfiles
    下的）
    artistSlug
    字段可用于后续查询
  • 该工具会自动排除未分配/测试项目
  • 如果艺术家姓名存在歧义（部分匹配返回多个艺术家），
    artistNames
    数组会显示所有匹配的名称
  • projectIndex
    是合约上的项目编号（例如：
    78
    ）；
    id
    是完整项目ID（例如：
    0xa7d8...d270-78
    ）