近期成交记录（无对应领域工具支持购买行为查询）

query {
  purchases_metadata(
    order_by: { block_timestamp: desc }
    limit: 20
    where: { chain_id: { _eq: 1 } }
  ) {
    token_id
    price_in_eth
    block_timestamp
    buyer_address
    seller_address
  }
}

按持有者聚合某项目的 Token 数量

query {
  tokens_metadata_aggregate(
    where: { project_id: { _eq: "0xa7d8d9ef8d8ce8992df33d8b8cf4aebabd5bd270-78" } }
    distinct_on: owner_address
  ) {
    aggregate { count }
  }
}

获取某项目下所有 Token（领域工具仅支持按钱包维度返回）

query {
  tokens_metadata(
    where: { project_id: { _eq: "0xa7d8d9ef8d8ce8992df33d8b8cf4aebabd5bd270-0" } }
    order_by: { invocation: asc }
    limit: 50
  ) {
    token_id
    invocation
    owner_address
    features
  }
}

筛选具备特定链上属性的项目

query {
  projects_metadata(
    where: {
      script_type_and_version: { _ilike: "%three%" }
      chain_id: { _eq: 1 }
      complete: { _eq: false }
    }
    limit: 20
  ) {
    id
    name
    artist_name
    script_type_and_version
    invocations
    max_invocations
  }
}

使用提示

• 编写查询前，先使用 explore_table 理解字段含义与关联关系——其精选视图比完整 Schema 更易快速浏览
• build_query 是最安全的起点：它会校验字段合法性，并明确告知您当前可用的字段
• 查询多链数据时，请务必传入 chainId，避免跨链噪声干扰结果
• 若仅需验证未知字段是否存在，validate_fields 比完整 Schema 自省（introspection）更快