获取账户标签
1. 概述与典型用途
返回与账户关联的所有链上行为标签，包括资产、活跃度、DeFi、NFT 和治理等类别。
- 典型用途：快速了解账户的链上行为画像。
- 何时不要用：查询账户余额请用账户接口。
2. 接口与鉴权
GET /api/account/tag
Base URL 与鉴权见 公共网络与鉴权说明。
本接口强制需要 API Key：无 Key 调用返回 401。
3. 请求
字段
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
address | string | 是 | — | 查询的账户地址 |
4. 响应
字段
顶层
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
blueTag | string | 必返 | 蓝色标签（官方标识） | — |
greyTag | string | 必返 | 灰色标签 | — |
redTag | string | 必返 | 红色标签（风险标识） | — |
publicTag | string | 必返 | 公开标签 | — |
chainTags | object | 必返 | 按类别分组的链上行为标签；账户无任何标签时返回空对象 {} | — |
refreshTimeInfo | object | 可选 | 数据刷新时间信息；账户无标签数据时不返回 | — |
chainTags 类别键（动态对象的 key 集合）
| 类别 | 类型 | 是否必返 | 说明 |
|---|---|---|---|
Assets | array | 可选 | 资产类标签（如 High Balance / Whale） |
Activity | array | 可选 | 活跃度类标签（如 High Activity / Large Trader） |
DeFi | array | 可选 | DeFi 类标签（如 Lender on JustLend） |
NFT | array | 可选 | NFT 类标签（如 NFT Collector） |
Governance | array | 可选 | 治理类标签 |
各类别 value 为标签元素数组；账户在该类别无命中时返回空数组 []。
refreshTimeInfo 对象
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
type | string | 必返 | 刷新类型（如 realtime） | — |
lastUpdateTime | integer | 必返 | 最近更新时间 | 秒时间戳 |
chainTags 各类别下的标签元素
| 字段 | 类型 | 是否必返 | 说明 | 单位/精度 |
|---|---|---|---|---|
tagName | string | 必返 | 标签名称 | — |
tagNameKey | string | 必返 | 标签名称键 | — |
tagDesc | string | 必返 | 标签描述 | — |
tagDescKey | string | 必返 | 标签描述键 | — |
5. 错误
HTTP 状态码见 公共错误说明。本接口要点：
- 需要 API Key：未携带返回
401。 - 通用错误处理规则适用，无特殊错误场景。
最后更新于: