获取链列表

GET /api/open/chains

该接口返回公开链列表，精简字段 以降低传输量；支持关键词、标签与排序。列表项含 categorySlugs（数据源有则返回），与 GET /api/open/categories?scope=chain 的 key 对齐，用于筛选与展示。

请求地址

GET /api/open/chains

请求参数

参数	类型	是否必传	说明
`locale`	string	否	链名称等展示语言
`q`	string	否	关键词搜索（名称等）
`tag`	string	否	逗号分隔的分类 slug，OR 匹配
`sort`	string	否	排序字段：`name` / `chainId` / `platforms` / `tvl`，默认 `tvl`
`sortDir`	string	否	排序方向：`asc` / `desc`，默认 `desc`

返回体

200 OK，application/json：

字段	类型	说明
`chains`	object[]	链列表，每项为 `ChainSlim`

ChainSlim 结构

字段	类型	说明
`_id`	string	内部 id
`slug`	string	链 slug，稳定标识
`name`	string	链名称（已按 locale 解析）
`logo`	string \| undefined	logo URL
`chain_id`	string	链 ID（如 EVM chainId）
`categorySlugs`	string[]	分类 slug 列表，与 categories 的 `key` 对齐
`llama_tvl`	number \| undefined	TVL（若有）

错误码

HTTP 状态	场景
`429`	命中 open API 限流
`500`	服务器内部错误

请求示例

curl -s "https://www.web3base.ai/api/open/chains?locale=zh-hans&sort=tvl&sortDir=desc" | jq '.chains[0]'
curl -s "https://www.web3base.ai/api/open/chains?tag=l2,evm" | jq '.chains | length'

返回示例

{
  "chains": [
    {
      "_id": "1",
      "slug": "ethereum",
      "name": "Ethereum",
      "logo": "https://...",
      "chain_id": "1",
      "categorySlugs": ["l1", "evm"],
      "llama_tvl": 50000000000
    }
  ]
}

← 返回 API 总览